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当今 社会 是 一 个 电子 信息 技术 飞速 发 展 的 年 代 ， 小 到 玩具 ， 家 电 ， 大 到 手机 、 飞 机 、 洪 艇 

等 ， 都 离 不 开 电 子 信息 技术 。 社 会 上 对 于 电子 信息 方面 的 人 才 需 求 也 很 大 ， 从 就 业 的 角度 而 言 
电子 、 计 算 机 、 通 信 以 及 信息 方面 专业 的 毕业 生 工 资 都 比较 高 ， 就 业 也 比较 容易 ， 尤 其 是 嵌入 
式 、Linux 和 Android 等 相关 开发 工作 。 
EPERERA Linux 中 的 驱动 开发 ， 相 信 大 部 分 读者 和 作者 一 样 ， 以 前 都 是 做 单片机 开 
发 的 工作 ， 比 如 51 或 者 STM32 等 。 单 片 机 开发 很 难 接触 到 更 高 层次 的 系统 方面 的 知识 ， 单 片 
机 用 到 的 系统 都 很 简单 ， 比 如 UCOS. FreeRTOS 等 等 ， 这 些 操作 系统 都 是 一 个 kernel, WRA 
要 网 络 、 文 件 系统 、GUI 等 这 些 就 需要 开发 者 自行 移植 。 而 移植 又 是 非常 痛苦 的 一 件 系统 ， 而 
且 移 植 完 成 以 后 的 稳定 性 也 无 法 保证 。 即 使 移植 成 功 以 后 后 续 的 开发 工作 也 比较 繁琐 ， 因 为 不 
同 的 组 件 其 API 操作 函数 都 不 同 ， 没 有 一 个 统计 的 标准 ， 使 用 起 来 的 话 学 习 成 本 比较 高 。 这 个 
时 候 一 个 功能 完善 的 操作 系统 显得 尤为 重要 : 具有 统一 的 标准 ;提供 完善 的 多 任务 管理 、 存 储 
管理 、 设 备 管理 、 文 件 管理 和 网 络 等 。Linux 就 是 这 样 一 个 系统 ， 当 然 这 样 的 系统 还 有 很 多 ， 比 
如 Windows, MacOS, UNIX 等 等 。 本 书 我 们 讲解 Linux, m Linux 开发 可 以 分 为 底层 驱动 开发 
和 应 用 开发 ， 本 书 讲解 的 是 Linux 的 驱动 开发 ， 主 要 面向 与 那些 此 前 使 用 STM32 的 开发 者 。 平 
心 而 论 , 如 果 此 前 只 会 51 单片机 开发 的 话 我 是 非常 不 建议 直接 上 手 Linux 驱动 开发 的 , 因为 51 
和 Linux 驱动 开发 的 差距 太 大 了 ! 笔者 建议 在 学 习 拒 入 式 Linux 驱动 开发 之 前 一 定 要 学 一 下 
STM32 这 种 Cortex-M 内 核 的 MCU， 因 为 STM32 这 样 的 MCU 其 内 部 资源 基本 和 可 以 运行 
Linux 的 CPU 差不多 ， 如 果 会 STM32 的 话 上 手 Linux 驱动 开发 就 会 容易 很 多 。 笔 者 就 是 此 前 
做 了 4 年 STM32 开发 工作 ， 然 后 转 的 Linux 驱动 开发 ， 整 个 过 程 比较 顺畅 。 

鉴于 当前 STM32 非常 火爆 ， 学 习 者 众多 ， 如 何 帮 助 STM32 学 习 者 顺利 的 转 入 Linux 驱动 
开发 是 笔者 思考 了 很 久 的 问题 。 为 此 笔者 本 书 和 相应 例 程 的 安排 如 下 : 

1、 选 取 合 适 的 CPU 
理论 上 来 讲 ， 如 果 ST 公司 有 可 以 运行 的 Linux 的 芯片 那 再 好 不 过 了 ， 因 为 大 家 对 STM32 
很 熟悉 ， 但 是 在 写本 书 的 时 候 ST 也 没有 可 以 运行 Linux 的 CPU。Linux 驱动 开发 入 门 的 CPU 
一 定 不 能 复杂 !1!! 比如 像 三 星 的 Exynos 4412, Exynos 4418 等 这 些 手 机 CPU， 这 些 CPU 性 能 
很 强大 ， 带 有 GPU、 支 持 硬 件 视频 解码 、 可 以 运行 Andriod。 但 是 正 是 它们 的 性 能 过 于 强大 ， 
功能 过 于 繁杂 ,所 以 不 适合 Linux 驱动 开发 入 门 。 一 款 外 设 和 STM32H7 这 样 的 MCU 差不多 的 
CPU 就 非常 适合 Linux 入 门 ， 三 星 的 2440 就 非常 合适 ， 但 是 2440 早已 停产 了 ， 学 了 以 后 工作 
上 肯定 又 用 不 到 了 ， 又 得 学 习 其 他 的 CPU， 有 点 浪费 时 间 。 作 者 花 了 不 少时 间 终 于 找到 了 一 款 
合适 的 CPU, 那 就 是 NXP 的 IMX6UL 1! 可 以 认为 LMX6UL 就 是 一 球 可 以 跑 Linux 的 STM32， 
外 设 功能 和 STM32 相似 ， 如 果 此 前 学 习 过 STM32 的 话 会 非常 容易 上 手 LIMX6UL。 而 且 目 前 
LMX6UL 正在 大 量 出 货 ， 这 是 一 款 工业 级 的 CPU， 大量 的 以 前 三 星 2440、6410 做 的 产品 更 新 
换代 的 绝 佳之 选 , 学 习 完 LMX6UL 以 后 工作 就 可 以 直接 使 用 了 。 本 书 选取 开发 平台 为 和 焉 头 猫 科 
技 的 LIMX6U-ALPHA 开发 板 ， 其 他 厂商 的 ILMX6UL 开发 板 也 可 以 参考 本 书 。 

2、 开 发 环境 讲解 


STM32 的 开发 都 是 在 Windows 系统 下 进行 的 ， 使 用 MDK 或 者 IAR 这 样 的 集成 IDE， 但 
ERA Linux 驱动 开发 需要 的 主机 是 Linux 平台 的 ， 也 就 是 你 必须 先 在 自己 的 电脑 上 安装 
Linux 系统 ，Linux 系统 发 行 版 有 Ubuntu, CentOS, Fdeora, Debian 等 等 ， 本 书 我 们 使 用 Ubuntu 
操作 系统 。 本 书 假 设 大 家 此 前 从 来 没有 接触 过 Ubuntu 操作 系统 ， 因 此 会 有 详细 的 Ubuntu 操作 
系统 安装 、 使 用 教程 ， 帮 助 大 家 数据 开发 环境 。 
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3、 合 理 的 裸 机 例 程 

FIRAR Linux 驱动 开发 一 定 要 先 学 习 裸 机 开发 1!! Linux 驱动 开发 非常 庞大 、 繁 琐 。 要 
想 进行 Linux 驱动 开发 ， 必 须要 先 移 植 Uboot、 然 后 移植 Linux 系统 和 根 文 件 系统 到 你 的 开发 
FEE. m Uboot 又 是 一 个 超大 的 裸 机 综合 例 程 ， 因 此 如 果 你 没有 学 习 过 裸 机 例 程 那么 Uboot 
移植 基本 不 可 能 成 功 ， 尤 其 是 当 要 修改 Uboot 代码 的 时 候 。 做 STM32 开发 的 话 基 本 都 是 裸 机 
开发 ， 在 IDE 平台 下 编写 代码 ， 可 以 使 用 ST 提供 的 库 。 但 是 在 Ubuntu 下 编写 LMX6UL 裸 机 
例 程 的 话 就 没有 这 么 方便 了 ， 没 有 MDK 和 IAR 这 样 的 IDE， 没 有 ST 提供 的 库 。 所 有 的 一 切 
都 需要 我 们 自己 搭建 ， 大 家 不 用 担心 ， 本 书包 括 视 频 会 有 详细 的 讲解 。 在 裸 机 例 程 内 容 方面 ， 
我 们 提供 了 数 十 个 裸 机 例 程 ， 由 浅 入 深 ， 涵 盖 了 大 部 分 常用 的 功能 ， 比 如 IO 输入 和 输出 、 中 
断 、 串 口 、 定 时 器 、DDR、LCD、LC 等 。 学习 完 裸 机 例 程 以 后 基本 就 对 IMX6UL 这 颗 CPU JE 
常 了 解 了 。 再 去 学 习 Linux 驱动 开发 的 话 就 很 轻松 了 。 

4、Uboot、Linux 和 根 文件 系统 移植 

学 习 完 裸 机 例 程 以 后 就 是 Linux 驱动 开发 了 ， 但 是 在 进行 Linux 驱动 开发 之 前 要 先 在 使 用 
的 开发 板 平 台 上 移植 好 Uboot，Linux 和 根 文件 系统 。 这 是 Linux 驱动 开发 的 第 一 个 拦路 虎 ， 
因此 本 书 和 相应 的 视频 会 着 重 讲解 Uboot/Linux 和 根 文件 系统 的 移植 。 

5. BAR Linux 驱动 开发 

当 我 们 把 Uboot, Linux 和 根 文件 系统 都 在 开发 板 上 移植 好 了 以 后 就 可 以 开始 Linux 驱动 
开发 了 。Linux 驱动 有 三 大 类 :字符 设备 驱动 、 块 设备 驱动 和 网 络 设备 驱动 ， 这 三 大 类 我 们 都 会 
详细 的 讲解 ， 并 且 配 有 数 十 个 相应 的 例 程 ， 由 简 入 深 ， 从 最 简单 的 点 灯 ， 到 最 后 的 网 络 驱动 。 

本 书 一 共 分 四 篇 ， 每 篇 对 应 一 个 不 同 的 阶段 ; 

第 一 篇 ， Ubuntu 操作 系统 入 门 

本 篇 主要 讲解 Ubuntu 操作 系统 的 使 用 ， 本 篇 不 涉及 到 任何 嵌入 式 方 面 的 知识 ， 全 部 是 在 
PC 上 完成 的 ， 只 要 安装 好 Ubuntu 操作 系统 即 可 。 

第 二 篇 ARM 裸 机 开发 

从 本 篇 开始 我 们 就 正式 开始 使 用 开发 板 学 习 了 ， 本 篇 通过 数 十 个 裸 机 例 程 来 帮助 大 家 了 解 
I.MX6UL 这 果 CPU。 为 以 后 的 Linux 驱动 开发 做 准备 ， 通 过 本 篇 大 家 可 以 掌握 在 Ubuntu 下 进 
行 ARM 开发 的 方法 。 

第 三 篇 : Uboot、Linux 和 根 文件 系统 移植 

本 篇 讲解 如 何 将 Uboot、Linux 和 根 文件 系统 移植 到 我 们 的 开发 板 上 ， 为 后 面 的 Linux 驱 
动 开 发 做 准备 。 

第 四 篇 : Linux 驱动 开发 

前 面 做 了 那么 多 的 工作 就 是 为 了 本 篇 ， 因 此 本 篇 注定 了 将 是 本 书 重 中 之 重 ， 大 家 应 该 投入 
精力 最 多 的 一 篇 ， 望 大 家 做 好 准备 。 

通过 上 面 四 篇 的 学 习 ， 大 家 基本 掌握 了 和 骨 入 式 Linux 驱动 的 开发 流程 ， 本 书 旨 在 引导 大 家 
入 门 Linux 驱动 开发 ， 更 加 深入 的 研究 就 需要 大 家 自行 查阅 其 他 更 加 专业 的 书籍 了 ， 祝 愿 大 家 
学 习 顺 利 。 
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第 一 篇 Ubuntu 系统 入 门 篇 


本 篇 主要 讲解 Ubuntu 系统 ,包括 如 何在 虚拟 机 上 安装 Ubuntu 操作 系统 , 安装 好 以 后 Ubuntu 
的 设置 、 基 本 操作 等 等 。 在 正式 进行 谋 入 式 开 发 之 前 肯定 是 要 先 学 会 Ubuntu 系统 如 何 使 用 的 ， 
由 于 Ubuntu 系统 功能 很 庞大 ， 如 果 要 详细 讲解 的 话 一 本 书 都 讲 不 完 ， 因 此 本 篇 只 做 Ubuntu 系 
统 入 门 讲解 , 掌握 我 们 进行 嵌入 式 开发 所 需 的 计 能 即 可 ,如 果 想 详细 的 学 习 Ubuntu 系统 的 话 可 
以 参考 其 他 的 书籍 ， 比 如 经 典 的 《 鸟 哥 的 linux 私房 菜 》 CS; SEIT] linux 私房 荣 》 这 本 书 使 用 的 
CentOS 操作 系统 ， 但 是 Ubuntu 下 完全 可 以 使 用 。 
当 Ubuntu 系统 入 门 以 后 ， 我 们 重点 要 学 的 就 是 如 何在 Linux 下 进行 C 语言 开发 ， 如 何 使 用 gee 
编译 器 、 如 何 编写 Makefile 文件 等 等 。 

如 果 此 前 已 经 使 用 过 Ubuntu 操作 系统 ,并 且 从 事 过 Linux C 编程 工作 的 话 本 篇 就 不 需要 看 
了 ， 可 以 直接 跳 到 第 二 篇 ， 开 始 ARM 裸 机 开发 篇 的 学 习 。 
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第 一 章 Ubuntu 系统 安装 


Linux 的 开发 需要 在 Linux 系统 下 进行 ， 这 就 要 求 我 们 的 PC 主机 安装 Linux 系统 ， 


KER 


们 选择 Ubuntu 这 个 Linux 发 行 版 系统 。 本 章 讲解 如 何 安装 虚拟 机 ， 以 及 如 何在 虚拟 机 中 安装 





Ubuntu 系统 ， 安 装 完 成 以 后 如 何 做 简单 的 设置 。 如 果 已 经 对 于 虚拟 机 以 及 Ubuntu Afi 


操作 已 





经 熟悉 的 话 就 可 以 跳 过 本 章 。 
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1.1 安装 虚拟 机 软件 VMware 


不 是 安装 Ubuntu 吗 ? 怎么 要 先 安装 虚 拟 机 呢 ? 虚拟 机 是 个 啥 ? 相 信 大 部 分 第 一 次 安装 

Ubuntu 的 人 都 会 有 这 个 疑问 。 我 不 能 直接 安装 Ubuntu 吗 ? 能 不 能 不 要 虚拟 机 呢 ? 答案 是 肯定 
可 以 的 ! 直接 在 电脑 上 安装 Ubuntu 以 后 你 的 电脑 就 是 一 个 真 真正 正 的 Ubuntu 电脑 了 ， 你 可 以 
再 安装 一 个 Windows 系统 ， 这 样 你 的 电脑 就 是 双 系 统 了 ， 在 开机 的 时 候 可 以 选择 不 同 的 系统 启 
动 。 但 是 这 样 的 话 会 有 一 个 问题 ， 那 就 是 你 每 次 只 能 选择 其 中 的 一 个 系统 启动 ， 要 么 Windows 
要 么 Ubuntu, 但 是 我 们 再 开发 的 时 候 很 多 时 候 需 要 再 Windows 和 Ubuntu 下 来 回 切换 , Windows 
系统 下 的 软件 资源 要 比 Ubuntu 下 丰富 的 多 ， 比 如 我 们 在 Windows 用 Source Insight 这 个 神器 编 
写 代码 ,然后 拿 到 Ubuntu 下 编译 。 这 个 就 设计 到 两 个 系统 切换 问题 ,显然 如 果 你 直接 在 电脑 上 
安装 Ubuntu 以 后 就 没 法 做 到 ， 因 为 你 每 次 开机 只 能 在 Windows 和 Ubuntu 下 二 选 一 。 
如 果 Ubuntu 系统 能 作为 Windows 下 的 一 个 软件 就 好 了 ， 我 们 默认 启动 Windows 系统 ， 需 要 用 
到 Ubuntu 的 话 直接 打开 这 个 软件 就 行 了 。 当 然 可 以 ! 这 个 就 要 借助 虚拟 机 了 ， 虚 拟 机 顾名思义 
就 是 虚拟 出 一 个 机 器 ， 然 后 你 就 可 以 在 这 个 机 器 上 安装 任何 你 想 要 的 系统 ， 相 当 于 在 克隆 出 一 
个 你 的 电脑 ， 这 样 在 主机 上 运行 Windows 系统 ， 当 我 们 需要 用 到 Ubunut 的 话 就 打开 安装 有 
Ubuntu 系统 的 虚拟 机 。 

虚拟 机 的 实现 我 们 可 以 借助 其 他 软件 ,比如 Vmware Workstation, Vmware Workstation 是 收 
费 软件 , 免费 的 虚拟 机 软件 有 Virtualbox 。 本 书 我 们 使 用 Vmware Workstation 软件 来 做 虚拟 机 。 
Vmware Workstation 软件 可 以 在 Wmeare E N FR, FA Hh Bb: 
https://www.vmware.com/products/workstation-pro/workstation-pro-evaluation.html, %4 Ri 3r) 
本 是 Vmware Workstation Pro 15， 我 们 下 载 Windows 版 本 的 ， 如 下 图 所 示 : 

















































































































© j| hao123 上 网 从 这 里 开始 图 Download VMware Workstat x | 十 U- 0x 
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COMPANY 我 们 将 cookies 用 于 广告 、 社 交 媒 体 和 分 析 等 用 途 。 请 在 此 了 解 我 们 如 何 使 用 cookies 以 及 如 何 控制 它们 。 如 果 您 继续 使 用 本 网 


即 表 示 您 同意 我 们 使 用 cookies 








我 们 已 经 在 开发 板 光盘 里 面 提供 了 Vmware Workstation 软件 ， 大 家 可 以 直接 使 用 ， 在 光盘 
目录 : 开发 板 光 盘 ->3、 软 件 -~>VMware-workstation-full-15.0.2-10952284.exe。WMware Workstation 
的 安装 和 普通 软件 安装 一 样 ,双击 VMware-workstation-full-15.0.2-10952284.exe 进入 安装 界面 ， 
如 图 1.1.1 所 示 : 
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39 VMware Workstation Pro 安装 = x 


15 


WORKSTATION . 
es 安装 向 导 将 在 您 计算 机 上 安装 VMware Workstation Pro o 
PRO 单 击 下 一 步 叭 续 ， 或 单 击 * 取 消 "退出 安装 向 导 。 


欢迎 使 用 VMware Workstation Pro 安装 向 导 


版 权 所 有 1998-2018 VMware, Inc. 保留 所 有 权利 。 本 产品 
受 美国 和 国际 版 权 及 知识 产权 法 保护 。VMware 产品 获得 
以 下 网 站 中 列 出 的 一 需 或 多 项 专利 : 





http: 'w.vmware.com tents-cn 











图 1.1.1 VMware 安装 界面 
点 击 图 1.1.1 中 的 “下 一 步 ”， 进 入 图 1.1.2 所 示 步 又 : 





39 VMware Workstation Pro 安装 = x 
最 终 用 户 许可 协议 
请 仔细 阅读 以 下 许可 协议 。 


VMWARE 最 终 用 户 许可 协议 





请 注意 ， 在 本 软件 的 安装 过 程 中 无 论 可 能 会 出 现任 何 条 款 ， 
使 用 本 软件 者 将 受 此 最 终 用 户 许可 协议 各 条 款 的 约束 。 

重要 信息 ， 请 仔细 阅读 ， 您 一 旦 下 载 、 安 装 或 使 用 本 软件 ， 
您 (自然 人 或 法 人 ) 即 同意 接受 本 最 终 用 户 许可 协议 (“本 
协议 ”) 的 约束 。 如 果 您 不 同意 本 协议 的 条 款 ， 请 勿 下 载 、 
安装 或 使 用 本 软件 ， 您 必须 删除 本 软件 ， 或 在 三 十 (30) 天 _ v 


口 我 接受 许可 协议 中 的 条 款 (A) 选中 接受 条 款 


HE | | 上 一 步 6) || P-E 取消 














1.1.2 VMware 条 款 
先 选 择 图 1.1.2 中 的 “我 接受 许可 协议 中 的 条 款 ” 然后 在 选择 “下 一 步 ” 进入 图 1.1.3 所 
ASIE 
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39] VMware Workstation Pro 安装 = x 
自 定义 安装 
选择 安装 目标 及 任何 其 他 功能 。 


安装 位 置 : 
C:\Program Files (x86)WMwareWMware Workstation 


A 
口 增强 型 键盘 驱动 程序 (需要 重新 引导 以 使 用 此 功能 日 。 ”更 改 安装 路 径 
此 功能 要 求 主机 驱动 器 上 具有 10M8 空间 。 





上 一 步 6) [T*—5w] | 取消 








1.1.3 选择 安装 路 径 
1.1.3 中 选择 软件 的 安装 路 径 ， 点 击 “ 更 改 ” 按 钮 ， 然 后 根据 自己 的 实际 需要 选择 合适 路 
径 即 可 ,我 的 安装 路 径 如 图 1.1.4 所 示 : 











19] VMware Workstation Pro 安装 = x 
更 改 目 标 文件 夫 
浏览 到 目标 文件 夹 
查找 … | Ek VMware Workstation v | © a 




















Fi + 2 ERIE 


D:\Program Files (x86)WMwareWMware Workstation!| 





[ we ] | 








1.1.4 安装 路 径 
选择 好 路 径 以 后 点 击 图 1.1.4 中 的 “确定 ”按钮 ， 然 后 回 到 图 1.1.3 所 示 界 面 ， 点 击 图 1.1.3 
中 的 “下 一 步 ” 进入 图 1.1.5 所 示 界 面 : 
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418 VMware Workstation Pro 安装 = x 
用 户 体验 设置 - 
编辑 默认 设置 以 提高 您 的 用 户 体验 。 L 
建议 不 勾 选 这 两 个 


口 启动 时 检查 产品 更 新 (C) 。 、 
Ee Workstation Pro 启动 时 ， 检 查 应 用 程序 和 已 安装 软件 组 件 是 否 有 





口 加 入 VMware 客户 体验 提升 计划 中 ) 


VMware 客户 体验 提升 计划 (CEIP) 将 向 VMware 提供 相 ^ 
关 信 息 ， 以 帮助 VMware 改进 产品 和 服务 、 解 决 问 

题 、 并 向 您 建议 如 何以 最 佳 方式 部 哮 和 使 用 我 们 的 产 
品 。 作 为 CEIP 的 一 部 分 ，VMware 会 定期 收集 和 您 所 

持 有 的 VMware 密 钥 相关 的 使 用 VMware 产品 和 服务 的 v 
lE 








上 一 步 @) [T-N] | 取消 








1.1.5 检查 更 新 界面 
在 图 1.1.5 中 ， 会 有 两 个 复 选 枉 ， 默 认 都 是 选中 的 ， 建 议 不 要 选中 ! 然后 点 击 图 1.1.5 中 的 
“下 一 步 ” 按 钮 ， 进 入 图 1.1.6 所 示 界 面 : 











$ VMware Workstation Pro 安装 = x 
快捷 方式 
选择 您 要 放 入 系统 的 快捷 方式 。 


在 以 下 位 置 创 建 VMware Workstation Pro 的 快捷 方式 : 


回 开 始 菜单 程序 文件 来 (S) 


选中 这 两 个 





上 一 步 (6) 取消 








1.1.6 快捷 方式 设置 
在 图 1.1.6 中 有 两 个 选项 ， 我 们 都 选中 ， 这 样 在 安装 完成 以 后 就 会 在 开始 菜单 和 桌面 上 有 
VMware 的 图 标 ， 选 中 以 后 点 击 图 1.1.6 中 的 “下 一 步 2” 进入 图 1.1.7 界面 : 
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19 VMware Workstation Pro 安装 一 x 
已 准备 好 安装 VMware Workstation Pro (9 


MIR MERA 单 击 "上 一 步 查 看 或 更 改 任何 安装 设置 。 单 击 "取消 ?退出 向 





上 一 步 @) 取消 | 








1.1.7 安装 确定 界面 
前 面 几 步 已 经 设置 好 安装 参数 了 ， 如 果 许 需要 修改 安装 参数 的 话 就 点 击 图 LIS 中 的 “ 安 
装 ” 按 钮 开始 安装 VMware， 安 装 过 程 如 图 1.1.8 所 示 : 





期 VMware Workstation Pro 安装 = x 


正在 安装 VMware Workstation Pro t 


安装 向 导 正在 安装 VMware Workstation Pro， 请 稍 候 。 


状态 : 正在 VMware 密 钥 上 设置 自 定义 注册 表 权 限 。 
[A 





上 一 步 6) | 下 一 步 (VY) 








1.1.8 安装 进行 中 
图 1.1.8 就 是 安装 过 程 ， 耐 心 等 待 几 分 钟 ， 等 待 安装 完成 ， 安 装 完成 以 后 会 有 如 图 1.1.9 所 
示 提 示 : 
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P5] VMware Workstation Pro 安装 


论坛 :www.opendev.com 





1 VMware Workstation Pro 安装 向 导 已 完成 


WORKSTATION 单 击 ` 完 成 按钮 退出 安装 向 导 。 
PRO” 


DRA EEEE 请 按 下 面 的 许可 证 S 








TREO 











1.1.9 安装 完成 
点 击 图 1.1.9 中 的 “完成 ”按钮 ， 完 成 VMware 的 安装 ， 安 装 完成 以 后 就 会 在 桌面 上 出 现 
VMware Workstation Pro 的 图 标 ， 如 图 1.1.10 所 示 : 








1.1.10 VMware 桌面 图 标 


双击 图 1.1.10 中 的 图 标 打开 VMware 软件 ， 在 第 一 次 打开 软件 的 时 候 会 提示 你 输入 许可 证 
密 钥 ， 如 图 1.1.11 所 示 : 








欢迎 使 用 VMware Workstation 15 x 


g VMware Workstation 15 


(€) 我 有 VMware Workstation 15 的 许可 证 密 钥 (H): 





是 天 需要 许可 证 密 钥 ? 
立即 购买 


O 我 希望 试用 VMware Workstation 15 30 天 (W) 


四 继续 (C) 取消 











1.1.11 输入 许可 证 密 钥 
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前 面 说 了 VMware 是 付费 软件 ， 是 需要 购买 的 ， 如 果 你 购买 了 VMware 的 话 就 会 有 一 串 
许可 密 铀 ， 如 果 没 有 购买 的 话 就 选择 “我 希望 试用 VMware Workstation 15 30 天 ”选项 ， 这 样 
你 就 可 以 体验 30 天 VMware。 输 入 密 钥 以 后 点 击 “ 继 续 按钮 ” 如 果 你 的 密 钥 正确 的 话 就 会 提 
示 你 购买 成 功 ， 如 图 1.1.12 所 示 : 














欢迎 使 用 VMware Workstation 15 
g VMware Workstation 15 


感谢 您 购买 VMware Workstation 15! 


VMware Workstation 15 是 最 先进 的 虚拟 化 软件 ， 广 泛 支 持 多 
种 操作 系统 ， 可 提供 极其 丰富 的 桌面 用 户 体验 。 


我 们 相信 您 一 定 会 发 现 VMware Workstation 15 应 用 程序 将 
成 为 您 提高 生产 效率 、 开 展业 务 所 不 可 或 缺 的 利器 。 


祝 您 使 用 愉快 ! 








1.1.12 购买 VMware 成 功 
点 击 图 1.1.12 中 的 “完成 ”按钮 ，VMware 软件 正式 打开 ， 界 面 如 图 1.1.13 所 示 : 























(B) VMware Workstation 一 n x 
文件 (F) 编辑 (E) 查看 V) ”虚拟 机 (M) 选项 F(T 帮助 H) DP - c o ns [Bu H 
库 
O 在 此 处 键入 内 容 进行 搜索 
日 ines 
D nEn WORKSTATION 15 PRO™ 


4 


打开 虚拟 机 




















1.1.13 VMware Workstation 主 界面 
至 此 ， 虚 拟 机 软件 VMware 安装 成 功 。 


1.2 创建 虚拟 机 
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安装 好 VMware 以 后 我 们 就 可 以 在 VMware 上 创建 一 个 虚拟 机 ， 打 开 VMware, wik: X 


件 -> 新 建 虚 拟 机 ， 如 图 1.2.1 所 示 : 


论坛 :Www.opendev.com 








(B) VMware Workstation 









b--oa28s|nnBgg! 














E 编辑 (日 ”查看 (V) ”虚拟 机 (M) ”选项 卡 (T) BH) 
[E 新 建 窗口 (W) 





打开 (O)… 
扫描 虚拟 机 (S)… 
关闭 选项 卡 (C) 


E ERZES)... 


Ctrl-O 


Ctrl-W 
Ctrl+L 


d ”虚拟 化 物理 机 (P)… 
SHA OVF(E)... 
D ”映射 虚拟 磁盘 (M).… 


退出 (X) 


















WORKSTATION 15 PRO™ 


1.2.1 新 建 虚拟 机 
打开 图 1.2.2 所 示 创 建 虚拟 机 向 导 界 面 : 





新 建 虚拟 机 向 导 


VMWARE 5 


WORKSTATION 


PRO" 


欢迎 使 用 新 建 虚拟 机 向 导 


您 希望 使 用 什么 类 型 的 配置 ? 


O 典型 (推荐 )(T) 
通过 几 个 简单 的 步骤 创建 Workstation 
15.x 虚拟 机 。 


(€) 自 定义 (高 级 )(C) 
创建 带 有 SCSI 控制 器 类 型 、 虚 拟 磁 盘 类 


型 以 及 与 旧版 VMware 产品 兼容 性 等 高 
级 选项 的 虚拟 机 。 

















< LB) 





1.2.2 创建 虚拟 机 向 导 
选中 图 1.2.2 中 的 “ 自 定义 ”选项 ， 然 后 选择 “下 一 步 ” 进入 图 1.2.3 所 示 硬 件 兼容 性 
选择 界面 : 
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论坛 :Www.opendev.com 
新 建 虚拟 机 向 导 x 
选择 虚拟 机 硬件 兼容 性 
该 虚拟 机 需要 何 种 硬件 功能 ? 
虚拟 机 硬件 兼容 性 
硬件 兼容 性 (H): Workstation 15.x Y 
兼容 : ESX Server(S) 
兼容 产品 : 限制 : 
Fusion 11.x 64 GB 内 存 
Workstation 15.x 16 个 处 理 器 
10 个 网 络 适配器 
8 TB 磁盘 大 小 
3 GB 共享 图 形 内 存 













































































帮助 < 上 一 步 (B) 取消 
图 1.2.3 硬件 兼容 性 选择 
在 图 1.2.3 中 我 们 使 用 默认 值 就 行 了 ， 直接 点击 “下 一 步 ”， 进 入 图 1.2.4 所 示 的 操作 系统 安 
装 界面 : 
新 建 虚拟 机 向 导 x 
安装 客户 机 操作 系统 
虚拟 机 如 同 物理 机 ， 需 要 操作 系统 。 您 将 如 何 安装 客户 机 操作 系统 ? 
安装 来 源 
安装 程序 光盘 (D): 
无 可 用 驱动 器 


O 安装 程序 光盘 映像 文件 (so)(M): 


G:\ 软 件 \ubuntu 操 作 系统 ubuntu-16.04-desktop-amd6 浏览 (R).… 








帮助 





«E-5) má 








图 1.24 安装 客户 机 操作 系统 
图 1.2.4 就 是 选择 你 新 创建 的 虚拟 机 要 安装 什么 系统 ? windos 还 是 linux， 如 果 你 要 现在 就 
安装 系统 的 话 需 要 准备 好 系统 文件 

















F, 一 般 是 .iso 文件 。 我 们 现在 不 安装 系统 ,因此 选择 “ 稍 后 安 
装 操作 系统 (S)” 这 个 选项 ， 然 后 选择 “下 一 步 "”， 进 入 图 1.2.5 所 示 界 面 : 
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论坛 :www.opendev.com 





新 建 虚拟 机 向 导 x 
选择 客户 机 操作 系统 
此 虚拟 机 中 将 安装 哪 种 操作 系统 ? 
客户 机 操作 系统 


O Microsoft Windows(W) 
O VMware ESX(X) 
O 其 他 (O) 


版 本 (V) 





帮助 < 上 一 步 (B) 取消 








图 1.2.5 客户 机 操作 系统 选择 
1.2.5 中 依旧 是 让 你 选择 你 要 在 虚拟 机 中 装 什 么 系统 ， 图 1.2.5 是 和 图 1.2.4 配合 在 一 起 
使 用 的 ， 在 图 1.2.4 中 放 入 系统 文件 (.iso XH, REER 1.2.5 中 选择 你 图 1.2.4 中 放 入 的 是 什 
么 系统 , 然后 VMware 就 会 稍 后 自动 安装 所 设置 的 系统 。 在 图 1.2.4 中 我 们 没有 设置 系统 文件 ， 
因此 图 1.2.5 是 没 用 的 ， 不 过 我 们 还 是 在 图 1.2.5 中 的 客户 机 操作 系统 一 栏 选择 “Linux”， 版 本 


















































选择 Ubuntu 64 位 ， 然 后 点 击 “ 下 一 步 ” 进入 图 1.2.6 所 示 界 面 : 
新 建 虚 拟 机 向 导 x 


命名 虚拟 机 
您 希望 该 虚拟 机 使 用 什么 名 称 ? 











y nl 





C:\Users\zuozh\Documents\Virtual MachineslUbuntu 64 位 浏览 (R)… 





在 "编辑 ">" 首 选项 “中 可 更 改 默认 位 置 。 
选择 虚拟 机 使 用 的 磁盘 ! 一 定 要 是 一 个 空 磁 盘 ! ! 





< 上 一 步 (B) 取消 








图 1.2.6 命名 虚拟 机 
在 图 1.2.6 中 上 面 是 命名 虚拟 机 名 字 , 大 家 可 以 根据 自己 的 使 用 习惯 给 虚拟 机 命名 ， 








| 四 
Tu 
lir 

a 
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下 面 的 虚拟 机 位 置 选择 ! 我 们 要 给 虚拟 机 单独 清理 出 一 块 磁 盘 ， 做 符 入 式 开发 建议 这 块 空 磁盘 
的 大 小 不 小 于 100GB， 比 如 我 清理 除了 一 个 196GB 的 工程 给 虚拟 机 使 用 ， 如 图 1.2.7 所 示 : 














Ubuntu (I:) 


Um" 196 GB 可 用 , i£ 196 GB 





图 1.2.7. 虚拟 机 所 使 用 的 磁盘 
清理 出 虚拟 机 专用 的 磁盘 以 后 然后 就 在 图 1.2.6 中 的 位 置 出 选择 这 个 磁盘 ， 比 如 我 的 位 置 
选择 如 图 1.2.8 所 示 : 
新 建 虚拟 机 向 导 x 


命名 虚拟 机 
您 希望 该 虚拟 机 使 用 什么 名 称 ? 



































虚拟 机 训 称 (V): 
Ubuntu 64 位 
位 置 (L): 
浏览 (R)... 





在 "编辑 "> "首选 项 "中 可 更 改 默认 位 置 。 





< 上 一 步 (B) | | 下 一 步 (N) > 取消 








图 1.2.8 选择 虚拟 机 磁盘 位 置 
设置 好 图 1.2.8 中 的 虚拟 机 磁盘 位 置 以 后 点 击 “ 下 一 步 ” 进入 图 1.2.9 所 示 的 处 理 器 配置 选 
择 界面 : 
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新 建 虚 拟 机 向 导 x 
处 理 器 配置 


为 此 虚拟 机 指定 处 理 器 数量 。 








处 理 器 数量 (P): 
每 个 处 理 器 的 内 核 数量 (C): 
处 理 器 内 核 总 数 : 4 

帮助 < 上 一 步 (B) 取消 








图 1.2.9 处 理 器 配置 界面 

1.2.9 中 就 是 配置 你 的 虚拟 机 所 使 用 的 处 理 器 数量 ,以 及 每 个 处 理 器 的 内 核 数量 , 这 个 要 
根据 自己 实际 使 用 的 电脑 CPU 配置 来 设置 。 比 如 我 的 电脑 CPU 是 I7-4720HQ， 这 是 个 4 核 8 
线程 的 CPU， 因 此 我 就 可 以 分 2 个 核 给 VMware， 然 后 I7-4720HQ 每 个 物理 核 有 两 个 逻辑 核 ， 
因此 每 个 处 理 器 的 内 核 数量 就 是 2， 所 以 的 VMware 虚拟 机 配置 就 如 图 1.2.9 所 示 ， 大 家 根据 自 
己 的 实际 电脑 CPU 配置 来 设置 即 可 ， 设 置 好 以 后 点 击 “ 下 一 步 ” 进入 图 1.2.10 所 示 内 存 配置 















































界面 : 














新 建 虚拟 机 向 导 x 
此 虚拟 机 的 内 存 
您 要 为 此 虚拟 机 使 用 多 少 内 存 ? 
指定 分 配给 此 虚拟 机 的 内 存量 。 内 存 太 小 必须 为 4 MB 的 信 数 。 
64 GB 此 虚拟 机 的 内 存 (M): 8192 全 MB 
32 GB 
ETE E. 调整 滑 块 ， 选 择 内 存 大 小 
TTE g 最 大 推荐 内 存 : 
26H 4 13.4 GB 
1GB ~ 
512 MB m 推荐 内 存 : 
256 MB 2 GB 
128 MB 
64 MB c 客户 机 操作 系统 最 低 推荐 内 存 : 
32 MB 1 GB 
16 MB 
8 MB 
4MB 
帮助 < 上 一 步 (B) 取消 
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1.2.10 内 存 配置 
同样 的 在 图 1.2.10 中 根据 自己 电脑 的 实际 内 存 配置 来 设置 分 给 虚拟 机 的 内 存 大 小 ， 比 如 我 

的 电脑 是 16GB 的 内 存 ， 因 此 我 可 以 给 虚拟 机 分 配 8GB 的 内 存 。 配 置 好 虚拟 机 的 内 存 大 小 以 后 
点 击 “ 下 一 步 ” 进入 图 1.2.11 所 示 的 网 络 类 型 选择 界面 : 




















新 建 虚拟 机 向 导 


网 络 类 型 
要 添加 哪 类 网 络 ? 





O 使 用 网 络 地 址 转换 (NAT)(E) 


为 客户 机 操作 系统 提供 使 用 主机 IP 地 址 访问 主机 拨号 连接 或 外 部 以 太 网 网 络 
连接 的 权限 。 


O 使 用 仅 主 机 模式 网 络 (H) 
将 客户 机 操作 系统 连接 到 主机 上 的 专用 虚拟 网 络 。 


O 不 使 用 网 络 连接 (T) 








帮助 < 上 一 步 (B) 取消 





图 1.2.11 网 络 类 型 选择 界面 
在 图 1.2.11 中 我 们 选择 “使 用 桥接 网 络 ” 然后 点 击 “ 下 一 步 ” 进入 图 1.2.12 所 示 的 选择 
VO 控制 器 类 型 界面 : 
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新 建 虚 拟 机 向 导 x 
选择 I/O 控制 器 类 型 


您 要 使 用 何 种 类 型 的 SCSI 控制 器 ? 


I/O 控制 器 类 型 
SCSI 控制 器 : 
Buslogi(U) ”( 不 适用 于 64 位 客户 机 ) 
@ LSI Logic(L) (推荐 ) 
OLSI Logic SAS(S) 








帮助 < 上 一 步 (B) 取消 





1.2.12 IO 控制 器 选择 
VO 控制 器 类 型 选择 默认 值 就 行 ， 也 就 是 “LSILogic” 然后 点 击 “ 下 一 步 ” 进入 磁盘 类 型 
选择 界面 ， 如 图 1.2.13 所 示 : 











新 建 虚 拟 机 向 导 x 


选择 磁盘 类 型 
您 要 创建 何 种 磁盘 ? 


虚拟 磁盘 类 型 
OIDE(I) 
(e scsis) (GÈ) 
O SATA(A) 
ONVMe(V) 








帮助 < 上 一 步 (B) 取消 





1.2.13 
1.2.13 中 选择 磁盘 类 型 ， 使 用 默认 值 “SCSI” 即 可 ， 然 后 点 击 “ 下 一 步 ” 进入 选择 磁盘 
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界面 ， 如 图 1.2.14 所 示 : 





新 建 虚 拟 机 向 导 x 


选择 磁盘 
您 要 使 用 哪个 磁盘 ? 


(€) 创建 新 虚拟 磁盘 (V) 
虚拟 磁盘 由 主机 文件 系统 上 的 一 个 或 多 个 文件 组 成 , 寡 户 机 操作 系统 会 将 


Pa 虚拟 磁盘 可 在 一 台 主 机 上 或 多 人 台 主 机 之 间 轻 松 复制 或 移 





O 使 用 现 有 虚拟 磁盘 (E) 
选择 此 选项 可 重新 使 用 以 前 配置 的 磁盘 。 
O 使 用 物理 磁盘 (适用 于 高 级 用 户 )(P) 
REA RE MERETUR 。 需 要 具有 管理 员 特 





帮助 < 上 一 步 (B) 取消 











图 1.2.14 磁盘 选择 
1.2.14 中 使 用 默认 值 ， 即 “创建 新 虚拟 磁盘 ” 这样 我 们 前 面 设置 好 的 那个 空 的 磁盘 就 会 
被 创建 为 一 个 新 的 磁盘 , 设置 要 以 后 点 击 “ 下 一 步 ” 进入 磁盘 容量 设置 界面 , 如 图 1.2.15 所 示 : 


























新 建 虚 拟 机 向 导 X 


指定 磁盘 容量 
磁盘 大 小 为 多 少 ? 


最 大 磁盘 大 小 (GB)(S): 196.0 全 


针对 Ubuntu 64 位 的 建议 大 小 : 20 GB 





器] 立即 分 配 所 有 磁盘 空间 (A) 。 


分 配 所 有 容量 可 以 提高 性 能 ， 但 要 求 所 有 物理 磁盘 空间 立即 可 用 。 如 果 不 立 即 
分 配 所 有 空间 ， 虚 拟 磁 盘 的 空间 最 初 很 小 ,会 随 着 您 向 其 中 添加 数据 而 不 断 变 


o 


O 将 虚拟 磁盘 存储 为 单个 文件 (D) 
(9) 将 虚拟 磁盘 拆 分 成 多 个 文件 (M) 


折 分 硬 生 后 ， 可 以 更 径 从 地 在 计算 机 之 间 和 动 虚拟 机 ， 介 可 能 会 了 低 大 容量 
9 性 能 。 





帮助 < 上 一 步 (B) 取消 





图 1.2.15 磁盘 容量 设置 
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1.2.15 是 用 来 设置 我 们 清 出 的 空 的 磁盘 多 少 是 给 虚拟 机 用 的 ， 我 们 清 出 了 一 个 空 磁盘 肯 
定 是 全 部 给 虚拟 机 用 的 ， 因此 设置 最 大 磁盘 大 小 为 空 磁盘 的 大 小 ， 比 如 图 1.2.7 PRIA IE 
是 196GB 的 ， 因 此 图 1.2.15 中 就 设置 最 大 磁盘 大 小 为 196GB， 然 后 点 击 “ 下 一 步 ” 进入 图 
1.2.16 所 示 界 面 指定 磁盘 文件 ， 














新 建 虚拟 机 向 导 X 


指定 磁盘 文件 
您 要 在 何 处 存储 磁盘 文件 ? 


磁盘 文件 (F) 
将 使 用 多 个 磁盘 文件 创建 一 个 196 GB 虚拟 磁盘 。 将 根据 此 文件 名 自动 命名 这 
些 磁盘 文件 。 


Ubuntu 64 1: .vmd 浏览 (R).…. 











帮助 < 上 一 步 (B) 取消 








1.2.16 指定 磁盘 文件 











1.2.16 使 用 默认 设置 ， 不 要 做 任何 修改 ， 直 接点 击 “ 下 一 步 ” 进入 已 准备 好 创建 虚拟 机 
界面 ， 如 图 1.2.17 所 示 : 
新 建 虚拟 机 向 导 x 


已 准备 好 创建 虚拟 机 
单 击 "完成 "创建 虚拟 机 。 然 后 可 以 安装 Ubuntu 64 位 。 





将 使 用 下 列 设置 创建 虚拟 机 : 














名 称 : Ubuntu 64 位 

位 置 : IA 

版 本 : Workstation 15.x 

操作 系统 : Ubuntu 64 位 

硬盘 : 196 GB, 折 分 

内 存 : 8192 MB 

网 络 适 配器 : 桥接 模式 (自动 ) 

其 他 设备 : 4 个 CPU 内 核 , CD/DVD, USB 控制 器 , 打印 机 , 声卡 
自 定 尺 硬 件 (C).…. 








< 上 一 步 (9) mis 
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图 1.2.17 准备 创建 虚拟 机 
在 图 1.2.17 中 确认 自己 的 虚拟 机 配置 ， 如 果 确 认 无 误 就 点 击 “ 完 成 ” 如 果 有 误 的 话 就 
返回 有 误 的 配置 界面 做 修改 ， 点 击 “ 完 成 ”按钮 以 后 就 会 创建 一 个 虚拟 机 ， 如 图 1.2.17 所 示 : 



































(B) Ubuntu 64 位 - VMware Workstation = 口 X 
文件 (F) RAE 查看 (V) 虚拟 机 (M) 选项 #(D) 帮助 H) >- c Oo 25$ [DEBITI 
库 X |Q Em x | [P] ubuntu 64 È 
O 在 此 处 键入 内 容 进行 搜索 Y 
- [C] Ubuntu 64 位 
P 开启 此 虚拟 机 ^ 
D 编辑 虚拟 机 设置 
刚刚 创建 的 虚拟 机 
v 设备 
ES p 8GB 
ENTIS. 4 
AER (SCSI) 196 GB 
© CD/DVD (SATA) 自动 检测 
T 网 络 适配器 桥接 模式 (B... v 虚拟 机 详细 信息 
USB 控制 器 存在 状态 : 已 关机 
s zi 配置 文件 : IAUbuntu 64 位 .vmx 
AER and 硬件 兼容 性 Workstation 15.x 虚拟 机 
c 打印 机 存在 主 IP 地 址 : 网 络 信息 不 可 用 
LZ] 显示 器 自动 检测 

















D 7 








图 1.2.17 新 创建 的 虚拟 机 
创建 虚拟 机 成 功 以 后 就 会 在 右 侧 的 :我 的 计算 机 下 出 现 刚刚 创建 的 虚拟 机 “Ubuntu 64. 位 ”， 
点 击 一 下 就 会 在 右 侧 打开 这 个 虚拟 机 的 详细 信息 ， 如 图 1.2.18 所 示 : 
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一 口 x 
BRET) 帮助 (H) P~ oaa [Eu 
(à 主页 [C] Ubuntu 64 fi; 
E Ubuntu 64 位 
P 开启 此 虚拟 机 ^ 
D 编辑 虚拟 机 设置 
v 设备 
ES 内存 8 GB 
并 二 处理 器 4 
OEA (SCSI) 196 GB 
CD/DVD (SATA) 自动 检测 
T 网 络 适配器 桥接 模式 (Bi... v 虚拟 机 详细 信息 
USB 控制 器 存在 状态 : 已 关机 
配置 文件 : |:\Ubuntu 64 位 .vmx 
中 声卡 自动 检测 硬件 兼容 性 : Workstation 15.x 虚拟 机 
号 打印 机 存在 主 IP 地 址 : 网 络 信息 不 可 用 
LL] 显示 器 自动 检测 











图 1.2.18 新 建 虚拟 机 配置 信息 
在 图 1.2.18 中 的 设备 一 栏 我 们 可 以 看 到 虚拟 机 详细 的 配置 信息 ， 图 1.2.19 所 示 的 两 个 按钮 
就 是 虚拟 机 的 开关 ， 




















n 


选项 卡 (T) “帮助 (H) [>] LL | m £g 


Q 主页 [O Ubuntu 64 
] [7] Ubuntu 64 47 
[psn 


D 编辑 虚拟 机 设置 ARS 











v 设备 





图 1.2.19. 虚拟 机 开关 
图 1.2.19 中 的 这 两 个 绿色 三 角 按钮 都 可 以 打开 虚拟 机 ， 但 是 此 时 虚拟 机 没有 安装 任何 操作 
系统 ， 因 此 没 法 打开 ， 接 下 来 我 们 就 是 要 在 刚刚 新 建 的 这 个 虚拟 机 中 安装 Ubuntu 操作 系统 。 


1.3 安装 Ubuntu 操作 系统 


1.3.1 获取 Ubuntu 系统 
前 面 虚拟 机 已 经 创建 成 功 了 ， 相 当 于 硬件 已 经 准备 好 了 ， 接 下 来 就 是 要 在 虚拟 机 中 安装 
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Ubuntu 系统 了 ,首先 肯定 是 获取 到 Ubuntu 的 系统 镜像 ，Ubuntu 系统 镜像 肯定 是 在 Ubuntu 官网 
获取 ， 下 载 地 址 为 : https:/www.ubuntu.com/download/desktop， 如 图 1.3.1.1 所 示 : 














E & Download Ubuntu Desktopi gps 十 o-—-nx 
C û ù OGáhtps ubuntu.com, e*t 3 E E ak- w Ak Ju5-- 


CAN®NICAL Products ~ 





ubuntu® Enterprise Developer Community Download 


DI UGEREME& Overview Cloud loT Server Desktop Alternative downloads Ubuntu flavours 


o: D El E 


Download Ubuntu Desktop 
FR 
Ubuntu 18.04.1 LTS \ 


Download the latest LTS version of Ubuntu, for desktop PCs and laptops. LTS stands 
For long-term support — which means five years, until April 2023, of free security and 


maintenance updates, guaranteed. For other versions of Ubuntu Desktop including 

Ubuntu 18.04 LTS release notes P torrents, the network installer, a list of local 
8. S s 

mirrors, and past releases see our alternative 


Recommended system requirements: downloads. 


© 2 GHz dual core processor or better 


2 GB system memory 


© 

© 25GBoffree hard drive space 

© Either a DVD drive or a USB port for the installer media 
© 


Internet access is helpful 








rum 图 热点 资讯 O n VFR P d» Q100% s 


图 1.3.1.1 Ubuntu 最 新 版 系统 下 载 

从 图 1.3.1.1 中 可 以 看 出 ， 最 新 版 本 的 Ubuntu 系统 是 18.04， 但 是 在 笔者 编写 本 教程 的 时 候 
18.04 版 刚 出 来 没 多 和 久 ， 怕 不 稳定 ， 因 此 笔者 实际 使 用 的 是 16.04 版 本 的 Ubuntu， 后 面 所 有 的 例 
程 和 教程 均 在 16.04 下 完成 ， 包 括 我 们 接 下 来 安装 的 也 是 16.04 版 本 的 Ubuntu。16.04 版 本 的 
Ubuntu 下 载 地 址 为 : http://releases.ubuntu.com/16.04/, 下 载 “ubuntu-16.04.5-desktop-amd64.iso” 
这 个 版 本 ， 我 已 经 下 载 下 来 放 到 了 开发 板 光盘 中 ， 路 径 为 : 3、 软 件 -> ubuntu-16.04.5-desktop- 


amd64.iso. 















































1.3.0 安装 Ubuntu 操作 系统 


Ubuntu 系统 获取 到 以 后 就 可 以 安装 了 ， 打 开 VMware 软件 ， 选 择 : 虚拟 机 -> 设置 ， 如 图 
1.3.2.1 所 示 : 
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(B) Ubuntu 64 位- VMware Workstation = El X 
文件 (F) ”编辑 (E) ”查看 (V) | 虚拟 机 (M) |‖ 选项 #(D) 帮助 (0) 9 od oaa [D EB mu i 
E O SAP) > 
O Taena O TERED) 
L E 暂停 (U) Ctrl+Shift+P 
| & C2 我 的 计算 机 
[E] Ubuntu 64 位 发 送 Ctrl+Alt+Del(E) 
(C 共享 的 虚拟 机 抓 取 输 入 内 容 () Ctrl+G A^ 
[o REN) > 
捕获 屏幕 (C) Ctrl+Alt+pPrtSscn 
£^ 管理 (M) > 





安装 VMware Tools(T)... 





© CD/DVD (SATA) 自动 检测 

T 网 络 适配器 桥接 模式 (Bi... v 虚拟 机 详细 信息 

USB 控制 器 存在 状态 : 已 关机 

d ts WHERE: Workstation 15 iB 
号 打印 机 存在 主 IP 地 址 : 网 络 信息 不 可 用 

号 显示 器 自动 检测 




















图 1.3.2.1 打开 虚拟 机 设置 对 话 框 
打开 以 后 的 虚拟 机 设置 对 话 框 如 图 1.3.2.2 PTR: 


























图 1.3.2.2 虚拟 机 对 话 框 












































虚拟 机 设置 x 
硬件 ”选项 
设备 摘要 连接 
BAr 8 GB USB 兼容 性 (C): | 
拒 卡 处 理 器 4 — "m 
C3 888 (SCSI) 196 GB L] 显示 所 有 EB 和 
®© CD/DVD (SATA) 自动 检测 与 庶 拟 机 共享 蓝牙 设备 (B) 
Ies 网 络 适配器 桥接 模式 (自动 ) 
USB 控制 器 存在 
中 声卡 自动 检测 
号 打印 机 存在 
辐 显 示 器 自动 检测 


首先 设置 “USB 控制 器 ”选项 ， 默 认 USB 控制 器 的 USB 兼容 性 为 USB2.0， 这 样 当 你 使 月 





H 


USB3.0 的 设备 的 时 候 Ubuntu 可 能 识别 不 出 来 ， 因 此 我 们 需要 调整 USB 兼容 性 为 USB3.0， 如 








图 1.3.2.3 所 示 : 
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虚拟 机 设置 x 
硬件 ”选项 
设备 摘要 
EAR 8 GB USB 兼容 性 (C): | 
Cines 4 - 一 
Pies D PR 显示 所 有 U5B 输入 设备 (5) 
®© CD/DVD (SATA) 自动 检测 与 虚拟 机 共享 蓝牙 设备 (B) 
名 网 络 适配器 桥接 模式 (自动 ) Li] 要 通过 USB 3.0 控制 器 使 用 USB 设备 ,必须 具备 
[ 司 USB 控制 器 存在 Linux 内 核 3.2 或 更 新 版 本 。 
中 声卡 自动 检测 
吧 打印 机 存在 USB 兼 容 性 选择 USB 3.0 
TERS 自动 检测 








图 1.3.2.3 USB 兼容 性 设置 








设置 要 USB 兼容 性 以 后 就 开始 安装 Ubuntu 系统 了 ， 选 中 虚拟 机 设置 对 话 框 中 的 
“CD/DVD(SATA)” 选 项 ， 然 后 在 右 侧 选中 “使 用 ISO 映像 文件 ” 如 图 1.3.2.4 所 示 : 


















































虚拟 机 设置 x 
硬件 ”选项 
设备 摘要 设备 状态 
ES 内 存 8 GB 已 连接 (C) 
lass 4 启动 时 连接 (O) 
E3888 (SCSI) 196 GB 
C) CD/DVD (SATA) 自动 检测 连接 
Euse ema Gere ian 
外 声卡 自动 检测 自动 检测 
E 
E Bd 2s - © 使 用 ISO 映像 文件 (M): 
浏览 (B)..… 
高 级 (V).…. 


1.3.2.4 系统 镜像 设置 
在 图 1.3.2.4 中 的 “使 用 ISO 映像 文件 ”里 面 添加 我 们 刚刚 下 载 到 的 Ubuntu 系统 镜像 ， 点 
击 “ 浏 览 ” 按 钮 ， 选 择 Ubuntu 系统 镜像 ， 完 成 以 后 如 图 1.3.2.5 所 示 : 
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原子 哥 在 线 教学 ，www.yuanzige.com 论坛 :Www.opendev.com 
虚拟 机 设置 x 
硬件 ”选项 

设备 摘要 设备 状态 

E Pt 8 GB 已 连接 (C) 

Cass 4 启动 时 连接 (0) 

E3888 (SCSI) 196 GB 

© CD/DVD (SATA) 自动 检测 连接 

T 网 络 适配器 桥接 模式 (自动 ) Zoa 

USB 控制 器 存在 O 使 用 物理 驱动 器 (P): E 

中 声卡 自动 检测 自动 检测 x] 

骂 打 印 机 存在 

OERS 自动 检测 e 使 用 ISO 映像 文件 (M): 

G:\IMX6\IMX6UL\ 开 发 板 光 盘 \ ~ | | 浏览 (B)..… 
高 级 (V)... 

1.3.2.5 Ubuntu 镜像 选择 


设置 好 以 后 点 击 “ 确 定 ” 按 钮 退出 ， 退 出 以 后 就 可 以 打开 虚拟 机 了 ， 虚 拟 机 就 会 自动 的 安 
装 Ubuntu 系统 ， 如 图 1.3.2.6 所 示 : 



































(B) Ubuntu 64 位 - VMware Workstation = El x 
文件 (F) “编辑 (日 ”查看 (V) 虚拟 机 (M) ARM 帮助 H) | 中 ~ & oso nui A ~ 
库 (A 主页 - 局 ubuntu 64 位 

O 在 此 处 键入 内 容 进行 搜索 : 

日 L2 我 的 计算 机 

[re 
[EE 

要 将 输入 定向 到 该 虚拟 机 ， 请 在 虚拟 机 内 部 单 击 或 按 Ctrl+G。 EeGmedso|D 4 





1.3.2.6 Ubuntu 安装 开始 
Ubuntu 开始 安装 以 后 首先 是 语言 选择 ， 如 图 1.3.2.7 所 示 : 
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(à 主页 [> Ubuntu 64 位 
LC o ED NEG 


安装 (as superuser) 


欢迎 


Aid 

eblup 

四 四 四 图 四 图 
24 7zj|41 
BEREK 
i sjjasj|cojjasj|a1 
Rea 

EStG 


D] 
oem)og。 A 
nive 试用 Ubuntu 安装 Ubuntu 


您 可 以 直接 从 此 CD 尝试 Ubuntu， 而 不 用 对 您 的 电脑 作 任何 更 改 。 


如 果 您 已 经 准备 完毕 ， 您 可 以 与 现 有 系统 并 存 (或 者 替代 ) 方式 将 Ubuntu 安装 到 您 的 


| 中 文 (简体 ) 电脑 上 。 此 过 程 无 需 耗 时 太 久 。 


中 文 (繁体 ) 
日 本 语 您 可 以 阅读 一 下 发 行 注 记 。 








击 或 按 Ctrl+G。 


图 1.3.2.7 语言 选择 
Ubuntu 默认 语言 是 英文 , 毫 无 疑问 , 我 们 要 选择 “中 文 (简体 )” 选择 好 以 后 点 击 右 侧 的 “ 安 























R Ubuntu” 按 钮 ， 进 入 安装 过 程 。 安 装 一 开始 会 有 7 个 配置 步骤 ， 第 一 配置 如 图 1.3.2.8 所 示 ， 
证 你 选择 是 否 安装 Ubuntu 时 下 载 更 新 ,以 及 是 否 为 图 形 或 者 无 线 硬 件 安 装 其 它 第 三 方 软件 , 我 
们 不 勾 选 这 两 个 ， 否 则 安装 过 程 很 慢 。 
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(m 主页 [Fy Ubuntu 64 位 


安装 (as superuser) 


准备 安装 Ubuntu 


_ | 安装 Ubuntu 时 下 载 更 新 
这 能 节约 安装 后 的 时 间 。 
为 图 形 或 无 线 硬 件 ， 以 及 MP3 和 其 它 媒体 安装 第 三 方 软件 
This software is subject to license terms included with its documentation. Some is proprietary. 


Fluendo MP3 插件 包含 Fraunhofer IIS 和 Technicolor SA 授权 的 MPEG Layer-3 音频 解码 技术 。 


不 要 选择 ， 否 则 安装 过 程 很 慢 ! ! 


退出 (Q) 后 退 (B) 





击 或 按 Ctrl+G。 











图 1.3.2.8 是 否 安 装 是 下 载 更 新 























Ubuntu”， 如 图 1.3.2.9 所 示 : 
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原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
(n 主页 












[5 Ubuntu 64 位 





cm 9? t Be s 


安装 (as superuser) 


_ 加 密 Ubuntu 新 安装 以 提高 安全 性 。 
下 一 步 ， 你 需要 选择 一 个 安全 密 钥 。 

-) 在 Ubuntu 新 安装 中 使 用 LVM 
这 将 局 动 有 逻辑 分 区 管理 (LYM)， 有 快照 和 调整 分 区 大 小 等 功能 。 


其 他 选项 
您 可 以 自己 创建 、 调 整 分 区 ， 或 者 为 Ubuntu 选择 多 个 分 区 。 





退出 (Q) 后 退 (B) 现在 安装 (1) 





击 或 按 Ctrl+G。 


图 1.3.2.9 安装 类 型 选择 





设置 好 安装 类 型 以 后 点 击 “ 现 在 安装 ”按钮 ， 会 弹出 “将 改动 写 入 磁盘 吗 ? ”对 话 框 ， 点 
击 “ 继 续 ” 即 可 ， 下 一 步 会 让 你 输入 你 在 哪个 位 置 ， 输 入 自己 所 在 的 城市 即 可 ， 比 如 我 在 广州 
就 输入 广州 ， 如 图 1.3.2.10 所 示 : 
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Q 主页 | [5 Ubuntu 64 位 


安 技 (as superuser) 


您 在 什么 地 方 ? 





击 或 按 Ctrl+G。 E) €! d o9|LD A 
1.3.2.10. 输入 所 在 位 置 
Ubuntu 默认 带 了 拼音 输入 法 ， 切 换 到 拼音 输入 法 的 方法 如 图 1.3.2.11 所 示 : 
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(m 主页 [[ Ubuntu 64 位 


安 靶 (as superuser) 


您 在 什么 地 方 ? 








击 或 按 Ctrl+G。 以 QE D 
图 1.3.2.11 切换 拼音 输入 法 
输入 地 址 以 后 点 击 “ 继 续 ” 按 钮 , 会 进入 键盘 布局 设置 界面 , 不 需要 做 任何 修改 ， 点击 “ 继 























续 ” 按 钮 ， 进 入 下 一 步 设置 用 户 名 和 和 密码， 自己 设置 自己 的 用 户 名 和 密码 ， 比 如 我 的 设置 如 图 
1.3.2.12 所 示 : 
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QA 主页 [> Ubuntu 64 位 


ES M (as SUperusen) 


您 是 谁 ? 





您 的 姓名 : | zuozhongkai 





您 的 计算 机 名 : |zuozhongkai-virtual-m | «f 
与 其 他 计算 机 联络 时 使 用 的 名 称 。 
选择 一 个 用 户 名 : | zuozhongkai ~ 





选择 一 个 密码 :| @@@@@@ 密码 强度 : 


确认 您 的 密码 : eeeeee rA 
自动 登录 
O 登录 时 需要 密码 
加 密 我 的 主 目录 


击 或 按 Ctrl+G。 





图 1.3.2.12 设置 用 户 名 和 密码 
设置 好 用 户 名 和 密码 以 后 点 击 “ 继 续 ” 按钮 ， 系 统 就 会 开始 正式 安装 ， 如 图 1.3.2.13 所 示 : 
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[QER x| T ubuntu 64 È 


安装 (as superuser) 


欢迎 使 用 Ubuntu 


最 新 版 本 的 Ubuntu 快速 且 具 有 丰富 新 特性 ， 
用 起 来 比 以 往 更 方便 。 这 里 有 一 些 值得 注意 的 
的 新 玩意 .…… 





击 或 按 Ctrl+G。 EQusadeolDpA 


1.32.13 系统 安装 中 
等 待 系统 安装 完成 ， 安 装 过 程 中 会 下 载 一 些 文件 ， 所 以 一 定 要 保证 电脑 能 够 正常 上 网 ， 如 
果 不 能 正常 上 网 的 话 可 以 点 击 右 侧 的 “skip ”按钮 来 跳 过 下 载 文件 这 个 步骤 , 对 于 系统 的 安装 没 
有 任何 影响 ， 安 装 完成 以 后 提示 重启 系统 ， 如 图 1.3.2.14 所 示 : 
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ín 主页 [[ Ubuntu 64 位 





击 或 按 Ctrl+G。 


1.3.2.14 安装 完成 ， 重 启 系统 
重启 系统 以 后 就 会 提示 输入 密码 ， 如 图 1.3.2.15 所 示 : 


zuozhongkai 


ubuntu? 16.04 LTS 





图 1.3.2.15 系统 重启 ， 输 入 密码 








在 图 1.3.2.15 中 输入 密码 ， 点 击 键盘 上 的 回 车 就 会 ; 
所 示 : 
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入 系统 主 界面 ， 系 统 界面 如 图 1.3.2.16 


ty 中 ) 02:21 %4 


LibreOffice Writer 


回 
e 
E 
5 
z 





1.3.2.16 系统 桌面 
图 1.3.2.16 就 是 第 一 次 进入 系统 的 系统 桌面 ， 此 时 我 们 的 系统 镜像 还 在 CD/DVD 里 面 ， 我 
们 要 将 它 弹 出 ， 先 关闭 Ubuntu 系统 ， 点 击 系统 桌面 右上 角 的 设置 按钮 ， 如 图 1.3.2.17 Brzn: 
Ea ty 中 ) 02:24 如 
关于 这 人 台 计 算 机 























Ubuntu 帮助 ... 


人 会 话 


zuozhongkai 





图 1.3.2.17 关机 
按照 图 1.3.2.17 所 示 方 式 关 机 。 


1.3.3 弹出 系统 镜像 


和 我 们 在 真实 电脑 上 安装 系统 一 样 ， 不 管 我 们 使 用 的 光盘 还 是 U 盘 安装 系统 ， 当 系统 安装 
成 功 以 后 都 要 弹出 光盘 或 者 拔 出 U 盘 ， 然 后 调整 BIOS 从 硬盘 启动 ， 否 则 以 后 开机 的 话 都 会 首 
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的 时 候 是 在 CD/DVD 中 加 载 了 Ubuntu 系统 镜像 ， 





从 CD/DVD 中 弹出 。 


论坛 :www.opendev.com 


先 从 光盘 或 者 U 盘 启 动 了 ， 这 样 会 进入 系统 安装 界面 。 同 理 ， 我 们 在 VMware 中 安装 Ubuntu 


现在 系统 安装 成 功 了 ， 因 此 也 要 把 这 个 镜像 


关闭 Ubunut 操作 系统 ， 关 重新 打开 VMware， 不 要 打开 Ubunut 系统 ! 打开 VMware 的 虚 
拟 机 设置 界面 ， 然 后 选中 “CD/DVD(SATA)”， 右 侧 的 “连接 ”选择 “使 用 物理 驱动 器 ” 如 图 


1.3.3.1 所 示 。 














虚拟 机 设置 
硬件 ”选项 
设备 摘要 
EP 8 GB 
[六 处 理 器 4 





(CD/DVD (SATA) 正在 使 用 文件 G:MX6VIMX6..| 
x 网络 这 配 覆 Bri ru (Ela 





USB 控制 器 存在 
中 声卡 自动 检测 
EHEN 存在 
辐 显 示 器 自动 检测 




















设备 状态 
已 连接 (C) 
启动 时 连接 (O) 





O 使 用 ISO 映像 文件 (M): 
G:\IMX6\IMX6UL\ 开 发 板 光盘 \ sib)... 





高 级 (V)..… 


1.3.3.1 弹出 Ubuntu 系统 镜像 
设置 好 以 后 点 击 “ 确 定 ” 按 钮 ， 然 后 重新 打开 虚拟 机 ， 看 看 是 否 能 够 正常 启动 Ubuntu， 一 








般 肯 定 能 正常 打开 的 。 

















至 此 ，VMware 虚拟 机 以 及 Ubunut 系统 安装 成 功 ， 接 下 来 我 们 就 要 学 习 如 何 是 用 Ubuntu 


了 。 
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第 二 章 Ubuntu 系统 入 门 


在 上 一 章 我 们 已 经 安装 好 虚拟 机 , 并 且 在 虚拟 机 中 安装 好 了 Ubuntu 操作 系统 了 , 本 章 我 们 

















就 来 学 习 Ubuntu 系统 的 基本 使 用 ， 通 过 本 章 的 学 习 为 我 们 以 后 的 开发 做 准备 。Ubuntu 系统 是 
和 Windows 一 样 的 大 型 桌面 操作 系统 ， 因 此 功能 非常 强大 , 不 是 一 章 就 能 介绍 完 的 ， 因 此 本 章 
叫做 《Ubuntu 系统 入 门 》。 本章 的 主要 目的 是 教会 读者 掌握 后 续 舱 入 式 开发 所 需 的 Ubuntu 基本 
技能 ， 比 如 系统 的 基本 设置 、 长 用 的 shel 命令 、vim 编辑 器 的 基本 操作 等 等 ， 如 果 想 详细 的 学 
2] Ubuntu 操作 系统 请 参考 其 它 更 为 详实 的 书籍 ， 本 章 参 考 了 《Ubuntu Linux 从 入 门 到 精通 》， 
这 本 书 不 厚 ， 很 适合 用 来 作 Ubunut AT]. 
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2.1 Ubuntu 系统 初 体 验 


2.1.1 Hello Ubuntu 





上 一 章 我 们 已 经 安装 好 了 Ubuntu 操作 系统 ， 我 们 再 来 回顾 一 下 如 何 开 机 : 
1、 打 开 VMware 虚拟 机 软件 ， 打 开 以 后 如 图 2.1.1.1 所 示 : 













































































回 ubuntu 64 位 - VMware Workstation = X 
文件 (F) ”编辑 (E) ”查看 (V) ”虚拟 机 (M) ”选项 人 (TD) ”帮助 (H) D ~ agag DODES 
库 A Q 主页 [C] Ubuntu 64 位 
O 在 此 处 键入 内 容 进 行 搜索 7 " 
S CI 我 的 计算 机 [ 口 Ubuntu 64 位 
[E Ubuntu 64 位 
C 共享 的 虚拟 机 P 开启 此 虚拟 机 S 
D 编辑 虚拟 机 设置 
v 设备 
园 内 存 8GB 
TIS. 4 
E3388 (SCSI) 196 GB 
© CD/DVD (SATA) 自动 检测 
T 网 络 适配器 桥接 模式 (Bi... 
(s) USB 控制 器 存在 v 虚拟 机 详细 信息 
Sh untu V.VImX 
c 打印 机 存在 硬件 兼容 性 : Workstation 15.x 虚拟 机 
号 显示 器 自动 检测 主 IP 地 址 : 网 络 信息 不 可 用 
pee v 
D 








图 2.1.1.1 WMware 主 界面 


























2、 打 开 VMware 上 的 开机 按钮 ， 打 开 方 式 如 图 2.1.1.2 所 示 : 


选项 卡 (T) “帮助 ( aa DES 





[e xm [C] Ubuntu 64 NU 
IL] Ubuntu IL UNS 以 开机 
有 辽 开启 此 虚拟 机 ^ 
D 编辑 虚拟 机 设置 
v 设备 
国内 存 8GB 
站 上 处 理 器 4 
E3888 (SCSI) 196 GB 
CD/DVD (SATA) 自动 检测 
O 网 络 话 配 器 mat (RA. 

















图 2.1.1.2 VMware 开机 按钮 


F Ubuntu 操作 系统 ， 首 先进 入 





3、 点 击 图 2.1.1.2 中 两 个 开机 按钮 中 的 任意 一 个 就 会 打 玫 
2.1.1.3 所 示 的 登陆 界面 ， 输 入 密码 即 可 进入 系统 。 




















95 








zuozhongkai 





图 2.1.1.3 Ubuntu 登陆 界面 
在 登陆 界面 输入 密码 ， 进 入 系统 主 界面 ， 如 图 2.1.1.4 所 示 : 


TE i: 





























一 
e 
^ 
B 





图 2.1.1.4 Ubuntu 主 界 面 
进入 主 界 面 以 后 大 家 就 可 以 看 到 和 Windows 基本 一 样 ， 左 侧 有 一 列 APP， 第 一 个 是 “搜索 



































计算 机 ”， 第 二 个 是 文件 浏览 器 , 打开 以 后 可 以 浏览 Ubuut 系统 中 的 文件 , 打开 以 后 如 图 2.1.1.5 
Biz: 
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O 最 近 使 用 的 = -= 
a 
EE 公共 的 模板 
2 ME. 
T] 
向 BR 
视频 "m 
D 文档 
e a a 
4) 音乐 文档 T 
画 回收 站 " 
e ne E 
因 计算 机 nid aia 
D 连接 到 服务 器 ad 
示例 





图 2.1.1.5 文件 浏览 
第 三 个 是 firefox 浏览 器 ， 可 以 用 来 上 网 ， 比 如 我 们 登陆 百度 网 站 ， 如 图 2.1.1.6 所 示 : 


AE—TF, MA -Mozilla Firefox 
党 百度 一 下 ， 你 就 知道 


€ C Go © tt Nww.baidu.com -Q 


b Your Firefox is critically out of date. An update is required to stay secure. | Update X 


新 闻 haol23 地 图 视频 贴吧 学 术 登录 设置 


Bai 5E 














2.1.1.6 firefox 浏览 
这 里 还 有 其 它 一 些 APP, 大 家 可 以 自行 打开 看 一 下 这 些 APP 都 是 干 哈 的 , 这 里 就 不 一 一 详 
的 介绍 了 。 


us 

















2.. 系统 设置 


我 们 会 发 现 ，Ubuntu 的 默认 桌面 很 小 ,， 这 是 因为 Ubuntu 默认 分 辨 率 是 800*600， 因 此 我 们 
首先 要 设置 系统 分 辩 率 ， 调 整 到 合适 的 大 小 。 打 开 系 统 设置 界面 ， 打 开 方 式 如 图 2.1.2.1 所 示 : 























97 


Ubuntu 桌面 EE fy «») 203: d 
关于 这 人 台 计 算 机 


Ubuntu #8)... 


9$ 
F 
- 
B 


| 
» 


Iv 


| 





图 2.1.2.1 打开 系统 设置 
打开 以 后 的 系统 设置 界面 如 图 2.1.2.2 所 示 : 


系统 设置 





安全 和 隐私 亮度 和 锁 屏 外 观 文本 输入 语言 支持 在 线 帐 户 


硬件 
> — b | 
zè 8 - 0 x 
Wacom 手写 打印 机 电源 键盘 蓝牙 色彩 
板 
[] 一 
UU Bg B 
鼠标 和 触摸 板 网 络 显示 
系统 





图 2.1.2.2 系统 设置 界面 
系统 设置 界面 可 以 完成 系统 的 大 部 分 设置 ， 我 们 找到 “显示 ”设置 并 打开 ， 打 开 以 后 如 图 
2.1.2.3 所 示 : 
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分 辩 率 (R) | 800x 600 (4:3) - || 启动 器 布局 (A) | 所 有 显示 


imb seu enh 了 | Ai 
菜单 和 标题 栏 缩放 比例 : 缩放 所 有 窗口 的 内 容 以 匹配 (OQ): 


| 














P 显示 最 大 的 控制 项 | 








图 2.1.2.3 显示 设置 界面 
从 图 2.1.2.3 中 可 以 看 出 ， 系 统 默认 分 辨 率 是 800X600， 现 在 的 电脑 分 辩 率 最 少 都 是 
1920X1080 了 ， 因 此 我 们 可 以 调整 这 个 分 辩 率 至 合适 的 大 小 ， 比 如 我 设置 为 1440x900 分 辨 率 ， 








设置 好 以 后 点 击 “ 应 用 ”按钮 ， 这 里 要 注意 ， 由 于 分 辨 率 太 小 了 ， 导 臻 “应 用 ”按钮 就 上 只 露出 
了 很 少 一 部 分 ， 如 图 2.1.2.4 所 示 : 





镜像 显示 (M) ER: TERRIA MEAN) 
Unknown Display 地 | 常规 选项 
AMER) | 1440x 900 (16:10) ~ || 启动 器 布局 (A) | MEST ~ 











旋转 (0) | 正常 一 粘 灌 边 缘 (T 
菜单 和 标题 栏 缩放 比例 : 缩放 所 有 窗口 的 内 容 以 匹配 (CO): 
1 EUSBOGSESBUT ”| 露出 很 少 一 部 分 的 应 用 





gay 


图 2.1.2.4 调整 屏幕 分 辨 率 
设置 好 分 辩 率 以 后 Ubuntu 的 主 界面 就 大 了 , 看 起 来 也 舒服 了 。 通过 设置 系统 分 辨 率 这 个 例 
T, 我 们 就 知道 了 如 何 设置 Ubuntu 系统 , 如 果 有 需要 设置 其 它 东 西 的 话 都 可 以 到 系统 设置 里 面 
去 进行 ， 这 里 就 不 一 一 详细 的 介绍 了 。 
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2.1.3 系统 注销 与 关机 
当 我 们 不 使 用 Ubuntu 系统 以 后 就 需要 将 其 关机 ， 就 和 我 们 使 用 Windows 系统 一 样 ， 干 万 


不 要 通过 直接 退出 VMware 软件 来 关机 ! 关机 很 简单 ,在 主 界面 ， 点 击 右上 角 的 齿轮 图 标 ， 然 
后 选择 关机 选项 ， 如 图 2.1.3.1 所 示 : 























EE fj 中 2056 i 
关于 这 人 台 计 算 机 


Ubuntu 帮助 ... 








图 2.1.3.1 关机 

在 图 2.1.3.1 中 可 以 看 到 有 三 个 选项 : 注销 ， 挂 起 和 关机 ， 这 个 和 Windows 下 是 一 样 的 ， 你 
如 果 想 要 注销 就 点 击 “ 注 销 ”按钮 ， 想 要 关机 就 点 击 “ 关 机 ”按钮 ， 以 关机 为 例 ， 点 击 关 机 以 
后 会 弹出 图 2.1.3.2 所 示 关 机 确认 界面 ， 在 确认 界面 上 可 以 选择 是 “重启 ”还 是 “关机 ”。 



































图 2.1.3.2 关机 确认 界面 
在 图 2.1.3.2 中 ， 左 边 的 按钮 为 重启 图 标 ， 点 击 以 后 系统 重启 ， 右 边 的 按钮 为 关机 按钮 ， 点 
击 以 后 就 会 关闭 Ubunut 系统 。 





2.1.4 中 文 输入 测试 


我 们 是 中 国人 ， 平 时 用 的 做 多 的 肯定 是 中 文 ， 那 么 Ubuntu 下 中 文 输入 是 否 和 Windows 一 
FEME? 如 何在 Ubunut 下 使 用 中 文 输入 法 。 我 们 在 安装 Ubuntu 系统 的 时 候 就 已 经 使 用 过 中 文 输 
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入 法 了 ， 就 是 选择 我 们 所 在 地 的 时 候 。 本 节 我 们 就 以 创建 一 个 文本 为 例 , 介绍 如 何在 Ubunut 中 
使 用 中 文 输入 法 。 

在 桌面 上 点 击 鼠 标 右键 ， 然 后 选择 新 建文 档 -> 空白 文档 ， 如 图 2.1.4.1 所 示 ; 























新 建文 件 夹 (F) 





图 2.1.4.1 新 建 空白 文档 
文档 名 字 使 用 默认 名 字 : 无 标题 文档 ， 如 图 2.1.42 所 示 : 





无 标题 文档 
图 2.1.4.2 新 建 的 无 标题 文档 
双击 打开 文档 ， 打 开 以 后 如 图 2.1.4.3 所 示 : 
无 标题 文档 Es 








EXTR 制 表 符 宽 度 : 8 ~ f11, 5l 1 





图 2.1.4.3. 打开 文档 
打开 文档 以 后 ， 我 们 可 以 尝试 在 里 面 输入 一 些 英 文 和 数字 ， 输 入 英文 和 数字 是 没有 任何 问 
题 的 , 输入 中 文 的话 需 要 切换 到 Ubuntu 自 带 的 拼音 输入 法 ， 有 两 种 方式 切换 ,一 种 是 使 用 快捷 
键 :Windows+ 空 格 键 ， 一 种 是 使 用 鼠标 点 击 设置 输入 法 ， 如 图 2.1.4.4 所 示 : 
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cm ip 4) 21:12 $ | 
D 在 线 帮 助 
简体 中 文 


2 半角 字符 
” 全 角 标 点 
718 de ib 


无 联想 





图 2.1.4.4 切换 拼音 输入 法 





这 两 种 方法 都 可 以 切换 输入 法 ,切换 到 拼音 输入 法 以 后 就 可 以 输入 中 文 了 ， 如 图 2.1.4.5 所 

















* 无 标题 文档 (~/ 桌 面 ) - gedit 


zuozhongkai 
123456789 


左 忠 凯 
ARM 逻 辑 与 嵌入 式 Linux 驱 十 开发 


kai fa 
1. 开 发 2... 3. 凯 4. 开 5. 楷 





纯 文本 ~ ” 制 表 符 宽度 : 8 134, 5| 17 v 插入 
图 2.1.4.5 输入 中 文 文本 





大 家 会 发 现 Ubuntu 下 的 拼音 输入 法 使 用 起 来 跟 Windows 下 的 输入 法 差距 太 大 了 ， 没 有 





Windows 下 的 输入 法 好 用 , 没 办 法 , 谁 让 桌面 端 Linux 用 的 少 呢 , 所 以 也 就 没有 喻 公司 开发 Linu 
下 的 输入 法 。 




















X 


通过 上 面 几 个 小 节 中 对 Ubunut 的 基本 操作 来 看 ， 基 本 和 Windows 下 的 操作 差不多 ， 我 们 

















真正 要 使 用 Ubuntu 的 不 是 通过 图 形 界面 操作 , 而 是 通过 命令 行 操 作 的 。 这 也 是 我 们 接 下 来 着 


Tp 




















要 讲 的 : Ubuntu(Linux) 终 端 操 作 ， 会 涉及 到 很 多 命令 ， 但 是 常用 的 命令 就 那 几 十 个 ， 不 需要 刻 
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意 的 去 背 ， 使 用 习惯 了 就 自然 记 住 了 。 不 要 看 到 要 记 命 令 就 觉得 可 怕 。 根 据 2080 原则 ，80% 情 
况 下 只 LER 20% 的 命令 ， 实 际 情况 会 更 少 ， 常 用 的 可 能 就 那 5%~10% 的 命令 。 


2.2 Ubuntu 终端 操作 


本 节 就 是 我 们 学 习 Ubunut 操作 系统 的 重点 了 ， 终 端 操 作 ， 也 就 是 俗称 的 “ 敲 合 令 ”， 不管 
是 哪个 版 本 的 Linux 发 行 版 系统 ， 它 都 会 提供 终端 操作 ，Linux 下 的 终端 操作 类 似 与 Windows 
下 的 DOS 操作 。 要 使 用 终端 首先 肯定 是 要 打开 终端 , 在 主 界面 上 点 击 鼠 标 右键 ， 然 后 选择 打开 
终端 ， 如 图 2.2.1 所 示 : 

























































































新 建文 件 夹 {F) 
新 建文 档 (D) 


打开 终端 (E) 


按 名 称 整理 桌面 (O) 
Y 保持 对 齐 (K) 








图 2.2.1 打开 终端 





打开 终端 以 后 如 图 2.2.2 所 示 : 


zuozhongkai(pzuozhongkai-virtual-machine: ~ 


To run a command as administrator (user "root"), use "sudo <command>". 
See "man sudo_root" for details. 





:~5 Bl 





图 2.2.2 终端 界面 
我 们 就 是 在 图 2.2.2 所 示 界 面 上 输入 命令 的 ， 终 端 默认 会 有 类 似 下 夯 

















行 所 示 的 一 串 提 示 























IECEUTTNENZTE -virtual-machine: ~$ 
述 字符 串 中 ，@ 前 面 的 “zuozhongkai” 是 当前 的 用 户 名 字 ，@ 后 面 的 zuozhongkai-virtual- 
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machine 是 我 的 机 器 名 字 。 最 后 面 的 符号 “$” 表 示 当 前 用 户 是 普通 用 户 ， 我 们 可 以 在 提示 符 后 
面 输入 命令 ， 比 如 输入 命令 “ls” 命令 “ls” 是 打印 出 当前 所 在 目录 中 所 有 文件 和 文件 来， 如 图 
2.2.3 所 示 : 












































zuozhongkai@ubuntu: ~ 
:~$ ls 
examples .desktop 





:~$ y 
图 2.2.3 Is 命令 
在 图 2.2.3 中 我 们 输入 了 “ls” 这 个 命令 ， 然 后 打印 出 了 当前 目录 下 的 所 有 文件 和 文件 夹 ， 

















后 面 我 们 学 习 命令 的 时 候 就 是 在 终端 中 输入 相应 命令 的 。 
2.3 Shell 操作 


2.3.1 Shell 简介 


学 习 linux 的 时 候 会 频繁 的 看 到 Shell 这 个 词语 ? 那么 什么 是 Shel W? 网 上 搜索 一 下 ， 各 
种 专业 的 解释 一 堆 ， 但 是 对 于 第 一 次 接触 Linux. 的 人 来 说 这 些 专业 的 词语 只 会 让 人 更 晕 。 简 单 
的 说 Shell 就 是 敲 命令 。 国 内 把 Linux 下 通过 命令 行 输入 命令 叫做 “项 命令 ”国外 人 玩 的 比较 
洋气 ， 人 家 叫做 “Shell”。 因 此 以 后 看 到 Shell 这 个 词语 第 一 反应 就 是 在 终端 中 敲 命 令 ， 将 多 个 
Shell 命令 按照 一 定 的 格式 放 到 一 个 文本 中 ， 那 么 这 个 文本 就 叫做 Shell 脚本 。 

严格 意义 上 来 讲 ，Shell 是 一 个 应 用 程序 ， 它 负责 接收 用 户 输入 的 命令 ， 然 后 根据 命令 做 出 
相应 的 动作 ，Shell 负责 将 应 用 层 或 者 用 户 输入 的 命令 传递 给 系统 内 核 ， 由 操作 系统 内 核 来 完成 


相应 的 工作 ， 然 后 将 结果 反馈 给 应 用 层 或 者 用 户 。 







































































2.3.2 Shell 基本 操作 


前 面 我 们 说 Shell 就 是 “ 敲 命令 ” 那么 既然 是 命令 ， 那 肯定 是 有 格式 的 ，Shell 命令 的 格式 
如 下 : 

command -Options [argument] 

command: Shell 命令 名 称 。 

options: 选项 ， 同 一 种 命令 可 能 有 不 同 的 选项 ， 不 同 的 选项 其 实现 的 功能 不 同 。 

argument: Shell 命令 是 可 以 带 参 数 的 ， 也 可 以 不 带 参 数 运行 。 

同样 以 命令 “ls” 为 例 ， 下 面 “ls” 命 令 的 三 种 不 同 格式 其 结果 也 不 同 : 





























ls 
IS 
ls /usr 


这 三 种 命令 的 运行 结果 如 图 2.3.2.1 所 示 : 
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习 zuozhongkai@ubuntu: ~ 
zuozhongkai@ubuntu:~$ ls 


examples.desktop tmp 


公共 的 


模板 


zuozhongkai@ubuntu:~$ ls -l 


总 用 量 48 

-rw-r--r-- 
drwxrwxr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 


1 
2 
2 
2 
2 
2 
2 
2 
2 


zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 


zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 


视频 


8980 
4096 
4096 
4096 
4096 
4096 
4096 
4096 
4096 


xI 


图 片 文档 FË 音乐 


12H 
12H 
12H 
12H 
12H 
12H 
12H 
12H 
12H 


18 
19 
18 
18 
18 
18 
18 
18 
18 


02: 
00: 
02: 
02: 
02: 
02: 
02: 
02: 
02: 


08 
29 
21 
21 
21 
21 
pa! 
21 
pa! 


zuozhongkai 4096 12H 19 00:25 5 


/usr 
local locale 


drwxr-xr-x 2 zuozhongkai 
zuozhongkaiQubuntu:-$ ls 
bin games include lib 
zuozhongkaiQubuntu:-$ 


sbin share sr 








图 2.32.11s 命令 
在 图 2.3.2.1 中 “1s” 命 令 用 来 打印 出 当前 目录 下 的 所 有 文件 和 文件 夹 ， 而 “ls -1” 同 样 是 
打印 出 当前 目录 下 的 所 有 文件 和 文件 夹 ， 但 是 此 命令 会 列 出 所 有 文件 和 文件 夹 的 详细 信息 ， 比 
如 文件 大 小 、 拥 有 者 、 创 建 日 期 等 等 。 最 有 一 个 “ls Aasr” 是 用 来 打印 出 目录 “Asr” 下 的 所 有 
文件 和 文件 夹 。 

Shell 命令 是 支持 自动 补 全 功能 的 ， 因 为 Shell 命令 非常 多 ， 如 果 不 作 自 动 补 全 的 话 就 需要 
用 户 去 记忆 这 些 命令 的 全 部 字母 。 使 用 自动 补 全 功能 以 后 我 们 只 需要 输入 命令 的 前 面 一 部 分 字 
母 , 然后 按 下 TAB 键 ， 如 果 只 有 一 个 命令 匹配 的 话 就 会 自动 补 全 这 个 命令 剩 下 的 字母 。 如 果 有 
多 个 命令 匹配 的 话 系统 就 会 发 出 报警 声音 ， 此 时 在 按 下 一 次 TAB 键 就 会 列 出 所 有 匹配 的 命令 ， 
比如 我 们 输入 字母 “if”， 然后 按 下 TAB 键 ， 结 果 如 图 2.3.2.2 所 示 : 


zuozhongkai@ubuntu:~$ if 
if ifconfig ifdown 



























































































































































































































































ifquery ifup 
图 2.3.2.2 “if” 开 始 的 命令 
从 图 2.3.2.2 可 以 看 出 ， 以 “if” 开 头 的 命令 有 5 个 ， 我 们 以 “ifconfig” 为 例 ， 此 命令 是 用 
卡 信息 的 ,我 们 重新 输入 “ife” 然 后 在 按 一 下 TAB St, 就 会 自动 补 全 出 “ifconfig” 命 
因为 以 “ifc” 开 头 的 命令 只 有 一 个 ， 结 果 如 图 2.3.2.3 Bron: 
zuozhongkai@ubuntu:~$ ifconfig 
ens33 Link encap: 以 太 网 ”硬件 地 址 00:0c:29:96:89:d6 
inet 地 址 :192.168.31.235 广播 :192.168.31.255 掩 码 :255.255.255.0 
Hp: Ho kt pA Lp 
UP BROADCAST RUNNING MULTICAST MTU:1500 路 点数 :1 
接收 数据 包 :14268 错误 :0 丢弃 :0 过 载 :0 帧 数 :0 
发 送 数据 包 :1571 错误 :0 丢弃 :0 过 载 :0 载波 :0 
碰撞 :0 发 送 队 列 长 度 :1000 
接收 字 节 :5861098 (5.8 MB) 















































3g 





















































发 送 字 节 :109785 (109.7 KB) 


Link encap: 本 地 环 回 
inet 地 址 :127.0.0.1 


掩 码 :255.0.0.0 

::1/128 Scope:Host 

MTU:65536 跃 点 数 :1 
错误 :0 丢弃 :0 过 载 :0 帧 数 :0 

发 送 数据 包 :247 错误 :0 丢弃 :0 过 载 :0 载波 :0 

碰撞 :6 发 送 队 列 长 度 :1000 

接收 字 节 :19425 (19.4 KB) 


inet6 地 址 : 
UP LOOPBACK RUNNING 
接收 数据 包 :247 错误 


发 送 字 节 :19425 (19.4 KB) 








图 2.3.2.3 ifconfig 命令 结 
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2.2.4 常用 Shell 命令 
我 们 做 嵌入 式 开 发 用 的 最 多 就 是 Shell 命令 ，Shell 命令 是 所 有 的 Linux 系统 发 行 版 所 通用 



































的 ， 并 不 是 说 我 在 Ubuntu 下 学 会 了 Shell 命令 ， 换 另外 一 个 Linux 发 行 版 操作 系统 以 后 就 没 用 
了 (不 同 的 发 行 版 Linux 系统 可 能 会 自 定 义 一 些 命令 )。 本 节 我 们 先 来 介绍 一 些 Shell 下 常用 的 命 


























、 目 录 信息 查看 命令 ls 


文件 浏览 是 最 基本 的 操作 了 ，Shell 下 文件 浏览 命令 为 8， 格 式 如 下 : 

Is pm] [路径 ] 

ls 命令 主要 用 于 显示 指定 目录 下 的 内 容 ， 列 出 指定 目录 下 包含 的 所 有 的 文件 以 及 子 目 录 ， 
它 的 主要 参数 有 : 

-a ”显示 所 有 的 文件 以 及 子 目 录 ， 包 括 以 “.” 开 头 的 隐藏 文件 。 

-1 ”显示 文件 的 详细 信息 ， 比 如 文件 的 形态 、 权 限 、 所 有 者 、 大 小 等 信息 

-t ”将 文件 按照 创建 时 间 排序 列 出 。 

-A ”和 -a 一样， 但 是 不 列 出 “.”( 当 前 目录 ) 和 “..”( 父 目录 )。 

-R 递归 列 出 所 有 文件 ， 包 括 子 目录 中 的 文件 。 

Shell 命令 里 面 的 参数 是 可 以 组 合 在 一 起 用 的 ， 比 如 组 合 “-al” 就 是 显示 所 有 文件 的 详细 信 
Eo WRA <” FRRO, s 命令 使 用 如 图 2.2.4.1 所 示 : 






































































































































zuozhongkai zuozhongkai 4096 12 月 19 21:41 
zuozhongkai zuozhongkai 4096 12 月 19 20:31 
zuozhongkai zuozhongkai 0 12A 19 21:41 a 
zuozhongkai zuozhongkai 0 12H 19 21:41 b 
zuozhongkai zuozhongkai 0 12H 19 2AE 








图 2.2.4.1 Is 命令 演示 
注意 图 2.2.4.1 中 tmp 文件 夹 是 我 为 了 演示 方便 ， 自 己 创建 的 ， 里 面 的 文件 a，b 和 ec 也 是 
我 创建 的 ， 关 于 文件 夹 和 文件 的 创建 后 面 会 详细 的 讲解 。 
2、 目 录 切 换 命令 cd 
要 想 在 Shell 中 切换 到 其 它 的 目录 ， 使 用 的 命令 是 cd， 命 令 格 式 如 下 : 
cd [路径 ] 
路 径 就 是 我 们 要 进入 的 目录 路 径 ， 比 如 下 面 所 示 操 作 : 

























































































cd / // 进 入 到 根 目录 “/” 下 ，Linux 系统 的 根 目 录 为 “/”， 
cd /usr // 进 入 到 目录 “/usr” 里 面 。 

cd .. // 进 入 到 上 一 级 目录 。 

cd ~ // 切 换 到 当前 用 户主 目录 


比如 我 们 要 进入 到 目录 “/msr” 下 去 ， 并 且 查 看 “/usr” 下 有 什么 文件 ， 操 作 如 图 2.2.4.2 所 
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:-$ cd /usr 


$ ls 








图 2.2.4.2 cd 命令 演示 
在 图 2.2.4.2 中 ， 我 们 先 使 用 命令 “cd /usr” 进 入 到 “/usr” 目 录 下 ， 然 后 使 用 “ls” 命 令 
显示 “/usr” 目 录 下 的 所 有 文件 。 仔 细 观 察 图 2.2.4.2 可 以 看 到 ， 当 我 们 切换 到 其 它 目 录 以 后 在 
符号 “$” 前 面 就 会 以 蓝 色 的 字体 显示 出 当前 目录 名 字 ， 如 图 2.2.4.3 所 示 ; 

: $l ls 









































图 2.2.4.3 目录 路 径 显示 
3、 当 前 路 径 显 示 命 令 pwd 














pwd 命令 用 来 显示 当前 工作 目录 的 绝对 路 径 ， 不 需要 任何 的 参数 ， 使 用 如 图 2.2.4.4 所 示 ; 
:-$ pwd 











/home/zuozhongkai 





图 2.2.4.4 pwd 命令 
4、 系 统 信息 查看 命令 uname 
要 查看 当前 系统 信息 ， 可 以 使 用 命令 uname， 命 令 格式 如 下 : 
uname [Xm] 
可 选 的 选项 参数 如 下 : 
-c 列 出 当前 系统 的 具体 内 核 版 本 号 。 
-s ” 列 出 系统 内 核 名 称 。 
-0 ” 列 出 系统 信息 。 
使 用 如 图 2.2.4.5 所 示 : 


:~$ uname 

















Linux 

:~$ uname - 
4.15.0-29-generic 

:-$ uname - 


:-$ uname - 





图 2.2.4.5 uanme 命令 操作 





S、 清 屏 命令 clear 

clear 命令 用 于 清除 终端 上 的 所 有 内 容 ， 只 留 下 一 行 提 示 符 。 

6、 切 换 用 户 执行 身份 命令 sudo 

Ubuntu(Linux) 是 一 个 允许 多 用 户 的 操作 系统 ， 其 中 权限 最 大 的 就 是 超级 用 户 root， 有 时 候 
我 们 执行 一 些 操作 的 时 候 是 需要 用 root 用 户 身 份 才能 执行 ， 比如 安装 软件 。 通过 sudo 命令 可 以 
使 我 们 暂时 将 身份 切换 到 root 用 户 。 当 使 用 sudo 命令 的 时 候 是 需要 输入 密码 的 , 这 里 要 注意 输 
入 密码 的 时 候 是 没有 任何 提示 的 ! 命令 格式 如 下 : 

sudo [选项 ] [mS] 

选项 主要 参数 如 下 : 

-h ”显示 帮助 信息 。 
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J 列 出 当前 用 户 可 执行 与 不 可 执行 的 命令 
-Pp 改变 询问 密码 的 提示 符 。 
假如 我 们 现在 要 创建 一 个 新 的 用 户 test， 创 建新 用 户 的 命令 为 “adduser”， 创 建新 用 户 的 权 
限 只 有 root 用 户 才 有 ， 我 们 在 装 系统 的 时 候 创 建 的 那个 用 户 是 没有 这 个 权限 的 ， 比 如 我 的 
“zuozhongkai 用 户 。 所 以 创建 新 用 户 的 话 需要 使 用 “sudo” 命 令 以 root 用 户 执行 “adduser” 
这 个 命令 ， 如 图 2.2.4.6 所 示 ; 
:~$ adduser test 
adduser: 只 有 root 才能 将 用 户 或 组 添加 到 系统 。 
:~$ sudo adduser test 
正在 添加 用 户 "test"... 
正在 添加 新 组 "test" (1001)... 
正在 添加 新 用 户 "test"” (1001) 到 组 "test"... 
创建 主 目录 "/home/test"... 
正在 从 "/etc/skel" 复 制 文件 ... 
输入 新 的 UNIX 密码 : 
重新 输入 新 的 UNIX 密码 : 




































































passwd: 已 成 功 更 新 密码 
正在 改变 test 的 用 户 信 息 
请 输入 新 值 ， 或 直接 敲 回 车 键 以 使 用 默认 值 








图 2.2.4.6 sudo 命 oe 

在 图 2.2.4.6 中 ,我 们 一 开始 直接 使 用 “adduser test” 命 令 添加 用 户 的 时 候 提示 我 们 “adduser: 
只 有 root 才能 将 用 户 或 组 添加 到 系统 。” 所 以 我 们 要 在 前 Tn “sudo” 命 令 ， 表 示 以 root 用 
户 执行 adduser 操作 。 


7、 添 加 用 户 命令 adduser 


在 讲解 sudo 命令 的 时 候 我 们 已 经 用 过 命令 “adduser”， 此 命令 需要 root 身份 去 运行 。 命 令 
格式 如 下 : 
adduser [参数 ] [用 户 名 ] 
常用 的 参数 如 下 : 
-system 添加 一 个 系统 用 户 
-home DIR DIR 表示 用 户 的 主 目录 路 径 
-uid ID ID 表示 用 户 的 uid。 
-ingroup GRP ”表示 用 户 所 属 的 组 名 。 
adduser 的 使 用 我 们 前 面 已 经 演示 过 了 ， 大 家 可 以 试 着 再 添加 一 个 用 户 。 


8、 删 除 用 户 命 令 deluser 


前 面 讲 了 添加 用 户 的 命令 ， 那 肯定 也 有 删除 用 户 的 命令 ,删除 用 户 使 用 命令 “deluser”， 合 
令 参 数 如 下 : 
deluser ” [参数] [用 户 名 ] 
































—— 



































































































































主要 参数 有 : 
-System 当 用 户 是 一 个 系统 用 户 的 时 候 才 能 删除 。 





-remove-home 删除 用 户 的 主 目录 
-remove-all-files ”删除 与 用 户 有 关 的 所 有 文件 。 
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-backup 备份 用 户 信息 























同样 的 ， 命 令 “deluser” 也 要 使 用 “sudo” 来 以 root 用 户 运 行 ， 以 删除 我 们 前 面 创建 的 用 
户 test 为 例 ，deluser 使 用 如 图 2.2.4.7 所 示 : 
A 

















/sys/kernel/security/apparmor/.null 
: 无 法 处 理 特殊 文件 /run/udev/static node-tags/uaccess/sndWx2fseq 
: 无 法 处 理 特殊 文件 /run/udev/static node-tags/uaccess/snd\x2ftimer 
: 无 法 处 理 特殊 文件 /dev/vcsa7 
/usr/sbin/deluser: 无 法 处 理 特殊 文件 /dev/vcs7 


/usr/sbin/deluser: 无 法 处 理 特殊 文件 /lib/systemd/system/single.service 
/usr/sbin/deluser: 无 法 处 理 特殊 文件 /lib/systemd/system/cryptdisks.service 
/usr/sbin/deluser: 无 法 处 理 特殊 文件 /lib/systemd/system/cryptdisks-early.service 
正在 删除 文件 . . . 

正在 删除 用 户 'test'... 

警告 : 组 "test" 没 有 其 他 成 员 了 。 

完成 。 








图 2.2.4.7 命令 deluser 演示 

9、 切 换 用 户 命令 su 

前 面 在 讲解 命令 “sudo” 的 时 候 说 过 ,“sudo” 是 以 root 用 户 身 份 执行 一 个 命令 ， 并 没有 更 
改 当前 的 用 户 身 份 ， 所 有 需要 root 身份 执行 的 命令 都 必须 在 前 面 加 上 “sudo” 命令 “su” 可 以 
直接 将 当前 用 户 切 换 为 root 用 户 ， 切换 到 root 用 户 以 后 就 可 以 尽情 地 尽情 任何 操作 了 ! 因为 你 
已 经 获得 了 系统 最 高 权限 ， 在 root 用 户 下 ， 所 有 的 命令 都 可 以 无 障碍 执行 ， 不 需要 在 前 面 加 上 
* sudo ", * su" 命令 格式 如 下 : 

su [XX] [用 户 名 ] 




































































常用 选项 参数 如 下 : 

-c -command 执行 指定 的 命令 ， 执 行 完毕 以 后 回复 原 用 户 身 份 。 
-login 改变 用 户 身份 ， 同 时 改变 工作 目录 和 PATH 环境 变量 。 
-m 改变 用 户 身 份 的 时 候 不 改变 环境 变量 

-h 显示 帮助 信息 

以 切换 到 root 用 户 为 例 ， 使 用 如 图 2.2.4.8 所 示 : 








:-$ sudo su 
[sudo] zuozhongkai 的 密码 : 





rootqQubuntu: /home/zuozhongkai£ 





图 2.2.4.8 su 命令 演示 

在 图 2.2.4.8 中 ， 先 使 用 命令 “sudo sa” 切换 到 root 用 户 ，su 命令 不 写 明 用 户 名 的 话 默 认 切 
换 到 root 用 户 。 然 后 输入 密码 ， 密 码 正确 的 话 就 会 切换 到 root 用 户 ， 可 以 看 到 切换 到 root 用 户 
以 后 提示 符 的 “@” 符 号 前 面 的 用 户 名 变 成 了 “root” 表示 当前 的 用 户 是 root 用 户 。 并且 以 “#” 


zh 








































































































注意 !! 由 于 root 用 户 权 限 太 大 ， 稍 微 不 注 意 就 可 能 删除 掉 系 统 文 件 ， 导 致 系统 奔 涡 ， 因 此 
强烈 建议 大 家 ,不 要 以 root 用 户 运行 Ubuntu。 当 要 用 到 root 身份 执行 某 些 命令 的 时 候 使 用 “sudo” 
命令 即 可 。 

要 切换 回 原来 的 用 户 , 使 用 命令 “sudo su 用 户 名 ” 即 可 , 比如 我 要 从 root 切换 回 zuozhongkai 
这 个 用 户 ， 操 作 如 图 2.2.4.9 所 示 : 






































root@ubuntu:/home/zuozhongkai# sudo su zuozhongkai 





:~$ 








图 2.2.4.9 切换 回 原来 用 户 
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10、 显 示 文 件 内 容 命令 cat 


查看 文件 内 容 是 最 常见 的 操作 了 ， 在 windows 下 可 以 直接 使 用 记事 本 查看 一 个 文本 文件 内 
容 ，linux 下 也 有 类 似 记 事 本 的 软件 ， 叫 做 gedit， 找 到 一 个 文本 文件 ， 双 击 打 开 ， 默 认 使 用 的 就 
是 gedit， 如 图 2.2.4.10 所 示 : 






































* 无 标题 文档 (~/ 桌 面 ) - gedit 


打开 (Oo) | 





zuozhongkai 
123456789 


ARNM 裸 机 与 戏 入 式 Ltnux 驱 动 开 发 


纯 文本 vy 制 表 符 宽度 : 8 行 4, 列 1 v 插入 
图 2.2.4.10 gedit 打开 文档 

我 们 现在 讲解 的 是 Shell 命令 ， 那 么 Shell 下 有 没有 办 法 读 取 文 件 的 内 容 呢 ?肯定 有 的 ， 那 
就 是 命令 “cat”， 命 令 格 式 如 下 : 

cat [选项 ] ” [文件 ] 

选项 主要 参数 如 下 : 

-n ”由 1 开始 对 所 有 输出 的 行进 行 编号 。 

-b F-n 类 似 ， 但 是 不 对 空白 行 编号 。 

-s “ 当 遇 到 连续 两 个 行 以 上 空白 行 的 话 就 合并 为 一 个 行 空白 行 。 




































































比如 我 们 以 查看 文件 “/etcwenvironment” 的 内 容 为 例 ， 结 果 如 图 2.2.4.11 所 示 : 


:-$ cat /etc/environment 
PATH=" /usr/local/sbin: /usr/local/bin: /usr/sbin:/usr/bin:/sbin:/bin:/usr/games: /usr/local/games" 





:~$ cat /etc/environment -n 
1 PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games" 








图 2.2.4.11 命令 cat 演示 
11、 显 示 和 配置 网 络 属性 命令 ifconfig 
ifconfig 是 一 个 跟 网 络 属性 配置 和 显示 密切 相关 的 命令 , 通过 此 命令 我 们 可 以 查看 当前 网 络 
衣 性 ， 也 可 以 通过 此 命令 配置 网 络 属性 ， 比 如 设置 网 络 IP 地 址 等 等 ， 此 命令 格式 如 下 : 
ifconfig interface options | address 
主要 参数 如 下 : 
interface 网 络 接口 名 称 ， 比 如 eth0 等 。 























up 开启 网 络 设备 。 
down 关闭 网 络 设备 。 
add IP 地 址 ， 设 置 网 络 IP 地址 。 
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netmask add F PIEI. 
命令 ifconfig 的 使 用 如 图 2.2.4.12 Bran: 


zuozhongkai@ubuntu:~$ ifconfig 
ens33 Link encap: 以 太 网 ”硬件 地 址 00:0c:29:96:89:d6 
inet 地 址 :192.168.31.235 广播 :192.168.31.255 掩 码 :255.255.255.6 
inet6 地 址 : fe80::e92a:d882:e1b:7402/64 Scope:Link 
UP BROADCAST RUNNING MULTICAST MTU:1500 跃 点 数 :1 
接收 数据 包 :13404 错误 :0 丢弃 :0 过 载 :0 帧 数 :0 
发 送 数 据 包 :967 错误 :0 丢弃 :0 过 载 :0 载波 :0 
碰撞 :6 发 送 队 列 长 度 :1009 
接收 字 节 :810508 (810.5 KB) 发 送 字 节 :75728 (75.7 KB) 








Link encap: 本 地 环 回 

inet 地 址 :127.0.0.1 掩 码 :255.0.0.0 

inet6 地 址 : ::1/128 Scope:Host 

UP LOOPBACK RUNNING MTU:65536 跃 点数 :1 

接收 数据 包 :248 错误 :0 丢弃 :0 过 载 :0 帧 数 :0 

发 送 数据 包 :248 错误 :0 丢弃 :0 过 载 :9 载波 :0 

碰撞 :6 发 送 队 列 长 度 :1000 

接收 字 节 :19004 (19.0 KB) 发 送 字 节 :19004 (19.0 KB) 


zuozhongkaiQubuntu:-$ ifconfig ens33 
ens33 Link encap: 以 太 网 硬件 地 址 00:0c:29:96:89:d6 
inet 地 址 :192.168.31.235 J 1$:192.168.31.255 1&$3:255.255.255.0 
inet6 地 址 : fe80::e92a:d882:e1b:7402/64 Scope:Link 
UP BROADCAST RUNNING MULTICAST MTU:1500 跃 点 数 :1 
接收 数据 包 :13406 错误 :0 丢弃 :0 过 载 :0 帧 数 :0 
发 送 数 据 包 :971 错误 :0 丢弃 :0 过 载 :0 载波 :0 
碰撞 :0 发 送 队 列 长 度 :1000 
接收 字 节 :810658 (810.6 KB) 发 送 字 节 :76218 (76.2 KB) 








图 2.2.4.12 ifconfig 命令 演示 

在 图 2.2.4.12 中 有 两 个 网 卡 : ens33 和 lo，ens33 是 我 的 电脑 实际 使 用 的 网 卡 ，lo 是 回 测 网 
卡 。 可 以 看 出 网 卡 ens33 的 IP 地 址 为 192.168.31.235， 我 们 使 用 命令 “ifeonfig” 将 网 卡 ens33 的 
IP 地 址 改 为 192.168.31.20， 操 作 如 图 2.2.4.13 所 示 : 


zuozhongkai@ubuntu:~$ sudo ifconfig ens33 192.168.31.20 
zuozhongkaiQubuntu:-$ ifconfig ens33 
ens33 Link encap: 以 太 网 硬件 地 址 00:0c:29:96:89:d6 
inet 地 址 :192.168.31.26 广播 :192.168.31.255 掩 码 :255.255.255.0 
inet6 地 址 : fe80::e92a:d882:e1b:7402/64 Scope:Link 






























































UP BROADCAST RUNNING MULTICAST MTU:1500 跃 点 数 :1 
接收 数据 包 :15188 错误 :0 丢弃 :0 过 载 :0 W% :0 

发 送 数据 包 :1040 错误 :0 丢弃 :0 过 载 :0 载波 :0 

碰撞 :0 发 送 队 列 长 度 :1000 

接收 字 节 :917930 (917.9 KB) 发 送 字 节 :84590 (84.5 KB) 





图 2.2.4.13 修改 网 卡 IP 地 址 
从 图 2.2.4.13 可 以 看 出 ， 我 在 使 用 命令 “ifconfig” 修 改 网 卡 ens33 的 IP 地 址 的 时 候 使 用 了 
"sudo", 说 明 在 Ubuntu 下 修改 网 卡 IP 地 址 是 需要 root 用 户 权限 的 。 当 修改 完 以 后 使 用 命令 
“ifconfig ens33” 再 次 查看 网 卡 ens33 的 命令 ， 发 现 网 卡 ens33 的 IP 地 址 变 成 了 192.168.31.20 

12、 系 统 帮 助 命令 man 

Ubuntu 系统 中 有 很 多 命令 ， 这 些 命令 都 有 不 同 的 格式 ， 不 同 的 格式 对 应 不 同 的 功能 ， 要 完 
记 住 这 些 命令 和 格式 几乎 是 不 可 能 的 ， 必 须 有 一 个 帮助 手册 ， 当 我 们 需要 了 解 一 个 命令 的 详 
信息 的 时 候 查 阅 这 个 帮助 手册 就 行 了 。Ubuntu 提供 了 一 个 命令 来 帮助 用 户 完成 这 个 功能 ， 那 
7 AN 


是 “man ”命令 ， 通 过 “man” 命 令 可 以 查看 其 它 命令 的 语法 格式 、 主 要 功能 、 主 要 参数 说 明 
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等 ， “man” 命 令 格 式 如 下 : 
man [命令 名 ] 
比如 我 们 要 查看 命令 “ifconfig” 的 说 明 ， 输 入 “man ifconfig” 即 可 ， 如 图 2.2.4.14 所 示 : 











图 2.2.4.14 man 命令 演示 
在 终端 中 输入 图 2.2.4.14 所 示 的 命令 ， 然 后 点 击 回 车 键 就 会 打开 “ifconfig” 这 个 命令 的 详 
细 说 明 ， 如 图 2.2.4.15 所 示 : 

































































Linux Programmer's Manual IFCONFIG(8) 


ifconfig - configure a network interface 


SYNOPSIS 
ifconfig [-v] [-a] [-s] [interface] 
ifconfig [-v] interface [aftype] options | address ... 


DESCRIPTION 
Ifconfig is used to configure the kernel-resident network interfaces. 
It is used at boot time to set up interfaces as necessary. After that, 
it is usually only needed when debugging or when system tuning is 
needed. 


If no arguments are given, ifconfig displays the status of the cur- 
rently active interfaces. If a single interface argument is given, it 
displays the status of the given interface only; if a single -a argu- 
ment is given, it displays the status of all interfaces, even those 
that are down. Otherwise, it configures an interface. 


Address Families 
If the first argument after the interface name is recognized as the 
Manual page ifconfia(8) line 1 (press h for help or q to quit) 


图 2.2.4.15 命令 “ifconfig” 详 细 介 绍 信息 
图 2.2.4.15 就 是 命令 “ifconfig” 的 详细 介绍 信息 ， 按 “gq” 键 退出 到 终端 。 
13、 系统 重启 命令 reboot 


通过 点 击 Ubuntu 主 界面 右上 和 角 的 齿轮 按钮 来 选择 关机 或 者 重启 系统 ， 同 样 的 我 们 也 可 以 
使 用 Shell 命令 “reboot” 来 重启 系统 , 直接 输入 命令 “reboot” 然 后 点 击 回 车 键 接口 , 如 图 2.2.4.16 
所 示 : 


zuozhongkaigubuntu:-$ reboot 


图 2.2.4.16 reboot 命令 演示 









































































































































14、 系 统 关闭 命令 poweroff 
使 用 命令 “reboot” 可 以 重启 系统 ， 使 用 命令 “poweroff” 就 可 以 关闭 系统 ， 在 终端 中 输入 
命令 “poweroff” 然 后 按 下 回 车 键 即 可 关闭 Ubuntu 系统 ， 如 图 2.2.4.17 所 示 : 


zuozhongkaiQubuntu:-$ poweroff 


图 2.2.4.17 poweroff 命令 演示 















































15、 软 件 安装 命令 install 
截至 目前 ， 我 们 都 没有 讲 过 Ubuntu 下 如 何 安装 软件 ， 因 为 Ubuntu 安装 软件 不 像 Windows 
下 那样 ， 直 接 双击 .exe 文件 就 开始 安装 了 。Ubuntu 下 很 多 软件 是 需要 先 自行 下 载 源 码 ， 下 载 源 
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码 以 后 自行 编译 ， 编 译 完成 以 后 使 用 命令 “intsall” 来 安装 。 当 然 Ubuntu 下 也 有 其 它 的 软件 安 
装 方法 , 但 是 用 的 最 多 的 就 是 自行 编译 源码 然后 安装 , 尤其 是 嵌入 式 Linux 开发 。 命 令 “install” 
格式 如 下 : 

install pÆ]... [-T] 源 文件 目标 文件 




















Bk: install [选项 ]... Us xc ft... 目录 
Bk: install pÆ]... -t 目录 Js cft... 


Bk: install [选项 ].. -d HX... 
“install” 命 令 是 将 文件 (通常 是 编译 后 的 文件 ) 复 制 到 目的 位 置 ， 在 前 三 种 形式 中 ， 将 源 文 
件 复 制 到 目标 文件 或 将 多 个 源 文件 复制 到 一 个 已 存在 的 目录 中 同时 设置 其 所 有 权 和 权限 模式 。 
在 第 四 种 形式 会 创建 指定 的 目录 。 命 令 “install” 通 常 和 命令 “aptrget” 组 合 在 一 起 使 用 的 ， 关 
于 “apt-get” 命 令 我 们 稍 后 会 讲解 。 
以 上 就 是 Shell 最 基本 一 些 命 令 ， 还 有 一 些 其 它 的 命令 我 们 在 后 面 在 讲解 ， 循 序 渐进 嘛 。 


2.4APT 下 载 工 具 


对 于 长 时 间 使 用 Windows 的 我 们 , 下 载 安装 软件 非常 容易 , Windows 下 有 很 多 的 下 载 软件 ， 
Ubuntu 同样 有 不 少 的 下 载 软件 ， 本 节 我 们 讲解 Ubunut 下 我 们 用 的 最 多 的 下 载 工具 : APT 下 载 
TA, APT 下 载 工具 可 以 实现 软件 自动 下 载 、 配 置 、 安 装 二 进 制 或 者 源码 的 功能 。APT FRE 
具 和 我 们 前 面 讲解 的 “install ”命令 结合 在 一 起 构成 了 Ubunut 下 最 常用 的 下 载 和 安装 软件 方法 。 
它 解决 了 Linux 平台 下 一 安装 软件 的 一 个 缺陷 ， 即 软件 之 间 相 互 依赖 。 

APT 采用 的 C/S 模式 ， 也 就 是 客户 端 /服务 器 模式 ， 我 们 的 PC 机 作为 客户 端 ， 当 需要 下 载 

















































































































软件 的 时 候 就 向 服务 器 请 求 ， 因 此 我 们 需要 知道 服务 器 的 地 址 ， 也 叫做 安装 源 或 者 更 新 源 。 打 
开 系 统 设置 ， 打 开 “ 软 件 和 更 新 ”设置 ， 打 开 以 后 如 图 2.4.1.1 所 示 : 











软件 和 更 新 


Ubuntu 软件 其 它 软件 更 新 身份 验证 附加 驱动 ”开发 者 选项 


可 从 互联 网 下 载 
Canonical 支持 的 免费 和 开源 软件 (main) 
图 社区 维护 的 免费 和 开源 软件 (universe) 
设备 的 专 有 驱动 (restricted) 
O 有 版 权 和 合法 性 问题 的 的 软件 (multiverse) 
_] 源 代码 
TRA: “| 中 国 的 服务 器 ~ 





可 从 光驱 安装 


还 原 (V) 关闭 (O 





图 2.4.1.1 软件 和 更 新 设置 
在 图 2.4.1.1 中 的 “Ubunut 软件 ”选项 卡 下 面 的 “下 载 自 ”就 是 APT 工具 的 安装 源 ， 因 为 
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我 们 是 在 中 国 ， 所 以 需要 选择 中 国 的 服务 器 ， 和 否则 的 话 可 能 会 导致 下 载 失 败 ! 这 个 也 就 是 网 上 
说 的 Ubunut 安装 成 功 以 后 要 更 新 源 。 
在 我 们 使 用 APT 工具 下 载 安装 或 者 更 新 软件 的 时 候 ， 首 先 会 在 下 载 列 表 中 与 本 机 软件 对 
比 ， 看 一 下 需要 下 载 哪些 软件 ， 或 者 升级 哪些 软件 ， 默 认 情 况 下 APT 会 下 载 最 新 的 软件 包 ， 被 
安装 的 软件 包 所 依赖 的 其 它 软件 也 会 被 下 载 安装 。 说 了 这 么 多 ，APT 下 载 工 具 究 竟 怎 么 用 呢 ? 
APT 工具 常用 的 命令 如 下 : 

1、 更 新 本 地 数据 库 


如 果 想 查看 本 地 哪些 软件 可 以 更 新 的 话 可 以 使 用 如 下 命令 : 
sudo apt-get update 
这 个 命令 会 访问 源 地 址 ， 并 且 获 取 软 件 列表 并 保存 在 本 电脑 上 ， 过 程 如 图 2.4.1.2 所 示 : 




















































































































:-$ sudo apt-get update 
udo] zuozhongkai 的 密码 : 
:1 http://security.ubuntu.com/ubuntu xenial-security InRelease 
:2 http://cn.archive.ubuntu.com/ubuntu xenial InRelease 


:3 http://cn.archive.ubuntu.com/ubuntu xenial-updates InRelease [109 kB] 
:4 http://cn.archive.ubuntu.com/ubuntu xenial-backports InRelease [107 kB] 
载 216 kB， 耗 时 13 秒 (16.5 kB/s) 

. 完成 








图 2.4.1.2 更 新 本 地 数据 库 





2、 检 查 依赖 关系 
有 时 候 本 地 某 些 软件 可 能 存在 依赖 关系 ,所谓 依赖 关系 就 是 A 软件 依赖 于 B 软件 。 通过 如 
下 命令 可 以 查看 依赖 关系 ， 如 果 存 在 依赖 关系 的 话 APT 会 提出 解决 方案 : 

sudo apt-get check 

上 述 命令 的 执行 结果 如 图 2.4.1.3 所 示 : 


:~$ sudo apt-get check 
正在 读 取 软件 包 列 表 ... 完成 





























系 树 
成 





图 2.4.1.3 检查 依赖 关系 

3、 软 件 安装 

这 个 是 重点 了 ， 安 装 软件 ， 使 用 如 下 命令 : 

sudo apt-get install package-name 

可 以 看 出 上 述 命令 是 由 “apt-get” 和 “install ”组 合 在 一 起 的 ,“package-name” 就 是 要 安装 
的 软件 名 字 ,“apt-get” 负 责 下 载 软件 ,“install” 负 责 安装 软件 。 比 如 我 们 要 安装 软件 Ubunut 下 
的 串口 工具 “minicom”， 我 们 就 可 以 使 用 如 下 命令 : 

sudo apt-get install minicom 


执行 上 述 命令 以 后 就 会 自动 下 载 和 安装 minicom 软件 ， 如 图 2.4.1.3 所 示 : 
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:-$ sudo apt-get install minicom 

正在 读 取 软件 包 列 表 ... 完 
正在 分 析 软 件 包 的 依赖 关系 树 
正在 读 取 状态 信息 ... 完成 
将 会 同时 安装 下 列 软件 : 

lrzsz 
下 列 【 新 】 软 件 包 将 被 安装 : 

lrzsz minicom 
升级 了 9 个 软件 包 ， 新 安装 了 2 TAHE, EMR 0 个 软件 包 ， 有 92 个 软件 包 未 被 升 
级 。 
需要 下 载 306 kB 的 归档 。 
解压 缩 后 会 消耗 1,193 kB 的 额外 空间 。 
您 希望 继续 执行 吗 ? [Y/n] y 
获取 :1 http://cn.archive.ubuntu.com/ubuntu xenial/universe amd64 lrzsz amd64 0.1 
2:21:82 [73-8 KB] 
获取 :2 http://cn.archive.ubuntu.com/ubuntu xenial-updates/universe amd64 minicom 
amd64 2.7-l+deb8ulbuild9.16.04.1 [232 kB] 
BG FÉ 306 kB， 耗 时 3f^ (80.8 kB/s) 
正在 选中 未 选择 的 软件 包 lrzsz. 
(正在 读 取 数 据 库 ... 系统 当前 共 安 装 有 217399 个 文件 和 目录 。 ) 
正 准 备 解 包 .../Lrzsz 0.12.21-8 amd64.deb ... 
正在 解 包 Lrzsz (0.12.21-8) ... 
正在 选中 未 选择 的 软件 包 minicom 
正 准 备 解 包 .../minicom 2.7-1+deb8ulbuiLd0.16.04.1 amd64.deb 
正在 解 包 minicom (2.7-1«deb8ulbuild0.16.04.1) ... 
正在 处 理 用 于 man-db (2.7.5-1) 的 触发 器 ... 
正在 设置 Lrzsz (6.12.21-8) ... 
正在 设置 minicom (2.7-l+deb8ulbuild9.16.04.1) ... 





图 2.4.1.3 安装 minicom 软件 
图 2.4.1.3 就 是 安装 minicom 这 个 软件 的 过 程 ， 在 图 2.4.1.3 中 安装 的 过 程 中 ， 会 有 如 下 所 
示 询 问 : 
您 希望 继续 执行 吗 ”[Ym] 
如 果 和 希望 继续 执行 的 话 就 输入 y， 如 果 不 希望 继 续 执行 的 话 就 输入 n。 安装 完成 以 后 我 们 直 
接 在 终端 输入 如 下 命令 打开 minicom 这 个 串口 软件 : 
minicom -s 


打开 以 后 的 minicom 软件 如 图 2.4.1.4 所 示 : 






































Filenames and 
File transfer protocols 
Serial port setup 


Modem and dialing 
Screen and keyboard 
Save setup as dfl 
Save setup as.. 
Exit 

Exit from Minicom 








图 2.4.1.4 minicom 软件 
关于 minicom 的 使 用 大 家 可 以 上 网 搜索 一 下 ， 这 里 就 不 详细 讲解 了 ， 要 退出 minicom 可 以 
直接 按 下 ESC 键 
4、 软 件 更 新 
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有 时 候 我 们 需要 更 新 软件 ， 更 新 软件 的 话 使 用 命令 

sudo apt-get upgrade package-name 

其 中 package-name 为 要 升级 的 软件 名 字 ， 比 如 我 们 升级 刚刚 安装 的 minicom 这 个 软件 ， 如 
图 2.4.1.5 所 示 : 























:~$ sudo apt-get upgrade minicom 
正在 读 取 软件 包 列 表 ... 完成 
正在 分 析 软 件 包 的 依赖 关系 树 
正在 读 取 状 态 信息 ... 完成 
minicom 已 经 是 最 新 版 (2.7-1«deb8ulbuild0.16.04.1). 
正在 计算 更 新 ... 完成 
下 列 软件 包 的 版 本 将 保持 不 变 : 
ubuntu-minimal 





图 2.4.1.5. 更 新 minicom 软件 

从 图 2.4.1.5 可 以 看 出 ，minicom 已 经 是 最 新 的 了 ， 不 用 更 新 ， 不 过 有 其 它 软件 需要 更 新 ， 
因此 会 自动 更 新 其 它 的 软件 。 

5、 钊 载 软件 

如 果 要 外 载 菜 个 软件 的 话 使 用 如 下 命令 

sudo apt-get remove package-name 

其 中 package-name ZÉ XESAXBUASKfE, EGAL IRI A minicom 这 个 软件 ， 操 作 如 图 
2.4.1.6 所 示 : 



























































:~$ sudo apt-get remove minicom 
.完成 


人 
使 用 'sudo apt autoremove' 来 卸载 它 (它们 )。 
下 列 软件 包 将 被 【 逢 载 】: 

minicom 


升级 了 0 个 软件 包 ， 新 安装 了 0 个 软件 包 ， 要 和 外 载 1 个 软件 包 ， 有 1 个 软件 包 未 被 升 
级 。 

解压 缩 后 将 会 空 出 928 kB 的 空间 。 

您 希望 继续 执行 吗 ? [Y/n] y 

(正在 读 取 数据 库 ... 系统 当前 共 安 装 有 217494 个 文件 和 目录 。 ) 

正在 卸载 minicom (2.7-1+deb8ulbuiLd6.16.04.1) .. 

正在 处 理 用 于 man-db (2.7.5-1) 的 触发 器 ... 





图 2.4.1.6 SUSRAKT- 
从 图 2.4.1.6 中 可 以 看 出 软件 minicom 被 卸载 措 了 。 关 于 APT 下 载 工具 就 讲解 到 这 里 ， 我 
们 用 的 最 多 的 就 是 “sudo apt-get install package-name” 来 下 载 和 安装 软件 。 有 关 Ubunut 其 它 的 
安装 软件 的 方法 打开 可 以 自行 上 网 查阅 学 习 ， 这 里 就 不 一 一 详解 了 。 


2.5 Ubuntu 下 文本 编辑 
2.5.1 Gedit 编辑 器 
进行 文本 编辑 是 最 常用 的 操作 ，Windows 下 我 们 会 使 用 记事 本 来 完成 ， 或 者 其 它 一 些 优秀 


的 文本 编辑 器 ， 比 如 notepad++，Ubuut 下 有 一 个 自 带 的 文本 编辑 器 ， 那 就 是 Gedit。Gedit 是 一 
个 窗口 式 的 编辑 器 ， 关 于 Gedit 的 使 用 前 面 我 们 已 经 讲解 了 。 本 节 我 们 重点 讲解 的 是 另外 一 个 
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编辑 器 : VI/VIM 编辑 器 。 
2.5.2 VI/VIM 编辑 器 
我 们 如 果 要 在 终端 模式 下 进行 文本 编辑 或 者 修改 文件 就 可 以 使 用 VUVIM 编辑 器 ，Ubuntu 























是 VI 编 



































Eu f VI 编辑 器 , 但 是 VI 编辑 器 对 于 习惯 了 Windows 下 进行 开发 的 人 来 说 不 方便 ， 比 如 竟然 
不 能 使 用 键盘 上 的 上 下 左右 键 调整 光标 位 置 。 因 此 我 推荐 大 家 使 用 VIM 编辑 器 ，VIM 编辑 器 


















































辑 器 升级 版 本 ，VI/VIM 编辑 器 都 是 一 种 基于 指令 式 的 编辑 器 ， 不 需要 鼠标 ， 也 没有 全 


























我 们 





单 ， 仅 仅 使 用 键盘 来 完成 所 有 的 编辑 工作 。 




















需要 先 安 装 VIM 编辑 器 ， 命 令 如 下 : 








sudo apt-get install vim 

安装 完成 以 后 就 可 以 使 用 VIM 编辑 器 了 ，VIM 编辑 器 有 3 中 工作 模式 : 输入 模式 、 指 令 
模式 和 底 行 模式 ， 通 过 切换 不 同 的 模式 可 以 完成 不 同 的 功能 ， 我 们 就 以 编辑 一 个 文本 文档 为 例 
讲解 VIM 编辑 器 的 使 用 。 打 开 终 端 ， 输 入 命令 :vi test.txt， 如 图 2.52.1 所 示 : 


:-$ vim test.txt 





























图 2.5.2.1 新 建 test.txt 文档 





























在 终端 中 输入 图 2.5.2.1 中 所 示 的 命令 以 后 就 会 创建 一 个 test.txt 文档 ,并 且 用 VIM 打开 了 ， 
如 图 2.5. 














2.2 所 示 : 


zuozhongkai@ubuntu: ~ 





"test. txt ƏL: 86 
图 2.5.2.2 VIM 打开 的 test.txt 文档 














我 们 试 着 在 图 2.5.2.2 中 输入 数字 , 发 现 根本 没 法 输入 , 这 不 是 因为 你 的 键盘 坏 了 。 因 为 VIM 
默认 是 以 只 读 模式 打开 的 文档 ， 因 此 我 们 要 切换 到 输入 模式 ， 切 换 到 输入 模式 的 命令 如 下 : 





"nw (GO me mme 














在 当前 光标 所 在 字符 的 前 面 ， 转 为 输入 模式 。 

在 当前 光标 所 在 行 的 行 首 转换 为 输入 模式 。 

在 当前 光标 所 在 字符 的 后 面 ， 转 为 输入 模式 。 

在 光标 所 在 行 的 行 尾 ， 转 换 为 输入 模式 。 

在 当前 光标 所 在 行 的 下 方 ， 新 建 一 行 ， 并 转 为 输入 模式 。 
在 当前 光标 所 在 行 的 上 方 ， 新 建 一 行 ， 并 转 为 输入 模式 。 
出 除 光标 所 在 字符 。 

蔡 换 光 标 处 字符 。 
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HX (m 





6 插入 » 


在 图 

















的 就 是 “a” 我们 在 图 2.5.2.2 中 按 下 键盘 上 的 “a” 键 ， 这 时 候 终 端 左 下 角 会 提示 











字样 ， 表 示 我 们 进入 到 了 输入 模式 ， 如 图 2.5.2.3 所 示 : 


zuozhongkai@ubuntu: ~ 














图 2.5.2.3 切换 到 插入 模式 

图 2.5.2.3 表明 我 们 可 以 正常 输入 文本 了 ， 我 们 可 以 输入 图 2.5.2.4 所 示 文 本 : 
zuozhongkai@ubuntu: ~ 

zuozhongkaiM 

123456789, 

ARM 裸 机 与 嵌入 式 Linux 驱 动 开发 。 











图 2.5.2.4 输入 文本 








2.5.2.4 中 我 们 在 test.txt 中 输入 了 字母 、 数 字 和 中 文 , 我 们 输入 完成 以 后 需要 保存 文本 












































啊 ，Windows 下 的 记事 本 可 以 使 用 快捷 键 Ctrl+S 来 保存 ，VIM 是 否 也 可 以 使 用 Ctrl+S 来 保存 
WE? 你 会 发 现 当 你 按 下 Ctrl+S 键 以 后 你 的 终端 不 能 操作 了 !!1! 这 是 因为 在 Ubuntu 下 Ctrl+S 快 





























捷 刍 不 是 用 来 完成 保存 的 功能 的 ， 而 是 暂停 该 终端 ! 所 以 你 一 旦 在 使 用 终端 的 时 候 按 下 Ctrl+S 























快捷 键 ， 那么 你 的 终端 肯定 不 会 再 有 任何 反应 ， 如 果 你 按 下 Ctrl S 关闭 了 当前 终端 的 话 可 以 按 


下 Ctrl+Q 来 重新 打开 终端 


既然 


要 从 VIM 现在 的 输入 模式 切换 到 指令 模式 ， 方 式 就 是 按 下 键盘 的 ESC 键 ， 按 下 ESC 键 以 后 
终端 坐 下 角 的 “插入 ”字样 就 会 消失 ， 此 时 你 就 不 能 在 输入 任何 文本 了 ， 如 果 想 再 次 输入 文本 
的 话 就 按 下 “a” 键 重新 进入 到 输入 模式 。 指 令 模式 顾名思义 就 是 输入 指令 的 模式 ， 这 些 指 令 是 






































Ctrl+S 不 能 保存 文本 文档 ， 那 么 有 没有 其 它 方法 保存 文本 文档 呢 ? 肯 定 是 有 的 ， 我们 
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控制 文本 的 指令 ， 我 们 将 这 些 指令 进行 分 类 ， 如 下 所 示 : 
1、 移 动 光标 指令 : 
h( 或 左 方向 键 ) ”光标 左 移 一 个 字符 。 
1( 或 右 方向 键 ) ”光标 右 移 一 个 字符 。 
j( 或 下 方向 键 ) ”光标 下 移 一 行 。 
k( 或 上 方向 键 ) ”光标 上 移 一 行 。 















































nG 光标 移动 到 第 n 行 首 。 

nt 光标 下 移 n fr. 

n- 光标 上 移 n 行 。 

2、 屏 幕 翻滚 指令 

CtrlHf 屏幕 向 下 翻 一 页 ， 相 当 于 下 一 页 。 
Ctrl+b 屏幕 向 上 翻 一 页 ， 相 当 于 上 一 页 。 














3、 复 制 、 删 除 和 粘贴 指令 


























cc 删除 整 行 ， 并 且 修 改 整 行内 容 。 
dd 删除 改行 ， 不 提供 修改 功能 
ndd 删除 当前 行 向 下 nm fT. 

x 删除 光标 所 在 的 字符 。 

X 删除 光标 前 面 的 一 个 字符 。 
nyy 复制 当前 行 及 其 下 面 n 行 。 

p 粘贴 最 近 复 制 的 内 容 。 














上 面 就 是 VVVIM 的 命令 模式 下 最 常用 的 一 些 命令 ， 还 有 一 些 不 常用 的 我 没有 列 出 来 ， 感 
兴趣 的 可 以 自行 上 网 查阅 。 从 上 面 的 命令 可 以 看 出 ， 并 没有 保存 文本 的 命令 ， 那 是 因为 保存 文 
档 的 命令 是 在 底 行 模式 中 ， 我 们 要 先进 入 到 指令 模式 ， 进 入 底 行 模式 的 方式 是 先进 入 指令 模式 
下 ， 然 后 在 指令 模式 下 输入 “:” 进 入 底 行 模式 ， 如 图 2.52.5 所 示 : 


zuozhongkai@ubuntu: ~ 










































































zuozhongkai 
123456789. 
ARM 裸 机 与 嵌入 式 Linux 驱 动 开发 。 





图 2.5.2.5“:”* 底 行 模式 
在 图 2.5.2.5 中 当 进 入 底 行 模式 以 后 会 在 终端 的 左下 角 就 会 出 现 符 号 “: ”我们 可 以 在 “:” 
后 面 输入 命令 ， 常 用 的 命令 如 下 : 
x ”保存 当前 文档 并 且 退 出 。 
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q 退出 。 
W ”保存 文档 。 
q! ”退出 VVVIM， 不 保存 文档 。 
如 果 我 们 要 退出 并 保存 文本 的 话 需 要 在 “: ” 底 行 模式 下 输入 “wq”， 如 图 2.52.6 所 示 : 
zuozhongkai@ubuntu: ~ 
zuozhongkai 
123456789. 
ARM 裸 机 与 嵌入 式 Linux 驱 动 开 发 。 














图 2.5.2.6 保存 并 退出 VIM 
在 “:” 底 行 模式 下 输入 “wq” 以 后 按 下 回 车 键 就 保存 test.txt 并 退出 VI/VIM 编辑 器 ， 退 出 
以 后 我 们 可 以 使 用 命令 “cat” 来 查看 刚刚 新 建 的 testtxt 文档 的 内 容 ， 如 图 2.5.2.7 所 示 : 
:~ cat test.txt 
























































zuozhongkai 


123456789。 
ARM$& Jl E Ex A zX Linuxik a 7T £ o 


图 2.5.2.7 查看 文档 内 容 




















从 图 2.5.2.7 中 可 以 看 出 ，test.txt 中 的 内 容 就 是 我 们 用 VIM 输入 的 内 容 ， 至 此 我 们 就 完整 
的 进行 了 一 遍 VIVIM 创建 文档 、 编 辑 文档 和 保存 文档 。 
在 上 面 讲解 进入 VIM 的 底 行 模式 的 时 候 之 说 了 在 指令 模式 下 输入 “: ”的 方法 ， 还 可 以 在 
指令 模式 下 输入 “/” 进 入 底 行 模式 ， 输 入 “/” 以 后 如 图 2.5.2.8 所 示 。 
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zuozhongkai(pubuntu: ~ 








图 2.5.2.8 “/” 底 行 模式 
在 “/” 底 行 模式 下 我 们 可 以 在 文本 中 搜索 指定 的 内 容 ， 比 如 搜索 test.txt LP RAR” 
三 个 字 ， 使 用 方法 如 图 2.5.2.9 所 示 : 

















图 2.5.2.9 搜索 文本 
在 “/” 后 面 输入 要 搜索 的 内 容 ， 然 后 按 下 回 车 键 就 会 在 testtxt "PR BU ETE. MRAR” 
匹配 的 部 分 ， 如 图 2.5.2.10 所 示 : 


























zuozhongkai@ubuntu: ~ 
zuozhongkai 
123456789, 
ARM} XL 5 EAA H Linuxiük zh F £ o 





已 查找 到 文件 ... 再 从 开头 继续 查找 3,13-10 


图 2.5.2.10 查找 到 指定 内 容 

图 2.5.2.10 中 可 以 看 出 ， 在 test.txt 中 找到 了 “ 拒 入 式 ” 这 个 词 ， 并 且 标 记 出 来 位 置 。 我 们 
以 后 要 在 一 个 文档 中 搜索 是 否 存在 某 个 字符 串 的 时 候 就 可 以 使 用 这 种 方法 。 有 关 VIVIM 编辑 
器 的 讲解 就 到 这 里 , 我 们 完整 的 练习 了 一 遍 如 何 使 用 VIM 创建 文档 、 编 辑 文档 、 保 存 文档 和 在 
文档 中 搜索 字符 串 。 有 关 更 多 更 详细 的 VIM 编辑 器 的 操作 大 家 自行 上 网 查阅 相关 文档 和 博客 。 
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2.6Linux 文件 系统 
操作 系统 的 基本 功能 之 一 就 是 文件 管理 ， 而 文件 的 管理 是 由 文件 系统 来 完成 的 。Linux X 





























持 多 种 文件 系统 ， 本 节 我 们 就 来 讲解 Linux 下 的 文件 系统 、 文 件 系 统 类 型 、 文 件 系 统 结构 和 文 
件 系 统 相 关 Shell 命令 。 





2.6.1 Linux 文件 系统 简介 以 及 类 型 


1、Linux 文件 系统 简介 

操作 系统 就 是 处 理 各 种 数据 的 ， 这 些 数据 在 硬盘 上 就 是 二 进 制 ， 人 类 肯定 不 能 直接 看 懂 这 
些 二 进 制 数据 ， 要 有 一 个 翻译 器 ， 将 这 些 二 进 制 的 数据 还 原 为 人 类 能 看 懂 的 文件 形式 ， 这 个 工 
作 就 是 由 文件 系统 来 完成 的 ， 文 件 系统 的 目的 就 是 实现 数据 的 查询 和 存储 ， 由 于 使 用 场合 、 使 
用 环境 的 不 同 , Linux 有 多 种 文件 系统 , 不 同 的 文件 系统 支持 不 同 的 体系 。 文件 系统 是 管理 数据 
的 ， 而 可 以 存储 数据 的 物理 设备 有 硬盘 、U 盘 、SD 卡 、NAND FLASH、NOR FLASH、 网 络 存 
储 设备 等 。 不 同 的 存储 设备 其 物理 结构 不 同 ， 不 同 的 物理 结构 就 需要 不 同 的 文件 系统 去 管理 ， 
比如 管理 NAND FLASH 的 话 使 用 YAFFS 文件 系统 ， 管 理 硬盘 、SD 卡 的 话 就 是 ext 文件 系统 
Ak A 

我 们 在 使 用 Windows 的 时 候 新 买 一 个 硬盘 回来 一 般 肯 定 是 将 这 个 硬盘 分 为 好 几 个 盘 , 比如 
C 盘 、D 盘 等 等 。 这 个 叫 磁 盘 的 分 割 ，Linux 下 也 支持 磁盘 分 制 ，Linux 下 常用 的 磁盘 分 割 工具 
Jj: fdisk, fdisk 这 个 工具 我 们 后 面 会 详细 讲解 怎么 用 ， 因 为 我 们 移植 Linux 的 时 候 需 要 将 SD 
卡 分 为 三 个 分 区 来 存储 不 同 的 东西 。 在 Windows 下 我 们 创建 一 个 新 的 盘 符 以 后 都 要 做 格式 化 处 
理 , 格式 化 其 实 就 是 给 这 个 盘 符 创建 文件 系统 的 过 程 ， 我 们 在 Windows 格式 化 某 个 盘 的 时 候 都 
会 让 你 选择 文件 系统 ， 如 图 2.6.1.1 所 示 ; 
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格式 化 ESD-USB (J:) x 

容量 (P): 

28.8 GB v 
文件 系统 (F) 

FAT32 (Ski) 3 
分 配 单元 大 小 (A) 

16 KB v 

还 原 设备 的 默认 值 (D) 





图 2.6.1.1 格式 化 磁盘 

图 2.6.1.1 就 是 格式 化 磁盘 的 时 候选 择 文件 系统 ，Windows 下 一 般 有 FAT. NTFS 和 exFAT 

这 些 文件 系统 。 同样 的 , 在 Linux 下 我 们 使 用 fdisk 创建 好 分 区 以 后 也 是 要 先 在 创建 好 的 分 区 上 
面 创 建文 件 系统 ， 也 就 是 格式 化 。 
在 Windows 下 有 磁盘 分 区 的 概念 ， 比 如 C，D，E RS, Æ Linux 下 没有 这 个 概念 ， 因 此 
Linux 下 你 找 不 到 像 C、D、E 盘 这 样 的 东西 。 前 面 我 们 说 了 Linux 下 可 以 给 磁盘 分 制 ， 但 是 没 
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A C. D. E 盘 那 怎么 访问 这 些 分 区 呢 ? 在 Linux 下 创建 一 个 分 区 并 且 格 式 化 好 以 后 我 们 要 将 其 












































“ 挂 载 ” 到 一 个 目录 下 才能 访问 这 个 分 区 。Windows 的 文件 系统 挂 载 过 程 是 其 内 部 完成 的 ， 用 
户 是 看 不 到 的 ，Linux 下 我 们 使 用 mount 命令 来 挂 载 磁盘 。 挂 载 磁 盘 的 时 候 是 需要 确定 挂 载 点 
的 ， 也 就 是 你 的 这 个 磁盘 要 挂 载 到 哪个 目录 下 。 

2. Linux 文件 系统 类 型 


前 面 我 们 说 了 ， 在 Windows 下 有 FAT. NTFS 和 exFAT 这 样 的 文件 系统 ， 在 Linux 下 又 有 
哪些 文件 系统 呢 ，Linux 下 的 文件 系统 主要 有 ext2, ext3, ext4 等 文件 系统 。Linux 还 支持 其 他 
的 UNIX 文件 系统 ， 比 如 XFS、JS、UFS 等 ， 也 支持 Windows If] FAT 文件 系统 和 网 络 文件 系 
统 NFS 等 。 这 里 我 们 主要 讲 一 下 Linux 自 带 的 ext2、ext3 和 ext4 文件 系统 。 


ext2 文件 系统 : 


ext2 是 Linux 早期 的 文件 系统 , 但 是 随 着 技术 的 发 展 ext2 文件 系统 已 经 不 推荐 使 用 了 , ext2 
是 一 个 非 日 志文 件 系 统 ,大 多 数 的 Linux 发 行 版 都 不 支持 ext2 文件 系统 了 。 

ext3 文件 系统 : 

ext3 是 在 ext2 的 基础 上 发 展 起 来 的 文件 系统 ， 完 全 兼容 ext2 文件 系统 ，ext3 是 一 个 日 志文 
件 系统 ，ext3 支持 大 文件 ，ext3 文件 系统 的 特点 有 如 下 : 
高 可 靠 性 : 使 用 ext3 文件 系统 的 话 ， 即 使 系统 非 正常 关机 、 发 生死 机 等 情况 ， 恢 复 ext3 X 
件 系统 也 只 需要 数 十 秒 。 

数据 完整 性 : ext3 提高 了 文件 系统 的 完整 性 ， 避 人 免 意 外 死机 或 者 关机 对 文件 系统 的 伤害 。 

文件 系统 速度 : ext3 的 日 志 功 能 对 磁盘 驱动 器 读 写 头 进 行 了 优化 , 文件 系统 速度 相对 与 ext2 
来 说 没有 降低 。 

数据 转换 : 从 ext2 转换 到 ext3 非常 容易 ， 只 需要 两 条 指令 就 可 以 完成 转换 。 用 户 不 需要 花 
时 间 去 备份 、 恢 复 、 格 式 化 分 区 等 ， 用 ext3 文件 系统 提供 的 工具 tune2fs 即 可 轻松 的 将 ext2 X 
件 系统 转换 为 ext3 日 志文 件 系 统 。ext3 文件 系统 不 需要 经 过 任何 修改 , 可 以 直接 挂 载 成 ext2 X 
件 系统 。 

ext4 文件 系统 : 

ext4 文件 系统 是 在 ext3 上 发 展 起 来 的 ，ext4 相 比 与 ext3 提供 了 更 佳 的 性 能 和 可 靠 性 ， 并且 
功能 更 丰富 ，ext4 向 下 兼容 ext3 和 ext2， 因 此 可 以 将 ext2 和 ext3 挂 载 为 ext4。 那 么 我 们 安装 
的 Ubuntu 使 用 的 哪个 版 本 的 文件 系统 呢 ? 在 终端 中 输入 如 下 命令 来 查询 当前 磁盘 挂 载 的 喻 文 



















































































































































































































































































AE 安 可 用 BA% 挂 载 点 
devtmpfs : 3.9G % /dev 


tmpfs 3 787M % /run 

ext4 177G / 

tmpfs ; 3.9G l1% /dev/shm 

tmpfs : i 5.0M l1% /run/lock 

tmpfs i 3.9G 0% /sys/fs/cgroup 

tmpfs 796M 1% /run/user/1000 

图 2.6.1.2 Ubuntu 使 用 的 文件 系统 

在 图 2.6.1.2 中 ， 框 起 来 的 就 是 我 们 安装 Ubunut 的 这 个 磁盘 ， 在 Linux 下 一 切 皆 为 文件 ， 
“/dev/sdal” 就 是 我 们 的 磁盘 分 区 ， 可 以 看 出 这 个 磁盘 分 区 类 型 是 ext4， 它 的 挂 载 点 是 “/” 也 
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就 是 根 目录 。 


2.6.2 Linux 文件 系统 结构 





本 地 磁盘 (C:) 
名 称 


T $WINDOWS.-BT 
$Windows.-WS 

T AppData 

T DRMsoft 

T ESD 

^ Intel 


三 M1530 MFP Series Basic Solution 


| perfLogs 

^. Program Files 

^. Program Files (x86) 
ProgramData 

^ touchgfx-env 

^ TouchGFXProjects 

- uacdump 

T Users 

^ Windows 

$] InstallConfig.ini 








根 目 录 之 类 的 。 其 实 如 果 你 的 Windows 


修改 日 期 


2017-01-18 10:25 
2017-12-17 11:34 
2018-08-27 14:47 
2017-09-07 11:24 
2017-12-17 12:11 
2016-09-07 15:13 
2016-12-29 23:30 
2016-07-16 19:47 
2017-12-13 15:08 
2018-12-18 0:04 

2018-12-17 21:57 
2017-12-05 11:37 
2018-01-07 11:22 
2016-11-28 12:39 
2016-09-08 13:00 
2018-10-31 23:49 
2017-10-13 23:12 





aem 
文件 夫 
文件 夹 
文件 去 
文件 夫 
文件 去 
文件 志 
文件 夫 
X 
文件 夹 
文件 去 
文件 赤 
Su 
文件 志 
LHR 
文件 夫 
Xt 
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在 Windows 下 直接 打开 C 盘 ， 我 们 进入 的 就 是 C. 盘 的 根 目 录 ， 打 开 DD 盘 进 入 的 就 是 D fi 
的 根 目录 ， 比 如 C 盘 根 目 录 如 下 : 


大 小 


配置 设置 1 KB 


2.6.2.1 C SR Eo 


在 Linux 下 因为 没有 C、D 盘 之 说 ， 因 此 Linux 只 有 一 个 根 目 录 ， 没 有 C SUR Ho. D 盘 
只 有 一 个 C 盘 的 话 那 么 整个 系统 也 就 只 有 一 个 根 目录 。 





Windows 下 的 C 盘 根 目录 就 是 “C:”, 在 Linux 下 的 根 目录 就 是 “/” 你 没有 看 错 ，Linux 根 目 
录 就 是 用 “/” 来 表示 的 ， 打 开 Ubuntu 的 文件 浏 


2.6.2.2 所 示 : 





Ubuntu 桌面 


VA 
Ji» 








文件 浏览 器 在 左 侧 的 导航 栏 ， 图 标 如 图 


2.6.2.2 文件 浏览 器 
打开 以 后 的 文件 浏览 器 如 图 2.6.2.3 所 示 : 
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主 文件 夹 


[^ 52-4 








CO 最 近 使 用 的 一 
一 
tmp 
m 桌面 
m 视频 E- 
向 EH ^ ems 
图 片 文档 
口 文档 
$ TE EJ 
dd 音乐 sm test.txt 
D 回收 站 
R 网 络 


图 计算 机 
O 连接 到 服务 器 
图 2.6.2.3 文件 浏览 
直接 打开 文件 浏览 器 以 后 ， 我 们 默认 不 是 处 于 根 目录 中 的 ， 不 像 Windows， 我 们 直接 打开 
C 盘 就 处 于 C 盘 根 目 录 下 。Ubuntu 是 支持 多 用 户 的 ，Ubuntu 为 每 个 用 户 创 建 了 一 个 根 目录 ， 比 
如 我 电脑 现在 登陆 的 是 “zuozhongkai” 这 个 用 户 ， 因 此 默认 进入 的 是 “zuozhongkai” 这 个 用 户 
的 根 目 录 。 我 们 点 击 图 2.62.3 中 左 侧 的 “计算 机 ” 打开 以 后 如 图 2.6.2.4 PTR: 


最 近 使 用 的 当前 路 径 为 "/” 
Home 

桌面 

视频 


E :E 
; 9 
3 


文档 
下 载 


zx 
E d 


&E 8 «o mo9oà Nbo 
3 8 
2: a 
S 3 


网 络 


9 


O sn Oo O 计算 机 
D 连接 到 服务 器 å d 连接 到 服务 器 f 


run sbin 


3 
D 


点 击 " 计 算 机 “进入 根 目录 


A 
initrd.img.old 


A 
vmlinuz.old 选中 了 “home” (含有 1 项 ) 


2.6.2.4 根 目录 “/” 
2.6.2.4 就 是 Ubuntu 的 根 目录 “/”， 这 时 候 肯 定 就 有 人 有 疑问 ， 刚 刚 说 Ubuntu 会 给 每 个 
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用 户 创 建 一 


所 谓 的 给 每 个 月 
以 我 的 “zuo 
只 要 你 创建 了 一 个 用 户 ， 忆 
夹 就 是 这 个 用 户 的 根 目 
录 下 的 文件 进行 随意 的 读 写 操 作 ， 但 是 如 果 要 修改 根 目录 “/” 
BARAR, EURIA 
2.6.2.5 所 示 : 


一 个 文件 夹 ， 


夹 ， 这 个 文件 





用 户 可 以 对 自己 的 用 户 根 目 


下 的 文件 就 会 提示 没有 权限 。 打 开 终 端 以 后 默认 进入 的 是 当前 月 
以 后 输入 “1s” 命 令 查看 当前 目录 下 有 什么 文件 
:~$ ls 
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个 根 目录 ， 那 这 些 用 户 的 根 目录 在 哪里 

















b 么 系统 就 会 
录 。 
































examples.desktop 


在 /home i 


户 创 建 一 个 根 目 录 只 是 方便 说 而 已 ， 这 个 所 谓 的 用 户 根 目录 
zhongkai” 这 个 用 户 为 例 ， 





a? 是 不 是 和 根 目录 “/” 














是 一 个 地 位 的 ? 



































， 结 果 如 图 





其 实 就 是 “/” 下 的 
其 用 户 根 目录 就 是 : /home/zuozhongkai。 
这 个 目录 下 创建 一 个 以 这 个 用 户 名 命名 的 文件 





I] 





test.txt 


可 以 看 出 图 2.6.2.5 中 的 文件 和 
录 。 我 们 来 看 一 下 根 目 
// 进 入 到 根 目录 “/ 
// 查 看 根 目录 “/” 下 的 文件 以 及 文件 夹 





cd / 
Is 





图 2.62. 











图 2.6.2.3 H 


5 目录 查看 











执行 上 述 两 行 命令 以 后 ， 终 端 如 图 2.6.2.6 所 示 : 





FPF 的 一 模 一 样 ， 都 是 “zuozhongkai” 这 
录 “/” 下 都 有 哪些 文件 ， 在 终端 中 输入 如 下 命令 : 


个 账户 的 根 








图 2.6.2.6 查看 根 目 


录 «m 
















































































































































































































































































图 2.6.2.6 中 列举 出 了 根 目 录 “/” 下 面 的 所 有 文件 夹 ， 这 里 我 们 仔细 观察 一 下 ， 当 我 们 进入 
到 根 目录 “/” 里 面 以 后 终端 提示 符 “$” 前 面 的 符号 “~” 变 成 了 “/” 这 是 因为 当 我 们 在 终端 
中 切换 了 目录 以 后 “$” 前 面 就 会 显示 切换 以 后 的 目录 路 径 。 我们 来 看 一 下 根 目录 “/” 中 的 一 些 
重要 的 文件 夹 : 

/bin 存储 一 些 二 进 制 可 执行 命令 文件 ，Asrbin 也 存放 了 一 些 基于 用 户 的 命令 文件 。 

/sbin 存储 了 很 多 系统 命令 ，/ust/sbin 也 存储 了 许多 系统 命令 。 

/root ERAF root 的 根 目 录 文 件 。 

home ”普通 用 户 默认 目录 ， 在 该 目录 下 ， 每 个 用 户 都 有 一 个 以 本 用 户 名 命名 的 文件 夹 。 

/boot “存放 Ubuntu 系统 内 核 和 系统 启动 文件 。 

/mnt 通常 包括 系统 引导 后 被 挂 载 的 文件 系统 的 挂 载 点 。 

/dev 存放 设备 文件 ， 我 们 后 面 学 习 Linux 驱动 主要 是 跟 这 个 文件 夹 打交道 的 。 

lete 保存 系统 管理 所 需 的 配置 文件 和 目录 。 

/lib 保存 系统 程序 运行 所 需 的 库 文件 ，/usr/lib 下 存放 了 一 些 用 于 普通 用 户 的 库 文件 。 

/losttfound 一般 为 空 ， 当 系统 非 正 常 关机 以 后 ， 此 文件 夹 会 保存 一 些 零散 文件 。 

Ivar 存储 一 些 不 断 变化 的 文件 ， 比 如 日 志文 件 

/usr 包括 与 系统 用 户 直接 有 关 的 文件 和 目录 ， 比 如 应 用 程序 和 所 需 的 库 文 件 。 

/media 存放 Ubuntu 系统 自动 挂 载 的 设备 文件 。 

/proc ”虚拟 目录 ， 不 实际 存储 在 磁盘 上 ， 通 常用 来 保存 系统 信息 和 进程 信息 。 

/tmp ”存储 系统 和 用 户 的 临时 文件 ， 该 文件 夹 对 所 有 的 用 户 都 提供 读 写 权限 。 

/opt 可 选 文件 和 程序 的 存放 目录 。 

/sys 系统 设备 和 文件 层次 结构 ， 并 向 用 户 程序 提供 详细 的 内 核 数据 信息 。 
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2.6.2 文件 操作 命令 

本 节 我 们 来 学 习 一 下 在 终端 进行 文件 操作 的 一 些 常 用 命令 : 

1、 创 建新 文件 命令 一 touch 
在 前 面 学 习 VIM 的 时 候 我 们 知道 可 以 用 vi 指令 来 创建 一 个 文本 文档 ， 本 节 我 们 就 学 习 一 
个 功能 更 全 面 的 文件 创建 命令 一 touch。touch 不 仅仅 可 以 用 用 来 创建 文本 文档 ， 其 它 类 型 的 文 
档 也 可 以 创建 ， 命 令 格式 如 下 : 

touch [2X] [文件 名 ] 

使 用 touch 创建 文件 的 时 候 ， 如 果 [ 文 件 名 ] 的 文件 不 存在 ， 那 就 直接 创建 一 个 以 [文件 名 ] 命 
名 的 文件 ， 如 果 [ 文 件 名 ] 文 件 存 在 的 话 就 仅仅 修改 一 下 此 文件 的 最 后 修改 日 期 ， 常 用 的 命令 参 
数 如 下 : 

-a ”只 更 改 存 取 时 间 。 

-Cc ”不 建立 任何 文件 。 

-d< 日 期 > 使 用 指定 的 日 期 ， 而 并 非 现 在 日 期 。 

-t< 时 间 > 使 用 指定 的 时 间 ， 而 并 非 现在 时 间 。 

进入 到 用 户 根 目录 下 ， 直 接 使 用 命令 “cd~” 即 可 快速 进入 用 户 根 目录 , 进入 用 户 根 目录 以 
后 使 用 touch 命令 创建 一 个 名 为 test 的 文件 ， 创 建 过 程 如 图 2.6.2.1 所 示 : 





















































































































































SAES 


examples . desktop 


:~$ touch test 
:~$ ls test 


$ ls test -l 
- 1 Suoshondkai zuozhongkai 0 12H 22 01:24 test 








图 2.6.2.1 touch 命令 操作 
2、 文 件 夹 创建 命令 一 mkdir 
既然 可 以 创建 文件 ， 那 么 肯定 也 可 以 创建 文件 夹 ， 创 建文 件 夹 使 用 命令 “mkdir”， 命 令 格 

式 如 下 : 
mkdir | [参数 ] ”[ 文 件 夹 名 目录 名 ] 

主要 参数 如 下 : 

-p ”如 所 要 创建 的 目录 其 上 层 目 录 目 前 还 未 创建 ， 那 么 会 一 起 创建 上 层 目 录 。 
我 们 在 用 户 根 目录 下 创建 两 个 分 别名 为 “testdir1 ”和 “testdir2” 的 文件 夹 ， 操作 如 图 2.6.2.2 

所 示 : 



































:~$ ls 
examples .desktop i txt 
test 

:~$ mkdir testdirl 


:-$ mkdir testdir2 

:~$ ls 
examples.desktop test.txt 
test 








图 2.6.2.2 创建 文件 夹 
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在 图 2.6.2.2 中 ， 我 们 使 用 命令 “mkdir” 创 


3、 文 件 及 目录 删除 命令 一 rm 


既然 有 创建 文件 的 命令 ， 那 肯定 有 删除 文 从 
命令 “rm”， 此 命令 可 以 完成 删除 一 个 
链接 文件 ， 只 删除 链接 ， 原 文件 保持 不 变 ， 
文件 ， 此 命令 格式 如 下 : 

rm [参数 ] [目的 文件 

命令 主要 参数 如 下 : 

-d 

-f 


-i 




















所 谓 








或 文件 夹 目录 名 ] 





强制 删除 文件 和 文件 夹 (目录 )。 

删除 文件 或 者 文件 夹 (目录 ) 之 前 先 询问 
递归 删除 ， 指 定 文件 夹 (目录 ) 下 的 所 有 
显示 删除 过 程 。 











-r 


-V 








HH 


我 们 使 用 rm 命令 来 删除 前 面 使 用 命 








文件 或 者 多 个 文人 


直接 把 要 删除 的 目录 的 硬 连接 数据 删 成 0， 


4 "touch" Gf] test 文件， 操作 过 程 如 


论坛 :www.opendev.com 





建 了 “testdir1” 和 “testdir2” 这 两 个 文件 夹 。 














F 的 命令 ， 要 删除 一 个 文件 或 者 文件 夹 可 以 使 用 
F 及 文件 夹 ， 它 可 以 实现 递归 删除 。 对 于 
的 链接 文件 ， 其 实 就 是 Windows 下 的 快捷 方式 

















删除 该 目录 。 


HP. 
文件 和 子 文 件 夹 全 部 删除 掉 。 








图 2.6.2.3 所 














Lo 3E E- 
examples .desktop test.txt 
test 
:-$ rm test 
:-$ ls 
examples . desktop 
test.txt 
图 2.6.2.3 删除 文件 
命令 “rm” 也 可 以 直接 删除 文件 夹 ， 我 们 可 以 试 一 下 删除 前 面 创建 的 testdirl 文件 夹 ， 先 直 
接 使 用 命令 “rm testdir1 ”测试 一 下 是 否 可 以 删除 ， 结 果 如 图 2.6.2.4 所 示 : 





:-$ rm testdirl 





rm: 无 法 删除 'testdirl': 是 一 个 目录 


图 2.6.2.4 删除 文 伯 























在 图 2.6.2.4 中 可 以 看 出 ， 直 接 使 用 命令 “rm” 是 无 法 删除 文件 夹 (目录 ) 的 ， 我 们 需要 加 上 
参数 “-rf”， 也 就 是 强制 递归 删除 文件 夹 (目录 )， 操 作 结 果 如 图 2.6.2.5 所 示 : 





:~$ ls 
examples .desktop 
test.txt 


:-$ rm testdirl -rf 


=$ LS 
examples .desktop test.txt 

















ME 2.6.2.5 可 以 看 出 , 当 在 命令 
Te 

4、 文 件 夹 (目录 ) 删 除 命令 一 rmdir 

上 面 我 们 讲解 了 如 何 使 用 命令 “rm” 删 除 文 件 
供 





命令 格式 如 下 : 


图 2.6.2.5 带 参 数 删 除 文件 夹 
rm” 中 加 入 参数 “-rf” 以 后 就 可 以 删除 掉 文 件 夹 “testdir1 " 








夹 ， 那 就 是 要 加 上 参数 “-rf”， 其 实 Linux 提 


了 直接 删除 文件 夹 (目录 ) 的 命令 一 rmdir， 它 可 以 不 加 任何 参数 的 删除 掉 指 定 的 文件 夹 (目录 )， 
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rmdir [参数 ] [文件 夹 (目录 )] 
命令 主要 参数 如 下 : 
-P ”删除 指定 的 文件 夹 (目录 ) 以 后 ， 若 上 层 文件 夹 (目录 ) 为 空 文件 夹 ( 目 录 ) 的 话 就 将 其 一 起 



































我 们 使 用 命令 “rmdir” 删 除 掉 前 面 创建 的 “testdir2” 文 件 夹 ， 操 作 过 程 如 图 2.6.2.6 所 示 : 


:~$ ls 
examples.desktop test.txt 














:~$ rmdir testdir2 
:~$ ls 


examples.desktop 
test.txt 








图 2.6.2.6 命令 rmdir 删除 文件 夹 
5、 文 件 复制 命令 一 cp 
在 Windows 下 我 们 可 以 通过 在 文件 上 点 击 鼠 标 右 键 来 进行 文件 的 复制 和 粘贴 ， 在 Ubuntu 
下 我 们 也 可 以 通过 点 击 文件 右键 进行 文件 的 复制 和 粘贴 。 但 是 本 节 我 们 来 讲解 如 何在 终端 下 使 
用 命令 来 进行 文件 的 复制 ，Linux 下 的 复制 命令 为 “cp”， 命 令 描 述 如 下 : 

cp [2X] ”[ 源 地 址 ] [目的 地 址 ] 
主要 参数 描述 如 下 : 

-a ”此 参数 和 同时 指定 “-dpR” 参 数 相 同 

-d 在 复制 有 符号 连接 的 文件 时 ， 保 留 原 始 的 连接 。 

地。 强行 复制 文件 ， 不 管 要 复制 的 文件 是 否 已 经 存在 于 目标 目录 。 

-I ” 禾 盖 现 有 文件 之 前 询问 用 户 。 

-Pp ”保留 源 文件 或 者 目录 的 属性 。 

-r HER 递归 处 理 ， 将 指定 目录 下 的 文件 及 子 目 录 一 并 处 理 

我 们 在 用 户 根 目 录 下 ， 使 用 前 面 讲解 的 命令 “mkdir” 创 建 两 个 文件 夹 : testl 和 test2， 过 程 
如 图 2.6.2.7 所 示 。 












































































































































:~$ ls 


examples .desktop 
test.txt 
:-$ mkdir testl test2 
:~$ ls 
examples.desktop 





test.txt 
图 2.62.7 创建 testl 和 test2 两 个 文件 夹 
进入 上 面 创建 的 testl 文件 夹 ， 然 后 在 test. 文件 夹 里 面 创建 一 个 a.c 文件 ， 操 作 过 程 如 图 
2.6.2.8 所 示 : 














:~$ cd test1 
$ touch a.c 


$ ls 





图 2.6.2.8 创建 a.c 文件 
我 们 先 将 图 2.6.2.8 中 的 ac 这 个 文件 做 个 备份 ， 也 就 是 复制 到 同文 件 夹 testl 里 面 ， 新 的 文 
件 命 名 为 b.c。 然 后 在 将 testl 文件 夹 中 的 ac 和 b.c 这 两 个 文件 都 复制 到 文件 夹 test2 P, HF 
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如 图 2.6.2.9 所 示 





cp a-c D-E 
ls 


Me ee test 
cd ::/test2 
ls 





图 2.6.2.9 找 贝 文件 
在 图 2.6.2.9 中 ， 我 们 添加 了 一 些 高 级 使 用 技巧 ， 首 先是 拷贝 ac 和 b.c 文件 到 test2 文件 夹 
中 , 我 们 使 用 了 通配符 “*”“*.c” 就 表示 testl 下 的 所 有 以 “.c” 结尾 的 文件 , 也 就 是 ac fI b.c. 
“../test2” 中 的 “../” X Lans. 因此 “../test2” 就 是 上 级 目录 下 的 test2 文件 夹 。 
上 面 都 是 文件 复制 , 我 们 接 下 来 学 习 一 下 文件 夹 复 制 , 我 们 将 test2 文件 夹 复制 到 同 目录 下 ， 
新 拷贝 的 文件 夹 命 名 为 test3， 操 作 如 图 2.6.2.10 所 示 : 
:~$ cp -rf test2/ test3/ 


:~$ ls 
examples .desktop test.txt 









































:-$ cd test3 
$ l5 








图 2.6.2. 10. 拷贝 文件 夹 
6、 文 件 移动 命令 一 mv 
有 时 候 我 们 需要 将 一 个 文件 或 者 文件 夹 移动 到 另外 一 个 地 方 去 ， 或 者 给 一 个 文件 或 者 文件 
夹 进行 重 命名 ， 这 个 时 候 我 们 就 可 以 使 用 命令 “mv” 了 ， 此 命令 格式 如 下 : 

mv [参数 ] ”[ 源 地 址 ] [目的 地 址 ] 
主要 参数 描述 如 下 : 

-b ”如果 要 履 盖 文件 的 话 履 盖 前 先进 行 备份 。 

-f 若 目 标 文 件 或 目录 与 现在 的 文件 重复 ， 直 接 履 盖 目 的 文件 或 目录 。 

-I 在 覆盖 之 前 询问 用 户 。 

使 用 上 面 讲解 “cp” 命 令 的 时 候 创建 了 三 个 文件 夹 ， 在 上 面 创建 的 test! 文件 夹 里 面 创建 一 
个 c.c 文件 ， 然 后 将 c.c 这 个 文件 重 命名 为 d.c。 最 后 将 d.c 这 个 文件 移动 到 test2 文件 夹 里 面 ， 
操作 如 图 2.6.2.11 所 示 : 

:~$ cd test1 


$ touch c.c 
$ ls 




















































































































$ mv-c-c d.c 
$ ls 





图 2.6.2.11 移动 文件 操作 
我 们 再 将 testl 中 的 d.c 文件 移动 到 test2 文件 夹 里 面 ， 操 作 如 图 2.6.2.12 所 示 : 
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$ ls 





D-E 
$ cd :./testi 
$ ls 


$ mv d.c ../test2 
二 -LS /test2 


图 2.6.2.12 移动 文件 操作 





2.6.3 文件 压缩 和 解压 缩 








文件 的 压缩 和 解压 缩 是 非常 常见 的 操作 ， 在 Windows 下 我 们 有 很 多 压缩 和 解压 缩 的 工具 ， 
比如 zip. 360 压缩 等 等 。 在 Ubuntu 下 也 有 压缩 工具 ， 本 节 我 们 学 习 Ubuntu 下 图 形 化 以 及 命令 
行 这 两 种 压缩 和 解压 缩 操作 。 

1、 图 形 化 压缩 和 解压 缩 


图 形 化 压缩 和 解压 缩 和 Windows 下 基本 一 样 ， 在 要 压缩 或 者 解压 的 文件 上 点 击 鼠 标 右键 ， 
然后 选择 要 进行 的 操作 ， 我 们 先 讲 解 一 下 如 何 进行 文件 的 压缩 。 首 先 找 到 要 压缩 的 文件 ， 然 后 
在 要 压缩 的 文件 上 点 击 和 鼠标 右 键 ， 选 择 “ 压 缩 ” 选 项 ， 如 图 2.6.3.1 所 示 : 



















































































EE ^E (P) 
图 2.63.1. 文件 压缩 
在 图 2.6.3.1 中 我 们 要 对 test2 这 个 文件 夹 进 行 压 缩 ， 点 击 “ 压 缩 ” 以 后 会 弹出 图 2.6.3.2 所 
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示 界 面 让 选择 压缩 后 的 文件 名 和 压缩 格式 。 


文件 名 (F): .targz v 





位 置 (LU) : ifi zuozhongkai = 





, 其 它 选 项 (O) 
wao | | aen | 
图 2.6.3.2 压缩 命名 和 格式 选择 


在 图 2.6.3.2 中 , 设置 好 压缩 以 后 的 文件 名 , 然后 选择 压缩 格式 , 可 选 的 压缩 格式 如 图 2.6.3.3 
所 示 : 











„tar 
| .tar.Z 
.tar.bz2 
-tar.gz 
| .tar.lz 
.tar.lzma 
.tar.lzo 
.tar.xz 
.War 
.XZ 
.Zip 
2.6.3.3 可 选 压 缩 格 式 

从 图 2.6.3.3 中 可 以 看 出 ， 可 以 选择 的 压缩 格式 还 是 有 很 多 的 ， 挑 选 一 个 格式 进行 压缩 ， 比 

如 我 选择 的 “.zip” 这 个 格式 ， 压 缩 完 成 以 后 如 图 2.6.3.4 所 示 : 
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主 文件 夹 


合 主 文件 夹 






test.txt 
因 计算 机 
B 


连接 到 服务 器 





选中 了 “test2.zip”(600 字 节 ) 


图 2.6.3.4 压缩 完成 的 文件 
上 面 就 是 使 用 图 形 化 进行 文件 压缩 的 过 程 , 我 们 接 下 来 对 刚刚 压缩 的 test2.zip 进行 解压 缩 ， 
鼠标 放 到 test2.zip 上 然后 点 击 鼠 标 右键 ， 选 择 “ 提 取 到 此 处 ” 如 图 2.6.3.5 所 示 : 








éd 使 用 归档 管理 器 打开 (O) 





2.6.3.5 解压 缩 文 件 
点 击 图 2.6.3.5 中 的 “提取 到 此 处 ”以 后 ,系统 就 会 自动 进行 解压 缩 ， 上 面 就 是 在 Ubuntu 中 
使 用 图 形 化 工具 进行 文件 的 压缩 和 解压 缩 。 


2、 命 令 行 进行 文件 的 压缩 和 解压 缩 
上 面 我 们 学 习 了 如 何 使 用 图 形 化 工具 在 Ubunut 下 进行 文件 的 压缩 和 解压 缩 ， 本 节 我 们 学 






































学 如 何 使 用 命令 行进 行 压缩 和 解压 缩 ， 我 们 后 面 的 开发 中 所 有 涉及 到 压缩 和 解压 缩 的 操作 都 是 
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在 命令 行 下 完成 的 。 命 令 行 下 进行 压缩 和 解压 缩 常 用 的 命令 有 三 个 : zip. unzip 和 tar， 我 们 依 
次 来 学 习 : 
QD. fir4 zip 
zip 命令 看 名 字 就 知道 是 针对 .zip 文件 的 ， 用 于 将 一 个 或 者 多 个 文件 压缩 成 一 个 .zip 结尾 的 
文件 ， 命 令 格式 如 下 : 
zip [参数 ] [压缩 文件 名 .zip] ” [被 压缩 的 文件 ] 
主要 参数 函数 如 下 : 
-b< 工 作 目 录 > 指定 暂时 存放 文件 的 目录 。 
-d 从 zip 文件 中 删除 一 个 文件 。 
-F ”尝试 修复 已 经 损毁 的 压缩 文件 。 
-g ”将 文件 压缩 入 现 有 的 压缩 文件 中 ， 不 需要 新 建 压缩 文件 。 
-h 帮助 。 
-j 只 保存 文件 的 名 ， 不 保存 目录 。 
-m 压缩 完成 以 后 删除 源 文件 。 
-n< 字 尾 符号 > ”不 压缩 特定 扩展 名 的 文件 。 
-q ”不 显示 压缩 命令 执行 过 程 。 
c ”递归 压缩 ， 将 指定 目录 下 的 所 有 文件 和 子 目 录 一 起 压缩 。 
-Vv ”显示 指令 执行 过 程 。 
-num ”压缩 率 ， 为 1~9 的 数值 。 
上 面 讲解 了 如 何 使 用 图 形 化 压缩 工具 对 文件 夹 test2 进行 压缩 ,这 里 我 们 使 用 
test2 文件 夹 进行 压缩 ， 操 作 如 图 2.6.3.6 所 示 ; 




















































































































Ed 
A 





4€ zip » 对 




















:~$ ls 
examples.desktop test.txt 


:~$ 2 -rv test2.zip test2 
adding: test2/ (in=0) (out=0) (stored 


adding: test2/d.c in=0) (out=0) (stored 


) ( 
(i ) ( 
adding: test2/b.c (in=0) (out=0) (stored 
(i ) ( 
-> 


adding: test2/a.c in=0 
total bytes=0, compressed=0 
:~$ ls 


(out=0) (stored 
0% savings 


examples .desktop 
test.txt 


图 2.6.3.6 使 用 zip 进行 文件 压缩 
图 2.6.3.6 就 是 使 用 zip 命令 进行 test2 文件 夹 的 压缩 ， 我 们 使 用 的 命令 如 下 : 
pe -TV test2.zip test2 

述 命令 中 ，-rv 表示 递归 压缩 并 且 显示 压缩 命令 执行 过 程 。 
© 命令 unzip 
unzip 命令 用 于 对 .zip 格式 的 压缩 包 进 行 解 压 ， 命 令 格式 如 下 : 
unzip ”[ 参 数 ] [压缩 文件 名 .zip] 
































x 





-1 ”显示 压缩 文件 内 所 包含 的 文件 。 
t ”检查 压缩 文件 是 否 损 坏 ， 但 不 解压 。 
-V ”显示 命令 显示 的 执行 过 程 。 


-Z 只 显示 压缩 文件 的 注解 。 
-C 压缩 文件 中 的 文件 名 称 区 分 大 小 写 
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-j 不 处 理 压缩 文件 中 的 原 有 目录 路 径 。 
-L 将 压缩 文件 中 的 全 部 文件 名 改 为 小 写 。 
-n ”解压 缩 时 不 要 宪 盖 原 有 文件 。 
-P< 密码 > 解压 密码 。 
-qd 静默 执行 ， 不 显示 任何 信息 。 
-X< 文 件 列表 > 指定 不 要 处 理 .zip 中 的 哪些 文件 。 
-d< 目 录 > ”把 压缩 文件 解 到 指定 目录 下 。 
对 上 面 压缩 的 test2.zip 文件 使 用 unzip 命令 进行 解压 缩 ， 操 作 如 图 2.6.3.7 所 示 : 


:~$ rm -rf test2 
:~$ ls 
examples.desktop test. txt 












































:~$ unzip test2.zip 
Archive: test2.zip 
creating: test2/ 
extracting: test2/d.c 
extracting: test2/b.c 
extracting: test2/a.c 
:~$ ls 


examples . desktop 


test.txt 
图 2.6.3.7 命令 unzip 使 用 演示 











©, MA tar 

















我 们 前 面 讲 的 zip 和 unzip 这 两 个 是 命令 只 适用 于 .zip 格式 的 压缩 和 解压 ， 其 它 压 缩 格式 就 
用 不 了 了 ， 比 如 Linux 下 最 常用 的 .bz2 和 .gz 这 两 种 压缩 格式 。 其 它 格式 的 压缩 和 解压 使 用 命令 

















tar, tar 将 压缩 和 解压 缩 集合 在 一 起 ， 使 用 不 同 的 参数 即 可 ， 命 令 格式 如 下 : 
tar [参数 ] [压缩 文件 名 ] [被 压缩 文件 名 ] 

常用 参数 如 下 : 

-c 创建 新 的 压缩 文件 。 

-C< 目 的 目录 > ”切换 到 指定 的 目录 。 

-f< 备 份 文件 > 指定 压缩 文件 。 

-j 用 tar 生 成 压缩 文件 ， 然 后 用 bzip2 进行 压缩 。 

-k 解 开 备 份 文 件 时 ， 不 覆盖 已 有 的 文件 。 

-m 还 原文 件 时 ， 不 变更 文件 的 更 改 时 间 。 

-r ”新 增 文件 到 已 存在 的 备份 文件 的 结尾 部 分 。 

-t ” 列 出 备份 文件 内 容 。 

-Vv ”显示 指令 执行 过 程 。 

-w ”遭遇 问题 时 先 询问 用 户 。 

-x ”从 备份 文件 中 释放 文件 ， 也 就 是 解压 缩 文 件 。 

-z 用 tar 生 成 压缩 文件 ， 用 gzip 压缩 。 

-Z H tar 生成 压缩 文件 ， 用 compress 压缩 。 

使 用 tar 命令 来 进行 .zip 和 .gz 格式 的 文件 压缩 ， 操 作 如 图 2.6.3.8 所 示 : 
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zuozhongkai@ubuntu:~$ ls 
exampLes .desktop test2 test.txt 公共 的 视频 文档 

test3 tmp 模板 EH 下 载 
zuozhongkai@ubuntu:~$ tar -vcjf testl.tar.bz2 testl 





zuozhongkai@ubuntu:~$ ls 
examples .desktop test3 tmp 模板 
test.txt 公共 的 视频 


zuozhongkaiQubuntu:-$ tar -vczf testl.tar.gz testl 


zuozhongkai@ubuntu:~$ ls 
examples . desktop test2 test.txt 公共 的 视频 
test3 tmp 模板 图 片 


图 2.6.3.8 tar 命令 进行 压缩 
在 图 2.6.3.8 中 ， 我 们 使 用 如 下 两 个 命令 将 testl 文件 夹 压缩 为 .bz2 和 .gz 这 两 个 格式 : 
tar -vcjf testl.arbz2 testl 





























tar -vezf testl.targz testl 

在 上 面 两 行 命令 中 ，-vcjf 表示 创建 bz2 格式 的 压缩 文件 ，-vczf 表示 创建 .gz 格式 的 压缩 文 
牛 。 学 习 了 如 何 使 用 tar 命令 来 完成 压缩 ， 我 们 再 来 学 习 使 用 tar 命令 完成 文件 的 解压 ， 操 作 如 
图 2.6.3.9 所 示 : 

zuozhongkaiQubuntu:-$ ls 

examples . desktop test.txt 公共 的 


test3 tmp 模板 
zuozhongkai@ubuntu:~$ tar -vxjf testl.tar.bz2 






























































zuozhongkai@ubuntu:~$ ls 

examples .desktop test3 tmp 
test1 test.txt 公共 的 
zuozhongkaiQubuntu:-$ tar -vxzf test2.tar.gz 


zuozhongkaiQubuntu:-$ ls 

examples.desktop  test2 test.txt 模板 x 

testl tmp 下 
test3 公共 的 EE 


$ 
载 
f 


* 


" 
` 





图 2.6.3.9 tar 解压 缩 命令 
图 2.6.3.9 中 我 们 使 用 如 下 所 示 两 行 命令 完成 .bz2 和 .gz 格式 文件 的 解压 缩 ; 
tar -vxjf testl.tar.bz2 



































tar -vxzf test2.targz 

上 述 两 行 命令 中 ，-vxjf 用 来 完成 .bz2 格式 压缩 文件 的 解压 ，-vxzf 用 来 完成 .gz 格式 压缩 文 
件 的 解压 。 关 于 Ubunut 下 的 命令 行 压缩 和 解压 缩 就 讲解 到 这 里 ， 重 点 是 tar 命令 ， 要 熟练 掌握 
使 用 tar 命令 来 完成 .bz2 和 .gz 格式 的 文件 压缩 和 解压 缩 。 
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2.6.4 文件 查询 和 搜索 


文件 的 查询 和 搜索 也 是 最 常用 的 操作 ， 在 租 入 式 Linux 开发 中 常常 需要 在 Linux 源码 文件 
中 查询 某 个 文件 是 否 存 在 ， 或 者 搜索 哪些 文件 都 调用 了 某 个 函数 等 等 。 本 节 我 们 就 讲解 两 个 最 
常用 的 文件 查询 和 搜索 命令 : find 和 grep。 

1、 命 令 find 

find 命令 用 于 在 目录 结构 中 查找 文件 ， 其 命令 格式 如 下 : 

find [路 径 ] ” [参数 ] [关键 字 ] 

路 径 是 要 查找 的 目录 路 径 ， 如 果 不 写 的 话 表 示 在 当前 目录 下 查找， 关键 字 是 文件 名 的 一 部 
分 ， 主 要 参数 如 下 : 

-name<filename> 按照 文件 名 称 查 找 ， 查 找 与 人 lename 匹配 的 文件 ， 可 使 用 通配符 。 

-depth 从 指定 目录 下 的 最 深层 的 子 目录 开始 查找 。 

-gid< 群 组 识别 码 > 查找 符合 指定 的 群 组 识别 码 的 文件 或 目录 。 

-group< 群 组 名 称 > ”查找 符合 指定 的 群 组 名 称 的 文件 或 目录 。 

-Size< 文 件 大 小 > ”查找 符合 指定 文件 大 小 的 文件 。 

-type< 文 件 类 型 > 查找 符合 指定 文件 类 型 的 文件 。 

-user< 拥 有 者 名 称 > ”查找 符合 指定 的 拥有 者 名 称 的 文件 或 目录 。 

find 命令 的 参数 有 很 多 ， 常 用 的 就 这 些 ， 关 于 其 它 的 参数 大 家 可 以 自行 上 网 查找 ， 我 们 来 
看 一 下 如 何 使 用 find 命令 进行 文件 搜索 ， 我 们 搜索 目录 /etc 中 以 “vim” 开 头 的 文件 为 例 ， 操 
作 如 图 2.6.4.1 Bron: 











































































































































































































:-$ find /etc/ -name vim* 
/etc/vim 
/etc/vim/vimrc 
/etc/vim/vimrc.tiny 


find: `/etc/cups/ssl': 权限 不 够 
/etc/alternatives/vim 
/etc/alternatives/vimdiff 
: "/etc/polkit-1/localauthority': 权限 不 够 
: `/etc/ssl/private': 权限 不 够 





图 2.6.4.1 find 命令 操作 

从 图 2.6.4.1 可 以 看 出 , 在 目录 /etc F, 包含 以 “vim*” 开 头 的 文件 有 /etc/vim、 /etc/vim/vimrc 
等 等 ， 就 不 一 一 列 出 了 。 

2、 命 令 grep 

find 命令 用 于 在 目录 中 搜索 文件 ， 我 们 有 时 候 需 要 在 文件 中 搜索 一 串 关 键 字 ，grep 就 是 完 
成 这 个 功能 的 ，grep 命令 用 于 查找 包含 指定 关键 字 的 文件 ， 如 果 发 现 某 个 文件 的 内 容 包 含 所 指 
定 的 关键 字 ，grep 命令 就 会 把 包含 指定 关键 字 的 这 一 行 标记 出 来 ，grep 命令 格式 如 下 : 

grep [参数 ] ”关键 字 ”文件 列表 

grep 命令 一 次 只 能 查 一 个 关键 字 ， 主 要 参数 如 下 : 

-b 在 显示 符合 关键 字 的 那 一 列 前 ， 标 记 处 该 列 第 1 个 字符 的 位 编号 。 

-c 计算 符合 关键 字 的 列 数 。 

-d< 进 行动 作 > 当 指 定 要 查找 的 是 目录 而 非 文 件 时 ， 必 须 使 用 此 参数 ! 否则 grep 指令 
将 回报 信息 并 停止 搜索 。 

-i 忽略 字符 大 小 写 。 
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v Bd 


-r ”在 指定 目录 中 递归 查找 。 
比如 我 们 在 目录 /usr 下 递归 


























查找 ， 只 显示 不 匹配 的 行 。 








e 





ERR 


AER:IWWM 


查找 包含 字符 “Ubuntu” 的 文件 ， 操 作 如 图 2.6.4.2 所 示 : 


:-$ grep -ir "Ubuntu" /usr 
匹配 到 二 进 制 文 件 /usr/bin/fcitx-qimpanel-configtool 
匹配 到 二 进 制 文 件 /usr/bin/nsupdate 


# Author: Martin Pitt «martin.pitt( 


# this so that confined applications using 


7 -integration 
匹配 到 二 进 制 文件 /usr/bin/locale 


2.6.5 文件 类 型 


里 的 文 





这 








AAE 72 
-rw-r--r-- 
drwxrwxr-x 
-rw-rw-r-- 
drwxrwxr-x 
-rw-rw-r-- 
drwxrwxr-x 
-rw-rw-r-- 
drwxrwxr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 


件 类 型 ， 比 如 


的 文件 类 型 如 











目录 
字符 
块 设 


符号 
套 接 

















zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 


在 图 2.6.5.1 F, FAH 


Ae 


testl 的 
T: 





普通 文件 ， 一 些 应 用 程序 创建 的 ， 


文件 。 
设备 文件 
备 文件 ， 





件 类 型 不 是 说 这 个 文 伯 
-1” 来 查看 用 户 根 目 录 下 所 有 文件 的 详 
:~$ LSs 





的 详细 信息 占 


第 一 个 字符 是 “d”，testl.tar.bz2 文件 第 一 个 字符 是 


，Linux 驱动 里 








.COm> 
-browsers .d 











F 是 音乐 文件 还 是 文本 文件 ， 在 用 户 根 目 录 下 使 用 












































-l 


zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 


图 2.6.5.1 








信息 ， 如 图 





2.6.5.1 所 示 : 


8980 examples .desktop 


test1 
test2 


test3 
test.txt 


4096 
HEA 





2: Ed 


[Sun] 























NAE ER 














^x 
Y 











都 是 一 个 符号 就 标记 了 当前 文 


By Ar -十 


“-” 这 些 字 符 表示 





行 ， 每 行 最 前 











比如 文档 、 图 片 、 音 乐 
































的 字符 设备 驱动 ， 比 如 串 
存储 设备 驱动 ， 比 如 硬盘 ，U WEAR. 


口 设备 ， 音 频 设 备 等 。 





连接 文件 ， 相 当 于 Windwos 下 的 快捷 方式 。 


字 文件 。 














学 习 Linux 驱动 


管道 文件 ， 主 要 指 FIFO 文件 。 




















于 发 的 时 候 基 本 是 在 和 字符 设备 文件 和 块 设备 文件 打交道 。 
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2.7Linux 用 户 权 限 管理 


2.7.1 Ubuntu 用 户 系统 


Ubuntu 是 一 个 多 用 户 系 统 ， 我 们 可 以 给 不 同 的 使 用 者 创建 不 同 的 用 户 账号 ， 每 个 用 户 使 用 
各 自 的 账号 登陆 ， 使 用 用 户 账号 的 目的 一 是 方便 系统 管理 员 管 理 ， 控 制 不 同 用 户 对 系统 的 访问 
权限 ， 另 一 方面 是 为 用 户 提供 安全 性 保护 。 

我 们 前 面 在 安装 Ubuntu 系统 的 时 候 被 要 求 创 建 一 个 账户 ， 当 我 们 创建 好 账号 以 后 ,系统 会 
在 目录 /home 下 以 该 用 户 名 创建 一 个 文件 来 ， 所 有 与 该 用 户 有 关 的 文件 都 会 被 存储 在 这 个 文件 


























































































































文件 夹 中 。 同 样 的 ， 创 建 其 它 用 户 账号 的 时 候 也 会 在 目录 /home 下 生成 一 个 文件 夹 来 存储 该 用 
户 的 文件 ， 图 2.7.1.1 就 是 我 的 电脑 上 “zuozhongkai” 这 个 账户 的 文件 夹 。 
:~$ ls 











examples .desktop 








图 2.7.1.1 用 户 账 号 根 目录 
装 系统 的 时 候 创建 的 用 户 其 权限 比 后 面 创建 的 用 户 大 一 点 ， 但 是 没有 root 用 户 权限 大 ， 
Ubuntu 下 用 户 类 型 分 为 以 下 3 类 : 

e 初次 创建 的 用 户 ， 此 用 户 可 以 完成 比 普 通用 户 更 多 的 功能 。 

@ root 用 户 ， 系 统管 理 员 ， 系 统 中 的 玉 星 大 帝 ， 拥 有 至 高 无 上 的 权利 。 

e 普通 用 户 ， 安 装 完 操作 系统 以 后 被 创建 的 用 户 。 

以 上 三 种 用 户 ， 每 个 用 户 都 有 一 个 D 号 ， 称 为 UID， 操 作 系 统 通过 UID 来 识别 是 哪个 用 
户 ， 用 户 相 关 信 息 可 以 在 文件 /etc/passwd 中 查看 到 ， 如 图 2.7.1.2 所 示 : 


:/$ cat /etc/passwd 
root:x:0:0:root:/root:/bin/bash 
daemon:x:1:1:daemon: /usr/sbin:/usr/sbin/nologin 
bin:x:2:2:bin:/bin:/usr/sbin/nologin 
sys:X:3:3:sys:/dev:/usr/sbin/nologin 
sync:X:4:65534:sync:/bin:/bin/sync 
games:x:5:60:games:/usr/games : /usr/sbin/nologin 
man:x:6:12:man:/var/cache/man: /usr/sbin/nologin 
lp:x:7:7:1p:/var/spool/lpd:/usr/sbin/nologin 
hplip:x:115:7:HPLIP system user, ,,:/var/run/hplip:/bin/false 
kernoops:x:116:65534:Kernel Oops Tracking Daemon,,,:/:/bin/false 
pulse:x:117:124:PulseAudio daemon,,,:/var/run/pulse:/bin/false 
rtkit:x:118:126:RealtimeKit, ,,:/proc:/bin/false 
saned:x:119:127: :/var/lib/saned:/bin/false 
usbmux:x:120:46:usbmux daemon, ,,:/var/lib/usbmux:/bin/false 
zuozhongkai:x:1000:1000:zuozhongkai, , , :/home/zuozhongkai : /bin/bash 
guest-sjhdig:x:999:999:;i5 Æ :/tmp/guest-sjhdig:/bin/bash 
























































































































































图 2.7.1.2 passwd 文件 内 容 

从 配置 文件 passwd 中 可 以 看 到 ， 每 个 用 户 名 后 面 都 有 两 个 数字 ， 比 如 用 户 “zuozhongkai” 
后 面 “1000:1000”， 第 一 个 数字 是 用 户 的 ID， 另 一 个 是 用 户 的 GID， 也 就 是 用 户 组 ID 。Ubunut 
里 面 每 个 用 户 都 属于 一 个 用 户 组 里 面 ， 用 户 组 就 是 一 组 有 相同 属性 的 用 户 集合 。 


































































































2.7.2 权限 管理 


在 使 用 Windows 的 时 候 我 们 很 少 接触 到 用 户 权 限 , 最 多 就 是 打开 某 个 软件 出 问题 的 时 候 会 
选择 以 “管理 员 身 份 ” 打开。Ubuntu 下 我 们 会 常 跟 用户 权 限 打交道 ， 权 限 就 是 用 户 对 于 系统 资 
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源 的 使 用 限制 情况 ，root 用 




















户 拥 
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有 最 大 的 权限 ， 可 以 为 所 欲 为 ， 装 系统 的 时 候 创 建 的 ) 














A 





1r 











root 用 户 的 部 分 权限 ， 其 它 普通 用 户 的 权限 最 低 。 对 于 我 们 做 嵌入 式 开发 的 人 一 般 不 关注 用 户 





的 权限 问题 ， 


对 于 一 个 文件 通常 有 三 种 权 P 
录 下 所 有 文件 的 权限 信息 ， 如 











-- 1 
-- 1 
-Xx 2 
-X 2 
-X 2 
=X 
sX 7a 
-X 2 
-X 2 
X 2 
-X 2 





:~$ ls 


zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 














zl 


zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 


8980 

0 
4096 
4096 
4096 
4096 
4096 
4096 
4096 
4096 
4096 








因为 诅 入 式 基 本 是 单 用 户 ， 做 舱 入 式 开 发 重点 关注 的 是 文件 的 权限 问题 。 
民 ，， 读 0、 写 (w) 和 执行 (0)， 使 用 命令 “ls -1” 可 以 查看 某 个 目 
图 2.7.2.1 所 示 : 





:08 examples.desktop 
:44 test.c 








图 2.7.2.1 文件 权限 信息 

在 图 2.7.2.1 中 我 们 以 文件 test.c 为 例 讲解 ， 文 件 test.c 文件 信息 如 下 : 

-rw-rw-r-- ] zuozhongkai zuozhongkai 012 H 25 20:44 test.c 

其 中 “-rw-rw-r--” 表 示 文 件 权 限 与 用 户 和 用 户 组 之 间 的 关系 , 第 一 位 表示 文件 类 型 ， 上 一 小 
节 已 经 说 了 。 剩 下 的 9 位 以 3 位 为 一 组 ， 分 别 表示 文件 拥有 者 的 权限 ， 文 件 拥有 者 所 在 用 户 组 
的 权限 以 及 其 它 用 户 权限 。 后 面 的 “zuozhongkai zuozhongkai” 分 别 代表 文件 拥有 者 (用 户 ) 和 该 
用 户 所 在 的 用 户 组 ， 因 此 文件 test.c 的 权限 情况 如 下 : 

(QD. XT test.c 的 拥有 者 是 用 户 zuozhongkai， 其 对 文件 tesst.c 的 权限 是 “rw-” 也 就 是 对 
该 文件 拥有 读 和 写 两 种 权限 。 

C. HP zuozhongkai 所 在 的 用 户 组 也 叫做 zuozhongkai， 其 









































c 





































































































组 内 用 户 对 于 文件 test.c 的 权 

















限 是 “rw-”， 也 是 拥有 读 和 写 这 两 种 权限 。 
©, REHAR FXI teste 的 权限 是 “r-” 也 就 是 只 读 权限 。 














对 于 文件 ， 可 读 权限 表示 可 以 打开 查看 文件 内 容 ， 可 写 权 限 表示 可 以 对 文件 进行 修改 ， 可 
执行 权限 就 是 可 以 运行 此 文件 (如 果 是 软件 的 话 )。 对 于 文件 夹 , 拥有 可 读 权限 才 可 以 使 用 命令 
查看 文件 夹 中 的 内 容 ， 拥 有 可 执行 权限 才能 进入 到 文件 夹 内 部 。 

如 果菜 个 用 户 对 某 个 文件 不 具有 相应 的 权限 的 话 就 不 能 进行 相应 的 操作 ， 比 如 根 目录 “/” 
下 的 文件 只 有 root 用 户 才 有 权限 进行 修改 ， 如 果 以 普通 用 户 去 修改 的 话 就 会 提示 没有 权限 。 比 
如 我 们 要 在 根 目录 “/” 创建 一 个 文件 mytest， 使 用 命令 “touch mytest”， 结 果 如 图 2.7.2.2 所 
ZN: 

















ls 






























































:/$ touch mytest 
: 权限 不 够 

图 2.7.2.2 创建 文件 
在 图 2.7.2.2 中 ,我 以 用 户 “zuozhongkai” 在 根 目录 “/” 创 建文 件 mytest， 结 果 提 示 我 无 法 
创建 “mytest”， 因 为 权限 不 够 ,因为 只 有 root 用 户 才能 在 根 目 录 “/” 下 创建 文件 。 我们 可 以 使 
用 命令 “sudo” 命 令 和 暂时 切换 到 root 用 户 ， 这 样 就 可 以 在 根 目录 “/” 下 创建 文件 mytest 了 ， 如 


图 2.7.2.3 所 示 : 


touch: 无 法 创建 'mytest' 
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:/$ sudo touch mytest 
[sudo] zuozhongkai 的 密码 : 
UC 








图 2.7.2.3 使 用 sudo 命令 创建 文件 
在 图 2.7.2.3 中 我 们 使 用 命令 “sduo” 以 后 就 可 以 在 根 目录 “/” 创 建文 件 mytest， 在 进行 其 
它 的 操作 的 时 候 ， 遇 到 提示 权限 不 够 的 时 候 都 可 以 使 用 sudo 命令 暂时 以 root 用 户 身 份 去 执行 。 
上 面 我 们 讲 了 ， 文 件 的 权限 有 三 种 : 读 (r)、 写 (w) 和 执行 (x)， 除 了 用 r、w 和 x 表示 以 外 ， 
我 们 也 可 以 使 用 二 进 制 数 表 示 ， 三 种 权限 就 可 以 使 用 3 位 二 进 制 数 来 表示 ， 一 种 权限 对 应 一 个 
二 进 制 位 , 如 果 该 位 为 1 就 表示 具备 此 权限 , 如 果 该 位 为 0 就 表示 没 不 具备 此 权限 , 如 表 2.7.2.1 
所 示 : 



















































































表 2.7.2.1 文件 权限 数字 表示 方法 

如 果 做 过 单片机 开发 的 话 ， 就 会 发 现 和 单片机 里 面 的 寄存 器 位 一 样 ， 将 三 种 权限 r、w 和 x 
进行 不 同 的 组 合 ， 即 可 得 到 不 同 的 三 进 制 数 和 八进制 数 ，3 位 权限 可 以 组 出 8 种 不 同 的 权限 组 
合 ， 如 表 2.7.2.2 所 示 : 

































































0 

X 001 1 
Ww 010 2 
WX 011 3 
T 100 4 
T-X 101 5 
TW 110 6 
TWX 111 7 

















表 2.7.2.2 文件 所 有 权限 组 合 

K 2.7.2.2 中 权限 所 对 应 的 八进制 数字 就 是 每 个 权限 对 应 的 位 相 加 ， 比 如 权限 rwx 就 是 
4+2+1=7。 前 面 的 文件 test.c 其 权限 为 “rw-rw-r--”， 因此 其 十 进 制 表示 就 是 : 664。 

另外 我 们 也 开始 使 用 a、u、g 和 o 表示 文件 的 归属 关系 ， 用 =、+ 和 -表示 文件 权限 的 变化 ， 
如 表 2.7.2.3 所 示 : 
| “3 | 
可 读 权 限 
可 写 权限 
可 执行 权限 
所 有 用 户 
归属 用 户 
归属 组 
其 它 用 户 






































o joa |cim|xizj|a 
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具备 权限 





十 


添加 某 权 限 











去 除 某 权 限 








对 于 文件 test.c， 我 们 想 要 修改 其 归属 














2.7.3 权限 管理 命令 


我 们 也 可 以 使 用 Shell 来 操作 文 伯 


令 ， 我 们 一 个 一 个 来 看 。 
1、 权 限 修改 命令 chmod 


命令 “chmod” 用 于 修改 文件 或 者 文 伯 


用 字母 表示 ， 命 令 格 式 如 下 : 


chmod 





[参数 ] 
主要 参数 如 下 : 




















[文件 名 /目录 名 ] 


表 2.7.2.3 权限 修改 字母 表示 方式 
用 户 (zuozhongkai) 对 其 拥有 可 执行 权限 ， 那 么 就 可 以 
使 用 : utx。 如果 希望 设置 归属 用 户 及 其 所 在 的 用 户 组 都 对 其 拥有 可 执行 权限 就 可 以 使 用 : gutx。 









































的 权限 管理 





F 夹 的 权限 , 权限 可 以 使 ) 


E, 主要 用 到 “chmod” 和 “chown” 这 两 个 命 














前 面 讲 的 数字 表示 也 可 以 使 











- 效果 类 似 “-v” 参 数 ， 但 仅 回 显 更 改 的 部 分 。 
-了 了 ”不 显示 错误 信息 。 


-R 递归 处 型 





E， 指 定 目录 下 的 所 有 文 伯 








-V ”显示 指令 的 执行 过 程 。 
我 们 先 来 学 习 以 下 如 何 使 用 命令 “chmod” 修 改 一 个 文件 的 权限 , 在 用 户 根 目录 下 创建 一 个 





文件 test， 然 后 查看 其 默认 权限 ， 操 作 如 几 2.7.3.1 所 示 : 





LibreOffice Calc 
GHA 40 
-rw-r--r-- 
-rw-rw-r-- 
drwxrwxr- 
drwxr-xr- 
drwxr-xr- 
drwxr-xr- 
drwxr-xr- 
drwxr-xr- 
drwxr-xr- 
drwxr-xr- 


1 
1 
2 
2 
2 
2 
2 
2 
2 
2 
drwxr-xr-x 2 


SQUE UE. 9€ 9€ 9€ 9€ 04 2€ 











:-$ touch test 


:~$ ls 


zuozhonakai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 


-l 


zuozhonakai 
zuozhongkai 
zuozhongkal 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 
zuozhongkai 





F 及 其 子 文件 目录 一 起 处 理 








o 























:08 examples.desktop 


图 2.7.3.1 创建 文件 test 





在 图 2.7.3.1 中 我 们 创建 了 一 个 文件 ，test， 这 个 文件 的 默认 权限 为 “rw-rw-r--”， 我 们 将 其 





权限 改 为 “rwxrw-rw” 对 应 数字 就 是 766， 操 作 如 下 : 


:~$ ls 


-l test 


-rw-rw-r-- 1 zuozhongkai zuozhongkai 0 12H 25 22:24 test 


- FWXTrW- rw- 





:-$ chmod 766 test 


Lx 3 


-l test 
1 zuozhongkai zuozhongkai 0 12H 25 22:24 





图 2.7.3.2. 修改 权限 


在 图 2.7.3.2 F, 我 们 修改 文件 test 的 权限 为 766, 修改 完成 以 后 的 test 文件 权限 为 “rwxrw- 
rw-”， 和 我 们 设置 的 一 样 ， 说 明 权 限 修 改 成 功 。 
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上 面 我 们 是 通过 数字 来 修改 权限 的 ， 我 们 接 下 来 使 用 字母 来 修改 权限 ， 操 作 如 图 2.7.3.3 所 





ZN: 


:~$ touch a.c 
:-$ ls -laa.c 
-rw-rw-r-- 1 zuozhongkai zuozhongkai 0 12 月 25 22:33 a.c 
:~$ chmod u+x a.c 
= 
-rwxrw-r-- 1 zuozhongkai zuozhongkai 0 12 月 25 22:33 
图 2.7.3.3. 使 用 字母 修改 文件 权限 
上 面 两 个 例子 都 是 修改 文件 的 权限 , 接 下 来 我 们 修改 文件 夹 的 权限 , 新 建 一 个 test 文件 夹 ， 
在 文件 夹 test 里 面 创建 ac、b.c 和 c.c 三 个 文件 ， 如 图 2.7.3.4 所 示 : 


:~$ ls -l test/ 



































- 1 zuozhongkai zuozhongkai 0 12H 26 00:20 a.c 
- 1 zuozhongkai zuozhongkai © 12H 26 00:20 b.c 
- 1 zuozhongkai zuozhongkai © 12H 26 00:20 c.c 





图 2.7.3.4 test 文件 来 
在 图 2.7.3.4 中 test 文件 夹 下 的 文件 ac、b.c 和 c.c 的 权限 均 为 “rw-rw-r--”， 我 们 将 test X 
件 夹 下 的 所 有 文件 权限 都 改 为 “rwxrwxrwx” 也 就 是 数字 777， 操 作 如 图 2.7.3.5 所 示 : 


:~$ chmod -R 777 test/ 
:~$ ls -l test/ 














总 用 量 0 


-rwxrwxrwx 1 zuozhongkai zuozhongkai 0 12 月 26 00:20 
-rwxrwxrwx 1 zuozhongkai zuozhongkai 0 12H 26 00:20 
-rwxrwxrwx 1 zuozhongkai zuozhongkai 0 12H 26 00:20 


图 2.7.3.5. 递归 修改 文件 夹 权限 











2、 文 件 归属 者 修改 命令 chown 

命令 chown 用 来 修改 某 个 文件 或 者 目录 的 归属 者 用 户 或 者 用 户 组， 命令 格式 如 下 : 

chown [2X] [用 户 名 .< 组 名 >] [文件 名 /目录 ] 

其 中 [用 户 名 .< 组 名 >] 表 示 要 将 文件 或 者 目录 改 为 哪 一 个 用 户 或 者 用 户 组 ， 用 户 名 和 组 名 用 
“.” 隔 开 ， 其 中 用 户 名 和 组 名 中 的 任何 一 个 都 可 以 省 略 ， 命 令 主 要 参数 如 下 : 

-c 效果 同 -v 类 似 ， 但 仅 回 报 更 改 的 部 分 。 

-f 不 显示 错误 信息 。 

-h 只 对 符号 连接 的 文件 做 修改 ， 不 改动 其 它 任何 相关 的 文件 。 

-R 递归 处 理 ， 将 指定 的 目录 下 的 所 有 文件 和 子 目录 一 起 处 理 。 

-Y “显示 处 理 过 程 。 
在 用 户 根 目录 下 创建 一 个 test 文件 ， 碍 看 其 文件 夹 所 属 用 户 和 用 户 组 ， 如 图 2.7.3.6 Bron: 

:~$ touch test 





















































































































































:~$ ls -l test 
-rw-rw-r-- 1 zuozhongkai zuozhongkai 0 12H 26 00:36 test 





图 2.7.3.6 test 文件 信息 查询 
从 图 2.7.3.6 中 可 以 看 出 ,文件 test 的 归属 用 户 为 zuozhongkai, 所 属 的 用 户 组 为 zuozhongkai， 
将 文件 test 归属 用 户 改 为 root 用 户 ， 所 属 的 用 户 组 也 改 为 root， 操 作 如 图 2.7.3.7 所 示 : 
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:~$ ls -l test 
-rw-rw-r-- 1l zuozhongkai zuozhongkai © 12H 26 00:45 test 


:-$ sudo chown root.root test 
:~$ ls -l test 
- 1 root root 0 12H 26 00:45 test 


图 2.7.3.7 修改 文件 归属 用 户 和 归属 组 
命令 shown 同样 也 可 以 递归 处 理 来 修改 文件 夹 的 归属 用 户 和 用 户 组 , 用 法 和 命令 chown 一 
FH 
































样 ， 这 里 就 不 演示 了 。 


2.8 Linux 磁盘 管理 


2.8.1 Linux 磁盘 管理 基本 概念 


Linux 的 磁盘 管理 体系 和 Windows 有 很 大 的 区 别 ， 在 Windows 下 经 常会 遇 到 “分 区 ”这 个 
概念 ， 在 Linux 中 一 般 不 叫 “ 分 区 ”而 叫 “ 挂 载 点 ”>。 “ 挂 载 点 ”就 是 将 一 个 硬盘 的 一 部 分 做 
成 文件 夹 的 形式 ， 这 个 文件 夹 的 名 字 就 是 “ 挂 载 点 ” 不 管 在 哪个 发 行 版 的 Linux F, HPE 
对 看 到 不 到 C St. D 盘 这 样 的 概念 的 ， 只 能 看 到 以 文件 夹 形式 存在 的 “ 挂 载 点 ”. 




















4 


























文件 /etc/fstab 详细 的 记录 了 Ubuntu 中 硬盘 分 区 的 情况 ， 如 图 2.8.1.1 所 示 : 


:~$ cat /etc/fstab 
4 /etc/fstab: static file system information. 





# Use 'blkid' to print the universally unique identifier for a 

4 device; this may be used with UUID- as a more robust way to name devices 

# that works even if disks are added and removed. See fstab(5) 

# 

# «file system» «mount point»  <type> <options> «dump» «pass» 

# / was on /dev/sdal during installation 

UUID-fcdae2a0-05f1-48fa-a6c8-b4efff06a180 / ext4 errors-remount-ro 0 
4 swap was on /dev/sda5 during installation 











UUID-cC9eb5d28-50fe-4e35-951d-ea8alc4b7810 none 0 
图 2.8.1.1 文件 fstab 
在 图 2.8.1.1 中 有 一 行 “/was on /dev/sdal during installation ", 意思 是 根 目 录 “/” 是 在 /dev/sdal 











上 的 ， 其 中 “/” 是 挂 载 点 ,，“/dev/sdal” 就 是 我 们 装 Ubuntu 系统 的 硬盘 。 由 于 我 们 的 系统 是 安 
装 在 虚拟 机 中 的 ， 因 此 图 2.8.1.1 没有 出 现实 际 的 硬盘 。 可 以 通过 如 下 命令 查看 当前 系统 中 的 磁 
盘 : 
B /dev/sd* 
述 命 令 就 是 打印 出 所 有 以 /dev/sd 开头 的 设备 文件 ， 如 图 2.8.1.2 Bras: 


:~$ ls ET 


图 2.8.1.2 查看 硬盘 设备 文件 

在 图 2.8.1.2 中 有 四 个 磁盘 设备 文件 ， 其 中 sd 表示 是 SATA 硬盘 或 者 其 它 外 部 设备 ， 最 后 
面 的 数字 表示 该 硬盘 上 的 第 n 个 分 区 , 比如 /dev/sdal 就 表示 磁盘 sda 上 的 第 一 个 分 区 。 图 2.8.1.2 
中 都 是 以 /dev/sda 开头 的 ， 说 明 当 前 只 有 一 个 硬盘 。 如 果 再 插 上 TU 盘 、SD 卡 喻 的 就 可 能 会 出 现 
/dev/sdb, /dev/sdc SES, "p HR RE] U 盘 有 两 个 分 区 那么 可 能 就 会 出 现 /devsdb1、dev/sdb2 这 样 
的 设备 文件 。 比 如 我 现在 插入 我 的 U 盘 ， 插 入 U ARIE U 盘 是 接 到 主机 还 是 虚拟 机 ， 如 图 
2.8.1.3 所 示 : 
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检测 到 新 的 USB 设备 x 


选择 您 希望 将 Kingston DataTraveler 3.0 连接 到 的 位 置 


O 连接 到 主机 
© 连接 到 虚拟 机 1、 连 接 到 虚拟 机 


LELA ER 


2、 选 中 要 连接 的 虚拟 机 名 字 




















图 2.8.1.3 U 盘 连 接 选 择 

设置 好 图 2.8.1.3 以后， 点击“ 确定” 按钮 U 盘 就 会 自动 连接 到 虚拟 机 中 ， 也 就 是 连接 到 
Ubuntu 系统 中 , 我 们 再 次 使 用 命令 “ls/devwsd* ”来 查看 当前 的 “/devwsd* ”设备 文件 , 如 图 2.8.1.4 
所 示 : 














:~$ ls /dev/sd* 





图 2.8.1.4 插入 UU 盘 后 的 设备 文件 
从 图 2.8.1.4 可 以 看 出 ， 相 比 图 2.8.1.2 多 了 /dev/sdb 和 /devwsdbl 这 两 个 文件 ， 
就 是 U BOXE. /dev/sdbl 表示 U 盘 的 第 一 个 分 区 ， 因 为 我 的 U 盘 就 一 个 分 区 。 























2.8.2 人 磁盘 管理 命令 
本 节 我 们 学 习 以 下 跟 磁 盘 操 作 有 关 的 命令 ， 这 些 命令 如 下 : 
1、 磁 盘 分 区 命令 fdisk 
如 果 要 对 某 个 磁盘 进行 分 区 ， 可 以 使 用 命令 fdisk， 命 令 格 如 下 : 
fdik [Až] 
主要 参数 如 下 : 
-b< 分 区 大 小 > 指定 每 个 分 区 的 大 小 。 
J 列 出 指定 设备 的 分 区 表 。 
-S< 分 区 编号 > ”将 指定 的 分 区 大 小 输出 到 标准 的 输出 上 ， 单 位 为 块 。 















































其 中 /dev/sdb 


-u ”搭配 “-1” 参 数 ， 会 用 分 区 数目 取代 柱 面 数目 ， 来 表示 每 个 分 区 的 起 始 地 址 。 

















比如 我 要 对 U 各 进行 分 区 ， 千 万 不 要 对 自己 装 Ubuntu 系统 进行 分 区 !!! 可 以 使 用 如 下 命 


d 


sudo fdisk  /dev/sdb 
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结果 如 图 2.8.2.1 所 示 : 


zuozhongkai@ubuntu:~$ sudo fdisk /dev/sdb 
[sudo] zuozhongkai 的 密码 : 


Welcome to fdisk (util-linux 2.27.1). 
Changes will remain in memory only, until you decide to write them. 
Be careful before using the write command. 


命令 (输入 m 获取 帮助 ): | 








图 2.8.2.1 U 盘 分 区 界面 

在 图 2.8.2.1 中 提示 我 们 输入 “m” 可 以 查看 帮助 ， 因 为 fdik 还 有 一 些 字 命令 ， 通 过 输入 
“m” 可 以 查看 都 有 哪些 子 命令 ， 如 图 2.8.2.2 PTR: 

命令 (输入 m 获取 帮助 ): m 



























































Help: 


D0S (MBR) 

a toggle a bootable flag 

b edit nested BSD disklabel 

c toggle the dos compatibility flag 


Generic 
delete a partition 
list free unpartitioned space 
list known partition types 
add a new partition 
print the partition table 
change a partition type 
verify the partition table 
print information about a partition 


print this menu 
change display/entry units 
extra functionality (experts only) 


Script 
I load disk layout from sfdisk script file 
0 dump disk layout to sfdisk script file 


Save & Exit 
w write table to disk and exit 
q quit without saving changes 


Create a new label 

g create a new empty GPT partition table 

G create a new empty SGI (IRIX) partition table 
o create a new empty DOS partition table 

S create a new empty Sun partition table 


图 2.8.2.2 fdisk 命令 的 子 命令 
图 2.8.2.2 中 常用 的 命令 如 下 : 

p ”显示 现 有 的 分 区 

n 建立 新 分 区 
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t ”更 改 分 区 类 型 
d ”删除 现 有 的 分 区 
a ”更 改 分 区 启动 标志 
Ww ”对 分 区 的 更 改写 入 到 硬盘 或 者 存储 器 中 。 
q ”不 保存 退出 。 

















由 于 我 的 U 盘 里 面 还 有 一 些 重 要 的 文件 ， 所 以 不 能 现在 不 能 进行 分 


论坛 :Www.opendev.com 

















区 ， 所 以 现在 就 不 演示 


fdisk 的 分 区 操作 了 ， 后 面 我 们 讲解 裸 机 例 程 的 时 候 需要 将 可 执行 的 bin 文件 烧 写 到 SD 卡 ， 中 


烧 写 到 SD 卡 之 前 需要 对 SD 卡 进 行 分 区 ， 到 时 候 在 详细 讲解 如 何 


区 。 
2、 格 式 化 命令 mkfs 








EH fdisk 命令 对 磁盘 进行 分 





使 用 命令 fdisk 创建 好 一 个 分 区 以 后 , 我 们 需要 对 其 格式 化 , 也 就 是 在 这 个 分 区 上 创建 一 个 
文件 系统 ，Linux 下 的 格式 化 命令 为 mkfs， 命 令 格式 如 下 : 





mkfs — [2X] 
主要 参数 如 下 : 
fs ”指定 建立 文件 系统 时 的 参数 
-V 显示 版 本 信息 和 简要 的 使 用 
显示 版 本 信息 和 详细 的 使 用 


[-t 文件 系统 类 型 ] 











方法 。 
方法 。 














=V 





[分 区 名 称 ] 


比如 我 们 要 格式 化 U 盘 的 分 区 /dev/sdb1 为 FAT 格式 ， 那 么 就 可 以 使 用 如 下 命令 : 


mkfs vfat /dev/sdbl 
3、 挂 载 分 区 命令 mount 


=i 








我 们 创建 好 分 区 并 且 格 式 化 以 后 肯定 是 要 使 用 硬盘 或 者 U BEBO. 那么 如 何 访问 磁盘 呢 ? 比 
如 我 的 U 盘 就 一 个 分 区 ， 为 /dev/sdbl1， 如 果 直 接 打 开 文 件 /dev/sdb1 会 发 现 根 本 就 不 是 我 们 要 的 


结果 。 我们 需要 将 /devwsdbl 这 个 分 区 挂 载 到 一 个 文 
挂 载 命 令 为 mount， 命 令 格式 如 下 : 





























mount ”[ 参 数 ] -+t [2S8] [设备 名 称 ] 
命令 主要 参数 有 : 

-V 显示 程序 版 本 。 

-h ”显示 辅助 信息 。 

-V ”显示 执行 过 程 详 细 信 息 。 

-0 ro 只 读 模式 挂 载 。 

-0rw ” 读 写 模式 挂 载 。 


-s-r 等 于 -0 ro. 


-w 等 于 -0 rw。 








挂 载 点 是 一 个 文件 夹 , 因此 在 挂 载 之 前 先 要 创建 一 个 文件 夹 , 一 般 我 
录 下 ， 在 “/mnt” 下 创建 一 个 tmp 文件 来 ， 然 后 将 U 盘 的 /dev/sdb1 分 





目 
夹 里 面 ， 操 作 如 图 2.8.2.3 所 示 : 
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牛 夹 中 ， 然 后 通过 这 个 文件 访问 U fi, 磁盘 


[目的 文件 炎 ] 


门 把 挂 载 点 放 到 “/mnt” 
区 挂 载 到 /mnt/tmp 文件 











LMX6U RAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


:~$ ls /mnt 

:~$ 

:-$ sudo mkdir /mnt/tmp 
[sudo] zuozhongkai 的 密码 : 

:~$ ls /mnt 


:-$ sudo mount -t vfat /dev/sdbl /mnt/tmp 
:-$ ls /mnt/tmp 





ARM 裸 机 与 嵌入 式 Linux 驱 动 开 发 V1.0.docx 
图 2.8.2.3 FER U Æ 
在 图 2.8.2.3 中 我 们 将 U 盘 以 fat 格式 挂 载 到 目录 /mnttmp 中 ， 然 后 我 们 就 可 以 通过 访问 
/mnt/tmp 来 访问 口 盘 了 。 
4、 钊 载 命令 umount 
当 我 们 不 在 需要 访问 已 经 挂 载 的 U 盘 ， 可 以 通过 umount YER ES AE ER, MORRU 














umount [参数 ] -t [文件 系统 类 型 ] [设备 名 称 ] 

-a SHISX/etc/mtab 中 的 所 有 文件 系统 。 

-h 显示 帮助 。 

-n ” 缀 载 时 不 要 将 信息 存 入 到 /etc/mtab 文件 中 

6r ”如 果 无 法 成 功 卸 载 ， 泽 尝试 以 只 读 的 方式 重新 挂 载 。 

-t< 文 件 系统 类 型 > 仪 扼 载 选 项 中 指定 的 文件 系统 。 

-V ”显示 执行 过 程 。 

上 面 我 们 将 U 盘 挂 载 到 了 文件 夹 /mnt/tmp 里 面 ， 这 里 我 们 使 用 命令 umount 将 其 外 载 掉 ， 
操作 如 图 2.8.2.4 所 示 : 


















































:~$ ls /mnt/tmp 


ARM 裸 机 与 嵌入 式 Linux 驱 动 开发 V1.0.docx 
:-$ sudo umount -t vfat /dev/sdbl 
:~$ ls /mnt/tmp 
:~ 中 
:~$ 





图 2.8.2.4 SIX U f 
在 图 2.8.2.4 中 ,我 们 使 用 命令 umount IRT U A, 卸载 以 后 当 我 们 再 去 访问 文件 夹 /mnttmp 
的 时 候 发 现 里 面 没有 任何 文件 了 ， 说 明 我 们 卸载 成 功 了 。 
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第 三 章 Linux C 编程 入 门 


在 Windows 下 我 们 可 是 使 用 各 种 各 样 的 IDE 进行 编程 ， 比 如 强大 的 Visual Studio。 但 是 在 



































Ubuntu 下 如 何 进 行 编程 呢 ? Ubuntu 下 也 有 一 些 可 以 进行 编程 的 工具 ， 但 是 大 多 都 只 是 编辑 器 ， 
也 就 是 只 能 进行 代码 编辑 ， 如 果 要 编译 的 话 就 需要 用 到 GCC 编译 器 ， 使 用 GCC 编译 器 肯定 就 
要 接触 到 Makefile。 本 章 就 讲解 如 何在 Ubuntu 下 进行 C 语言 的 编辑 和 编译 、GCC 和 Makefile 
的 使 用 和 编写 。 通 过 本 章 的 学 习 可 以 掌握 Linux 进行 C 编程 的 基本 方法 ， 为 以 后 的 ARM 裸 机 
和 Linux 驱动 学 习 做 准备 。 
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3.1 Hello World ! 


我 们 所 说 的 编写 代码 包括 两 部 分 : 代码 编写 和 编译 ， 在 Windows 下 可 以 使 用 Visual Studio 
来 完成 这 两 部 ， 可 以 在 Visual Studio 下 编写 代码 然后 直接 点 击 编译 就 可 以 了 。 但 是 在 Linux 下 
这 两 部 ， 部 分 是 分 开 的 ， 比 如 我 们 用 VIM 进行 代码 编写 ， 编 写 完 成 以 后 在 使 用 GCC 编译 器 进 
行 编译 ， 其 中 代码 编写 工具 很 多 ， 比 如 VIM 编辑 器 、Emacs 编辑 器 、VScode 编辑 器 等 等 ， 
教程 使 用 Ubunut 自 带 的 VIM 编辑 器 。 先 来 编写 一 个 最 简单 的 “Hello World” JEF, 把 Linux 下 
的 C 编程 完整 的 走 一 遍 。 



























































































































































3.1.1 编写 代码 


先 在 用 户 根 目 录 下 创建 一 个 工作 文件 夹 : C_Program， 所 有 的 C 语言 练习 都 保存 到 这 个 工 
作文 件 夹 下 ， 创 建 过 程 如 图 3.1.1.1 所 示 : 

















:~$ mkdir C Program 
:~$ ls 


test 





examples.desktop 


图 3.1.1.1 创建 工作 目录 
进入 图 3.1.1.1 创建 的 C_Program 工作 文件 夹 ,为 了 方便 管理 , 我 们 后 面 每 个 例 程 都 创建 一 
个 文件 夹 来 保存 所 有 与 本 例 程 有 关 的 文件 ， 创 建 一 个 名 为 “3.1” 的 文件 夹 来 保存 我 们 的 “Hello 
World” 程 序 相关 的 文件 ， 操 作 如 图 3.1.1.2 所 示 : 


:~$ cd C Program/ 
: $ mkdir 3.1 
$ ls 


si 
图 3.1.1.2 创建 工程 文件 夹 
前 面 说 了 我 们 使 用 VI 编辑 器 ， 在 使 用 VI 编辑 器 之 前 我 们 先 做 如 下 设置 : 
1、 设 置 TAB 键 为 4 字 节 
VI 编辑 器 默认 TAB 键 为 8 空格 ， 我 们 改 成 4 空格 ， 用 vi 打开 文件 /etc/vim/vimrc， 在 此 文 
件 最 后 面 输入 如 下 代码 : 
set ts=4 
添加 完成 如 图 3.1.1.3 所 示 : 









































































































































( 
/etc/ /vimrc.Local 





图 3.1.1.3 设置 TAB 为 四 个 空格 
修改 完成 以 后 保存 并 关闭 文件 。 


2. VIM 编辑 器 显示 行 号 




















VIM 编辑 器 默认 是 不 显示 行 号 的 ， 不 显示 行 号 不 利于 代码 查看 ， 我 们 设置 VIM 编辑 器 显 
示 行 号 ， 同 样 是 通过 在 文件 /etc/vim/vimre 中 添加 代码 来 实现 ， 在 文件 最 后 面 加 入 下 面 一 行 代码 
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Bl nf: 
set nu 


添加 完成 以 后 的 /etc/vinyvimrc 文件 如 图 3.1.1.4 所 示 : 





( 


/etc/ /vimrc. local 








图 3.1.1.4 设置 VIM 编辑 器 显示 行 号 











VIM 编辑 器 可 以 自行 定制 , 网 上 有 很 多 的 博客 讲解 如 何 设置 VIM, 感 兴趣 的 可 以 上 网 看 一 
T. 设置 好 VIM 编辑 器 以 后 就 可 以 正式 开始 编写 代码 了 ,进入 前 面 创建 的 “3.1” 这 个 工程 文件 
夹 里 面 ， 使 用 vi 指令 创建 一 个 名 为 “main.c” 的 文件 ， 然 后 在 里 面 输 入 如 下 代码 : 
示例 代码 3.1.1.1 main.c 文件 代码 




























































































include <stdio.h> 


Lae mata (Gus ArGe; Chas varow hiid) 
{ 
prine (GHS TE) Mies dire xat) e 














} 
有 写 完成 以 后 保存 退出 vi 编辑 器 ， 可 以 使 用 “cat ”命令 查 看 代码 是 否 编号 成 功 ， 如 图 3.1.1.5 所 


N: 












































| SERE M M 


y 


#include <stdio.h> 


$ cat main.c 


int main(int argc, char *argv[]) 


printf("Hello World!\n"); 





图 3.1.1.5. 查阅 程序 源码 
从 图 3.1.1.5 可 以 看 出 main.c 文件 是 编辑 成 功 的 ， 代 码 编辑 成 功 以 后 我 们 需要 对 其 进行 编 












































3.1.2 编译 代码 
Ubuntu 下 的 C 语言 编译 器 是 GCC. GCC 编译 器 在 我 们 Ubuntu 的 时 候 就 已 经 默认 安装 好 
了 ， 可 以 通过 如 下 命令 查看 GCC 编译 器 的 版 本 号 : 


gcc -v 


在 终端 中 输入 上 述 命令 以 后 终端 输出 如 图 3.1.2.1 所 示 : 
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:-/C Program/3.1$ gcc -v 
Using built-in specs. 
COLLECT GCC-gcc 
COLLECT LTO WRAPPER-/usr/lib/gcc/x86 64-linux-gnu/5/lto-wrapper 
Target: x86 64-linux-gnu 
Configured with: ../src/configure -v --with-pkgversion-'Ubuntu 5.4.0-6ubuntul-16.04.11' --with-bugurl-file:///usr/shar 
/doc/gcc-5/README.Bugs --enable-languages-c,ada,c--,java,go,d,fortran,objc,obj-ce- --prefix-/usr --program-suffix--5 - 
enable-shared --enable-linker-build-id --libexecdirz/usr/lib --without-included-gettext --enable-threads-posix --libdi 
-z/usr/lib --enable-nls --with-sysroot-/ --enable-clocale-gnu --enable-libstdcxx-debug --enable-libstdcxx-time-yes --wi 
h-default-libstdcxx-abi-new --enable-gnu-unique-object --disable-vtable-verify --enable-libmpx --enable-plugin --with- 
ystem-zlib --disable-browser-plugin --enable-java-awt-gtk --enable-gtk-cairo --with-java-home-/usr/lib/jvm/java-1.5.0- 
cj-5-amd64/jre --enable-java-home --with-jvm-root-dir-z/usr/lib/jvm/java-1.5.0-gcj-5-amd64 --with-jvm-jar-dir-/usr/lib/ 
vm-exports/java-1.5.0-gcj-5-amd64 --with-arch-directory-amd64 --with-ecj-jar-/usr/share/java/eclipse-ecj.jar --enable- 
bjc-gc --enable-multiarch --disable-werror --with-arch-32-1686 --with-abi-m64 --with-multilib-list-m32,m64,mx32 --enab 
e-multilib --with-tune-generic --enable-checking-release --build-x86 64-linux-gnu --host-x86 64-linux-gnu --target-x86| 
64-linux-gnu 
Thread model: posix 
gcc version 5.4.0 20160609 (Ubuntu 5.4.0-6ubuntu1-16.04.11) 


图 3.1.2.1 gec 版 本 查询 

如 果 输 入 命令 “gcc -v” 命 令 以 后 ， 你 的 终端 输出 类 似 图 3.1.1.6 中 的 信息 ， 那 么 说 明 你 的 
电脑 已 经 有 GCC 编译 器 了 。 最 后 下 面 的 “gcc version 5.4.0” 说 明 本 机 的 GCC 编译 器 版 本 为 5.4.0 
的 。 注 意 观察 在 图 3.1.2.1 中 有 “Target: x86_64-linux-gnu” 一 行 ， 这 说 明 Ubunut 自 带 的 GCC 编 
译 器 是 针对 X86 架构 的 , 因此 只 能 编译 在 X86 架构 CPU 上 运行 的 程序 。 如 果 想 要 编译 在 ARM 
上 运行 的 程序 就 需要 针对 ARM 的 GCC 编译 器 ， 也 就 是 交叉 编译 器 ! 我 们 是 ARM 开发 ， 因 此 
n o o e 0 
只 要 知道 不 同 的 目标 架构 ， 其 GCC 编译 器 是 不 同 的 。 
如何 使 用 GCC ARCHIE minc SCHEIE? GCC A 
令 来 使 用 gee 编译 器 来 编译 文件 ， 输 入 如 下 命令 


gcc main.c 


















































































































































器 是 命令 模式 的 ， 因 此 需要 输入 命 





DAI 


















































述 命令 的 功能 就 是 使 用 gcc 编译 器 来 编译 main.c 这 个 c 文件 ， 过 程 如 图 3.12.2 所 示 : 


:~/C_Program/3.1$ gcc main.c 








/C Program/3.1$ ls 








图 3.1.2.2 编译 main.c 文件 

在 图 3.1.2.2 中 可 以 看 到 ， 当 编译 完成 以 后 会 生成 一 个 a.out 文件 ， 这 个 a.out 就 是 编译 生成 
发 的 可 执行 文件 ， 执 行 此 文件 看 看 是 否 和 我 们 代码 的 功能 一 样 ， 执 行 的 方法 很 简单 使 用 命令 : 
“+ 可 执行 文件 ” 比如 本 例 程 就 是 命令 : ./a.out， 操 作 如 图 3.1.2.3 所 示 : 


:~/C_Program/3.1$ ls 
























































main.c 
:~/C_Program/3.1$ ./a.out 





Hello World! 


图 3.1.2.3 执行 编译 得 到 的 文件 

在 图 3.1.2.3 中 执行 a.out 文件 以 后 终端 输出 了 “Hello World!”， 这 正 是 main.c 要 实现 
， 说 明 我 们 的 程序 没有 错误 。a.out 这 个 文件 的 命名 是 GCC 编译 器 自动 命名 的 ， 那 我 们 能 

能 决定 编译 完 生成 的 可 执行 文件 名 字 呢 ? 肯定 可 以 的 ， 在 使 用 gee 命令 的 时 候 加 上 -o xum 
RAMS RIA, 比如 编译 main.c 以 后 生成 名 为 “main” 的 可 执行 文件 ， 操 作 如 图 3.1.2.4 
所 示 : 



























































:~/C_Program/3.1$ ls 


:-/C Program/3.1$ gcc main.c -0 main 
~/C_Program/3.1$ ls 

main.c 
~/C_Program/3.1$ ./main 





Hello World! 


图 3.1.2.4 指定 可 执行 文件 名 字 
在 图 3.1.2.4 中 ， 我 们 使 用 “gcc main.c-o main” 来 编译 main.c 文件 ， 使 用 参数 “-o” 来 指定 
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编译 生成 的 可 执行 文件 名 字 ， 至 此 我 们 就 完成 Linux 下 C 编程 和 编译 的 一 整套 过 程 。 
3.2 GCC 编译 器 


3.2.1 gcc 命令 


在 上 一 小 节 我 们 已 经 使 用 过 GCC 编译 器 来 编译 C 文件 了 ， 我 们 使 用 到 是 gee 命令 ，gcc án 
令 格式 如 下 : 
gcc [选项 ] | [文件 名 字 ] 
主要 选项 如 下 : 
-Cc ”只 编译 不 链接 为 可 执行 文件 ， 编 译 器 将 输入 的 .c 文件 编译 为 .o 的 目标 文件 。 
-0< 输 出 文件 名 > ”用 来 指定 编译 结束 以 后 的 输出 文件 名 ， 如 果 使 用 这 个 选项 的 话 GCC EX 
认 编 译 出 来 的 可 执行 文件 名 字 为 a.out。 
-g ”添加 调试 信息 ， 如 果 要 使 用 调试 工具 (如 GDB) 的 话 就 必须 加 入 此 选项 ， 此 选项 指示 编 
译 的 时 候 生成 调试 所 需 的 符号 信息 。 
-O ”对 程序 进行 优化 编译 ， 如 果 使 用 此 选项 的 话 整 个 源 代码 在 编译 、 链 接 的 的 时 候 都 会 进 
行 优化 ， 这 样 产 生 的 可 执行 文件 执行 效率 就 高 。 
-O2 比 -O 更 幅度 更 大 的 优化 ， 生 成 的 可 执行 效率 更 高 ， 但 是 整个 编译 过 程 会 很 慢 。 























































































































































































































3.2.2 编译 错误 警告 


在 Windows 下 不 管 我 们 用 啥 编译 器 ， 如 果 程 序 有 语法 错误 的 话 编译 的 时 候 都 会 指示 出 来 ， 
比如 开发 STM32 的 时 候 所 使 用 的 MDK 和 IAR， 我 们 可 以 根据 错误 信息 方便 的 修改 bug。 那 
GCC 编译 器 有 没有 错误 提示 呢 ?” 肯 定 是 有 的 ， 我们 可 以 测试 以 下 ， 新 名 为 “3.2” 的 文件 夹 ， 使 
用 vi 在 文件 来“3.2” 中 创建 一 个 main.c 文件 ， 在 文件 里 面 输入 如 下 代码 : 

示例 代码 3.2.2.1 mian.c 文件 代码 































































































1 4include Xstdio.h» 
2 
3. ime mainiot arge, Char el) 
* d 
E Wae Ap 199 
6 
9 gi C3 Sp 
8 b=4 
9 printf ("a+b=\n", a + b); 
LOR 
在 上 述 代 码 中 有 两 处 错误 : 

















第 8 行 、 第 一 处 是 “b=4” 少 写 了 个 一 个 “; ”号 。 

第 9 行 、 第 二 处 应 该 是 printf(“atb=%d\n”， a+ b); 

我 们 编译 以 下 上 述 代码 ， 看 看 GCC 编译 器 是 否 能 够 检查 出 错误 ， 编 译 结果 如 图 3.22.1 所 
ZN: 





























$ gcc main.c -o main 


main.c: In function ‘main’: 


main.c:9:5: expected ';' before ‘printf’ 
printf ("a+b=", a + b) 
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图 3.2.2.1 错误 提示 
从 图 3.2.2.1 中 可 以 看 出 有 一 个 error， 提 示 在 main.c 文件 的 第 9 行 有 错误 ， 错 误 类 型 是 在 
printf 之 前 没有 “;” 号 ， 这 就 是 第 一 处 错误 ， 我 们 在 “b = 4” 后 面 加 上 分 号 ， 然 后 接着 编译 ， 
结果 又 提示 有 一 个 错误 ， 如 图 3.2.2.2 所 示 : 


$ gcc main.c -0 main 












































main.c: In function 'main': 


main.c:9:12: ing: too many arguments for format [-wformat-extra-args] 
printf ("a+b=\n", a + b); 





图 3.2.2.2 错误 提示 
在 图 3.2.2.2 中 ， 提 示 我 们 说 文件 main.c 的 第 9 47: printf(“a+tb=\n”, a + b) 有 error， 错 误 是 
因为 太 多 参数 了 ， 我 们 将 其 改 为 : 
printf( “a+b=%d\n” , a+ b); 
修改 完成 以 后 接着 重新 编译 一 下 ， 结 果 如 图 3.2.2.3 所 示 : 
































$ gcc main.c -o main 
$ ls 





图 3.2.2.3 编译 成 功 
在 图 3.2.2.3 中 我 们 编译 成 功 ， 生 成 了 可 执行 文件 main， 执 行 一 下 main， 看 看 结果 和 我 们 
设计 的 是 否 一 样 ， 如 图 3.2.2.4 所 示 : 


$ ./main 
a+b=7 


图 3.2.2.4 执 行 结果 
可 以 看 出 ，GCC 编译 器 和 其 它 编译 器 一 样 ， 不 仅 能 够 检测 出 错误 类 型 ， 而 且 标 记 除 了 错误 
发 生 在 哪个 文件 ? 哪 一 行 ? 方便 我 们 去 修改 代码 。 












































3.2.3 编译 流程 


GCC 编译 器 的 编译 流程 是 : 预 处 理 、 汇 编 、 编 译 和 链接 。 预 处 理 就 是 对 程序 中 的 宏 定 义 等 
相关 的 内 容 先 进行 前 期 的 处 理 。 汇 编 是 先 将 C 文件 转换 为 汇编 文件 。 当 C 文件 转换 为 汇编 文件 
以 后 就 是 文件 编译 了 ， 编 译 过 程 就 是 将 C 源 文件 编译 成 .o 结尾 的 目标 文件 。 编 译 生成 的 .o 文件 
不 能 直接 执行 ， 而 是 需要 最 后 的 链接 ， 如 果 你 的 工程 有 很 多 个 c 源 文件 的 话 最 终 就 会 有 很 多 .o 
文件 ， 将 这 些 .o 文件 链接 在 一 起 形成 完整 的 一 个 可 执行 文件 。 

上 一 人 小节 演示 的 例 程 都 只 有 一 个 文件 ， 而 且 文 件 非常 简单 ， 因 此 可 以 直接 使 用 gec 命令 生 
成 可 执行 文件 ， 并 没有 先 将 c 文件 编译 成 .o 文件 ， 然 后 在 链接 在 一 起 。 






























































































































































3.3 Makefile 基础 


3.3.1 何 为 Makefile 


上 一 小 节 我 们 讲 了 如 何 使 用 GCC 编译 器 在 Linux 进行 C 语言 编译 , 通过 在 终端 执行 gcc 命 
令 来 完成 C 文件 的 编译 ， 如 果 我 们 的 工程 具有 一 两 个 C 文件 还 好 ， 需 要 输入 的 命令 不 多 ， 当 文 
件 有 几 十 、 上 百 甚 至 上 万 个 的 时 候 用 终端 输入 GCC 命令 的 方法 显然 是 不 现实 的 。 如 果 我 们 能 够 
编写 一 个 文件 ， 这 个 文件 描述 了 编译 哪些 源码 文件 、 如 何 编译 那 就 好 了 ， 每 次 需要 编译 工程 的 
时 只 需要 使 用 这 个 文件 就 行 了 。 这 种 问题 怎么 可 能 难 倒 聪明 的 程序 员 ， 为 此 提出 了 一 个 解决 大 
工程 编译 的 工具 : Make， 描 述 哪些 文件 需要 编译 、 哪 些 需 要 重新 编译 的 文件 就 叫做 Makefile, 
Makefile 就 跟 脚本 文件 一 样 ，Makefile 里 面 还 可 以 执行 系统 命令 。 使 用 的 时 候 只 需要 一 个 Make 
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命令 即 可 完成 整个 工程 的 自动 编译 , 极 大 的 提高 了 软件 开发 的 效率 。 如 果 大 家 以 前 一 直 使 用 IDE 

















来 编写 C 语言 的 话 肯 定 没 有 听 说 过 Makefile 这 个 东西 ， 其 实 这 些 IDE 是 有 的 ， 只 不 过 这 些 IDE 
对 其 进行 了 封装 ， 提 供给 大 家 的 是 已 经 经 过 封装 后 的 图 形 界面 了 ， 我 们 在 IDE 中 添加 要 编译 的 
C 文件 ， 然 后 点 击 按钮 就 完成 了 编译 。 在 Linux 下 用 的 最 多 的 是 GCC 编译 器 ， 这 是 个 没有 UI 
的 编译 器 ， 因 此 Makefile 就 需要 我 们 自己 来 编号 了 。 作 为 一 个 专业 的 程序 员 ， 是 一 定 要 懂得 
Makefile 的 ， 一 是 因为 在 Linux 下 你 不 得 不 懂 Makefile， 再 就 是 通过 Makefile 你 就 能 了 解 整个 
工程 的 处 理 过 程 。 
由 于 Makefile 的 知识 比较 多 ， 完 全 可 以 单独 写本 书 ， 因 此 本 章 我 们 只 讲解 Makefile 基础 入 
门 ， 如 果 想 详细 的 研究 Makefile, 推荐 大 家 阅读 《 跟 我 一 起 写 Makefile》 这 份 文档 ， 文 档 已 经 放 
到 了 开发 板 光盘 ->4、 参 考 资料 里 面 了 ， 本 章 也 有 很 多 地 方 参考 了 此 文档 。 





















































































































































3.3.2 Makefile 的 引入 


我 们 完成 这 样 一 个 小 工程 ， 通 过 键盘 输入 两 个 整形 数字 ， 然 后 计算 他 们 的 和 并 将 结果 显示 
在 屏幕 上 ， 在 这 个 工程 中 我 们 有 main.c, input.c 和 calcu.c 这 三 个 C 文件 和 inputh、calcu.h 这 
两 个 头 文件 。 其 中 main.c 是 主体 ，input.c 负责 接收 从 键盘 输入 的 数值 ，calcu.h 进行 任意 两 个 数 
相 加 ， 其 中 main.c 文件 内 容 如 下 : 
示例 代码 3.3.2.1 main.c 文件 代码 
































dinclude <stdio.h> 
dinclude "input.h" 


d$include "calcu.h" 


1 
2 
3 
4 
5 dint wüecum (Cue enge, Chaar west) 
6 ( 
qj icm & lop mung 
8 
9 input int(&a, &b); 
10 num - calcu(a, b); 
is jowcsbewear (Eel sp Cel e web wm. gu, lov, mi 
12. 3 

input.c 文件 内 容 如 下 : 

示例 代码 3.3.2.2 input.c 文件 代码 

#include <stdio.h> 


#include "input.h" 


1 
2 
3 
d voie! impt ime (int wag aane w10) 
5 { 
6 printf("input two num:"); 
E) secant (Ue mo", m. I» 
8 joxeabiewe de (CA xe Ni) e 
3 } 
calcu.c 文件 内 容 如 下 : 





示例 代码 3.3.2.3 calcu.c 文件 代码 


qam ve Maxell en a 
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2 


5| sime Caleu (ioe e soe 19) 
EN 
E return (a + b); 
6] 

文件 input.h 内 容 如 下 : 

示例 代码 3.3.2.4 input.h 文件 代码 

#ifndef INPUT H 
#define INPUT H 


void input int (int ar int #0)> 
fendif 
文件 calcu.h 内 容 如 下 : 


WTE WT DTT 


示例 代码 3.3.2.5 calcu.h 文件 代码 
Tusende e CALCU H 
&define CALCU H 





iae Calculon mu suae 1e) p 
fendif 
以 上 就 是 我 们 这 个 小 工程 的 所 有 源 文件 ,我 们 接 下 来 使 用 3.1 节 讲 的 方法 来 对 其 进行 编译 

在 终端 输入 如 下 命令 : 

gcc main.c calcu.c input.c -o main 

上 面 命令 的 意思 就 是 使 用 gcc 编译 器 对 main.c. calcu.c 和 input.c 这 三 个 文件 进行 编译 ， 编 
译 生成 的 可 执行 文件 叫做 main。 编 译 完成 以 后 执行 main 这 个 程序 ， 测 试 一 下 软件 是 否 工作 正 
常 ， 结 果 如 图 3.3.2.1 所 示 : 


I Ps despues SE 






















































































> $ l5 
calcu.c calcu.h input.c input.h main.c 


- $ ./main 
input two num:5 6 


5+6= 11 





图 3.3.2.1 程序 测试 

可 以 看 出 我 们 的 代码 按照 我 们 所 设想 的 工作 了 , 使 用 命令 “gcc main.c calcu.c input.c -o main” 
看 起 来 很 简单 是 吧 ， 只 需要 一 行 就 可 以 完成 编译 ， 但 是 我 们 这 个 工程 只 有 三 个 文件 啊 ! 如 果 几 
干 个 文件 呢 ? 再 就 是 如 果 有 一 个 文件 被 修改 了 以 ， 使 用 上 面 的 命令 编译 的 时 候 所 有 的 文件 都 会 
重新 编译 ， 如 果 工 程 有 几 万 个 文件 (Linux 源码 就 有 这 么 多 文件 ! )， 想 想 这 几 万 个 文件 编译 一 次 
所 需要 的 时 间 就 可 怕 。 最 好 的 办 法 肯定 是 哪个 文件 被 修改 了 ， 只 编译 这 个 被 修改 的 文件 即 可 ， 
其 它 没 有 修改 的 文件 就 不 需要 再 次 重新 编译 了 ， 为 此 我 们 改变 我 们 的 编译 方法 ， 如 果 第 一 次 编 
译 工程 ， 我 们 先 将 工程 中 的 文件 都 编译 一 遍 ， 然 后 后 面 修改 了 哪个 文件 就 编译 哪个 文件 ， 命 令 
如 下 : 


gcc -c main.c 













































































































































































gcc -c input.c 
gce -c calcu.c 


gcc main.o input.o calcu.o -o main 
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上 述 命令 前 三 行 分 别 是 将 main.c. input.c 和 calcu.c 编译 成 对 应 的 .o 文件 ， 所 以 使 用 了 “- 




















c" 选项 ,“-c” 选 项 我 们 上 面 说 了 ,是 只 编译 不 链接 。 最 后 一 行 命令 是 将 编译 出 来 的 所 有 .o 文件 
链接 成 可 执行 文件 main。 假 如 我 们 现在 修改 了 calcu.c 这 个 文件 ， 只 需要 将 caclue.c 这 一 个 文件 
重新 编译 成 .o 文件 ， 然 后 在 将 所 有 的 .o 文件 链接 成 可 执行 文件 即 ， 只 需要 下 面 两 条 命令 即 可 : 


gcc -c calcu.c 












































gcc main.o input.o calcu.o -o main 

但 是 这 样 就 又 有 一 个 问题 ,如果 修 改 的 文件 一 多 ,我 自己 可 能 都 不 记得 哪个 文件 修改 过 了 ， 
然后 忘记 编译 ， 然 后 .…...， 为 此 我 们 需要 这 样 一 个 工具 : 

1、 如 果 工 程 没 有 编译 过 ， 那 么 工程 中 的 所 有 .c 文件 都 要 被 编译 并 且 链 接 成 可 执行 程序 。 

2、 如 果 工 程 中 只 有 个 别 C 文件 被 修改 了 ， 那 么 只 编译 这 些 被 修改 的 C 文件 即 可 。 

3、 如 果 工 程 的 头 文 件 被 修改 了 ， 那 么 我 们 需要 编译 所 有 引用 这 个 头 文件 的 C 文件 ， 并 
链接 成 可 执行 文件 。 

很 明显 , 能 够 完成 这 个 功能 的 就 是 Makefile T, 在 工程 目录 下 创建 名 为 "Makefile” 的 文件 ， 
文件 名 一 定 要 叫做 “Makefile”!!! 区 分 大 小 写 的 哦 ! 如 图 3.3.2.2 所 示 : 

$ls 











































































































calcu.c calcu.h input.c input.h main.c | Makefile 








图 3.3.2.2 Makefile 文件 
在 图 3.3.2.2 中 Makefile 和 C 文件 是 处 于 同一 个 目录 的 ,在 Makefile 文件 中 输入 如 下 代码 : 
示例 代码 3.3.2.6 Makefile 文件 代码 


meane neue eae 





























gee -o main main © TinuE:0 Calc. 
manm amann 

GEC =C meL G 
Lont- O: impute 

gee =e Lout- E 
caleu 03 calcu © 


Gee —e eelcu e 


Ce o o DE YE C CO MESES 


10 clean: 
11 A O 


iZ rm main 


上 述 代 码 中 所 有 行 首 需要 空 出 来 的 地 方 一 定 要 使 用 “TAB ” 键 ! 不 要 使 用 空格 键 ! 这 是 












































Makefile 的 语法 要 求 ， 编 写 好 得 Makefile 如 图 3.3.2.3 所 示 : 
main.o input.o calcu.o 


main.c 
input.c 


calcu.c 
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图 3.3.2.3 Makefile 源码 

Makefile 编写 好 以 后 我 们 就 可 以 使 用 Make 命令 来 编译 我 们 的 工程 了 ， 直 接 在 命令 行 中 输 
入 “Make” 即 可 ，Make 命令 会 在 当前 目录 下 查找 是 否 存 在 “Makefile” 这 个 文件 ， 如 果 存 在 的 
话 就 会 按照 Makefile 里 面 定义 的 编译 方式 进行 编译 ， 如 图 3.3.2.4 所 示 : 

































































ini 














- $ ls 
calcu.c calcu.h input.c input.h main.c Makefile 
- $ make 
gcc -c main.c 
gcc -c input.c 
gcc -c calcu.c 
gcc -o main main.o input.o calcu.o 
- $ ls 
calcu.c calcu.o input.h main.o 
calcu.h input.c input.o main.c Makefile 


图 3.3.2.4 Make 编译 工程 
在 图 3.3.2.4 中 ， 使 用 命令 “Make” 编 译 完成 以 后 就 会 在 当前 工程 目录 下 生成 各 种 .o 和 可 
执行 文件 ， 说 明 我 们 编译 成 功 了 。 使 用 Make 命令 编译 工程 的 时 候 可 能 会 提示 如 图 3.3.2.5 所 示 


yx: 













































































$ make 





Makefile:2: *** missing separator. 停止 。 


图 3.3.2.5 Make 失败 

图 3.3.2.5 中 的 错误 来 源 一 般 有 两 点 : 

1、Makefile 中 命令 缩 进 没 有 使 用 TAB 键 ! 

2. VI/VIM 编辑 器 使 用 空格 代替 了 TAB 键 ， 修 改 文件 /etc/vimy/vimrc， 在 文件 最 后 面 加 上 如 
下 所 示 代 码 : 
set noexpandtab 

我 们 修改 一 下 input.c 文件 源码 ， 随 便 加 几 行 空 行 就 行 了 ， 保 证 input.c 被 修改 过 即 可 ,修改 
完成 以 后 再 执行 一 下 “Make” 命 令 重新 编译 一 下 工程 ， 结 果 如 图 3.3.2.6 所 示 ; 


$ make 












































gcc -c input.c 
gcc -o main main.o input.o calcu.o 


图 3.32.6 重新 编译 工程 


























从 图 3.3.2.6 中 可 以 看 出 因为 我 们 修改 了 input.c 这 个 文件 ， 所 以 inputc 和 最 后 的 可 执行 文 
件 main 重新 编译 了 ， 其 它 没有 修改 过 的 文件 就 没有 编译 。 而 且 我 们 只 需要 输入 “Make” 这 个 
命令 即 可 ,非常 方便 ,但 是 Makefile 里 面 的 代码 都 是 什么 意思 呢 ? 这 就 是 接 下 来 我 们 要 讲解 的 。 
























































3.4 Makefile 语法 


3.4.1 Makefile 规则 格式 


Makefile 里 面 是 由 一 系列 的 规则 组 成 的 ， 这 些 规则 格式 如 下 ; 
目标 …... : 依赖 文件 集合 …… 
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比如 下 面 这 条 规则 : 


main: main.o inputo calcu.o 











gcc -o main main.o inputo calcu.o 

这 条 规则 的 目标 是 main, main.o. input.o 和 calcu.o 是 生成 main 的 依赖 文件 ， 如 果 要 更 新 
目标 main， 就 必须 要 先 更 新 它 的 所 有 依赖 文 ， 如 果 依 赖 文 件 中 的 任何 一 个 有 更 新 ， 那 么 目标 也 
必须 更 新 ,“ 更 新 ”就 是 执行 一 遍 规 则 中 的 命令 列表 。 

命令 列表 中 的 每 条 命令 必须 以 TAB 键 开 始 ， 不 能 使 用 空格 ! 

命令 列表 中 的 每 条 命令 必须 以 TAB 键 开 始 ， 不 能 使 用 空格 

命令 列表 中 的 每 条 命令 必须 以 TAB 键 开 始 ， 不 能 使 用 空格 ! 

make 命令 会 为 Makefile 中 的 每 个 以 TAB 开始 的 命令 创建 一 个 Shell 进程 去 执行 。 

了 解 了 Makefile 的 基本 运行 规则 以 后 我 们 再 来 分 析 一 下 3.3 节 中 “示例 代码 3.3.2.6” 中 的 
Makefile， 代 人 码 如 下 : 



















































































men Wüscua.oO input © calcu. © 
gee -70 main main © imput-© calcu. © 
menn- OE meum. C 


GCE =C nee 


GCE =e INPUT E 
calicut or tea eune 


1 

2 

3 

4 

5  ampxuESOos Jp 
6 

q 

8 GCE e Caleu, 
9 


10 clean 
BI icWÜ $5 5) 
12 rm main 





上 述 代码 中 一 共有 5 条 规则 ，1~2 行为 第 一 条 规则 ，3~4 行为 第 二 条 规则 ，5~6 行为 第 三 条 
规则 ，7~8 行为 第 四 条 规则 ，10~12 为 第 五 条 规则 ，make 命令 在 执行 这 个 Makefile 的 时 候 其 执 
行 步骤 如 下 : 
首先 更 新 第 一 条 规则 中 的 main， 第 一 条 规则 的 目标 成 为 默认 目标 ， 只 要 默认 目标 更 新 了 那 
么 就 认为 Makefile 的 工作 ， 完 成 了 整个 Makefile 就 是 为 了 完成 这 个 工作 。 在 第 一 次 编译 的 时 候 
由 于 main 还 不 存在 , 因此 第 一 条 规则 会 执行 ,第 一 条 规则 依赖 于 文件 main.o, input.o 和 calcu.o 
这 个 三 个 .o 文件 ， 这 三 个 .o 文件 目前 还 都 没有 ， 因 此 必须 先 更 新 这 三 个 文件 。make 会 查找 以 这 
三 个 .o 文件 为 目标 的 规则 并 执行 。 以 main.o 为 例 ， 发 现 更 新 main.o 的 是 第 二 条 规则 ， 因 此 会 执 
行 第 二 条 规则 ， 第 二 条 规则 里 面 的 命令 为 “gcc -c main.c”， 这 行 命令 很 熟悉 了 吧 ， 就 是 不 链接 
编译 main.c, 生成 main.o, 其 它 两 个 .o 文件 同 理 。 最 后 一 个 规则 目标 是 clean; 它 没 有 依赖 文件 ， 
因此 会 默认 为 依赖 文件 都 是 最 新 的 ， 所 以 其 对 应 的 命令 不 会 执行 ， 当 我 们 想 要 执行 clean 的 话 
可 以 直接 使 用 命令 “make clean”， 执 行 以 后 就 会 删除 当前 目录 下 所 有 的 .o 文件 以 及 main， 因 此 
clean 的 功能 就 是 完成 工程 的 清理 , “make clean” 的 执行 过 程 如 图 3.4.1.1 所 示 : 
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$ ls 
calcu.c calcu.o input.h main.o 
calcu.h input.c input.o main.c Makefile 

- $ make clean 
rm *.0 
rm main 


- 30 E- 
calcu.c calcu.h input.c input.h main.c Makefile 





图 3.4.1.1 make clean 执行 过 程 

从 图 3.4.1.1 可 以 看 出 ， 当 执行 “make clean” 命 令 以 后 ， 前 面 编译 出 来 的 .o 和 main 可 执行 
文件 都 被 删除 掉 了 ， 也 就 是 完成 了 工程 清理 工作 。 

我 们 在 来 总 结 一 下 Make 的 执行 过 程 : 

1、make 命令 会 在 当前 目录 下 查找 以 Makefile(makefile 其 实 也 可 以 ) 命 名 的 文件 。 

2、 当 找到 Makefile 文件 以 后 就 会 按照 Makefile 中 定义 的 规则 去 编译 生成 最 终 的 目标 文件 。 

3、 当 发 现 目标 文件 不 存在 ， 或 者 目标 所 依赖 的 文件 比 目 标 文件 新 (也 就 是 最 后 修改 时 间 比 
目标 文件 晚 ) 的 话 就 会 执行 后 面 的 命令 来 更 新 目标 。 

这 就 是 make 的 执行 过 程 ，make 工具 就 是 在 Makefile 中 一 层 一 层 的 查找 依赖 关系 ， 并 执行 
相应 的 命令 .编译 出 最 终 的 可 执行 文件 .Makefile 的 好 处 就 是 “自动 化 编译 ”一 旦 写 好 了 Makefile 
文件 ， 以 后 只 需要 一 个 make 命令 即 可 完成 整个 工程 的 编译 ， 极 大 的 提高 了 开发 效率 。 把 make 




















































































































和 Makefile RISE < 类 似 ， 目 标 都 是 呈现 出 nm 














make 工具 BUR 负责 将 材料 加 工 成 cum 









































gcc 编译 器 厨具 加 工 “ 美 味 ” 的 工具 。 
Makefile 食材 加 工 美味 所 需 的 原材料 。 
最 终 的 可 执行 文件 ”| 最 终 的 菜 看 最 终 目的 ， 呈 现 盛宴 











表 3.4.1.1 make 和 做 菜 对 比 

总 结 一 下 ，Makefile 中 规则 用 来 描述 在 什么 情况 下 使 用 什么 命令 来 构建 一 个 特定 的 文件 ， 
这 个 文件 就 是 规则 的 “目标 ” 为 了 生成 这 个 “目标 ”而 作为 材料 的 其 它 文 件 称 为 “目标 ”的 依 
赖 ， 规 则 的 命令 是 用 来 创建 或 者 更 新 目标 的 。 

除了 Makefile 的 “终极 目标 ”所 在 的 规则 以 外 ， 其 它 规则 的 顺序 在 Makefile 中 是 没有 意义 
的 ,“ 终 极目 标 ” 就 是 指 在 使 用 make 命令 的 时 候 没 有 指定 具体 的 目标 时 ，make 默认 的 那个 目 
标 ， 它 是 Makefile 文件 中 第 一 个 规则 的 目标 ， 如 果 Makefile 中 的 第 一 个 规则 有 多 个 目标 ， 那 么 
这 些 目标 中 的 第 一 个 目标 就 是 make 的 “终极 目标 ”。 






























































3.4.2 Makefile 变量 
ER C 语言 一 样 Makefile 也 支持 变量 的 ， 先 看 一 下 前 面 的 例子 : 


mains üscumao ide. calcu. o 





gee -0 main main- © input- -© (Ceu. o) 

上 述 Makefile 语句 中 ，main.o input.o 和 calcue.o 这 三 个 依赖 文件 ， 我 们 输入 了 两 遍 ， 我 们 
这 个 Makefile 比较 小 ， 如 果 Makefile 复杂 的 时 候 这 种 重复 输入 的 工作 就 会 非常 费时 间 ， 而 且 非 
常 容 易 输 错 ， 为 了 解决 这 个 问题 ，Makefile 加 入 了 变量 支持 。 不 像 C 语言 中 的 变量 有 int、char 
等 各 种 类 型 , Makefile 中 的 变量 都 是 字符 串 ! 类 似 C 语言 中 的 宏 。 使 用 变量 将 上 面 的 代码 修改 ， 
修改 以 后 如 下 所 示 : 



































示例 代码 3.4.2.1 Makefile 变量 使 用 
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1 #Makefile 变量 的 使 用 


2 objects =< main.o input.o calcu.o 





3 main: $(objects) 
4 gcc -o main $(objects) 

我 们 来 分 析 一 下 “示例 代码 3.4.2.1”, 第 1 行 是 注释 ，Makefile 中 可 以 写 注释 ， 注 释 开 头 要 
用 符号 “#” 不 能 用 C 语言 中 的 “/” 或 者 “/##/”! 第 2 行 我 们 定义 了 一 个 变量 objects， 并 上 且 
给 这 个 变量 进行 了 赋值 ,其 值 为 字符 串 “main.o input.o calcu.0”, 第 3 和 4 行使 用 到 了 变量 objects， 
Makefile 中 变量 的 引用 方法 是 “$( 变 量 名 )”， 比如 本 例 中 的 “$(objects)” 就 是 使 用 变量 objects。 
在 “示例 代码 3.4.2.1” 中 我 们 在 定义 变量 objects 的 时 候 使 用 “=” 对 其 进行 了 赋值 , Makefile 
变量 的 赋值 符 还 有 其 它 两 个 “:=” 和 “?=” 我 们 来 看 一 下 这 三 种 赋值 符 的 区 别 : 

1、 赋 值 符 “=” 

使 用 “= ”在 给 变量 的 赋值 的 时 候 , 不 一 定 要 用 已 经 定义 好 的 值 , 也 可 以 使 用 后 面 定 义 的 值 ， 
比如 如 下 代码 : 



























































































































































示例 代码 3.4.2.1 赋值 符 "=" 使 用 
name 三 zzk 
curname - me) 


name = zuozhongkai 


penmi 
Gecho curname: $ (curname) 

我 们 来 分 析 一 下 上 述 代码 ， 第 1 行 定义 了 一 个 变量 name， 变 量 值 为 “zzk” 58 2 行 也 定义 
了 一 个 变量 curname, curname 的 变量 值 引用 了 变量 name, 按照 我 们 C 写 语言 的 经 验 此 时 curname 
的 值 就 是 “zzk” 第 3 行将 变量 name 的 值 改 为 了 “zuozhongkai” 第 5. 6 行 是 输出 变量 curname 
的 值 。 在 Makefile 要 输出 一 串 字 符 的 话 使 用 “echo”， 就 和 C 语言 中 的 “printf” 一 样 ， 第 6 行 
的 “echo” 前 面 加 了 个 “@” 符 号， 因为 Make 在 执行 的 过 程 中 会 自动 输出 命令 执行 过 程 ， 在 
令 前 面 加 上 “@” 的 话 就 不 会 输出 命令 执行 过 程 ,大 家 可 以 测试 一 下 不 加 “@” 的 效果 。 使 用 
令 “make print” 来 执行 上 述 代 码 ， 结 果 如 图 3.4.2.1: 


































































































命 
命 
$ make print 


d 
图 3.4.2.1 make 执行 结 
在 图 3.4.2.1 中 可 以 看 到 curname 的 值 不 是 “zzk” 竟然 是 “zuozhongkai” 也 就 是 变量 “name” 
最 后 一 次 赋值 的 结果 ， 这 就 是 赋值 符 “=” 的 神奇 之 处 ! 借助 另外 一 个 变量 ， 可 以 将 变量 的 真实 
值 推 到 后 面 去 定义 。 也 就 是 变量 的 真实 值 取决 于 它 所 引用 的 变量 的 最 后 一 次 有 效 值 。 
2、 赋 值 符 “:=?” 
在 “示例 代码 3.4.2.1” 上 来 测试 赋值 符 “:=” 修改 “示例 代码 3.4.2.1” 中 的 第 2 行 ， 将 其 
中 的 “=” 改 为 “:=” 修改 完成 以 后 的 代码 如 下 : 
示例 代码 3.4.22 的 使用 





curname: zuozhongkai 

























































































1 name = zzk 
2 curname :- $(name) 
3 name = zuozhongkai 


4 
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5 Em 
6 Qecho curname: $ (curname) 





修改 完成 以 后 重新 执行 一 下 Makefile， 结 果 如 图 3.4.2.2 所 示 : 





$ make print 


zzk 
si 

图 3.4.2.2 ”make 执行 结果 

从 图 3.4.2.2 中 可 以 看 到 此 时 的 curname 是 zzk, 不 是 zuozhongkai 了 。 这 是 因为 赋值 符 “:=” 
不 会 使 用 后 面 定 义 的 变量 ， 只 能 使 用 前 面 已 经 定义 好 的 ， 这 就 是 “=” 和 “:=” 两 个 的 区 别 。 

3、 赋值 符 «9» 

“?=” 是 一 个 很 有 用 的 赋值 符 ， 比 如 下 面 这 行 代码 : 

curname ?— zuozhongkai 

上 述 代 码 的 意思 就 是 , 如 果 变 量 curname 前 面 没 有 被 赋值 ,那么 此 变量 就 是 “zuozhongkai”， 
如 果 前 面 已 经 赋 过 值 了 ， 那 么 就 使 用 前 面 赋 的 值 。 

4、 变 量 追 加 “+=” 

Makefile 中 的 变量 是 字符 串 ， 有 了 时候 我 们 需要 给 前 面 已 经 定义 好 的 变量 添加 一 些 字符 串 进 
去 ， 此 时 就 要 使 用 到 符号 “+=” 比如 如 下 所 示 代 码 : 


objects = main.o inpiut.o 































































































objects += calcu.o 
一 开始 变量 objects 的 值 为 “main.o inputo”， 后 面 我 们 给 他 追加 了 一 个 “calcu.o”， 因 此 变 
量 objects Æ J “main.o input.o calcu.o”， 这 个 就 是 变量 的 追加 。 











3.4.3 Makefile 模式 规则 


在 3.3.2 小 节 中 我 们 编写 了 一 个 Makefile 文件 用 来 编译 工程 ， 这 个 Makefile 的 内 容 如 下 : 
示例 代码 3.4.3.1 Makefile 文件 代码 


maim main- © input -© cCalcu. © 


























gee -0 main main-© inpuc-© Celou © 
main.o: main.c 

gee =e edm. 
uput- ©: abes s € 

GEC =E IMONE 
caelcu.os Gmlcu.c 


Gee e Gelieu..e 


WO I CU ESCONDE ES 


WO eleans 
11 ie 1 5) 
T2 rm main 
EIR Makefile 中 第 3-8 行 是 将 对 应 的 .c 源 文件 编译 为 .o 文件 , 每 一 个 C 文件 都 要 写 一 个 对 
应 的 规则 ， 如 果 工 程 中 C 文件 很 多 的 话 显然 不 能 这 么 做 。 为 此 ， 我 们 可 以 使 用 Makefile 中 的 模 
式 规 则 ， 通 过 模式 规则 我 们 就 可 以 使 用 一 条 规则 来 将 所 有 的 .c 文件 编译 为 对 应 的 .o 文件 。 
模式 规则 中 , 至少 在 规则 的 目标 定 定 义 中 要 包涵 “%” 否则 就 是 一 般 规则 , 目标 中 的 “%” 
表示 对 文件 名 的 匹配 ,“%” 表 示 长 度 任意 的 非 空 字符 串 ， 比 如 “%.c” 就 是 所 有 的 以 .c 结尾 的 
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文件 ， 类 似 与 通配符 ，a.%.c 就 表示 以 a. 开头， 以 .c 结束 的 所 有 文件 。 
当 “%” 出 现在 目标 中 的 时 候 ， 目 标 中 “%” 所 代表 的 值 决定 了 依赖 中 的 “%” 值 ， 使 用 方 














法 如 下 : 
96.0 : %.c 
命令 


因此 “示例 代码 3.4.3.1” 中 的 Makefile 可 以 改 为 如 下 形式 : 
示例 代码 3.4.3.2 模式 规则 使 用 
objects = main.o input.o calcu.o 
main: $(objects) 


gcc -o main $(objects) 


Mer [eet cil Wexp bns HEX S S p) 
oe 
O 


O rm main 

“示例 代码 3.4.3.2" P 5. 6 这 两 行 代码 替代 了 “示例 代码 3.43.1" PHI 3-8 行 代码 ， 
修改 以 后 的 Makefile 还 不 能 运行 ， 因 为 第 6 行 的 命令 我 们 还 没 写 呢 ， 第 6 行 的 命令 我 们 需要 借 
助 男 外 一 种 强大 的 变量 一 自动 化 变量 。 

















3.4.4 Makefile 自动 化 变量 


上 面 讲 的 模式 规则 中 ， 目 标 和 依赖 都 是 一 系列 的 文件 ， 每 一 次 对 模式 规则 进行 解析 的 时 候 
都 会 是 不 同 的 目标 和 依赖 文件 ， 而 命令 只 有 一 行 ， 如 何 通 过 一 行 命令 来 从 不 同 的 依赖 文件 中 生 
成 对 应 的 目标 ? 自动 化 变量 就 是 完成 这 个 功能 的 ! 所 谓 自动 化 变量 就 是 这 种 变量 会 把 模式 中 所 
定义 的 一 系列 的 文件 自动 的 挨个 取出 ， 直 至 所 有 的 符合 模式 的 文件 都 取 完 ， 自 动 化 变量 只 应 该 
出 现在 规则 的 命令 中 ， 常 用 的 自动 化 变量 如 表 3.4.4.1: 





























规则 中 的 目标 集合 ， 在 模式 规则 中 ， 如 果 有 多 个 目标 的 话 ,“$@ ”表示 匹 配 模 




















39 | 式 中 定义 的 目标 集合 。 

so | 当 目 标 是 本 数 库 的 时 候 表示 类 区 中 的 目标 成 员 名 ， 如 果 目 标 不 是 丽 数 库 文件 : 
那么 其 值 为 空 。 

、 REPOR GEI. MUR HOHGEREAE DAS 967 YE UR WA 


“$<” 就 是 符合 模式 的 一 系列 的 文件 集合 。 
$? 所 有 比 目 标 新 的 依赖 目标 集合 ， 以 空格 分 开 。 
所 有 依赖 文件 的 集合 ， 使 用 空格 分 开 ， 如 果 在 依赖 文件 中 有 多 个 重复 的 文件 ， 
“$^” 会 去 除 重复 的 依赖 文件 ， 值 保留 一 份 。 
$+ 和 “$^” 类 似 ， 但 是 当 依 赖 文件 存在 重复 的 话 不 会 去 除 重复 的 依赖 文件 。 
这 个 变量 表示 目标 模式 中 "%" 及 其 之 前 的 部 分 , 如 果 目 标 是 test/a.test.c， 目标 模 
式 为 a.%.c， 那 么 “$* ”就 是 test/a.test。 

表 3.4.4.1 自动 化 变量 
d 3.4.4.1 中 的 7 个 自动 化 变量 中 ， 常 用 的 三 种 : $@、$< 和 $^， 我 们 使 用 自动 化 变量 来 完 





























$^ 


























$* 
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成 “示例 代码 3.4.3.2” 中 的 Makefile， 最 终 的 完整 代码 如 下 所 示 : 
示例 代码 3.4.4.1 自动 化 变量 


objects - main.o input.o calcu.o 


main: $(objects) 


gcc -o main $(objects) 


Ge ug xs 


il 

2 

3 

4 

$ $8.9 8 568 
6 

E 

seme leam: 

9 i t .9 
10 rm main 


上 述 代码 代码 就 是 修改 后 的 完成 的 Makefile， 可 以 看 出 相 比 3.32 小 节 中 的 要 精简 了 很 多 ， 
核心 就 在 于 第 5、6 这 两 行 ， 第 5 行使 用 了 模式 规则 ， 第 6 行使 用 了 自动 化 变量 。 


























3.4.5 Makefile 伪 目 标 


Makefile 有 一 种 特殊 的 目标 一 一 伪 目 标 ， 一 般 的 目标 名 都 是 要 生成 的 文件 ， 而 伪 目 标 不 代 
表 真 正 的 目标 名 ， 在 执行 make 命令 的 时 候 通 过 指定 这 个 伪 目 标 来 执行 其 所 在 规则 的 定义 的 命 


令 。 














使 用 伪 目 标的 主要 是 为 了 避免 Makefile 中 定义 的 只 执行 命令 的 目标 和 工作 目录 下 的 实际 文 
件 出 现 名 字 冲 突 ， 有 时 候 我 们 需要 编写 一 个 规则 用 来 执行 一 些 命令 ， 但 是 这 个 规则 不 是 用 来 创 
建文 件 的 ， 比 如 在 前 面 的 “示例 代码 3.4.4.1” 中 有 如 下 代码 用 来 完成 清理 工程 的 功能 


clean: 



























































rm *.0 
rm main 
上 述 规则 中 并 没有 创建 文件 clean 的 命令 ， 因 此 工作 目录 下 永远 都 不 会 存在 文件 clean, 24 
我 们 输入 “make clean” 以 后 ， 后 面 的 “rm*.o0” 和 “rm main” 总 是 会 执行 。 可 是 如 果 我 们 “ 手 
JE", 在 工作 目录 下 创建 一 个 名 为 “clean” 的 文件 ， 那 就 不 一 样 了 ， 当 执行 “make clean” 的 时 
候 ， 规 则 因为 没有 依赖 文件 ， 所 以 目标 被 认为 是 最 新 的 ， 因 此 后 面 的 rm 命令 也 就 不 会 执行 , 我 
们 预先 设想 的 清理 工程 的 功能 也 就 无 法 完成 。 为 了 避免 这 个 问题 ， 我 们 可 以 将 clean 声明 为 伪 
目标 ， 声 明 方式 如 下 : 
.PHONY : clean 
我 们 使 用 伪 目 标 来 更 改 “ 示 例 代 码 3.4.4.1”， 修 改 完成 以 后 如 下 : 
示例 代码 3.4.5.1 伪 目 标 


objects > main.o input.o calcu.o 


















































i 





























main: $(objects) 


gcc -o main $(objects) 


(ag & o 


1 

2 

3 

4 

SHON ee la 
6 

7 

8 gee ce Ss 
9 
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10 eleans 
ial m wo) 
122 rm main 
上 述 代码 第 5 行 声明 clean 为 伪 目 标 ， 声 明 clean 为 伪 目 标 以 后 不 管 当前 目录 下 是 否 存 在 名 
为 “clean” 的 文件 ， 输 入 “make clean” 的 话 规则 后 面 的 rm 命令 都 会 执行 。 














3.4.6 Makefile 条 件 判 断 


在 C 语言 中 我 们 通过 条 件 判断 语句 来 根据 不 同 的 情况 来 执行 不 同 的 分 支 ，Makefile 也 支持 
条 件 判 断 ， 语 法 有 两 种 如 下 : 

< 条 件 关 键 字 > 

< 条 件 为 真 时 执行 的 语句 > 

endif 

以 及 : 

STI AXE 
< 条 件 为 真 时 执行 的 语句 > 





























else 





< 条 件 为 假 时 执行 的 语句 > 

endif 

其 中 条 件 关 键 字 有 4 个 : ifeq、ifneq、ifdef 和 ifndef， 这 四 个 关键 字 其 实 分 为 两 对 、ifeq 与 
ifneq、ifdef 与 ifndef， 先 来 看 一 下 ifeq 和 ifneq，ifeq 用 来 判断 是 否 相 等 ，ifneq 就 是 判断 是 否 不 
相等 ，ifeq 用 法 如 下 : 

ifeq (< 参数 1>, < 参数 2>) 

ifeq “< 参数 1 >”,“ < 参数 2> 

ifeq “< 参数 1>”, “< 参数 2>” 

ifeq “< 参数 1>”, ‘< 参数 2> 

ifeq “< 参数 1^7 , “< 参数 2>” 

上 述 用 法 中 都 是 用 来 比较 “参数 1” 和 “参数 2” 是 否 相 同 ， 如 果 相 同 则 为 真 ,“ 参 数 1” 和 
“参数 2” 可 以 为 函数 返回 值 。ifneq 的 用 法 类 似 ， 只 不 过 ifneq 是 用 来 了 比较 “参数 1” 和 “ 参 
数 2” 是 否 不 相等 ， 如 果 不 相等 的 话 就 为 真 。 

ifdef 和 ifndef 的 用 法 如 下 : 

ifndef < 变量 名 > 

如 果 “ 变 量 名 ”的 值 非 空 ， 那 么 表示 表达 式 为 真 ， 否 则 表达 式 为 假 。“ 变 量 名 ”同样 可 以 是 
一 个 函数 的 返回 值 。ifndef 用 法 类 似 ， 但 是 含义 用 户 ifdef 相反 。 
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3.4.7 Makefile 函数 使 用 


Makefile 支持 函数 , 类 似 C 语言 一 样 , Makefile 中 的 函数 是 已 经 定义 好 的 , 我 们 直接 使 用 ， 
不 支持 我 们 自 定义 函数 。make 所 支持 的 函数 不 多 ， 但 是 绝对 够 我 们 使 用 了 ， 函 数 的 用 法 如 下 ; 

SHAE 参数 集合 ) 
或 者 

${ 函 数 名 参数 集合 } 

可 以 看 出 ， 调 用 函数 和 调用 普通 变量 一 样 ， 使 用 符号 “$” 来 标识 。 参 数 集合 是 函数 的 多 个 
参数 ， 参 数 之 间 以 逗号 “,” 隔 开 ， 函 数 名 和 参数 之 间 以 “空格 ”分 隔 开 ， 函 数 的 调用 以 “$” 开 
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头 。 接 下 来 我 们 介绍 几 个 常用 的 函数 ， 其 它 的 函数 大 家 可 以 参考 《 跟 我 一 起 写 Makefile》 这 份 
文档 。 

1. AŽ subst 

函数 subst 用 来 完成 字符 串 蔡 换 ， 调 用 形式 如 下 : 

$(subst <from>,<to>,<text>) 

此 函数 的 功能 是 将 字符 串 <tex 人 中 的 <from> 内 容 替 换 为 <to>， 函 数 返回 被 替换 以 后 的 字符 
比如 如 下 示例 : 

$(subst zzk,ZZK,my name is zzk) 

把 字符 串 “my name is zzk” 中 的 “zzk” 蔡 换 为 “ZZK” 蔡 换 完成 以 后 的 字符 串 为 “myname 
is ZZK”. 

2、 函 数 patsubst 

函数 patsubst 用 来 完成 模式 字符 串 蔡 换 ， 使 用 方法 如 下 : 

$(patsubst <pattern>,<replacement>,<text>) 

此 函数 查找 字符 串 <text> 中 的 单词 是 否 符合 模式 <pattern>， 如 果 匹 配 就 用 <replacement> 来 
替换 掉 ，<pattern> 可 以 使 用 包括 通配符 “%” 表示 任意 长 度 的 字符 串 ， 函 数 返 回 值 就 是 替换 后 
的 字符 串 。 如 果 <replacemen 人 > 中 也 包涵 “%”， 那 么 <replacement> 中 的 “%” 将 是 <pattern> 中 的 
那个 “%” 所 代表 的 字符 串 ， 比 如 : 

$(patsubst %.c,%.0,a.c b.c c.c) 

将 字符 串 “a.cb.cc.c” 中 的 所 有 符合 “%.c” 的 字符 串 ， 替 换 为 “%.o”， 蔡 换 完 成 以 后 的 字 
符 串 为 “a.o b.o c.0”。 

3、 函 数 dir 

函数 dir 用 来 获取 目录 ， 使 用 方法 如 下 : 

$(dir <names…>) 

此 函数 用 来 从 文件 名 序列 <names> 中 提取 出 目录 部 分 , 返回 值 是 文件 名 序列 <names> 的 目录 

$(dir </src/a.c>) 

提取 文件 “/src/a.c” 的 目录 部 分 ， 也 就 是 “/src”。 

4、 函 数 notdir 

函数 notdir 看 名 字 就 是 知道 去 除 文件 中 的 目录 部 分 ， 也 就 是 提取 文件 名 ， 用 法 如 下 : 

$notdir <names…>) 

此 函数 用 与 从 文件 名 序列 <names> 中 提取 出 文件 名 非 目 录 部 分 ， 比 如 : 

$(notdir </src/a.c>) 

提取 文件 “/src/a.c” 中 的 非 目 录 部 分 ， 也 就 是 文件 名 “a.c”。 

5, KÆ foreach 

foreach 函数 用 来 完成 循环 ， 用 法 如 下 : 

$(foreach <var>, «list»,«text^) 

此 函数 的 意思 就 是 把 参数 <list> 中 的 单词 逐一 取出 来 放 到 参数 <var> 中 , 然后 再 执行 <text> 所 
包含 的 表达 式 。 每 次 <text> 都 会 返回 一 个 字符 串 ， 循 环 的 过 程 中 ，<text> 中 所 包含 的 每 个 字符 串 
会 以 空格 隔 开 , 最 后 当 整 个 循环 结束 时 , <tex 仿 所 返回 的 每 个 字符 串 所 组 成 的 整个 字符 串 将 会 是 
函数 foreach 函数 的 返回 值 。 
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6. PRA wildcard 

通配符 “%” 只 能 用 在 规则 中 ,只 有 在 规则 中 它 才 会 展开 ,如果 在 变量 定义 和 函数 使 用 时 ， 
通配符 不 会 自动 展开 ， 这 个 时 候 就 要 用 到 函数 wildcard， 使 用 方法 如 下 : 

$(wildcard PATTERN…) 

比如 : 

$(wildcard *.c) 

上 面 的 代码 是 用 来 获取 当前 目录 下 所 有 的 .c 文件 ， 类 似 “%”。 

关于 Makefile 的 相关 内 容 就 讲解 到 这 里 ， 本 节 只 是 对 Makefile 做 了 最 基本 的 讲解 ， 确 保 大 
家 能 够 完成 后 续 的 学 习 ，Makefile 还 有 大 量 的 知识 没有 提 到 ， 有 兴趣 的 可 以 自行 参考 《 跟 我 一 
起 写 Makefile》 这 份 文档 来 深入 学 习 Makefile。 
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第 二 篇 裸 机 开发 篇 








前 面 几 章 都 是 Ubuntu/Linux 的 基础 操作 ， 没 有 涉及 到 开发 ， 从 本 篇 开始 我 们 就 开始 实战 操 
作 。 本 篇 讲解 ARM 的 裸 机 开发 ， 也 就 是 不 带 操作 系统 开发 ， 就 和 我 们 开发 STM32 一 样 ， 如 果 
有 STM32 开发 经 验 的 话 学 起 本 篇 会 很 容易 。 为 什么 我 们 要 先 学 习 裸 机 开发 呢 ? 

1、 裸 机 开发 是 了 解 所 使 用 的 CPU 最 直接 、 最 简单 的 方法 ， 比 如 本 教程 使 用 的 LMX6U， 跟 
STM32 一 样 ， 裸 机 开发 是 直接 操作 CPU 的 寄存 器 。Linux 驱动 开发 最 终 也 是 操作 的 寄存 器 ， 但 
是 在 操作 寄存 器 之 前 要 先 编写 一 个 符合 Linux 驱动 的 框架 。 同 样 一 个 点 灯 驱 动 ， 裸 机 可 能 只 需 
要 十 几 行 代码 ， 但 是 Linux 下 的 驱动 就 需要 几 十 行 代码 。 

2、 大 部 分 Linux 驱动 初学 者 都 是 从 STM32 转 过 来 的 ，Linux 驱动 开发 和 STM32 开发 区 别 
IRK, EEU Linux 没有 MDK, IAR 这 样 的 集成 开发 环境 ， 需 要 我 们 自己 在 Ubuntu 下 搭建 交叉 
编译 环境 。 直 接 上 手 Linux 驱动 开发 可 能 会 因为 和 STM32 巨大 的 开发 差异 而 打击 学 习 信心 。 

3、 裸 机 开发 是 连接 Cortex-M (如 STM32) 单片机 和 Cortex-A( 如 I.MX6U) 处 理 器 的 桥梁 ， 
笔者 为 了 帮助 STM32 开发 者 以 最 小 的 代价 转换 到 Linux. 驱动 开发 ， 精 心 准备 了 十 几 个 裸 机 例 
程 ， 根 据 笔者 4 年 的 STM32 开发 板 经 验 ， 合 理 的 安排 各 个 裸 机 例 程 。 使 用 STM32 开发 方式 来 
学 习 Cortex-A(I.MX6U)， 降 低 入 门 难度 。 通 过 这 十 几 个 裸 机 例 程 也 可 以 反哺 STM32， 掌 握 很 多 
MDK, IAR 这 种 集成 开发 环境 没有 告诉 你 的 “干货 ”。 
废话 不 多 说 ， 开 干 吧 !!! 
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第 四 章 开发 环境 搭建 








要 进行 裸 机 开发 肯定 要 先 搭 建 好 开发 环境 ， 我 们 在 开始 学 习 STM32 的 时 候 肯 定 需要 安装 


一 堆 的 软件 ， 比 如 MDK、IAR、 串 口 调试 助手 等 等 ， 这 个 就 是 STM32 的 开发 环境 搭建 。 同 样 





的 ， 要 想 在 Ubuntu 下 进行 Cortex-A(LMX6U) 开 发 也 需要 安装 一 些 软件 ， 也 就 是 网 上 说 的 开发 
环境 搭建 , 环境 搭建 好 以 后 我 们 就 可 以 进行 开发 了 。 环境 搭建 分 为 Ubuntu 和 Windows， 因 为 我 
们 最 熟悉 Windows， 所 以 代码 编写 、 查 找 资料 喻 的 肯定 是 在 Windows 下 进行 的 。 但 是 Linux JF 









































发 又 必须 在 Ubuntu 下 进行 ,所 以 还 需要 搭建 Ubuntu 下 的 开发 环境 , 主要 是 交叉 编译 器 的 安装 ， 
本 章 我 们 就 分 为 Ubuntu 和 Windows， 讲 解 这 两 种 操作 系统 下 的 环境 搭建 。 
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4.1 Ubuntu 和 Windows 文件 互 传 


在 开发 的 过 程 中 会 频繁 的 在 Windows 和 Ubuntu 下 进行 文件 传输 ， 比 如 在 Windwos 下 进行 




















代码 编写 ， 然 后 将 编写 好 的 代码 拿 到 Ubuntu 下 进行 编译 。Windows 和 Ubuntu 下 的 文件 互 传 我 
们 需要 使 用 FTP 服务 ， 设 置 方 法 如 下 : 


1、 开 启 Ubuntu 下 的 FTP 服务 


打开 Ubuntu 的 终端 窗口 ， 然 后 执行 如 下 命令 来 安装 FTP 服务 : 
sudo apt-get install vsftpd 
等 待 软件 自动 安装 ， 安 装 完成 以 后 使 用 如 下 VI 命令 打开 /etc/vsftpd.conf， 命 令 如 下 : 
sudo vi /etc/vsftpd.conf 
打开 以 后 vsftpd.conf 文件 以 后 找到 如 下 两 行 
local enable=YES 
write enable=YES 
确保 上 面 两 行 前 面 没 有 “#”， 有 的 话 就 取消 掉 ， 完 成 以 后 如 图 4.1.1 所 示 : 



































































































































local enable-YES 


write enablezYES 





图 4.1.1 vsftpd.conf 修改 
修改 完 vsftpd.conf 以 后 保存 退出 ， 使 用 如 下 命令 重启 FTP 服务 : 
sudo /etc/init.d/vsftpd restart 
2. Windows F FTP 客户 端 安装 
Windows 下 FTP 客户 端 我 们 使 用 FileZilla, 这 是 个 免费 的 FTP 客户 端 软件 , 可 以 在 FileZilla 
官网 下 载 ， 下 载 地 址 如 下 : https://wwwi.filezilla.cn/download， 下 载 界面 如 图 4.1.2 所 示 : 
c i, hao123_ 上 网 从 这 里 开始 x | 党 fileZilla 百度 搜索 x $ E 
< 






















































C û A Gáhtps filezilla.cn of ak- w Ak [15---c 
E IBFilezilla....... 首页 。 功能 下 载 ”博客 更 新 日 志 常见 问题 Q 
H yg IIT AN 
@ 
Filezilla Z — 4h RE RAAE ARRIRA eS im TTC i. B Filezilla Z — RE « BHRSRESETPSE Pri ULL RR SS aA ERBE B 
有 多 种 特色 、 直 觉 的 有 多 种 特色 、 直 觉 的 接口 。 
e 立即 下 载 
Windows Ft Windows 平台 
ndows 版 , Vista, 7, 8 and 8.1 are supported, each both 32 and 64 indow Windows Vista, 7, 8 and 8.1 are ted, e 
W bit. W 32 and 64 bit 
d to 
+ flavour of Linux z 
Hess E4 €) X Vy 下 载 P Q 10096 .: 





图 4.1.2 FileZilla 软件 下 载 
我 们 已 经 下 载 好 FileZilla 并 放 到 开发 板 光盘 中 了 ， 路径 为 :3、 软 件 ->FileZilla_3.39.0_win64- 
setup_bundled.exe， 双 击 安装 即 可 。 安 装 完成 以 后 找到 安装 目录 ， 找 到 图 标 ， 然 后 发 送 图 标 快捷 
方式 到 桌面 ， 完 成 以 后 如 图 4.1.3 所 示 : 
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图 4.1.3 FileZilla 图 标 
打开 FileZilla 软件 ， 界 面 如 图 4.1.4 所 示 : 































































































FileZilla 一 x 
文件 (F) 编辑 (E) 查看 (V) 传输 (D) 服务 器 (S$) 书签 (B) 帮助 (H) 
[et mIORO:.x.rTasd 
主机 (H): 用 户 名 (U): EBW: | HOP): [ esie) ] - 
: |CAUserszzuozhV 
&- R zuozh ^ 
由 -车 Windows 

-æ D: 

申 -wz E (工作 

由 -wz F: (生活 ) 

由 “> G: (仓库 ) 

由 -sz H: (新 加 卷 ) 

由 -< l: (Ubuntu) S 
文件 名 文件 大 小 文件 类 型 最 近 修 改 ^ | 文件 名 文件 大 小 文件 类 型 ”最 近 修改 权限 所 有 者 /组 
a. 
7 android 文件 去 2017-12-13 .… 没有 连接 到 任何 服务 器 
7 eclipse 文件 去 2016-12-19 .… 
T .idlerc 文件 卖 2017-11-03 ... 
7 .oracle_jre.… 文件 去 2016-09-07 .… 
vp? 文件 去 2016-12-19 .… 
T .stm32cub... 文件 去 2016-09-07 ... 
看 .stmcufinder 文件 夹 2017-05-17 ... 
I 3D Objects 文件 夹 2016-10-26 ... 
J AppData tse 2018-10-20 ... 
T Applicatio... 文件 夹 z 
18 个 文件 和 39 个 目录 。 大 小 总 计 : 27,550,389 215 未 连接 。 
服务 器 /本 地 文件 方向 ”远程 文件 大 小 优先 级 状态 





| 列队 的 文件 | 传输 失败 “成 功 的 传输 
€) 队列 : 空 oí 








图 4.1.4 FileZilla 软件 界面 


3. FileZilla 软件 设置 


Ubuntu 作为 FTP 服务 器 ，FileZilla 作为 FTP 客户 端 ， 客 户 端 肯 定 要 连接 到 服务 器 上 ， 打 开 
站 点 管理 器 ， 点 击 : 文件 -> 站 点 管理 器 ， 打 开 以 后 如 图 4.1.5 所 示 : 
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站 点 管理 器 x 





常规 ”高 级 ”传输 设置 字符 集 
HÈT): FTP - 文件 传输 协议 H 


主机 (HY: 端口 (PY: 








加 密 (E): 如 果 可 用 ， 使 用 显 式 的 FTP over TLS v 





登录 类 型 (L): MESS v 





HAR (U): 





TW: 























ER 
| 新 站 点 (N) ””” 新 文件 夫 (F) 
新 建 书签 (M) — 重 命名 (R) 
删除 (D) 复制 (1) 
连接 (C) WEO | DË 











4.1.5 站 点 管理 器 
点 击 图 4.1.5 中 的 “新 站 点 (N)” 按 钮 来 创建 站 点 ， 新 建站 点 以 后 就 会 在 “我 的 站 点 ”下 出 
现 新 建 的 这 个 站 点 ， 站 点 的 名 称 可 以 自行 修改 ， 比 如 我 将 新 的 站 点 命名 为 “Ubuntu” 如 图 4.1.6 





所 示 : 





4.1.6 新 建站 点 
选中 新 创建 的 “Ubuntu” 站 点 ， 然 后 对 站 点 的 “常规 ”进行 设置 ， 设 置 如 图 4.1.7 所 示 : 
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站 点 管理 器 x 
2、 选 中 常规 
选择 项 (S): 
e [mn |an 传输 设置 FNE 
En 我 的 站 点 | 
L.- Ubuntu 协议 (T): 
1、 选 中 站 点 








TES (E): 只 使 用 明文 FTP (不 安全 ) 
3、Ubuntu 系 统 IP 地 





登录 类 型 (LD): 正常 pei 


RU; 


4. Malo. 2e | 


5、Ubuntu 系 统 密码 . 
背景 颜色 (B) 无 v 

















注释 (M): 
新 站 点 (N) 新 文件 夫 () 
EIS) EGER) 6、 设 置 好 以 后 点 击 连 接 


| 删除 (D) ^ $90 











| šo || eo 取消 





图 4.1.7 站 点 设置 
按照 图 4.1.7 中 设置 好 以 后 ， 点 击 “ 连 接 ” 按 钮 ， 第 一 次 连接 可 能 会 弹出 提示 是 否 保存 密码 
的 对 话 框 ， 点 击 确定 即 可 。 连 接 成 功 以 后 如 图 4.1.8 所 示 : 
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Ubuntu - zuozhongkai@192.168.31.235 - FileZilla = x 
文件 (F) 编辑 (E) 查看 (V) 传输 (TD) 服务 器 (S) 书签 (B) 帮助 (H) 

ist TwOnMnO..-3esá4 

主机 (H): 用 户 名 (U): zaw: | O(P): [ameo ] - 

状态 : 列 出 /home/zuozhongkai/C_Program ”的 目录 成 功 


状态 : 读 取 "/home/zuozhongkai" 的 目录 列表 .… Windows 下 的 文件 目录 
状态 : 列 出 /homey/zuozhongkai "的 目录 成 功 



























































本 地 站 点 : | CAUserszuozhV 远程 站 点 :|/home/zuozhongkai 
H- R zuozh H-. zuozhongkai 
H-E Windows H-E C_Program 

由 -> D: | > 

由 -<> E (工作 ) 

四 -ws F: (生活 ) 

外- G: (GÈ) 

H- H: (新 加 卷 ) 

& «> l: (Ubuntu) 











文件 大 小 文件 类 型 最 近 修 改 文件 名 文件 大 小 文件 类 型 


2017-12-13 ... 
2016-12-19 .… 2018-12-2... 
2017-11-03 ... Use 2018-12-1... 
2016-09-07 ... r4 文件 夹 2018-12-1... 
2016-12-19 .… 文件 来 2018-12-1.… 
T .stm32cub... k 2016-09-07 ... m 文件 夹 2018-12-1... 
.stmcufinder 2017-05-17 ... 文件 卖 2018-12-1.… 
2016-10-26 .… A. 文件 去 2018-12-1.… 
2018-10-20 ... 文件 卖 2018-12-1... 
8,980 DESKT.. 2018-12-1... 
2 个 文件 和 9 个 目录 。 大 小 总 计 : 8,980 215 


大 小 优先 级 状态 





GO 队列 : 空 oí 





4.1.8. 连接 成 功 
连接 成 功 以 后 如 图 4.1.8 所 示 ， 其 中 左边 就 是 Windows 文件 目录 ， 右 边 是 Ubunut 文件 目 
录 ， 默 认 进 入 用 户 根 目 录 下 《比如 我 电脑 的 “/home/zuozhongkai”)。 但 是 注意 观察 在 图 4.1.8 中 
Ubuntu 文件 目录 下 的 中 文 目 录 都 是 乱码 的 ， 这 是 因为 编码 方式 没有 选 对 ， 先 断 开 连接 ， 点 击 : 
服务 器 (S)-> 断 开 连 接 ， 然 后 打开 站 点 管理 器 ， 选 中 要 设置 的 站 点 “Ubuntu”， 选 择 “ 字 符 集 ” 


设置 如 图 4.1.9 所 示 : 
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I.MX6U AÑ Linux 驱动 开发 指南 
原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
站 点 管理 器 x 
服务 器 使 用 以 下 的 字符 集 编 码 来 处 理 文件 名 : 
O 自动 检测 (A) 
如 果 服 务 器 支持 就 使 用 UTF-8 , 否则 使 用 本 
选择 "强制 UTF-8" 编码 (E): 
使 用 错误 的 字符 集 可 能 导致 文件 名 显示 不 正 
确 。 
新 站 点 (N) 新 文件 去 (P) 
新 建 书签 (M) 重 命名 (R) 
删除 (D) 复制 (|) 
连接 (C) 确定 (O) 取消 











4.1.9 设置 字符 集 
按照 图 4.1.9 设置 好 字符 集 以 后 重新 连接 到 FTP 服务 器 上 ， 
Ubuntu 下 的 文件 目录 中 文 显 示 就 正常 了 ， 如 图 4.1.10 所 示 : 





EE 新 链接 到 FTP 服务 器 以 后 


limi 
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原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
[A Ubuntu - zuozhongkai@192.168.31.235 - FileZilla — x 
文件 (F) 编辑 (日 查看 v) 传输 (T) 服务 器 (S) 书签 (B) 帮助 (H) 
i -[EET*EOSIRO:.-3-4 
主机 (H): 用 户 名 (U): | SBW: WOP): - 
状态 : 计算 服务 器 时 差 … ^ 
状态 : Timezone offset of server is 0 seconds. 
状态 : 列 出 "/home/zuozhongkai" 的 目录 成 功 
v 
本 地 站 点 : | CAUsersvzuozhV ~ /home/zuozhongkai 
由 - R zuozh ^|g 
H-E Windows J 
由 > D: éd 
由 -wz E: (工作 ) 
由 -sx F: (生活 ) - 
H-a G (仓库 ) Ubunut 下 文件 目录 中 文 显示 正常 
由 -wo H: (新 加 卷 ) 
由 -s l: (Ubuntu) v 
文件 名 文件 大 小 文件 类 型 最 近 修 改 ^ | 文件 名 文件 大 小 文件 类 型 ”最 近 修改 权限 所 有 者 /组 A 
a. 5 
7 android 文件 卖 2017-12-13 ... LIBE: 文件 去 2019-01-0.. drwxrw.. 1000 1... 
F eclipse 文件 夫 2016-12-19 .… | Xu3e 。 2018-12-1.. drwxr.. 1000 1... 
下 .idlerc 文件 夹 2017-11-03 ... 共 的 X3 2018-12-1.. drwxr-x.. 1000 1... 
F oracle jre... 文件 去 2016-09-07 … E 文件 去 2018-12-1.. drwxr-x.. 1000 1... 
T .p2 文件 夹 2016-12-19 .… 文件 夹 2018-12-1.. drwxr-x... 1000 1... 
.stm32cub... 文件 夹 2016-09-07 ... 文件 卖 2018-12-2.. drwxr-x.. 1000 1... 
T ,stmcufinder 文件 夫 2017-05-17 .… 文件 夹 2018-12-1.. drwxr-x.. 1000 1... 
33D Objects 文件 去 2016-10-26 .… vik 2018-12-1.. drwxr-x... 1000 1... 
T AppData 文件 夹 2018-10-20 ... Ac 文件 夫 2018-12-1.. drwxr-x.. 1000 1... 
T Applicatio... Nuts v - 8,980 DESKT.. 2018-12-1.. -rw-r--r-- 1000 1... 
18 个 文件 和 39 个 目录 。 大 小 总 计 : 27,550,389 字 节 2 个 文件 和 9 个 目录 。 大 小 总 计 : 8,980 字 节 
服务 器 /本 地 文件 方向 ”远程 文件 大 小 优先 级 状态 
列队 的 文件 “传输 失败 "成功 的 传输 
DO nar zs LJ 

















图 4.1.10 Ubunut 下 文件 目录 中 文 显示 正常 
如 果 要 将 Windows 下 的 文件 或 文件 夹 拷贝 到 Ubunut 中 ， 只 需要 在 图 4.1.10 中 左 侧 的 
Windows 区 域 选中 要 拷贝 的 文件 或 者 文件 夹 ,然后 直接 拖 到 右 侧 的 Ubuntu 中 指定 的 目录 即 可 。 
将 Ubuntu 中 的 文件 或 者 文件 夹 找 贝 到 Windows 中 也 是 直接 拖 放 。 


4.2 Ubuntu F NFS 和 SSH 服务 开启 























4.2.1 NFS 服务 开启 


后 面 进行 Linux 驱动 开发 的 时 候 需要 NFS 启动 ， 因 此 要 先 安装 并 开启 Ubuntu 中 的 NFS 服 
务 ， 使 用 如 下 命令 安装 NFS 服务 : 

sudo apt-get install nfs-kernel-server portmap 

等 待 安装 完成 ， 安 闭 完 成 以 后 在 用 户 根 目录 下 创建 一 个 名 为 “linux” 的 文件 夹 ， 以 后 所 有 
的 东西 都 放 到 这 个 “linux” 文件 夹 里 面 ， 在 “linux” 文 件 夹 里 面 新 建 一 个 名 为 “nfs” 的 文件 夹 ， 
如 图 4.2.1 所 示 : 
























































:~$ ls 
examples.desktop 
:-$ cd linux/ 


$ ls 





$ 





图 4.2.1 创建 linux 工作 目录 
图 4.2.1 中 创建 的 nfs 文件 夹 供 nfs 服务 器 使 用 ， 以 后 我 们 可 以 在 开发 板 上 通过 网 络 文件 系 
统 来 访问 nfs 文件 夹 ， 要 先 配 置 nfs， 使 用 如 下 命令 打开 nfs 配置 文件 /etc/exports: 


sudo vi /etc/exports 
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打开 /etc/exports 以 后 在 后 面 添加 如 下 所 示 内 容 : 
/home/zuozhongkai/linux/nfs *(rw,sync,no root squash) 
添加 完成 以 后 的 /etc/exports 如 图 4.2.2 所 示 : 




















/home/zuozhongkai/linux/nfs *(rw,sync,no root )| 


图 4.2.2 修改 文件 /etc/exports 
重启 NFS 服务 ， 使 用 命令 如 下 : 


sudo /etc/init.d/nfs-kernel-server restart 























4.2.2 SSH 服务 开启 


开启 Ubuntu 的 SSH 服务 以 后 我 们 就 可 以 在 Windwos 下 使 用 终端 软件 登陆 到 Ubuntu, 比如 
使 用 SecureCRT，Ubuntu 下 使 用 如 下 命令 开启 SSH 服务 : 

sudo apt-get install openssh-server 

ERMS ZR ssh 服务 ，ssh 的 配置 文件 为 /etc/ssh/sshd_config， 使 用 默认 配置 即 可 。 


4.3 Ubuntu 交叉 编译 工具 链 安装 


4.3.1 交叉 编译 器 安装 


ARM 裸 机 、Uboot 移植 、Linux 移植 这 些 都 需要 在 Ubuntu 下 进行 编译 ， 编 译 就 需要 编译 
器 ， 我 们 在 第 三 章 “Linux C 编程 入 门 ” 里 面 已 经 讲解 了 如 何在 Liux 进行 C 语言 开发 ， 里 面 使 
用 GCC 编译 器 进行 代码 编译 ， 但 是 Ubuntu 自 带 的 goc 编译 器 是 针对 X86 架构 的 ! 而 我 们 现在 
要 编译 的 是 ARM 架构 的 代码 , 所 以 我 们 需要 一 个 在 X86 架构 的 PC 上 运行 ,可 以 编译 ARM W 
构 代 码 的 GCC 编译 器 ， 这 个 编译 器 就 叫做 交叉 编译 器 ， 总 结 一 下 交叉 编译 器 就 是 : 

1、 它 肯定 是 一 个 GCC 编译 器 。 

2、 这 个 GCC 编译 器 是 运行 在 X86 架构 的 PC 上 的 。 

3、 这 个 GCC 编译 器 是 编译 ARM 架构 代码 的 , 也 就 是 编译 出 来 的 可 执行 文件 是 在 ARM 20s 
片上 运行 的 。 

交叉 编译 器 中 “交叉 ”的 意思 就 是 在 一 个 架构 上 编译 另外 一 个 架构 的 代码 ， 相 当 于 两 种 架 
XXL” ERTI. 

交叉 编译 器 有 很 多 种 ， 我 们 使 用 Linaro 出 品 的 交叉 编译 器 ，Linaro 一 间 非 营利 性 质 的 开放 
源 代码 软件 工程 公司 ,Linaro 开发 了 很 多 软件 ,最 著名 的 就 是 Linaro GCC 编译 工具 链 (编译 器 )， 
关于 Linaro 详细 的 介绍 可 以 到 Linaro 官网 查阅 。Linaro GCC 编译 器 下 载 地 址 如 下 : 
https://releases.linaro.org/components/toolchain/binaries/latest-7/arm-linux-gnueabihff ， 打 开 以 后 下 
载 界面 如 图 4.3.1.1 所 示 : 
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. VA 一 
原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
© $ Downloads - Linar x BB u = X 
< Q € 1r Â https//www.linaro.org/down EB < 4 2 E R-X- J m.m 口 9: 三 
uate About ~ Membership Engineering » Services ~ Downloads ~ Latest ~ Contact Us Q 
toolchain quarterly releases. Both x8Bó 64 Linux and Mingw32Z (MS Windows compatible) host binaries are provided: 
" 1 > 可 执行 
Latest Linux Targeted Binary Toolchain Releases 下 载 可 执行 文件 
arm-linux-gnueabihf 32-bit Armv7 Cortex-A, hard-float, little-endian Release-Notes Source 
armv8l-linux-gnueabihf 32-bit Armv8 Cortex-A, hard-float, little-endian Release-Notes Binaries Source 
aarchó4-linux-gnu 64-bit Armv8 Cortex-A, little-endian Release-Notes Binaries Source 





Latest Bare-Metal Targeted Binary Toolchain Releases 
arm-eabi 32-bit Armv7 Cortex-A, soft-float, little-endian Release-Notes Binaries Source 


aarchó4-elf 64-bit Armv8 Cortex-A, little-endian Release-Notes Binaries Source 





Interested in other target ABls such as big-endian or soft-float little-endian? All toolchain target ABI and host variants can be 


seen here. Note: Not all ABI and host variants are supported to the same degree. See the release-notes for more information. 


Interested in Cortex-R and Cortex-M bare-metal targeted toolchains for Arm embedded processors? We're working with Arm 


This website uses cookies to ensure you get the best experience on our website. Got it! 





https://www.linaro.org/membership/ [2] [ES] 


图 4.3.1.1 Linaro 下 载 界 面 
在 图 4.3.1.1 中 有 很 多 种 GCC 交叉 编译 工具 链 , 因为 我 们 所 使 用 的 LMX6U-ALPHA 开发 板 
是 一 个 Cortex-A7 内 核 的 开发 板 ， 因 此 选择 arm-linux-gnueabihf， 点 击 后 面 的 “Binaries” 进 入 可 
执行 文件 下 载 界面 ， 如 图 4.3.1.2 所 示 : 









































© *5* Downloads - Linaro Linaro Releases x | 十 uU 一 m x 
《 oO OG Â https//releases.linaro.org/components/toolchain/binaries, $ 4 点 此 搜索 ÜUo-.z 
> cad e 口 手机 收藏 夹 国 Links。 OHAR \ 【FFmp 图 回味 经 典 @U-Boot WimBuboot M (Linux mplayer B, -X%- 了 由- 时. 8$ 


Linaro Connect 


Linaro 
Releases 





Last modified Size License 


会 Parent Directory 

7j gcc-linaro-7.3.1-2018.05-i1686-mingw32 arm-linux-gnueabihf.tar.xz 20-Jun-2018 00:10 326.7M open 
gcc-linaro-7.3.1-2018.05-i1686-mingw32 arm-linux-gnueabihf.tar.xz.asc 19-Jun-2018 11:34 99 open 
园 gcc-linaro-7.3.1-2018.05-i686 arm-linux-gnueabihf.tar.xz 20-Jun-2018 00:11 101.0M open 
gcc-linaro-7.3.1-2018.05-i1686 arm-linux-gnueabihf.tar.xz.asc 19-Jun-2018 11:37 91 open 
| gcc-linaro-7.3.1-2018.05-linux-manifest.txt 19-Jun-2018 11:37  11.0K open 
EE) gcec-linaro-7.3.1-2018.05-win32-manifest.txt 19-Jun-2018 11:38  11.0K open 
园 gcc-linaro-7.3.1-2018.05-x86 64 arm-linux-gnueabihf.tar.xz 20-Jun-2018 00:11 102.1M open 
gcc-linaro-7.3.1-2018.05-x86 64 arm-linux-gnueabihf.tar.xz.asc 19-Jun-2018 11:41 93 open 
© runtime-gcc-linaro-7.3.1-2018.05-arm-linux-gnueabihf.tar.xz 20-Jun-2018 00:11 6.3M open 
runtime-gcc-linaro-7.3.1-2018.05-arm-linux-gnueabihf.tar.xz.asc 19-Jun-2018 11:42 94 open 
73 sysroot-glibc-linaro-2.25-2018.05-arm-linux-gnueabihf.tar.xz 20-Jun-2018 00:11  40.6M open 
sysroot-glibc-linaro-2.25-2018.05-arm-linux-gnueabihf.tar.xz.asc 19-Jun-2018 11:43 225 open 


Running linaro-license-protection cafd425. 


is Xov FEE | 10096 


4.3.1.2 Linaro 交叉 编译 器 下 载 
在 写本 教程 的 时 候 最 新 的 编译 器 版 本 是 7.3.1， 但 是 笔者 在 测试 7.3.1 版 本 编译 器 的 时 候 发 
现 编译 完成 后 的 uboot 无 法 运行 。 所 以 这 里 不 推荐 使 用 最 新 版 的 编译 器 。 笔者 测试 过 4.9 版 本 的 
编译 器 可 以 正 第 工作 ， 所 以 我 们 需要 下 载 4.9 版 本 的 编译 器 ， 下 载 地 址 为 : 

https://releases.linaro.org/components/toolchain/binaries/4.9-2017.01/arm-linux-gnueabihf/ ， 如 图 
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4.3.1.3 所 示 : 
Ie PF Downloads - Linaro Linaro Releases x 十 T — B x 
《 O 6 & https//releases.linaro.org/components/toolchain/binaries, $ 4 点 此 搜索 U9-.z 
D dad; v Leu [Links WAAR \A 【FFrmp 图 回味 经 典 (S U-Boot jAjÆuboot gj (Linux [ mplayer "-x-0omWm-GG-z 











Linaro 
Releases 
Last modified Size License 
会 Parent Directory 
© gcc-linaro-4.9-2017.01.tar.xz 26-Feb-2018 23:50 4 69.6M open 
gcc-linaro-4.9-2017.01.tar.xz.asc 28-Jan-2018 15:58 64 open 
© ger inaro- E 2 E 2017. "a i686- mingwoz arm- linux- "gnuesbini- tere 26- Feb 2018 23: 51 164.1M open 32 位 系统 版 本 


73 gcc- inaro- 4.9.4-2017. TTE i686 | arm- fins ea bi ta 26- Fen- 2018 23: 51 
|cc- -4.9.4-. -1686 arm-linux-gnueabihf.tar.xz.asc -Jan- : 9 
国 gcc- -linaro- P 2 H- 2017. 01- bes manifest: txt 28- 和 2018 15: 58 8.8K 






- - .tar.Xz.asc -Jan- : 9 

73 runtime-gcc- Me 4. 9, 4- 2017. 01- arm-linux-gnueabihf.tar.xz 28- Jan- 2018 15: 58 2.8M open 64 位 系统 版 本 
runtime-gcc-linaro-4.9.4-2017.01-arm-linux-gnueabihf.tarxz.asc 28-Jan-2018 15:58 94 open 

73 sysroot-eglibc-linaro-2017.01-arm-linux-gnueabihf.tar.xz 26-Feb-2018 23:51  33.3M open 
sysroot-eglibc-linaro-2017.01-arm-linux-gnueabihf.tar.xz.asc 28-Jan-2018 15:58 215 open 


VOTE P E Q 1009 








图 4.3.1.3 4.9.4 版 本 编译 器 下 载 

图 43.1.3. 中 有 很 多 种 交叉 编译 器 ， 我 们 只 需要 关注 这 两 种 : gcc-linaro-4.9.4-2017.01- 
1686 arm-linux-gnueabihf.tar.tar.xz 和 gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf.tar.xz, 
第 一 个 是 针对 32 位 系统 的 , 第 二 个 是 针对 64 位 系统 的 。 大 家 根据 自己 所 使 用 的 Ubuntu 系统 类 
型 选择 合适 的 版 本 ， 比 如 我 安装 的 Ubunutu 16.04 是 64 位 系统 ， 因 此 我 要 使 用 gcc-linaro-4.9.4- 
2017.01-x86 64 arm-linux-gnueabihf tar.xz. 

这 两 种 交叉 编译 器 我 们 已 经 下 载 好 放 到 了 开发 板 光盘 中 ， 路 径 : 5. JTAR LE. 3X 
译 器 。 我 们 要 先 将 交叉 编译 工具 拷贝 到 Ubuntu F, Æ 42.1 小 节 中 我 们 在 当前 用 户 根 目录 下 创 
建 了 一 个 名 为 “linux” 的 文件 夹 ， 在 这 个 linux 文件 夹 里 面 再 创建 一 个 名 为 “tool” 的 文件 夹 ， 
用 来 存放 一 些 开 发 工具 。 使 用 前 面 已 经 安装 好 的 FileZilla 将 交叉 编译 器 拷贝 到 Ubuntu 中 刚刚 
新 建 的 “tool” 文 件 夹 中 ， 操 作 如 图 4.3.1.4 所 示 : 
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Ubuntu - zuozhongkai@192.168.31.235 - FileZilla 

文件 (日 ”编辑 (E) EEV) EET) 服务 器 (S$) 书签 (8) ”帮助 (H) 有 新 版 本 (N) 

HME mm EER EL 

主机 (H): 用 户 各 (U): EB: SOP): - 


状态 列 出 "/home/zuozhongkai/linux" 的 目录 成 功 

状态 GEBU/home/zuozhongkai/linux/tool"85 E REI... 

状态 :” 列 出 "/home/zuozhongkai/linux/tool" 的 目录 成 功 

状态 : ”正在 删除 "/home/zuozhongkai/linuxjtool/gcc-linaro-7.3.1-2018.05-x86 64 arm-linux-gnueabihf.tar.xz" 


本 地 站 点 :|GNIMX6NIMX6UL\ 开 发 板 光盘 \5、 FELS, ZUAR v 


el 开发 手册 ^ 
[RE 





















































v 











(12. FARREA 


m-[]3. 软件 交叉 编译 器 所 在 目录 


Da4 参考 资料 
日 - 国 5. FEIA 











文件 名 7 | 文件 名 文件 大 小 ”文件 3 
D. 直接 拖 放 到 右 调 区域 即 可 完成 Windowvs 向 Ubuntu 传输 文件 A. 

gag linaro-4.9.4-2017.01-1686 arm-linux-gnueabihf.tar.xz 79 E 
Blgcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf.tar.xz SHE 
< sall E > 
选择 了 1 个 文件 。 大 小 总 共 : 80,881,572 F5 空 目录 。 
服务 器 /本 地 文件 方向 ” 远程 文件 大 小 优先 级 RE 




















4.3.1.4 拷贝 交叉 编译 器 
拷贝 完成 的 话 FileZilla 会 有 提示 ， 如 图 4.3.1.5: 


文件 名 
B. 


Bf gcc-linaro-4.9.4-2017.01-1686 arm-linux-gnueabihf.tar.xz 
Bl gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf.tar.xz 80, 


79, [Ml gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-g.. 80,881,572 3604 


交叉 编译 器 已 经 拷贝 了 Ubuntu 中 


« 
1 个 文件 。 大 小 总 共 : 80,881,572 F5 


< 


选择 了 1 个 文件 。 大 小 总 共 : 80,881,572 字 节 





服务 器 /本 地 文件 方向 ” 远程 文件 大 小 优先 级 时间 
W zuczhongkaiQ192.168.3.. 


GAIMX6\IMX6UL F Ë... 2019-03-18 21:19:31 











RO A:S 





4.3.1.5 交叉 编译 器 拷贝 完成 
在 Ubuntu 中 创建 目录 : /usr/local/arm， 命 令 如 下 : 
sudo mkdir /usr/local/arm 
创建 完成 以 后 将 刚刚 拷贝 的 交叉 编译 器 复制 到 /usr/local/arm 这 个 目录 中 ， 在 终端 使 用 命令 
“cd” 进 入 到 存放 有 交叉 编译 器 的 目录 ， 比 我 前 面 将 交叉 编译 器 拷贝 到 了 目录 
“/home/zuozhongkai/linux/tool” 中 ， 然 后 使 用 如 下 命令 将 交叉 编译 器 复制 到 /usr/local/arm 中 : 
sudo cp gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihtf.tar.xz /usr/local/arm/ -f 
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操作 步骤 如 图 4.3.1.6 所 示 : 


$ ls 


$ sudo cp gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf.tar.xz /usr/local/arm/ -f 


$ 
$ cd /usr/local/arm/ 
ls 





EJ | 


图 4.3.1.6 拷贝 交叉 编译 工具 到 /usr/local/arm 目录 中 

拷贝 完成 以 后 在 /usr/local/arm 目录 中 对 交叉 编译 工具 进行 解压 ， 解 压 命令 如 下 : 

sudo tar -vxf gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf.tar.xz 

等 待 解 压 完 成 ， 解 压 完成 以 后 会 生成 一 个 名 为 “gcc-linaro-4.9.4-2017.01-x86_64_arm-linux- 
gnueabihf” 的 文件 来， 这 个 文件 夹 里 面 就 是 我 们 的 交叉 编译 工具 链 。 

修改 环境 变量 ， 使 用 VI 打开 /etc/profile 文件 ， 命 令 如 下 : 

sudo vi /etc/profile 

打开 /etc/profile 以 后 ， 在 最 后 面 输入 如 下 所 示 内 容 : 

export PATH-$PATH:/usr/local/arm/gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf/bin 

添加 完成 以 后 的 /etc/profile 如 图 4.3.1.7 所 示 : 


zuozhongkai@ubuntu: ~ 
















































































/etc/profile.d 
a /etc/profile.d/*.sh 





图 4.3.1.7. 添加 环境 变量 


也 | 




















修改 好 以 后 就 保存 退出 ， 重 启 Ubuntu 系统 ， 交 叉 编 译 工 具 链 (编译 器 ) 就 安装 成 功 了 。 


4.3.2 安装 相关 库 


在 使 用 交叉 编译 器 之 前 还 需要 安装 一 下 其 它 的 库 ， 命 令 如 下 : 
sudo apt-get install Isb-core lib32stdc++6 











4.3.3. 交叉 编译 器 验证 
首先 查看 一 下 交叉 编译 工具 的 版 本 号 ， 输 入 如 下 命令 : 


arm-linux-gnueabihf-gcc - v 


如 果 交 叉 编 译 器 安装 正确 的 话 就 会 显示 版 本 号 ， 如 图 4.3.3.1 所 示 : 
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w.vuan WWW. 





9 zuozhongkaigpubuntu: ~ 
zuozhongkai@ubuntu:~$ arm-linux-gnueabihf-gcc -v 
Using built-in specs. 
COLLECT GCC-arm-linux-gnueabihf-gcc 
COLLECT LTO WRAPPER-/usr/local/arm/gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf/bin/../libexec/gcc/arm-linux-gnueabihf/4.9 
.4/lto-wrapper 
Target: arm-linux-gnueabihf 
Configured with: /home/tcwg-buildslave/workspace/tcwg-make- release/label/docker-trusty-amd64-tcwg-build/target/arm-linux-gnueabih 
f/snapshots/gcc-linaro-4.9-2017.01/configure SHELL-/bin/bash --with-mpc-/home/tcwg-buildslave/workspace/tcwg-make- release/label/d 
ocker-trusty-amd64-tcwg-build/target/arm-linux-gnueabihf/ build/builds/destdir/x86 64-unknown-linux-gnu --with-mpfr-/home/tcwg-bu 
ildslave/workspace/tcwg-make- release/label/docker-trusty-amd64-tcwg-build/target/arm-linux-gnueabihf/ build/builds/destdir/x86 64 
-unknown-linux-gnu --with-gmp-/home/tcwg-buildslave/workspace/tcwg-make-release/label/docker-trusty-amd64-tcwg-build/target/arm-l 
inux-gnueabihf/ build/builds/destdir/x86 64-unknown-linux-gnu --with-gnu-as --with-gnu-ld --disable-libmudflap --enable-lto --ena 
ble-objc-gc --enable-shared --without-included-gettext --enable-nls --disable-sjlj-exceptions --enable-gnu-unique-object --enable 
-linker-build-id --disable-libstdcxx-pch --enable-c99 --enable-clocale-gnu --enable-libstdcxx-debug --enable-long-long 
og-no --with-ppl-zno --with-isl-zno --disable-multilib --with-float-hard - h-mode-thumb --with-tune-zcortex-a9 --with-arc 
a --with-fpu-vfpv3-dl6 --enable-threads-posix --enable-multiarch --enable-libstdcxx-time-zyes --with-build-sysroot-/home/tcwg-buil 
dslave/workspace/tcwg-make- release/label/docker-trusty-amd64-tcwg-build/target/arm-linux-gnueabihf/ build/sysroots/arm-linux-gnue 
abihf --with-sysroot-/home/tcwg-buildslave/workspace/tcwg-make- release/label/docker-trusty-amd64-tcwg-build/target/arm-linux-gnue 
abihf/ build/builds/destdir/x86 64-unknown-linux-gnu/arm-linux-gnueabihf/libc --enable-checking-release --disable-bootstrap --ena 
ble-languages=c, c++, fortran, lto --build-x86 64-unknown-linux-gnu --host-x86 64-unknown-linux-gnu --target-arm-linux-gnueabihf --p 
refix-/home/tcwg-buildslave/workspace/tcwg-make-release/label/docker-trusty-amd64-tcwg-build/target/arm-linux-gnueabihf/ build/bu 
ilds/destdir/x86 64-unknown-linux-gnu 
Thread model: posix 
gcc version 4.9.4 (Linaro GCC 4.9-2017.01) 
zuozhongkaigubuntu:-$ | 





图 4.3.3.1 交叉 编译 器 版 本 查询 

从 图 4.3.3.1 中 可 以 看 出 当前 交叉 编译 器 的 版 本 号 为 4.9.4， 说 明 交 叉 编 译 工具 链 安 装 成 功 。 
第 三 章 “Linux C 编程 入 门 ” 中 使 用 Ubuntu 自 带 的 GCC 编译 器 ， 我 们 用 的 是 命令 “gcc”。 要 使 
用 刚刚 安装 的 交叉 编译 器 的 时 候 
gcc” 的 含义 如 下 : 

1、arm 表示 这 是 编译 arm 架构 代码 的 编译 器 。 

2. linux 表示 运行 在 linux 环境 下 。 

3. gnueabihf 表示 嵌入 式 二 进 制 接口 

4. gcc 表示 是 gcc 工具 。 

最 好 的 验证 验证 方法 就 是 直接 编译 一 个 例 程 ,我 们 就 编译 第 一 个 裸 机 例 程 “1_leds” 试 试 ， 
裸 机 例 程 在 开发 板 光盘 中 的 路 径 为 : 1、 程 序 源码 ->1、 裸 机 例 程 -> 1_leds。 在 前 面 创建 的 linux 
文件 夹 下 创建 driverboard_ driver 文件 夹 ， 用 来 存放 裸 机 例 程 ， 如 图 4.3.3.2 所 示 : 
zuozhongkaiQubuntu: -/linux/driver$ ls B 








































































































使 用 的 命令 是 “arm-linux-gnueabihf-gcc”“arm-linux-gnueabihf- 
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board driver 
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图 4.3.3.2 创建 board_driver 文件 夹 
将 第 一 个 裸 机 例 程 “1_leds” 找 贝 到 board driver 中 ， 然 后 执行 make 命令 进行 编译 ， 如 图 
4.3.3.3 所 示 : 


zuozhongkaiQubuntu:-/linux/driver/board driver/1 Leds$ ls 

imxdownload Led.bin led.dis led.elf Led.0 Led.s Load.imx Makefile SI 
zuozhongkaiQubuntu:-/linux/driver/board driver/1 leds$ make 
arm-linux-gnueabihf-gcc -g -c -o led.o led.s 

arm-linux-gnueabihf-ld -Ttext 0X87800000 -g led.o -o led.elf 
arm-linux-gnueabihf-objcopy -0 binary -S led.elf led.bin 
arm-linux-gnueabihf-objdump -D led.elf > led.dis 
zuozhongkaiQubuntu:-/linux/driver/board driver/1 leds$ ls 

imxdownload led.bin led.dis led.elf led.o led.s load.imx Makefile SI 
zuozhongkai@ubuntu:~/Linux/driver/board driver/1 leds$ 


图 4.3.3.3. 编译 过 程 

从 图 4.3.3.3 可 以 看 到 例 程 “1_leds” 编 译 成 功 了 , 编译 生成 了 led.o 和 led.bin 这 两 个 文件 ， 
使 用 如 下 命令 查看 led.o 文件 信息 : 
file led.o 


结果 如 图 4.3.3.4 所 示 : 
zuozhongkaigubuntu:-/linux/driver/board driver/1 leds$ file led.o 

















m: 











n 




































































led.o: ELF 32-bit LSB relocatable, ARM, EABIS version 1 (SYSV), not stripped 
zuozhongkai@ubuntu:~/linux/driver/board driver/1L leds$ 


图 4.3.3.4 led.o 文件 信息 
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从 图 4.3.3.4 可 以 看 到 led.o 是 32 位 LSB 的 ELF 格式 文件 ， 目 标 机 架构 为 ARM， 说 明 我 


们 的 交叉 编译 器 工作 正常 。 
4.4 Source Insight 软件 安装 和 使 用 


4.4.1 Source Insight 安装 


Source Inisght 是 一 款 功 能 强大 的 代码 编辑 、 阅 读 工 具 ， 工 作 在 Windows 下 ， 我 们 可 以 用 
Source Insight 来 进行 代码 编写 和 阅读 ,编写 完成 以 后 将 代码 拷贝 到 Ubuntu 中 去 编译 即 可 .Source 
Insight 下 载 地 址 为 ，https:/www.sourceinsight.com/download/， 如 图 4.4.1.1 所 示 : 


























Æ Downloads - Source Insight TESI 
C f vw QOhtps//www.sourceinsight.com/download/ && 4 上 京东 围 年 货 199 减 100 ak- w Ak J]U5-- 
Lf : : 
Ei SOURCE InsicHT Home Features Trial Support Updates | Contact Shop 


Source Insight Downloads 


This is the place to download the latest Source Insight updates, as well as sample macros, and custom language plug-ins. 


Free point-releases are made from time to time to fix bugs and add features. In order to use the updates, you must have a valid Source Insight serial number, or run it in 
Trial mode. 


The updates contain a full installation of Source Insight. They are not patch files, so you do not need to have Source Insight installed on your machine already. 


Source Insight 4 - Latest Version 


Version 4.0.0096 - September 26, 2018 


This requires a valid version 4.x license, OR you can run this in Trial mode for up to 30 days. 


* ViewChanges 


This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. o 








Hess Hasan © g 229 P @ m d» Q100% 4 

4.4.1.1 Source Insight 下 载 界 面 

我 们 已 经 下 载 好 并 放 到 了 开发 板 光 盘 中 ， 路 径 为 : 3、 软 件 ->Source Insight 

4.0->sourceinsight4096-setup.exe， 双 击 “sourceinsight4096-setup.exe” 即 可 开始 安装 ， 首 先是 图 
4.4.1.2 所 示 欢 迎 界 面 : 
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由 Source Insight 4.0 - Installer 


Welcome to the Installer for Source Insight 4.0 


HT 


The Installer will install Source Insight 4.0 on your computer. 
To continue, dick Next. 


Version 4.00.0096 | WARNING: This program is protected by 
copyright law and international treaties. 








4.4.1.2 Souce Insight 4.0 安装 欢迎 界面 
点 击 图 4.4.1.2 中 的 “Next” 按 钮 进入 下 一 步 ， 如 图 4.4.1.3 所 示 : 


E Source Insight 4.0 - Installer 








License Agreement 
Please read the following license agreement carefully. 





Source Dynamics 
Source Insight ™ Version 4.0 
End-User License Agreement 


IMPORTANT-READ CAREFULLY: This Source Insight End-User License Agreement S 


LEA ETEN LATTE a- -eenn 


(@) I accept the terms in the license agreement 


( )I do not accept the terms in the license agreement 


InstallShield 





图 4.4.1.3. 条 例 许可 界面 
选择 图 4.4.1.3 中 的 “I accept the terms in the license adreement”， 然 后 点 击 “Next” 按 钮 ， 
进入 安装 目录 选择 界面 ， 根 据 自己 的 实际 情况 选择 合适 的 安装 目录 ， 如 图 4.4.1.4 所 示 : 
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由 Source Insight 4.0 - Installer 
Destination Folder 
Click Next to install to this folder, or dick Change to install to a d 





Install Source Insight 4.0 to: 
D: Program Files (x86)\Source Insight 4.01 





























44.1.4. 安装 目录 选择 
选择 好 安装 目录 以 后 点 击 “Next” 按 钮 ， 进 入 图 4.4.1.5 所 示 的 准备 安装 界面 : 


由 Source Insight 4.0 - Installer 


Ready to Install the Program 
The wizard is ready to begin installation. 





If you want to review or change any of your installation settings, click Back. Click Cancel to 
exit the wizard. 
































图 4.4.1.5. 准备 安装 界面 





点 击 图 4.4.1.5 中 的 “Install” 按 钮 开始 安装 ， 等 待 安装 完 成 ， 安 装 完成 以 后 如 图 4.4.1.6 所 
ZN: 
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由 Source Insight 4.0 - Installer 


HT 


The Installer has successfully installed Source Insight 4.0. Click 
Finish to exit the wizard. 








44.1.6 安装 完成 界面 
点 击 图 4.4.1.6 中 的 “Finish” 按 钮 退出 安装 ， 安 装 成 功 以 后 会 在 桌面 上 出 现 Source Insight 
4.0 的 图 标 ， 如 图 4.4.1.7 所 示 : 





4.4.1.7 Sourc Insight 4.0 图 标 
双击 图 标 打开 Source Inisght 4.0， 第 一 次 打开 的 话 会 有 Licese 提示 ， 如 图 4.4.1.8 所 示 : 
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ax 


The license could not be activated because the serial number 
y Y you provided is not valid. 


Please check the serial number that was provided to you, and 
re-enter it. If you do not have a serial number, you can do one 


of the following on the next screen: 


1) Purchase a license and a serial number will be sent to you. 
2) Begin a 30-Day Trial. 


图 4.4.1.9 Licese 提示 





因为 Source Insight 4.0 是 个 收费 软件 ， 所 以 是 需要 购买 License 的， 如 果 没 有 购买 的 话 可 以 
免费 体验 30 天 ， 点 击 图 4.4.1.9 中 的 “确定 ”按钮 ， 进 入 图 4.4.1.10 所 示 界 面 : 














Source Insight 4.0 License Management x 


Welcome to Source Insight. 


Please select an option to enable your license. 








(€) Enter your purchased serial number to activate a license on this machine. 


Choose this option if you have a serial number for a purchased license. This 
will permanently activate your license. 


免费 体验 30 天 


You can purchase an new serial number online. p 


Q Begin a 30-day Free Trial of Source Insight. 
A Trial license will be activated immediately and will run for 30 days. 


O Import a new license file. 
Choose this option if a license file was sent to you. 


Exit Program 


4.4.1.10 license 输入 界面 


在 图 4.4.1.10 中 ， 如 果 你 已 经 购买 了 licese 那么 就 选择 第 一 个 ， 如 果 没 有 购买 licese 的 话 就 








选择 第 二 个 免费 体验 30 天 ， 选 择 好 以 后 点 击 “Next” 按 钮 ， 进 入 图 4.4.1.11 所 示 界 面 : 
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Source Insight Trial Activation x 


Please enter your information below. When you continue, a Trial license will be activated on 
your machine. This requires Internet access. 


Your Name: * 


[| | 


Company or Organization: 

















4.4.1.11 信息 输入 界面 
填写 图 4.4.1.11 中 的 信息 ， 然 后 点 击 “Next”， 填 写 好 以 后 一 路 “Next” 下 去 就 可 以 了 ， 打 
开 以 后 的 默认 界面 如 图 4.4.1.12 所 示 : 
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(Æ (No Project) - Source Insight 4.0 TRIAL - BD x 
File Edit Search Project Options Tools View Window Help 


€» |B6SHHOGG maase [| ER GR enm |e gag | aa am| 

















id 
图 4.4.1.12 Source Insight 默认 界面 
至 此 Source Insight 安装 完成 。 


4.4.2 Source Insight 新 建 工 程 


1、 新 建 工程 


跟 MDK, IAR 一 样 ，Source Insight 是 需要 创建 工程 的 ， 但 是 远 没 有 MDK 和 IAR 那么 复杂 ， 
先 新 建 一 个 工程 文件 夹 ， 比如 test, test 用 来 存放 工程 所 有 文件 ， 包 括 Source Insight 工程 文件 
和 C 语言 源码 文件 。 


在 刚刚 创建 的 test 文件 夹 中 新 建 一 个 SI 文件 夹 ,用 来 存放 Source Insight 的 所 有 工程 文件 ， 
完成 以 后 如 图 4.4.2.1 所 示 : 
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口 x 
vO  Z€£x'tesü D 
修改 日 期 


2019-01-09 4 








图 4.42.1 工程 文件 目录 
工程 文件 夹 准 备 好 以 后 就 可 以 创建 工程 了 ， 点 击 Source Insight 的 : Project->New Project， 
如 图 4.4.2.2 所 示 : 


名 (No Project) - Source Insight 4.0 








|| g mm £g | & a 


Project Files x | v p 


[Fie Name (Ctrl-O) " | 


File Name 











Open Project Master File List... 
Export Project File List... 
=) Project Report... 
Rebuild Project... 
Default Project Settings... 
Import External Symbols... 
Import External Symbols for Current Project.. 


| 
*»mnegcials 








图 4.4.2.2 新 建 工程 
点 击 “New Project” 后 进入 图 4.4.2.3 所 示 界 面 : 
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New project 


New project name: 








bw 
TEE, 放 到 我 们 刚刚 创建 的 test/SI 文 件 夹 里 面 


Enter the name of the new project and the location where its data files 
will be stored. We recommend a local non-networked drive. Your 
source files can still be in a separate location. 





44.2.3 工程 名 字 和 路 径 设置 
在 图 4.4.2.3 中 设置 好 工程 名 字 和 路 径 以 后 点 击 “OK ”按钮 ， 会 进入 另外 一 个 设置 界面 ， 如 


4.4.2.4 所 示 : 
New Project Settings X | 

















Conditional Parsing 
— These condition values are project-specific. They are 
Conditions... | merged with the global condition list found in 
= Preferences: Languages. 

















Proj ource Directory - the main location of your source files: 
Ci\Users\zuozh\Desktop\test\s|| 


Project Backup Directory - where source files are backed up: 








| 96PROJECT DATA DIRS&Backup 








Project Source Files 
(€) Add and remove source files manually 
Use a Master File List. The files in the project will be determined by the 


O contents of the Master File List. 
Master File List path: 
96PROJECT SOURCE_DIR9%6\96PROJECT_NAME96 filelist.bxt 





Database Options 


Quick browsing for member names. You only type the member names of 
classes and structures to browse, but the symbol index and memory usage 
can increase by a factor of 2 or more. 


Quick browsing for symbol name fragments. You only type one or more 
fragments to locate symbols, but the symbol index and memory usage can 
increase by a factor of 4 or more. 





External Symbols 


import Symbols... These imported symbols are project-specific.They are 
———————— typically used for SDK include files, or external assemblies. 





442.4 工程 设置 2 
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在 图 4.4.2.4 中 我 们 一 般 不 需要 做 任何 修改 ， 主 要 是 检查 一 下 路 径 是 否 正 确 ， 如 果 没 问题 的 
话 就 点 击 “OK” 按 钮 即 可 ， 进 入 向 工程 添加 文件 界面 ， 如 图 4.4.2.5 所 示 : 




















Add and Remove Project Files x 


File Name: 














Ci\Users\zuozh\Desktop\test 







Directory | File Name 








| | Application Data ^ 

















2, mul "Add 














Rx 
BM Documents 1. GP TENER Al” 将 工程 目录 中 Remove Tree 
| | Downloads 
5| | eclipse 的 所 有 源 文件 添加 到 
m " 工程 中 
3、 会 显示 所 有 添加 到 工程 中 的 文件 Show only known 
Project Files: (0) file types 


Remove File 
Remove All 
Remove Special... | 
Add from list... 


Help 








4.4.2.5 想 工 程 添加 源 文件 
如 果 你 的 工程 文件 夹 已 经 有 源 文 件 了 ,那么 就 可 以 按照 图 4.4.2.5 所 示 方 法 将 所 有 的 源 文件 
添加 到 工程 中 ,添加 完成 以 后 点 击 “Close” 按 钮 关闭 即 可 。 新 建 工程 完成 以 后 Source Insight 如 
4.4.2.6 所 示 : 
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图 test Project - Source Insight 4.0 - D x 
File Edit Search Project Options Tools View Window Help 

je» JBsHHJG maase [B Ef RED enm LLI 


|File Name (Ctrl+0) v| 
| File Name 
| 


sone 





图 4.42.6 工程 创建 成 功 
我 们 发 现 图 4.4.2.6 好 像 和 没有 新 建 工 程 的 界面 没有 区 别 ? 那 是 因为 我 们 新 建 的 工程 是 个 
空 的 工程 ， 没 有 任何 的 源 文件 ， 所 以 看 起 来 没 啥 变化 。 
2、 新 建 源 文件 


我 们 在 刚刚 新 建 的 工程 里 面 新 建 两 个 文件 ， main.c 和 main.h， 先 新 建 main.c 文件 ， 点 击 : 
File->new， 如 图 4.4.2.7 所 示 : 





Browse Files... 
Recent Files > 


图 4.4.2.7 新 建 c 文件 
设置 c 文件 的 名 字 为 main.c， 如 图 4.4.2.8 所 示 : 
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New File 


New File Name? 


4.4.2.8 文件 命名 
文件 命名 完成 以 后 点 击 “OK” 按 钮 ， 文 件 创建 完成 ，main.c 只 是 创建 了 但 是 还 没有 保存 ， 
更 没有 添加 到 我 们 的 工程 中 ， 所 以 我 们 点 击 : File->Save， 或 者 直接 按 下 键盘 上 的 “Ctrl+S” 键 
来 保存 ， 保 存 界 面 如 图 4.4.2.9 所 示 : 




















2019-01-09 22:00 ”文件 去 
(多 OneDrive 


[ij BR 

[|] xe 
国 此 电脑 2、 检 查 文件 名 是 否 正确 

Il Desktop s > 


保存 类 型 中 : Original Text Format v 
^ 隐 茂 文件 夫 | 


4.4.2.9 保存 界面 
设置 好 图 4.4.2.9 中 的 保存 路 径 以 后 点 击 “ 保 存 ” 按 钮 即 可 ,保存 以 后 会 弹出 一 个 对 话 框 ， 
询问 你 是 否 要 将 刚刚 保存 的 C 文件 添加 到 工程 中 ， 如 图 4.4.2.10 所 示 : 


1、 设 置 保存 路 算 ， 肯 定 是 我 们 的 工程 文件 夹 

















source Insight 


Do you want to add "C:\Users\zuozh\Desktop\test\main.c" to the 
current project? 








4.4.2.10 是 否 将 文件 添加 到 工程 中 。 
我 们 肯定 要 选择 “是 ”了 ， 要 将 main.c 添加 到 工程 中 的 ,添加 完成 以 后 的 Source Insight 界 
面 如 图 4.4.2.11 所 示 : 
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[74 test Project - Source Insight 4.0 - [main.c (C:\Users\zuozh\Desktop\test)] — 口 x 
File Edit Search Project Options Tools View "Window Help - 8x 
je» j&suWS3 ..lEoBjoe B ERA Ew EFIE 
main.c (Ci\Users\zuozh\Desktop\test) x à 2、 代 码 编辑 区 ， 可 以 进行 代码 编辑 
s A == 
Symbol Name (Alt+L) Project Files x | v 
[File Name (Ctrl+O) Y 
File Name 
AZ sz 3 < > bd 区 ® E * 
I3] Context x 
3. 3p ^ 


< EX) 
€»3mnzge-|a s 
| Line Col 1 | | NS 
图 4.4.2.11 工程 界面 讲解 

在 图 4.4.2.11 中 可 以 看 到 我 们 正在 操作 main.c 这 个 文件 , 当前 工程 只 有 main.c 这 一 个 文件 ， 
中 间 部 分 就 是 我 们 的 代码 编辑 区 ， 我 们 可 以 在 里 面 写 代 码 。 同 样 的 方法 我 们 在 新 建 一 个 main.h 
头 文件 ， 

3、 编 写 代 码 


我 们 在 工程 中 创建 了 mainc 和 mainh 两 个 源 文件 ， 接 下 来 在 这 两 个 文件 中 编写 代码 ， 在 
main.c 和 main.h 中 分 别 写 入 如 下 代码 : 





示例 代码 4.4.2.1 main.c 文件 代码 
1 4include "main.h" 
2  dimelwweke "suelo. Im" 
B 
4 volel main(int argc, char *argv[l) 
5 t 
3j. enet ates rinken) 
LE 
8 


示例 代码 4.4.2.2 main.h 文件 代码 
9 #ifndef MAIN H 
10 #define MAIN H 
Ial 
i2 
13 #endif 
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编写 完成 以 后 Source Insight 界面 如 图 4.4.2.12 所 示 : 














[7] test Project - Source Insight 4.0 - [main.c (C:\Users\zuozh\Desktop\test)] 一 口 x 

File Edit Search Project Options Tools View Window Help -x 
e» J8zHHG3 Basse EELT en n egag [aame |l 
main.c (CAUsers\zuozh\Deskiop\test) x | main.h (CAUsersVzuozhDesktopVest) | 


main.c : #include 
: #include 


J 
Symbol Name (Alt+L) : 
4: 
5: 
6 
7 


| 



































Project Files X | Project Symbols v 
[Fie Name (Ctrl+O) v | 

















void main(int argc, char *argv[]) 







printf ("thi E E r 。 









«z[E:5|m s «n se 
I3] main Function in main.c (C:\Users\zuozh\Desktop\test) at line 4 (4 lines) 
oid UERBO int argc, char *argv[]) 


printf("this is a test file"); 











e»ame-ciale 





图 4.4.2.12 编写 代码 后 的 工程 


4、 工 程 同步 
代码 编写 完成 以 后 需要 对 Source Insight 做 一 次 同步 操作 ,同步 的 目的 是 为 了 可 以 进行 函数 
跟踪 ， 比 如 MDK 中 直接 跳 转 到 某 个 函数 的 定义 处 查看 函数 源码 。 同 步 的 方法 很 简单 ， 点 击 
Project->Synchronize Files， 如 图 4.4.2.13 所 示 : 
d Options Tools View Window Help. 
New Project... Alt+Shift+N 


| E> Open Project.. Alt+Shift+P 
Alt«Shift-W. 









Export Project File List... 


国 Project Report... 
Rebuild Project... 
d) Project Settings... 
Import External Symbols... 
Import External Symbols for Current Project... 


图 442.13 工程 同步 
点 击 “Synchronize Files” 以 后 打开 同步 对 话 框 ， 如 图 4.42.14 所 示 : 
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Synchronize Files x 
This synchronizes the project database with your sources files. This normally 
happens automatically in the background, but you may want to do this now 
if a lot of files have changed and you want to update symbol information 
now. Cancel | 
2、 开 始 同步 





Help | 














> 


dding and Removing Files 





v| Add new files automatically 














Remove missing files from project 














图 4.4.2.14 同步 设置 
按照 图 4.4.2.14 所 示 设 置 同步 ， 设 置 好 以 后 点 击 “Start” 开 始 同步 ， 等 竺 同步 完成 ， 如 果 工 
程 很 小 的 话 同步 速度 会 很 快 ! 可 能 看 不 到 同步 的 过 程 ， 如 果 工 程 比较 大 的 话 同步 就 会 多 花 一 点 
时 间 。 
关于 Source Insight 的 安装 以 及 使 用 就 讲解 到 这 里 ， 大 家 自行 多 练习 几 遍 Source Insight 创 
建 工程 和 新 建文 件 操作 。 








4.4.3 Source Insight 解决 中 文 乱 码 




































第 一 次 装 好 Source Insight， 如 果 打 开 有 中 文 的 文件 ， 可 能 中 文 会 乱码 ， 如 图 4.4.3.1 所 
示 : 
(Æ leds Project - Source Insight 4.0 - [led.s] 
E File Edit Search Project Options Tools View Window Help 
e» j|BsHHGGS Maase ARAB»! eaag anma 
leds x | Makefile | 
m J; [JXGOKOEEOEOKOKOIOKOOOOOOOOOOOOOOOOOOOOOOo00000000000000000000 y 
a A 2: Copyright 沁 zuozhongkai Co., Ltd. 1998-2019. All right | 
: 3: $RERXK SS? : led.s 
pt 4: DUE? : P e V1.0 
[e 5: SHH : i-r 
i eo 6: BRAI fA SRGRSEIBIRUBUSLEDSS 
7: SR HR: FRENI. 0 2019/1/3 R~] PJE peeeeccecóeer 
8: 
9: .global start /* $82 ia */ 
10: 
11: jf* 1 ] 
12:  * SARR startSEZT RE BELL SEEEUMR o RENEE 
13: start: 
14: /* Hiki g Ja * 
15: /* ERPAT EHERRM ?*/ 
16: ldr r0, =0X020C4068 /* CCGRO */ 
17: ldr r1, -0XFFFFFFFF 
18: str r1, [r0] 
19: 
Az [E es] * « » 














图 4.4.3.1 中 文 乱码 
这 是 因为 编码 方式 没有 选 对 ， 点 击 Options->Preferences...， 如 图 4.4.3.2 所 示 : 




















inl File Type Options... Alt- Y 
Style Properties... * 
Visual Theme > 
1 


4.4.3.2 Preferences 对 话 框 打开 方式 
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打开 以 后 按照 图 4.4.3.3 所 示 设 置 : 
Preferences x 
Colors & Fonts Syntax Formatiing axDecorations Searching Remote Folders 






Languages Symbol Lookups Display 





Opening Files 
[7] Sharing: Let other programs modify files 
Reload externally modified files automatically 


1、 选 择 Files 


Note: "Reload Modified Files" command will also reload files. 
[7] Ask before reloading modified files 

C] Assume ^Z (ASCII 26) is End-Of-File 

[7] Open all backup files as read-only 


Customize 'Open' Command... 


Saving Files 
[7] Make backup files when saving 


[7] Remove backup files older than (days): 


上 器 Save All operation will query on each file separately 

C] Save All operation saves without prompts 

C Save all files when Source Insight program is deactivated 
[v] Preserve Undo data and revision marks after saving 

[7] Confirm saving over modified files 

Cl Save over read-only files without prompting 

[]Remove extra white space when saving 





Other 
L1Allow editing read-only file buffers 
[7] Confirm all file deletions 2、 文 件 编码 选择 GB2312 
Default line ending: Windows (CR/LF) j v | 





Default encoding: f Chinese Simplified (GB2312) CP:936 v 
[RTT] m [om 





4.4.3.3. 文件 编码 设置 

















将 文件 编码 改 为 GB2312 以 后 中 文 显示 就 正常 了 ， 如 果 中 文 还 是 显示 乱码 的 话 那 就 试 着 将 
4.4.3.3 中 的 “Default line ending” 改 为 “Unix(LF)”， 将 “Default encoding” 改 为 “UTF8”， 
如 图 4.4.3.4 所 示 : 
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Other 


[ ] Allow editing read-only file buffers 
Confirm all file deletions 


Default line ending: | Unix (LF) v 


Default encoding: UTF-8 v 
取消 m 


图 4.4.3.4. 改 为 UTF-8 编码 
这 是 因为 Linux 下 是 UTF-8 编码 的 ， 如 果 你 的 工程 是 从 Linux 下 拷贝 出 来 的 ， 那 么 肯定 就 
要 使 用 UTF8 编码 才能 正常 显示 。 中 文正 常 显 示 如 图 4.4.3.5 所 示 : 


(Æ leds Project - Source Insight 4.0 - [led.s (C:\Users\zuozh\Desktop\1_leds)] 
E File Edit Search Project Options Tools View Window Help 












































|e» j|s5&amuuHdgiG game (B) GR AS E en m egag |^ ams 
| led.s (CAUsersvzuozhVDesktopM leds) x 
n i. 1: ddd de dodo ddd ltd ddd nnd nd ld SERERE ESSE DEN py 
ES FRR 2: Copyright © zuozhongkai Co., Ltd. 1998-2019. All rights 
L 3: 文件 名 : mian.c 
4: 1 : EBEL 
5: 版 本 : V1.0 : 
6: 描述 : 裸 机 实验 1 汇编 点 灯 
7: 用 汇编 来 点 亮 开 发 板 上 的 LED 灯 ， 学 习 和 掌握 
8: 完成 对 I.MX6U 处 理 器 的 GPI0 初 始 化 和 控制 。 = 
9: 其 他 : 无 | 
10: 日 志 —: 初版 V1.8 2019/1/3 左 忠 凯 创 建 
11: F k ak 3k iE iE ak iE iE 3 3i iE E iE iE 3E iE iE E 3E iE kE 3E iE E E E E 3E E E E E kE 3E E E E E kE 3E 8E KE iE 8E 3k 3E 38E k iE iE 3k 3E ke k 
12: 
13: .global _start /* 全 局 标号 */ 
14: 
15: /* 
16:  * 描述 : ” _start 函 数 ， 程 序 从 此 函数 开始 执行 此 函数 完成 时 
17: * GPI0 初 始 化 、 最 终 控制 GPI0 输 出 低 电 平 来 点 亮 LED 灯 
18: */ 
19: start: 
20: /* 例 程 代码 */ 
|^z[E 2| d < > v 


























4.4.3.5 中 文 显示 正常 
4.5 Visual Studio Code 软件 的 安装 和 使 用 


4.5.1 Visual Studio Code 的 安装 





Visual Stuio Code 和 Source Insight 一 样 ， 都 是 编辑 器 ，Visual Studio Sode 本 教程 以 后 就 简 
称 为 VSCode，VSCode 是 微软 出 的 一 球 编辑 器 ， 但 是 免费 的 。VSCode 有 Windows. Linux 和 
macOS 三 个 版 本 的 , 是 一 个 跨 平 台 的 编辑 器 .VSCode 下 载 地 址 是 : https://code.visualstudio.com/， 
下 载 界面 如 图 4.5.1.1 所 示 : 
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3 visual Studio Code - Code Ec x 十 Uu 一口 x 
O 个 和 https//codevisualstudio.com/ «5 点 此 搜索 g D> 三 
D cem V DFE Links @AEAR \ 【FFmp 图 回味 经 典 @ U-Boot 出 用 uboot gi (Linux mplayer | (5 Linux "-x-o0om-Gd-s 


I} Visual Studio Code D: pdates Blog API Extensio AQ X Download 


wwwits X 


Code editing. 
Redefined. 


Download for Windows T 


macOS Package 
Windows x64 User Installer J 


Linux x64 .deb 


Other downloads 


«» ® D . .. [IR EM 
图 4.5.1.1 VSCode 下 载 界 面 
在 图 4.5.1.1 中 下 载 自己 想 要 的 版 本 ， 本 教程 需要 Windows 和 Linux 这 两 个 版 本 , 所 以 下 载 
这 两 个 即 可 ， 我 们 已 经 下 载 好 并 放 入 了 开发 板 光盘 中 ， 路 径 为 : 3、 软 件 ->Visual Studio Code. 
1. Windows 版 本 安装 
Windows 版 本 的 安装 和 容易 ， 和 其 他 Windows 一 样 ， 双 击 .exe 安装 包 ， 然 后 一 路 “下 一 步 ” 即 
可 ， 安 装 完 成 以 后 在 桌面 上 就 会 有 VSCode 的 图 标 ， 如 图 4.5.1.2 所 示 : 

















e| 
Visual 
Studio Code 


图 4.5.1.2 VSCode 图 标 











双击 图 4.5.1.2 打开 VSCode， 默 认 界 面 如 图 4.5.1.3 所 示 : 
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^| File Edit Selection View Go Debug Terminal Help Settings - Visual Studio Code 
Il] 三 Settings X 
[sea s 296 Settings Found 
User Settings 
Commonly Used 


Text Editor 
Workbench Files: Auto Save 


Commonly Used 


Window Controls auto save of dirty files. Read more about autosave here. 


Features off v 


Files: Auto Save Delay 
Controls the delay in ms after which a dirty file is saved automatically. Only applies when Files: Auto Save is set to af 


1000 


Editor: Font Size 


Controls the font size in pixels. 


14 


Editor: Font Family 
Controls the font family. 


Consolas, 'Courier New', monospace 


Editor: Tab Size 
The number of spaces a tab is equal to. This setting is overridden based on the file contents when Editor: Detect Indentation is 


on. 


4 








图 4.5.1.3 VSCode 默认 界面 











2. Linux 版 本 安装 


我 们 有 时 候 也 需要 在 Ubuntu 下 阅读 代码 ， 所 以 还 需要 在 Ubuntu 下 安装 VSCode。Linux 下 
的 VSCode 安装 包 我 们 也 放 到 了 开发 板 光盘 中 ， 将 开发 板 光 盘 中 的 .deb 软件 包 拷贝 到 Ubuntu 
系统 中 ， 然 后 使 用 如 下 命令 安装 : 
sudo dpkg -i code 1.35.3-1552606978 amd64.deb 


等 待 安装 完成 ， 如 图 4.5.1.4 所 示 : 
:~/linux/tool$ sudo dpkg -i code 1.32.3-1552606978 amd64.deb 
正在 选中 未 选择 的 软件 包 code。 
(正在 读 取 数 据 库 ... 系统 当前 共 安装 有 183257 个 文件 和 目录 。 ) 
正 准备 解 包 code 1.32.3-1552606978_amd64.deb 
正在 解 包 code (1.32.3-1552606978) 
正在 设置 code (1.32.3-1552606978) ... 
正在 处 理 用 于 gnome-menus (3.13.3-6ubuntu3.1) 的 触发 器 ... 
正在 处 理 用 于 desktop-file-utils (0.22-1ubuntu5.1) 的 触发 器 ... 
正在 处 理 用 于 bamfdaemon (0.5.3-bzr0416.04.20160824-Oubuntul) 的 触发 器 
Rebuilding /usr/share/applications/bamf-2.index... 
正在 处 理 用 于 mime-support (3.59ubuntul) 的 触发 器 
:~/linux/tool$ 加 















































D 














y 





图 4.5.1.4 VSCode 安装 过 程 
安装 完成 以 后 搜索 “Visual Studio Code” 就 可 以 找到 ， 如 图 4.5.1.5 所 示 : 
© 
o ® visual Studio Code 


= 会 应 用 程序 


u 








MEOS 


a Visual Studio Code 
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图 4.5.1.5 Visual Studio Code 
每 次 打开 VSCode 都 要 搜索 ,， 太 麻烦 了 ， 我 们 可 以 将 图 标 添加 到 Ubuntu 桌面 上 ， 安 装 的 所 
有 软件 图 标 都 在 目录 /usrshare/applications 中 ， 如 图 4.5.1.6 所 示 : 


applications 











图 usr share applications 
O 最 近 使 用 的 Shotwell Shotwell Viewer Shutdown Thunderbird 邮件 / 
fi Home 新 闻 
Ee [5 m Qo 
"m 视频 i Ey 
加 图 片 Transmission Unity Webapps UXTerm View file 
QML Test Launcher 
D 文档 
v Te EA 
d 音乐 Vim Visual Studio Code Wacom 手写 板 
-URL Handler 
W 回收 站 
2 ns 9 5 © 9@ 
[S 314GB 卷 XTerm X 诊 断 工具 安全 和 隐私 帮助 
B 连接 到 服务 器 
备份 备份 备份 


选中 了 "Visual Studio Code" (481 字 节 ) 


4.5.1.6 软件 图 标 
在 图 4.5.1.6 中 找到 Visual Studio Code 的 图 标 ， 然 后 点 击 鼠 标 右键 ， 选 择 复制 到 -> 桌面 ， 如 
图 4.5.1.7 所 示 : 

















选择 复制 的 目标 位 置 
O 最 近 使 用 的 
| Q Home 






4 Qzuozhongkai egi ^ E 






m 视频 
向 图 片 
口 文档 
v 下 载 
dd 音乐 
[m applications 





























| a manam 





取消 (O 选择 (S) 











图 4.5.1.7. 复制 图 标 到 桌面 
按照 图 4.5.1.7 所 示 方 法 将 VSCode 图 标 复制 到 桌面 ， 以 后 直接 双击 图 标 即 可 打开 VSC, 
Ubuntu 下 的 VSCode 打开 以 后 如 图 4.5.1.8 所 示 : 
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welcome - Visual Studio Code 


p a] welcome x 


Visual Studio Code 


Editing d 


Start Customize 
New file 
Open folder.. Tools and languages 


Add workspace folder... JavaScript, TypeScript, Python, PHP, Azure, Docke 


Vim, Sublime, Atom 


Recent 


Help 

Printable keyboard cheatsheet 

Introductory videos 

Tips and Tricks Find and run all commands 
Product documentation : 
GitHub repository 

Stack Overflow 


come page on startup 


Interactive playground 


图 4.5.1.8 Linux 下 的 VSCode 


























可 以 看 出 Linux 下 的 VSCode 和 Windows 下 的 基本 是 一 样 的 ， 所 以 使 ) 





4.5.2 Visual Studio Code 插件 的 安装 








方法 也 是 一 样 的 。 











VSCode 支持 多 种 语言 ， 比 如 C/C++、Python、C# 等 等 ， 本 教程 我 们 主要 用 来 编写 C/C++ 程 
序 的 ， 所 以 需要 安装 C/C++ 的 扩展 包 ， 扩 展 包 安装 很 简单 ， 如 图 4.5.2.1 所 示 : 
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File Edit Selection View Go Debug Terminal Visual Studio Code 
EXTENSIONS 


Search Extensions in Marketplace 


b RECOMMENDED 

4 POPULAR 
Python 20193.6215 
Linting, Debugging (multi-threaded, remote), … 
Microsoft Install 
ESLint 1.8.2 
Integrates ESLint JavaScript into VS Code. 
Dirk Baeumer Install 
C/C++ 0.22.1 
C/C++ IntelliSense, debugging, and code bro... 


Microsoft Install 


Debugger for Chrome 4.11.3 


Debug your JavaScript code in the Chrome br... 


Microsoft Install 


Language Support for Java(TM) by R... 0.42.1 
Java Linting, Intellisense, formatting, refactori... 
Red Hat Install 


Ln1,Col1 TabSize4 UTF-8 LF JSON 图 A 


图 4.5.2.1 VSCode 插件 安装 
我 们 需要 按照 的 插件 有 下 面 几 个 ; 

1)、C/C++， 这 个 肯定 是 必须 的 。 

2)、C/C++ Snippets, EN C/C++ 重用 代码 块 。 

3)、C/C++ Advanced Lint, 即 C/C++ 静态 检测 。 
4)、Code Runner， 即 代码 运行 。 

5). Include AutoComplete， 即 自动 头 文 件 包 含 。 

6). Rainbow Brackets， 彩 虹 花 括号 ， 有 助 于 阅读 代码 。 
7)、One Dark Pro，VSCode 的 主题 。 

8)、GBKtoUTF8， 将 GBK 转换 为 UTF8。 

9) 、ARM， 即 支持 ARM 汇编 语法 高 亮 显示 。 
10)、Chinese(Simplified)， 即 中 文 环境 。 
11)、vscode-icons，VSCode 图 标 插件 ， 主 要 是 资源 管理 器 下 各 个 文件 夹 的 图 标 。 
12)、compareit， 比 较 插件 ， 可 以 用 于 比较 两 个 文件 的 差异 。 
13)、DeviceTree， 设 备 树 语法 插件 。 

如 果 要 查看 已 经 安装 好 的 插件 ， 可 以 按照 图 4. 5. 2. 2 所 示 方 法 查看 : 
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安装 好 插件 以 后 就 可 以 











f! 





pi: 


Edit 


EXTENSIONS: MARKETPLACE 


@installed 


C/C++ 0221 
C/C++ IntelliSense, debugging, and code Ł 
Microsoft 


C/C++ Advanced Lint 1.2.2 
An advanced, modern, static analysis exten 


Joseph Benden 


C/C++ Snippets 0.0.13 

Code snippets for C/C++ 

Harsh 

Code Runner 0.9.7 

Run C, C++, Java, JS, PHP, Python, Perl, Rul 
Jun Han 

GBKtoUTF8 0.0.2 

a vscode extension to convert gbk to utf8 
bukas 

Include Autocomplete 0.0.4 
Autocompletion for C++ includes 


ajshort 


One Dark Pro 2.21.0 


erminal Help 


Show Installed Extensions 

Show Outdated Extensions 
Show Enabled Extensions 

Show Disabled Extensions 

Show Built-in Extensions 

Show Recommended Extensions 


Show Popular Extensions 


Sort By: Install Count 
Sort By: Rating 
Sort By: Name 


Check for Extension Updates 
Disable Auto Updating Extensions 
Install from VSIX... 


Disable All Installed Extensions 


Atom's iconic One Dark theme for Visual Stud... 


binaryify 

Rainbow Brackets 0.0.6 

A rainbow brackets extension for VS Code. 
2gua 









































Io 


Io] 


图 4.5.2.2 显示 已 安装 的 插件 
行 代码 编辑 了 , 截至 目前 , VSCode 
硬件 了 ， 最 后 将 VSCode 改 为 中 文 环境 ， 使 月 


适用 于 VS Code 的 中 文 (简体 ) 语言 























语言 包 为 VS Code 提 








图 4.5.2.3 中 文 语言 包 使 用 方法 














界面 都 是 英文 环境 , 我 们 已 经 安装 














方法 如 


图 4.5.2.3 所 示 : 














根据 图 4.5.2.3 的 提示 ， 按 下 “Ctrl+ShifttrP” 打 开 搜 索 框 ， 在 搜索 框 里 面 输入 “config”， 然 
后 选择 “Configure Display Language", 如 图 4.5.2.4 所 示 : 
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EXTENSIONS: MARKET »config 


二 Preferences: Configure Language Specific Settings... recently used 


Configure Display Language other commands 
Chinese (Simplifie: 
中 文 (简体 ) 
Microsoft 


Preferences: Configure User Snippets 
Tasks: Configure Default Build Task 








图 4.5.2.4 配置 语言 
在 打开 的 localjson 文件 中 将 locale 修改 为 zh-cn， 如 图 4.5.2.5 所 示 ; 


localejson X 


( 


























图 4.5.2.5 修改 locale 变量 
修改 完成 以 后 保存 localjson， 然 后 重新 打开 VSCode， 测 试 VSCode 就 变 成 了 中 文 的 了 ， 
如 图 4.5.2.6 所 示 : 





4 无 打开 的 文件 夹 


尚未 打开 文件 夹 。 


打开 文件 夹 





图 4.5.2.6 中 文 环 境 


4.5.3 Visual Studio Code 新 建 工程 

新 建 一 个 文件 夹 用 于 存放 工程 ， 比 如 我 新 建 了 文件 夹 目录 为 E\VScode_Program\1 test， 路 
径 尽 量 不 要 有 中 文 和 空格 打开 VSCode。 然后 在 VSCode 上 点 击 文件 -> 打开 文件 夹 ...， 选 刚刚 创 
建 的 “1_test"* 文 件 夹 ， 打 开 以 后 如 图 4.5.3.1 所 示 : 
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图 4.5.3.1 打开 的 文件 夹 
从 图 4.5.3.1 可 以 看 出 此 时 的 文件 夹 “1_ TEST” 是 空 的 ， 点 击 文件 -> 将 工作 区 另存 为 ...， 打 
开工 作 区 命名 对 话 框 ， 输 入 要 保存 的 工作 区 路 径 和 工作 区 名 字 ， 如 图 4.5.3.2 所 示 : 












































X) 保存 工作 区 x 
< vo^ T 》 此 电脑 上 十 工作 (E) > VScode Program > 1 test v O 搜索 "1 test" ^5 
组 织 -新建 文件 夹 作 区 路 径 E- 9 

ER ^ 名称 修改 日 期 类 型 

亩 桌面 

E 本 地 磁盘 (C) 没有 与 搜索 条 件 匹 配 的 项 。 

- 本 地 磁盘 (D:) 

SEKENE) MA ES > 

VE Is = 
保存 类 型 (T): Code 工作 区 (*.code-workspace) v 

^ EDUR 取消 











图 4.5.3.2 工作 区 保存 设置 
工作 区 保存 成 功 以 后 ， 点 击 图 4.5.3.1 中 的 “新 建文 件 ” 按 钮 创建 main.c 和 main.h 这 两 个 
文件 ， 创 建成 功 以 后 VSCode 如 图 4.5.3.3 所 示 : 
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AHF SEE IER f 






资源 管理 器 
4 打开 的 编辑 器 
X main.c 
main.h 
4 TEST (工作 区 ) 
4 .vscode 
b ipch 
main.c 
main.h 


test.code-workspace 





图 4.5.3.2 新 建文 件 以 后 的 VSCode 
从 图 4.5.3.2 可 以 看 出 ， 此 时 “实验 1 TEST” 中 有 .vscode 文件 夹 、mian.c 和 mian.h， 这 三 
个 文件 和 文件 夹 同 样 会 出 现在 “实验 1 test” 文 件 夹 中 ， 如 图 4.5.3.3 所 示 : 






























































B| Ma~ |1test — x 
Ed 主页 45 8 e 
e v 个 T > 此 电脑 > T/E(E) > VScode Program > 1 test Y 了 搜索 "1 test" 2 
^ ER 修改 日 期 类 型 大 小 
xr 快速 访问 
^ vscode 2019-04-02 18:38 ”文件 夹 
使 OneDrive | main.c 2019-04-02 18:38 ^ C Source File 0 KB 
a 此 电脑 ] mainh C/C++ Header File 0 KB 
] f - 2019-04-02 18:3 CODE-WORKSPAC... 1 
B 3D 对 象 | test.code-workspace 2 04-02 18:32 DE-W A KB 
— —a v 
4 个 项 目 Ez gm 








图 4.5.3.3. 实验 文件 夹 
在 main.h 中 输入 如 下 所 示 内 容 : 
示例 代码 4.5.3.1 main.h 文件 代码 





[E 


dinclude «€stdio.h» 


Ww 


ba exelel(usie gu 3a 19) p 
在 main.c 中 输入 如 下 所 示 内 容 : 
示例 代码 4.5.3.2 main.c 文件 代码 








dinclude <main.h> 


iban exolel(banE m ime 19) 
( 


return (a + b); 


int main (void) 
( 


rme value= (0p 


OO cb o mh dieu S (js 
-一 


e O 
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1152 value - add(5, 6); 


105) prdmte("5 r6 — sd value) 
14 Ug 
15-3 

















代码 编辑 完成 以 后 VSCode 界面 如 图 4.5.3.4 所 示 : 


i&include 
main.h 
4 TEST (工作 区 ) int add(int a, int 
4 &X .vscode 
UE return (a + b); 


[ main.c 
main.h 


test.code-workspace 
int main(void 


{ 


int value = 


value = add 
printf 
return ð; 





main(void 


图 4.5.3.4. 代码 编辑 完成 以 后 的 界 
从 图 4.5.3.4 可 以 看 出 ，VSCode 的 编辑 的 代码 高 亮 很 漂亮 ， 阅 读 起 来 很 舒服 。 但 是 此 时 提 
示 找 不 到 “stdio.hn” 这 个 头 文 件 ， 如 图 4.5.3.5 所 示 错 误 提 示 : 


#include 






























































#include errors detected. Please update your 
includePath. IntelliSense features for this 
translation unit (E:\VScode 程 序 \ 实 验 1 
test\main.c) will be provided by the Tag 
Parser. 


cannot open source file "stdio.h" 
(dependency of "main.h") 


快速 修复 速 览 问题 





图 4.5.3.5 头 文件 找 不 到 。 

图 4.5.3.5 中 提示 找 不 到 “main.h”， 同 样 的 在 mainh 文件 中 会 提示 找 不 到 “stdio.h”。 这 是 
因为 我 们 没有 添加 头 文件 路 径 。 按 下 “Ctrl+Shift+P 2? 打开 搜索 框 , 然后 输入 “Edit configurations”, 
选择 “C/C++:Edit configurations...", 如 图 4.5.3.6 所 示 : 
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>Edit configurations 


C/C++: 编辑 配置 ... 
C/C++: Edit configurations... 





图 4.5.3.6 打开 C/C++ 编辑 配置 文件 
C/C++ 的 配置 文件 是 个 json 文件 , 名 为 : c_cpp_properties.json， 此 文件 默认 内 容 如 图 4.5.3.7 
所 示 : 


文件 (F) ”编辑 (E) ”选择 (S 





资源 管理 器 C c cpp propertiesjson X 
4 打开 的 编辑 器 
C main.c 
x c cpp properties.json .vscode 
h main.h 
4 实验 1 TEST 
4 全 .vscode 
ipch 
c_cpp_properties.json 
C main.c 


main.h 








图 4.5.3.7 文件 c cpp properties.json 内 容 
c cpp properties.json 中 的 变量 “includePath” 用 于 指定 工程 中 的 头 文件 路 径 , 但 是 “stdio.h” 






































是 C 语言 库 文件 ， 而 VSCode 只 是 个 编辑 器 ， 没 有 编译 器 ， 所 以 肯定 是 没有 stdio.h 的 ， 除 非 我 
们 自行 安装 一 个 编译 器 ， 比 如 CygWin， 然 后 在 includePath 中 添加 编译 器 的 头 文 件 。 这 里 我 们 
就 不 添加 了 ， 因 为 我 们 不 会 使 用 VSCode 来 编译 程序 ， 这 里 主要 知道 如 何 指定 头 文件 路 径 就 可 
以 了 ， 后 面 有 实际 需要 的 时 候 再 来 讲 。 

我 们 在 VScode 上 打开 一 个 新 文件 的 话 会 覆盖 掉 以 前 的 文件 ， 这 是 因为 VSCode 默认 开启 
了 预览 模式 ， 预 览 模式 下 单 击 左 侧 的 文件 就 会 覆盖 掉 当 前 的 打开 的 文件 。 如 果 不 想 履 盖 的 话 采 
用 双击 打开 即 可 ， 或 者 设置 VSCode 关闭 预览 模式 ， 设 置 如 图 4.5.3.8 所 示 : 
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4 打开 的 编辑 器 
LIRE: 
4 2 LEDC 
4 Ee 
b ipch 


找到 16 个 设置 


用 户 设置 ”工作 区 设置 


4 工作 台 
篇 铝 管理 C2) ; : 器 。 预 览 编辑 器 在 被 固定 (例如 ， 通 过 双击 或 编辑 ) 


c cpp properties json 


命令 面板 -… 
Workbench » Editor: Enable Preview From Quick Open 


V 控制 从 Quick Open 打开 的 编辑 器 硕 览 编辑 器 在 被 固定 (例如 ， 通 
寺 双 击 或 编辑 ) 前 可 重用 。 


设置 

4 扩展 (1 

扩展 Markdown (11 
5 


用 户 代码 片段 


颜色 主题 
文件 图 标 主题 


检查 更 新 … 





图 4.5.3.8. 取消 预览 
我 们 在 编写 代码 的 时 候 有 时 候 会 在 右 下 角 有 如 图 4.5.3.9 所 示 的 警告 提示 ; 
































Unable to activate Flexelint analyzer. 


Unable to activate CppCheck analyzer. 


Unable to activate Clang analyzer. 





图 4.5.3.9 错误 提示 
这 是 因为 插件 C/C++ Lint 打开 了 几 个 功能 ， 我 们 将 其 关闭 就 可 以 了 ， 顺 便 也 可 以 学 习 一 下 
VSCode 插件 配置 方法 ， 如 图 4.5.3.10 所 示 : 
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4 打开 的 续 加 器 
xD E 
4 LEDC (工作 区 ) 


C/C++ Lint configuration 


Clang: Blocks 
V Enable or disable the -fblocks command-line argur 


main.h 


RE J 
Makefile Clang: Config File 


= Arma Dev Configur E 
命令 面板 … te file to use/fallba 
设置 C/C++ Lint config... 
扩展 SS 
键盘 快捷 方式 ane Clang: Defines 

Gi Preprocessor symbols to define. 
用 户 代码 片段 
TE settings son 中 编辑 
颜色 主题 


文件 图 标 主题 Clang: Enable 


检查 更 新 . v Enable or disable the Clang linter 


» X8 e Clang: Executable 





图 4.5.3.10 C/C++ Lint 配置 界面 
在 C/C++Lint 配置 界面 上 找到 CLang:Enable、Cppcheck:Enable、Flexlint:Enable 这 个 三 个 ， 
然后 取消 掉 勾 选 即 可 ， 如 图 4.5.3.11 所 示 : 





Clang: Enable 
Enable or disable the Clang linter 


Flexelint: Enable 


Enable or disable the Flexelint linter 


Cppcheck: Enable 
Enable or disable the CppCheck linter 








图 4.5.3.11 C/C++ Lint 配置 

按照 图 4.5.3.11 所 示 取 消 这 三 个 有 关 C/C Lint 的 配置 以 后 就 不 会 有 图 4.5.3.9 所 示 的 错误 
提示 了 。 但 是 关闭 Cppcheck:Enable 以 后 VSCode 就 不 能 实时 检查 错误 了 , 大 家 根据 实际 情况 选 
择 即 可 。 




















4.6 CH340 串口 驱动 安装 


我 们 一 般 在 Windwos 下 通过 串口 来 调试 程序 , 或 者 使 用 串口 作为 终端 , [LIMX6U-ALPHA F 
发 板 使 用 CH340 这 个 芯片 实现 了 USB 转 串 口 功 能 ，CH340 是 一 枚 江苏 沁 恒 生产 的 国产 蕊 片 ， 
稳定 性 还 是 很 不 错 的 ， 这 里 我 们 要 多 多 支持 国产 嘛 。 

先 通过 USB 线 将 开发 板 的 串口 和 电脑 连接 起 来 起 来 ， 连 接 方 式 如 图 4.6.1: 


JG 


j 
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HOPCB-2A 
E469747 
11678-904690 


ve nn 
1» 


图 4.6.1 开发 板 串口 连接 方式 
CH340 是 需要 安装 驱动 的 ， 驱 动 我 们 已 经 放 到 了 开发 板 光盘 中 ， 路 径 : 开发 板 光盘 ->3、 



































4.6.1 所 示 安 装 界面 : 





92 驱动 安装 64) — x | 
3) Seo AED ER 
选择 INF 文 件 : |CH341SER .INF 7 








安装 'MCH .CN 
| . USB-SERIRL CH3A0 
| . 98/08/201h, 3.5.2011 











图 4.6.1 CH340 驱动 安装 











件 ->CH340 驱动 (USB 串口 驱动 ) XP_WIN7 共用 ->SETUPEXE, ， 双 击 SETUPEXE， 打 开 如 图 





软 





点 击 图 4.6.1 中 的 “安装 ”按钮 开始 安装 驱动 ， 等 待 驱动 安装 完成 ， 驱 动 安装 完成 以 后 会 有 








如 图 46.2 所 示 提 示 : 





DriverSetup X | 


«p Skye RC! 


图 4.6.2. 驱动 安装 成 功 


























Ad 





j 











Ht 

















式 是 在 Windows 上 的 “此 电脑 ”图 标 上 点 击 鼠 标 右键 ， 选 择 “ 管 理 ” 如 图 4.6.3 




















213 


图 4.6.2 中 的 “确定 ”按钮 退出 安装 ， 重 新 插 拔 一 下 串口 线 。 打 开设 备 管理 器 ， 打 开 


A 


LMX6U SA XR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


打开 (O) 
固定 到 "快速 访问 ” 





图 4.6.3 打开 管理 窗口 
打开 以 后 的 计算 机 管理 器 如 图 4.6.4 所 示 : 

F 计算 机 管理 
文件 ( ”操作 (A) EEV) ENH) 
€ |m i| EH E 
是 | 计算 机 管理 (本 地 ) 
v jj 系统 工具 

( 作 和 计划 程序 

图 事件 查看 器 

a 共享 文件 夫 

de 本 地 用 户 和 组 

















® 性 能 
M 设备 管理 器 
v es 存储 
m 磁盘 管理 
c 服务 和 应 用 程序 

















图 4.6.4 计算 机 管理 器 
在 图 4.6.4 P, 点击 左 侧 “ 计 算 机 管 2 中 的 “设备 管理 器 ”在 右 侧 选 中 “端口 COM 
TU LPT)”, 如 图 4.6.5 所 示 : 
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Burgum — LH x 
文件 (F) ”操作 (A) ”查看 (V) ”帮助 (H) 

e+ Anm) [3 ÁBDRXG 


A 计算 机 管理 (本 地 ) v «B DESKTOP-90GNOJK 











v Ü} 系统 工具 > g Jungo Connectivity 
» O 任务 计划 程序 > P3 WSD 打印 提供 程序 
> E 事件 查看 器 | Dess 
^ gi HX > 二 磁盘 驱动 器 
dE 本 地 用 户 和 组 > Qa 存储 控制 器 
> EX 打印 队列 

> EX 打印 机 


《 


电 端口 COM 和 LPT) 
Ì Silicon Labs CP210x USB to UART Bridge (COM5) 
Sam (COM 


1、 选 择 “ 设 备 管理 器 ” > E 计算 机 


> mje 2、 找 到 自己 开发 板 所 
ER ALIENTEK DFU 使 用 的 COM 口 

^ RR 人 体 学 输入 设备 

|| 软件 设备 

， 天 声音、 视频 和 游戏 控制 器 

> O 鼠标 和 其 他 指针 设备 

> $ 通用 串 行 总 线 控制 器 

P 图 像 设备 

各 网 络 适配器 

1 系统 设备 

EI 

> Á 音频 输入 和 给 出 



















4.6.5 设备 管理 器 
如 果 在 图 4.6.5 中 找到 了 有 “USB-SERIAL CH340” 字 样 的 端口 设备 就 说 明 CH340 驱动 成 
功 了 ， 一 定 要 用 USB 线 将 开发 板 的 串口 和 电脑 连接 起 来 !!11 


4.7 SecureCRT 软件 安装 和 使 用 


4.7.1 SecureCRT 安装 


在 后 续 的 开发 过 程 中 我 们 需要 在 Windows 下 使 用 SecureCRT 作为 终端 ，SecureCRT 支持 
SSH 以 及 串口 ， 我 们 通常 使 用 SecureCRT 来 作为 串口 终端 使 用 。SecureCRT 下 载 地 址 为 : 
https://www.vandyke.com/download/index.html, 下 载 界 面 如 图 4.7.1 所 示 : 
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@o -0x 





C (OQ $$ |O â https://www.vandyk & 4 senama B.» 1 日 D9- 三 


z] m SecureCRT? 
Securely access remote UNIX, Linux, 
[I 


a 


and VMS applications from 
Windows, Mac, and Linux. 


e Manage 1 to thousands of 
sessions 

e Automate routine tasks 

* Work faster using tabbed sessions 


DOWNLOAD & 


> tas Eam O g Vy RES 巴 CO m dq Q10% ; 


4.7.1 SecureCRT 下 载 界面 
我 们 已 经 下 载 好 放 到 开发 板 光盘 中 了 ， 路 径 为 : 开发 板 光 盘 ->3、 软 件 ->SecureCRT7.1， 我 
们 提供 了 两 个 版 本 的 软件 : scrt712-x86.exe 和 scrt733-x64.exe， 这 两 个 分 别 为 32 位 和 64 位 ， 大 
家 根据 自己 所 使 用 的 电脑 来 选择 安装 版 本 ， 我 的 电脑 是 64 位 的 ， 因 此 安装 scrt733-x64.exe。 双 
击 scrt733-x64.exe 开始 安装 ， 界 面 如 图 4.7.1.1 Brzn: 


13 SecureCRT - InstallShield Wizard x 


























Welcome to the InstallShield Wizard for 
SecureCRT 


The InstallShield(R) Wizard will install SecureCRT on your 
computer. 


This product is available for evaluation without charge for a 
30-day period. In order to continue using the software after 
the evaluation period, SecureCRT must be registered. 


SecureCRT users who purchased licenses on or after August 1, 
Secu reCRT 2013 can upgrade to version 7.3 without charge. For more 


information, please see the Upgrade Eligibility page at 
http://www.vandyke.com. 


To continue, dick Next. 





2 WARNING: This is protected by copyright law and 
VANDYKE lj iria 


SOFTWARE 





ICE] ee 





图 4.7.1.1 安装 欢迎 界面 
点 击 图 4.7.1.1 中 的 “Next” 按 钮 ， 进 入 License 许可 界面 ， 如 图 4.7.1.2 所 示 : 
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b SecureCRT - InstallShield Wizard 





License Agreement 


一 
Please read the following license agreement carefully. X VAN D) XKE: 


SOFTWARE 





End-User License Agreement for SecureCRT 7.3 ("Software") 
Copyright (c) 1995-2015 VanDyke Software, Inc. 
A11 Rights Reserved. 


AGREEMENT. After reading this agreement carefully, if you 
("Customer") do not agree to all of the terms of this agreement, 
you may not use this Software. Unless you have a different 

license agreement signed by VanDyke Software, Inc. that covers 
this copy of the Software, your use of this Software indicates 
your acceptance of this license agreement and warranty. All 
updates to the Software shall be considered part of the Software vy 











(8) I accept the terms in the license agreement Print 
(OI do not accept the terms in the license agreement 





InstallShield 
































4.7.1.2 License 界面 
在 图 4.7.1.2 P, X&ff “Iacceptthe terms in the license agreement”， 然 后 点 击 “Next” 按 钮 ， 
进入 使 用 者 选择 界面 ， 如 图 4.7.1.3 所 示 : 


g SecureCRT - InstallShield Wizard 


" 











Select Profile Options 


EN 
Please specify which Windows profile to use for the T. VAN Dh KE: 
installation. > SOFTWARE 











Which profile do you want to use for the installation? 










@ Common profile (affects all users) 
(O Personal profile 





InstallShield 























4.7.1.3 使 用 者 选择 
选择 “Common profile(affects all users)”， 也 就 是 所 有 登陆 到 此 电脑 的 用 户 都 可 以 使 月 
SecureCRT， 选 中 以 后 点 击 “Next” 进 入 下 一 步 ， 进 入 安装 类 型 选择 界面 ， 如 图 4.7.1.4 所 示 : 
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1 SecureCRT - InstallShield Wizard 


Setup Type 
Choose the setup type that best suits your needs. 





Please select a setup type. 


O Complete 
All program features will be installed. (Requires the most disk 
space.) 


@ Custom 


Choose which program features you want installed and where they 
will be installed. Recommended for advanced users. 














4.7.1.4 安装 类 型 
在 图 4.7.1.4 中 我 们 选择 “Custom”， 也 就 是 自 定义 安装 ， 自 定义 安装 我 们 可 以 选择 安装 目 
录 ， 选 择 好 以 后 点 击 “Next” 进 入 下 一 步 。 进 入 安装 路 径 选 择 界面 ， 如 图 4.7.1.5 所 示 


SecureCRT - InstallShield Wizard 








Custom Setup TNX i 
, ZX VANDYKE 
Select the program features you want installed. ~ 


SOFTWARE 





Click on an icon in the list below to change how a feature is installed. 
| Feature Description 
The VanDyke Software 


SecureCRT secure terminal 
emulator. 


This feature requires 24MB on 
your hard drive. It has 8 of 8 
subfeatures selected. The 
subfeatures require 14MB on 
your hard drive. 











Install to: 
D:\Program FilesWanDyke Software XSecureCRT| 


InstallShield 




















Help 




















4.1.1.5. 安装 路 径 选 择 
根据 自己 实际 情况 设置 SecureCRT 安装 路 径 ， 设 置 好 以 后 点 击 “Next” 按 钮 ， 下 一 个 界面 
让 你 选择 是 否 在 桌面 创建 图 标 , 默认 是 需要 创建 的 , 所 以 我 们 不 用 做 任何 修改 , 直接 点 击 “Next”， 
进入 图 4.7.1.6 所 示 界 面 : 
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g SecureCRT - InstallShield Wizard 


Ready to Install the Program 
The wizard is ready to begin installation. 





Install settings 
The installation directory is: 
D:\Program Files\VanDyke Software\SecureCRT\ 


SecureCRT will be installed with the following protocols: 
SSH2, SSH1, Telnet/SSL, Telnet, Rlogin, Serial, TAPI, Raw 


Application icons will be installed for all users. 


If you want to change any of your installation settings, dick Back. Click Cancel to exit the 
wizard. 


InstallShield 





4.7.1.6 安装 确认 





点 击 图 4.7.1.6 中 的 “Istall ”按钮 正式 开始 安装 ， 等 待 安装 完成 界面 ， 安 装 完 成 以 后 如 图 


4.7.1.7 所 示 : 


r 
ia SecureCRT - InstallShield Wizard 





InstallShield Wizard Completed 


i 


| 


! SecureCRT 


The InstallShield Wizard has successfully installed VanDyke 
Software SecureCRT 7.3. Click Finish to exit the wizard. 





[V] View Readme now? 


[7] View History now? 





C] Subscribe to Product Announcements? 





Ce] cm 





4.1.1.7 安装 完成 


点 击 图 4.7.1.7 中 的 “Finish” 按 钮 退出 安装 ， 至 此 SecureCRT 安装 成 功 ， 安 装 成 功 以 后 就 


会 在 桌面 出 现 相 应 的 图 标 ， 如 图 4.7.1.8 所 示 : 
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图 4.7.1.8 SecureCRT 图 标 


4.7.2 SecureCRT 使 用 


SecureCRT 功能 很 强大 , 支持 SSH， 可 以 用 来 远程 登陆 ; 文 持 串口 ， 可 以 用 来 作为 Linux F 
发 板 的 串口 终端 。 我 们 用 的 最 多 的 就 是 将 SecureCRT 作为 串口 终端 来 使 用 。 双 击 图 4.6.1.8 所 示 
的 SecureCRT 图 标 ， 打 开 SecureCRT， 第 一 次 打开 界面 如 图 4.6.2.1 所 示 的 无 效 许可 对 话 框 : 




















m 














The license data must be entered exactly as shown on your 
registration letter. 


If you received your registration letter via e-mail, you can use 
ctrl-v to paste the license data into the dialog. 


If re-entering the data does not resolve the problem, please 
go to the URL http://www.vandyke.com/feedback.php. 
Please include your serial number and the error message you 
received. 


OK 


图 4.7.2.1 无 效 许可 
因为 SecureCRT 也 是 付费 软件 ， 所 以 会 弹出 无 效 许可 对 话 框 ， 点 击 “OK ”按钮 ， 弹 出 序列 
号 输入 对 话 框 ， 如 图 4.7.2.2 所 示 : 


License Wizard x 














Please copy the entire text of your license letter into the box below. 


If you only have a hard copy of your license, press the Next 


< 上 一 步 (B) | 下 一 步 (N) > 取消 





图 4.7.2.2 序列 号 输入 
如 果 购 买 了 序列 号 的 话 就 可 以 输入 序列 号 进行 注册 ， 注 册 成 功 以 后 就 会 进入 到 SecureCRT 
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主 界面 ， 如 图 4.6.2.3 所 示 : 





not connected - SecureCRT 一 口 X 
Fle Edit View Options Transfer Script Tools Window Help 
tac Mj $i x) Enter host <Alt+R> siad dà m t4 TSX* 9 E 
Session Manager 
4 A Aad n 
Filter by session name «Alt- X 


o- Sessions 


0,0 0 Rows, 0 Cols 





4.7.2.3 SecureCRT 主 界面 

我 们 以 串口 连接 为 例 讲 解 如 何 使 用 SecureCRT， 我 们 需要 准备 好 一 个 能 进行 串口 通信 的 设 
备 ， 我 们 的 IMX6U-ALPHA 开发 板 就 可 以 。LMX6U-ALPHA 开发 板 出 厂 已 经 烧 写 了 Linux 系 
Zi, Linux 系统 在 运行 的 过 程 中 会 通过 串口 输出 信息 ， 通 过 串口 可 以 实现 Linux 命令 行 交 互 操 
作 ， 就 和 Ubuntu 里 面 的 终端 一 样 ， 使 用 方法 如 下 : 

1、 查 看 开发 板 当前 使 用 的 串口 号 

首先 通过 USB 线 将 开发 板 的 串口 和 电脑 连接 起 来 ， 打 开 “ 设 备 管 理 器 ” 在 设备 管理 器 中 
查看 当前 连接 到 电脑 的 端口 都 有 哪些 ， 如 图 4.7.2.4 所 示 : 








» 





» 














221 


LMX6U RAR Linux 驱动 开发 指南 多 正点 原子 





原子 哥 在 线 教学 ，www.yuanzige.com 论坛 :www.opendevcom 








m 计算 机 管理 A z 
文件 (F) ”操作 (A) EAV) ”帮助 (H) 
es àme Hm |E xE 




















此 计算 机 管理 (本 地 ) v i DESKTOP-90GNOJK 操作 
v f] 系统 工具 > É Jungo Connectivity 
> © 任务 计划 程序 > Ex WSD 打印 提供 程序 
B 事件 查看 器 D 处 理 器 更 多 操作 > 
> gm) 共享 文件 夹 ^ a 磁盘 驱动 器 
> Æ 本 地 用 户 和 组 ^ Qa 存储 控制 器 
LS) MERI > A 打印 队列 
> EX 打印 机 


~ 电 端口 (COM 和 LPT) 
Silicon Labs CP210x USB to UART Bridge (COM5) 


1、 选 择 “ 设 备 管理 器 ” PI 









> EN 监视 器 

| p iod 2、 找 到 自己 开发 板 所 
EÈ ALIENTEK DFU 使 用 的 COM 口 

^ A 人 体 学 输入 设备 


， 县 软件 设备 

， 大 声音、 视频 和 游戏 控制 器 

> O 鼠标 和 其 他 指针 设备 

， $ 通用 串 行 总 线 控制 器 
ds 图 像 设备 

， 别 网 络 适配器 

Eu 系统 设备 

， 国 显示 适配器 

， 而 “音频 输 入 和 输出 











4.7.2.4 设备 管理 器 
在 图 4.7.2.4 中 可 以 看 到 有 多 个 COM O, 哪个 才 是 我 们 开发 板 的 呢 ? LMX6U-ALPHA 开发 
板 使 用 的 CH340 芯片 完成 串口 转 USB， 所 以 “USB-SERIAL CH340(COM8)” 就 是 我 的 开发 板 
所 使 用 的 端口 ， 串 口号 为 COM8。 如 果 你 的 电脑 连接 了 多 个 CH340 做 的 USB 转 串 口 设备 ， 无 
法 区 分 哪个 才 是 开发 板 所 使 用 的 ， 只 需要 把 你 的 开发 板 串口 拔 掉 ， 看 看 哪个 串口 号 消失 了 ， 然 
后 再 重新 插 上 开发 板 的 串口 线 ， 再 看 一 下 那个 消失 的 串口 号 会 不 会 重新 出 现 ， 如 果 会 的 话 那 你 
的 开发 板 就 是 用 的 这 个 串口 号 。 
2、 设 置 SecureCRT 


我 们 已 经 知道 了 当前 开发 板 所 使 用 的 串口 号 了 ， 比 如 我 的 是 COM8， 打 开 SecureCRT， 然 
后 点 击 File->Quick Connect...， 如 图 4.7.2.5 所 示 : 
































not connected - SecureCRT 






File | Edit View Options Transfer 


SJ Quick Connect. Alt«Q 
EEC 


Connect in Tab/Tile... Alt-B 









4.12.5 打开 快速 连接 
打开 以 后 的 快速 连接 界面 如 图 4.7.2.6 所 示 : 
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Quick Connect X | 
Protocol: SSH2 v 
mue [| ] 
m E] v em z 
bemame | | 
Authentication 
[v]Password ^ Properties... 
[z]PublicKey 
回 Keyboard Interactive - 
回 GssaFI 
C] Show quick connect on startup [V] Save session 
[V] Open in a tab 
Connect | Cancel 





图 4.7.2.6 快速 连接 





按照 图 4.7.2.7 所 示 进 行 设置 : 


Quick Connect X 








| 不 使 用 硬件 流 控 ,- TRA 
Name of pipe: Sw HEA 
根据 实际 使 用 情况 设置 ， 本 教程 串口 波 特 率 全 部 为 
115200、8 位 数据 为 、 无 校 验 、1 位 停止 位 
[C] Show quick connect on startup [7] Save session 
[7] Open in a tab 


[ emet ] | cance 


图 4.7.2.7 上 串口 设置 
设置 好 以 后 点 击 “Connect” 按 钮 进行 连接 ， 连 接 成 功 以 后 SecureCRT 如 图 4.7.2.8 所 示 : 











223 


LMX6U AR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 








serial-com8 - SecureCRT = xX 











File Edit View Options Transfer Script Tools Window Help 


EaR Enter host <Alt+R> T CR TEM) [7 5 
. MT Sirve. 会 显示 绿色 V 





Ja A 


Filter by session name «Alt 





34 Sessions 


A serial-com& 


1、 串 口 列 表 ， 
SecureCRT 支 持 连 接 
多 个 串口 


3、 串 口 数 据 收 发 区 域 





Ready Serial: COM8, 115200 1, 1 24 Rows, 80 Cols  VT100 CAP NUM 


图 4.7.2.8 串口 连接 成 功 界面 
在 图 4.7.2.8 中 ， 左 侧 是 会 话 列 表 ， 保存 着 历史 会 话 ， 会 显示 出 所 有 曾经 连接 的 串口 ， 这 个 
在 关闭 SecureCRT 以 后 会 被 保存 起 来 ,下 次 重新 打开 SecureCRT 就 可 以 直接 使 用 这 个 串口 会 话 
连接 进行 快速 连接 。 比 如 我 们 关闭 SecureCRT， 在 关闭 SecureCRT 之 前 要 先 关 闭 所 有 的 会 话 ( 串 
口 )， 重 新 打开 SecureCRT， 如 图 4.7.2.9 所 示 : 






























































not connected - SecureCRT 一 X 
File Edit View Options Transfer Script Tools Window Help 

faz Nj € 2) Enter host <Alt+R> 18 230 52 4 09 5x € 19 LES z 

Session Manager nx 

4i We 


Filter by session name «Alt«l: x 


3 serial-com8 





上 次 设置 的 串口 保存 
着 ， 我 们 可 以 通过 双击 
来 快速 打开 会 话 (串口 ) 








Ready 0,0 0 Rows, 0 Cols CAP NUM 


4.7.2.9 重新 打开 SecureCRT 
图 4.7.2.9 中 重新 打开 的 SecureCRT 保存 这 上 次 关闭 之 前 建立 的 会 话 (串口 )“serial-com8?”， 
十 双击“ serial-com8 ”可 以 重新 连接 会 话 ( 串 口 ), 不 需要 再 使 用 快速 连接 对 话 框 进行 连接 设置 。 
LMX6U-ALPHA 开发 板 默认 出 厂 烧 写 了 Linux 系统 , 所 以 如 果 连 接 上 SecureCRT 以 后 会 将 
串口 作为 终端 , 会 输出 Linux 系统 启动 信息 , 并 且 可 以 通过 SecureCRT 来 操作 开发 板 中 的 Linux 
系统 ， 此 时 SecureCRT 就 是 开发 板 的 终端 ， 和 Ubuntu 中 的 终端 一 样 ， 如 图 4.7.2.10 所 示 : 
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serial-com8 - SecureCRT = xX 
File Edit View Options Transfer Script Tools Window Help 

ta- 8J £2 2 Enter host <Alt+R> | ^ dA ETE) aZ ? 多 Lm z 

+ serial-com8 x 4b 
iam ' [starting statd: done 
- 4L Bj s ua - Starting advanced power management daemon: No APM support in kernel 
Filter by session name «Alt«l: x || (failed.) 





= : Starting atd: OK 
5- Sessions exportfs: can't open /etc/exports for reading 
A serial-com8 NFS daemon support not enabled in kernel 
Starting system log daemon. . .0 
Starting kernel log daemon...0 
* starting Avahi mDNS/DNS-SD Daemon: avahi-daemon [ ok ] 
Starting Telephony daemon 
Starting Linux NFC daemon 
Starting crond: OK 
Running local boot scripts (/etc/rc. local). 


Freescale i.MX Release Distro 4.1.15-2.0.0 imx6ul7d /dev/ttymxcO 


imx6ul7d login: root 
root@imx6u17d:~# 
root@imx6u17d:~# ls 
root@imx6ul7d:~# cd / 
root&imx6ul7d:/& ls 





bin dev home lost+found mnt proc sbin tmp usr 

boot etc lib media opt run sys unit tests var 

rootéimx6ul7d:/* J v 
Ready Serial: COM8, 115200 24, 18 24 Rows, 80 Cols  VT100 CAP NUM 





4.72.10 SecureCRT 作为 Linux 终端 
4.8 Putty 软件 的 安装 和 使 用 


4.8.1 Putty 软件 安装 


Putty 和 SecureCRT 是 类 似 的 软件 ,都 是 用 来 作为 SSH 或 者 串口 终端 的 , 区 别 在 于 SecureCRT 
是 付费 软件 ， 而 Putty 是 免费 的 1!1! 这 点 很 重要 啊 ! 虽然 Putty 没有 SecureCRT 功能 强大 ,但 是 
Putty 用 来 作为 艇 入 式 Linux 的 串口 终端 是 绰绰有余 。Putty 在 官网 下 载 即 可 ， 下 载 地 址 为 : 
https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html， 下 载 界面 如 图 4.8.1.1 所 示 : 





























= 1P Download PuTTY: latest rele + o= Ix 
< C ù ù 2 âN Pn uu 新 型 灵 宠 现世 群 魔 退 散 al- g- A4 ]5--z- 
version of the code available. If you have a problem with this release, then it might be worth trying out the development snapshots, to 
see if the problem has already been fixed in those versions. 


;e You probably want one of these. They include all the PuTTY utilities. 
(Not sure whether you want the 32-bit or the 64-bit version? Read the FAQ entry.) 


MSI ( ‘Windows Installer" ) 


putty-0. Tü- installer. msi (or by FTP) (signature) 
putty-64bit-0. 70- installer. msi (or by FTP) (signature) 








Unix source archive 
.tar.gz: putty-0. 70. tar. gz (or by FTP) (signature) 

















temm Eram O g y ME PD € gm « Q 10096 





4.8.1.1 Putty 下 载 界面 

Putty 同样 提供 了 32 位 和 64 位 两 个 版 本 的 软件 ,我 们 已 经 下 载 好 放 到 开发 板 光 盘 中 了 ,路 
径 为 : 开发 板 光 盘 ->3、 软 件 ->Putty， 有 32 位 和 64 位 两 种 ，putty-0.70-installermsi 是 32 位 版 本 
的 ，putty-64bit-0.70-installer.msi 为 64 位 版 本 的 ， 根 据 自己 所 使 用 的 Windows 系统 选择 合适 的 
版 本 。 因 为 我 的 电脑 是 64 位 系统 ， 所 以 我 使 用 的 是 putty-64bit-0.70-installermsi， 双 击 开 始 安 
装 ， 安 装 界面 如 图 4.8.1.2 所 示 : 
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g PuTTY release 0.70 (64-bit) Setup 一 


Welcome to the PuTTY release 0.70 
(64-bit) Setup Wizard 


The Setup Wizard will install PuTTY release 0.70 (64-bit) on 
your computer. Click Next to continue or Cancel to exit the 
Setup Wizard. 








ss em] 站 aa 


4.8.1.2 Putty 安装 界面 
点 击 图 4.7.1.2 中 的 “Next” 按 钮 ， 进 入 下 一 步 ， 下 一 步 是 选择 安装 路 径 ， 大 家 根据 自己 的 
实际 情况 选择 一 个 安装 路 径 ， 如 图 4.8.1.3 所 示 : 
由 PuTTY release 0.70 (64-bit) Setup 





Destination Folder 
Click Next to install to the default folder or click Change to choose another. 





Install PuTTY release 0.70 (64-bit) to: 








4.8.1.3 安装 路 径 
设置 好 安装 路 径 以 后 点 击 “Next” 按 钮 进入 下 一 步 ， 如 图 4.8.1.4 所 示 : 
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P PuTTY release 0.70 (64-bit) Setup — 
Product Features 
Select the way you want features to be installed. 








This feature requires 3713KB on your hard drive. 








| Bak | nstal Cancel 




















4.8.1.3. 产品 特性 
点 击 图 4.8.1.3 中 的 “Install” 按 钮 ， 开 始 安装 ， 安 装 完成 以 后 如 图 4.8.1.4 所 示 : 


Completed the PuTTY release 0.70 
(64-bit) Setup Wizard 


Click the Finish button to exit the Setup Wizard. 








图 4.8.1.4 安装 完成 
点 击 图 4.8.1.4 中 的 “Finish” 按 钮 退出 安装 。Putty 安装 完成 以 后 桌面 可 能 不 会 出 现 APP 
标 ， 自 行 找到 安装 目录 ， 将 Putty 图 标的 快捷 方式 发 送 到 桌面 上 即 可 ，Putty 图 标 如 图 4.8.1.5 所 
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E 








图 4.8.1.5 Putty 图 标 





4.8.2 Putty 软件 使 用 


使 用 USB 线 将 开发 板 串 口 和 电脑 连接 起 来 ， 打 开 Putty 软件 ， 打 开 以 后 是 配置 界面 ， 如 图 
4.8.2.1 所 示 : 




































































88 PuTTY Configuration ? x 

Category: 

E Session Basic options for your PuTTY session 
Logging Specify the destinati tt tt 

È Terminal pecify the destination you want to connect to 
Keyboard Host Name (or IP address) Port 
Bell 22 
Features 3 3 

& Window Connection type: ) i 
Appearance (Raw OTelnet Q) Riogin (€) SSH ( Serial 
Peens Load, save or delete a stored session 
Translation 
Selection Saved Sessions 
Colours 

E Connection - 
Data Default Settings Load 
Proxy 
Telnet Save 
Rlogin 

由 SSH Delete 
Serial 
Close window on exit: 
ays lever nly on clean exi 
OAways ON (€) Only on clean exit 

CEU omes 








4.82.1 配置 界面 
我 们 要 用 到 串口 功能 ， 所 以 在 左 侧 选 择 “Serial”， 然后 在 右 侧 配置 串口 ， 配 置 完 成 以 后 如 
图 4.8.2.2 所 示 : 
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89 PuTTY Configuration ? X 





Category: 
E Session Options controlling local serial lines 
Logging 


i : Select a serial line 
= Terminal 








Keyboard Serial line to connect to 
Bell 


Features 
E Window 
Appearance Speed (baud) 
Behaviour 
Translation 
Selection 
Colours 
& Connection Parity 
Data 
Proxy Flow control 
Telnet 
Rlogin 
E SSH 


LSeial n 2、 根 据 实 际 情况 配置 串口 


1. X8 "Serial" 





Configure the serial line 











Data bits 














Stop bits 




















ao | Hep ones 
图 4.8.2.2 串口 配置 
按照 图 4.8.2.2 配置 好 串口 ， 配 置 好 以 后 不 要 点 击 “Open”， 没 反应 的 !! 我 们 还 需要 设置 
“Session”， 设 置 如 图 4.8.2.3 所 示 ; 
89 PuTTY Configuration ? 


ES 1、 选 择 "Session 
CESS | Basic options for your PuTTY session 
Ogging 


É Terminal Specify the destination you want to connect to 
Keyboard Í peed 
115200 














X 























Features = TETT 
E Window onnec; : 

Appearance 门 Raw OTelnet ORlogin OSSH | @ Serial 

miae Load, save or delete a stored session 

b? u z LL 

Selection Saved Sessions 2、 选 择 “Serial 

Colours 
E Connection 


Data Default Settings Load 
Proxy 


Po 。 3、 检查 串口 配置 是 否 正确 ， 主 要 || sae 
Sogn 是 串口 号 和 波 特 率 


Serial 














Delete 











Close window on exit: 
Q Always (Neve X (9)Onlyon clean exit 


4. Rai "Open" HAO 
About Help 7 [E97] Cancel 
图 4.82.3 打开 串口 


按照 图 4.8.2.3 设置 好 以 后 ， 点 击 “Open” 打 开 串 口 ， 如 果 开 发 板 里 面 烧 写 了 Linux 系统 的 
舌 ，Putty 就 会 显示 Linux 局 动 过 程 的 信息 ， 并 且 作 为 开发 板 的 终端 ， 如 图 4.8.2.4 所 示 ; 
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gf COMB - PuTTY 2 x 


U-Boot 201t€ 








图 4.8.2.4 Putty 作为 串口 终端 


























相 比 于 SecureCRT 这 种 高 富 帅 ，Putty 就 有 点 寒酸 多 了 ， 但 是 Putty 免费 啊 ， 至 于 要 用 哪 一 
个 大 家 自行 选择 一 个 合适 的 ， 本 教程 后 面 全 部 使 用 SecureCRT。 一 是 因为 SecureCRT 使 用 范围 


^ 


很 广 ， 几 乎 所 有 要 用 到 串口 终端 的 设备 都 使 用 SecureCRT， 二 是 SecureCRT 功能 强大 。 
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第 五 章 L.MX6U-ALPHA 开发 平台 介绍 








要 学 租 入 式 Linux 驱动 开发 肯定 需要 一 个 硬件 平台 ， 也 就 俗称 的 开发 板 ， 本 书 使 用 的 是 正 
点 原子 出 品 的 LMX6U-ALPHA 开发 板 。 这 是 一 款 以 NXP If] LMX6UL/ULL 为 核心 的 Cortex-A7 
开发 平台 , 板 载 资 源 丰 富 , 非常 适合 以 前 学 过 Cortex-M 内 核 单片机 (比如 STM32)If T EEXEB HE 
AR Linux 开发 。 工 欲 善 其 事 ， 必 先 利 其 器 ， 本 章 我 们 就 先 来 详细 了 解 一 下 未 来 将 会 陪伴 我 们 
很 长 一 段 时 间 的 朋友 一 一 LMX6U-ALPHA 开发 平台 。 
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5.1 正点 原子 LIMX6U-ALPHA 开发 板 资源 初探 














正点 原子 目前 已 经 拥有 多 款 STM32. LMXRT 以 及 FPGA 开发 板 ， 这 些 开发 板 常年 稳 居 淘 
宝 销量 冠军 ， 累 计 出 货 超过 10W 套 。 这 款 ALPHA 开发 板 ， 是 正点 原子 推出 的 第 一 款 Linux 开 
发 板 ， 采 用 底板 + 板 的 形式 。 接 下 来 我 们 分 别 介 绍 LMX6U-ALPHA 开发 板 的 底板 和 核心 板 。 


























































































































5.1.1 LMX6U-ALPHA 开发 板 底板 资源 











如 图 5.1.1.1 所 示 : 


3 路 USB DC6~16V 
电源 输入 





首先 ， 我 们 来 一 下 I.MX6U-ALPHA 开发 板 的 底板 资源 图 








































RS485 以 太 网 接 
接 1(RJ45) 


AAE | 
c" ^J CES 


1 


RS485/RS232 选择 COM3 













































































































Mini PCIE 4G 模块 
接 



































LMX6UL/ULL 



















































核心 板 接 4G 模块 Nano SIM 
| LE E E V^ i uil di 卡 插座 
RGB LCD 接 E "M — 
后 备 电池 接 全 OE 乔 二 TH 
USB HOSTOOTG) 一 | 本 站 IB - LJ WM8960 音频 DAC 
hm | i. 20 i B u EIN ` itn j 






电源 指示 灯 





































Š " - 色 用 户 LED XT 
MONGE J 用户 拉 刍 KEY0 | 


SS 










SDIO_WIT 


=a E a. 
TaN cw 
9 ATK MODULE. Jp? Gs EE 
zi z 
y z A 5 u 


ATK 模 | 左右 声 道 
块 接 喇叭 接 


图 5.1.1.1 LMX6U-ALPHA 开发 板 底板 资源 图 
从 图 5.1.1.1 可 以 看 出 , LMX6U-ALPHA 开发 板 底板 资源 十 分 丰富 ， 把 IMX6UL/ULL 的 内 

部 资源 发 挥 到 了 极致 ， 基 本 所 有 IMX6UL/ULL 的 内 部 资源 都 可 以 在 此 开发 板 上 验证 ， 同 时 扩 

充 丰 富 的 接口 和 功能 模块 ， 整 个 开发 板 显得 十 分 大 气 。 
开发 板 的 外 形 尺 寸 为 100mm*180mm 大 小 ， 板 子 的 设计 充分 考虑 了 人 性 化 设计 ， 并 结合 正 

点 原子 多 年 的 开发 板 设 计 经 验 ， 经 过 多 次 改进 ， 最 终 确 定 了 这 样 的 设计 。 
正点 原子 IMX6U-ALPHA 开发 板 底板 板 载 资源 如 下 : 

1 个 核心 板 接 口 ， 支 持 LMX6UL/6ULL 等 核心 板 

1 个 电源 指示 灯 〈 蓝 色 ) 

1 个 状态 指示 灯 红色) 

1 个 六 轴 〔 陀 螺 仪 + 加 速度 ) 传感器 芯片 ，ICM20608 

1 个 高 性 能 音频 编 解码 芯片，WM8960 

1 路 CAN 接口 ， 采 用 TJA1050 芯片 

1 路 485 接口 ， 采 用 SP3485 心 片 

1 路 RS232 $O CŒ) 接口 ， 采 用 SP3232 忆 

1 个 ATK 模块 接口 ， 支 持 正点 原子 蓝牙 /GPS/MPU6050/ 手 势 识别 等 模块 





















































摄像 头 模块 接 



























BOOT 选择 
E 


TF 卡 接 
拨 码 H 


























(背面 ) 传感器 

































































































































































































































































CR E E E 多 
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1 个 摄像 头 模块 接口 
1 个 OLED 模块 接口 
1 个 USB 串口 ， 可 用 于 代码 调试 











1 个 有 源 蜂 鸣 器 

1 个 RS232/RS485 选择 接口 
1 个 串口 选择 接口 

1 个 TF 卡 接口 〈 在 板子 背面 ) 
2 个 10M/100M 以 太 网 接口 (RJ45) 
1 个 录音 头 〈MIC/ 咪 头 ) 
1 路 立体 声音 频 输 出 接口 
1 路 立体 声 录 音 输入 接口 
1 个 小 扬声器 (在 板子 背面 ) 
2 个 扬声器 外 接 接口 ， 左 右 声 道 。 
1 组 SV 电源 供应 / 接 入 口 
1 组 3.3V 电源 供应 / 接 入 口 

1 个 直流 电源 输入 接口 (输入 电压 范 
1 个 启动 模式 选择 配置 接口 

1 个 RTC 后 备 电 池 座 ， 并 带电 池 














































































































[4 









































1 个 功能 按钮 

1 个 电源 开关 ， 控 制 整个 板 的 电源 
1 个 Mini PCIE 4G 模块 接口 
1 个 Nano SIM 卡 接口 

1 个 SDIO WIFI 接口 























DAR E E E E E E E E a e a a E a a E a e a E a a E E E 








1 个 光环 境 传感器 〈 光 照 、 距 离 、 红 外 三 合 


1 个 复位 按钮 ， 可 用 于 复位 MPU 和 LCD 


=) 


1 ^ USB SLAVE(OTG) 接 口 ， 用 于 USB 从 机 通信 
1 个 USB HOST(OTG) 接 口 ， 用 于 USB 主机 通信 


正点 原子 IMX6U-ALPHA 开发 板 底板 的 特点 包括 : 
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围 : DC6~24V) 








1) 接口 丰富 。 板 子 提供 十 来 种 标准 接口 ， 


2) 设计 灵活 。 我 们 采用 核心 板 + 转 接 板 + 底板 








可 以 方便 的 i 





























不 同 条 件 下 的 使 用 ; 我 们 引出 了 105 个 IO 
3) 资源 丰富 。 板 载 高 性 能 音频 编 解 码 芯 片 、 六 轴 传 感 器 、 百 兆 网 卡 、 光 环境 传感器 以 及 各 





























种 接口 芯片 ， 满 足 各 种 应 用 需求 。 





行 各 种 外 设 的 实验 和 开发 。 











EX, C] 








口 ， 极 大 的 方便 大 家 扩展 及 使 用 。 





上 很 多 资源 都 可 以 灵活 配置 ， 以 满足 












































4) 人 性 化 设计 。 各 个 接口 都 有 丝印 标注 ， 


























5.1.2 LMX6U 核心 板 资源 
接 下 来 ,我们 来 看 LMX6ULL 核心 板 资源 








且 月 


图 ， 





昌 方 框框 出 ,使 
设 大 丝印 标 出 ， 方 便 查 找 ， 接口 位 置 设计 合理 ， 方 便 顺 了 
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j 起 来 一 目 了 然 ; 部 分 常用 外 
资源 搭配 合理 ， 物 尽 其 用 。 
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正点 原子 的 LIMX6ULL 核心 板 根据 存储 芯片 


的 不 同 分 为 EMMC fll NAND 两 种 , 根据 对 外 提供 的 接口 可 以 分 为 邮票 孔 和 BTB 两 种 。 本 




















教程 主要 使 用 与 教学 的 ， 所 以 只 会 讲解 BTB 接口 的 核 








板 如 图 5.1.2.1 所 示 : 
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核心 板 蓝 色 电 源 指 f CN m 











示 灯 24MHz 无 源 晶振 


Mead 
N | 
32.768KHz 无 源 唱 振 
NAND FLASH， 


256MB/512MB 


Q | 


NUCC. SO »; 


[zm ET [I 
Li 
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LMX6ULL ERCH, 
MCIMX6Y2CVM08AB/ 
MCIMX6Y2CVM05AB 





lzm 


TEE DESS 
1935 


256MB DDR3L : 


^ AMETE 


图 5.12.1 LMX6ULL NAND BTB 接口 核心 板 资源 图 

从 图 5.1.2.1 可 以 看 出 ，LMX6ULL 核心 板 板 载 资源 丰富 ， 可 以 满足 各 种 应 用 的 需求 。 整 个 

核心 板 的 外 形 尺寸 为 46mm*36mm 大 小 ， 非 常 小 巧 ， 并 且 采 用 了 贴 片 板 对 板 连接 器 ， 使 得 其 可 

以 很 方便 的 应 用 在 各 种 项 目 上 。I.MX6ULL NAND 版 核心 板 为 工业 级 工作 温度 ， 可 以 应 用 在 温 

度 要 求 严格 的 场合 。 

正点 原子 LIMX6ULL NAND 版 核心 板 板 载 资源 如 下 : 

€ CPU: MCIMX6Y2CVM05AB( 工 业 级 ) 或 MCIMX6Y2CVM08AB 工业 级 )， 主 频 分 别 
为 528MHz 和 800MHz( 实 际 为 792MHz)，BGA289 

€ 外 扩 DDR3L: NT5CC128M16JR-EK, 256MB 字 节 ， 工 业 级 

€ NAND FLASH: MT29F2G08ABAEAWP-IT 或 MT29F4G08ABADAWP-IT， 分 别 为 
256MB/512MB 字 节 ， 均 为 工业 级 

€ 两 个 2*30 的 防 反 插 BTB 座 ， 共 引出 120PIN 。 

BTB 接口 的 EMMC 版 本 核心 板 如 图 5.1.2.2 所 示 : 


核心 板 蓝 色 电源 指 
示 灯 























































































































24MHz 无 源 晶振 
ri 
HE 
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LJ "| 


S |^ 32.768KHz 无 源 晶振 


. ` 
firi! ls! 
dia M” a 





和 4 E LMX6ULL 主 控 芯 片 ， 
Brom a MCIMX6Y2CVM08AB/ 
LT | 

Tp4 aaa 二 | 站 -= 过 MCIMX6Y2CVM05AB 








ETT USES 





图 5.1.2.2 LMX6ULL EMMC BTB 接口 核心 板 资源 图 
































从 图 5.1.2.2 可 以 看 出 ，EMMC 版 本 的 核心 和 NAND 版 本 的 基本 一 样 ， 不 同 之 处 在 于 将 
NAND 换 成 了 EMMC, 将 DDR3L 换 成 了 512MB 的 商业 级 。 因 此 正点 原子 的 EMMC 核心 板 为 
商业 级 的 工作 温度 范围 ， 如 需 工 业 级 的 请 联系 定制 。 

正点 原子 ILMX6ULL EMMC 版 核心 板 板 载 资源 如 下 ; 

€ CPU: MCIMX6Y2CVM08AB 〈 工 业 级 )，800MHz( 实 际 792MHz)，BGA289 
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€ 外 扩 DDR3L: NT5CC256MIGEP-EK, 512MB 字 节 ， 商 业 级 。 


9 EMMC: KLM8G1GET， 这 是 一 个 8GB 的 EMMC 芯片 。 
€ 两 个 2*30 的 防 反 择 BTB 座 ， 共 引出 120 PIN 
正点 原子 ILMX6ULL 核心 板 的 特点 包括 : 
1) 体积 小 巧 。 核 心 板 仅 46mm*36mm 大 小 ， 方 便 使 用 到 各 种 项 目 里 面 。 
2) 集成 方便 。 核心 板 使 用 120P BTB ERE, 可 以 非常 方便 的 集成 到 客户 PCB E, 更换 简 
单 ， 方 便 维修 测试 。 
资源 丰富 ,核心 板 板 载 :256MB/512MB DDR3L、 可 以 选择 NAND 或 EMMC 等 存储 器 ， 
可 以 满足 各 种 应 用 需求 。 
4) 性 能 稳定 。 核 心 板 采用 6 层 板 设计 ， 单 独 地 层 、 电 源 层 ， 且 关键 信号 采用 等 长 线 走 线 ， 
保证 运行 稳定 、 可 靠 。 
5) 不 管 是 NAND 还 是 EMMC 核心 板 均 通 过 了 CE 和 FCC 认证 。 
6) 人 性 化 设计 。 底 部 放 有 详细 丝印 ， 方 便 安 装 ; 按 功能 分 区 引出 IO 口 ， 方 便 布 线 。 
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5.2 正点 原子 LMX6U-ALPHA 开发 板 资源 说 明 
资源 说 明 部 分 ， 我 们 将 分 为 两 个 部 分 说 明 : 硬件 资源 说 明和 软件 资源 说 明 。 





5.2.1 硬件 资源 说 明 


这 里 我 们 首先 详细 介绍 ILMX6U-ALPHA 开发 板 的 各 个 部 分 , 包括 底板 和 核心 板 二 部 分 (图 
5.1.1.1、 图 5.1.2.1 和 图 5.1.2.2 中 的 标注 部 分 ) 的 硬件 资源 ， 我 们 将 按 逆 时 针 的 顺序 依次 介绍 。 
首先 ， 我 们 来 看 底板 的 资源 说 明 : 

1. CAN 接口 

这 是 开发 板 板 载 的 CAN 总 线 接口 (CAN), 通过 2 个 端口 和 外 部 CAN 总 线 连接 , BI CANH 
和 CANL。 这 里 提醒 大 家 : CAN 通信 的 时 候 ， 必 须 CANH 接 CANH, CANL 接 CANL, | fit 
可 能 通信 不 正常 ! 

2. RS232/485 选择 接口 

这 是 开发 板 板 载 的 RS232 (COM3) /485 选择 接口 (JP1)， 因 为 RS485 基本 上 就 是 一 个 半 
双 工 的 串口 ， 为 了 节约 IO， 我 们 把 RS232 (COM3) 和 RS485 共用 一 个 串口 ， 通 过 JP1 来 设置 
当前 是 使 用 RS232(COM3) 还 是 RS485。 这 样 的 设计 还 有 一 个 好 处 。 就 是 我 们 的 开发 板 既 可 以 
充当 RS232 $J TTL 串口 的 转换 ， 又 可 以 充当 RS485 到 TTL485 的 转换 。( 注 意 ， 这 里 的 TTL 高 
电 平 是 3.3V) 

3. LMX6UL/ULL 核心 板 接 口 

这 是 开发 板 底板 上 面 的 核心 板 接口 ， 由 2 个 2*30 的 贴 片 板 对 板 接线 端子 (3710F 公 座 ) 组 
成 ， 可 以 用 来 插 正 点 原子 的 LMX6UL/ULL 核心 板 等 ， 从 而 学 习 ILMX6UL/6ULL 等 芯片 ， 达 到 
开发 板 ， 学 习 多 款 SOC 的 目的 ， 减 少 重复 投资 。 
4. RGBLCD 接口 
这 是 转 接 板 自 带 的 RGB LCD 接口 (LCD)， 可 以 连接 各 种 正点 原子 的 RGB LCD 屏 模块 ， 
并 且 支 持 触 摸 屏 (电阻 /电容 屏 都 可 以 )。 采 用 的 是 RGB888 格式 ， 可 显示 1677 万 色 ， 色 彩 显示 
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5. 后 备 电 池 接 口 
这 是 LMX6UL/ULL 后 备 区 域 的 供电 接口 ， 可 以 用 来 给 LMX6UL/ULL 的 后 备 区 域 提供 


量 ， 在 外 部 电源 断 电 的 时 候 ， 维 持 SNVS 区 域 数据 的 存储 ， 以 及 RTC 的 运行 。 
6. USB HOST(OTG) 
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这 是 开发 板 板 载 的 一 个 侧 插 式 的 USB-A 座 (CUSB _ HOST), HF LMX6U 的 USB 支持 OTG 
功能 ， 所 以 USB 既 可 作 HOST， 又 可 做 SLAVE. 我们 可 以 通过 这 个 USB-A Ji, 连接 TU 盘 /USB 
鼠标 /USB 键盘 等 其 他 USB 从 设备 ， 从 而 实现 USB 主机 功能 。 不 过 特别 注意 ， 由 于 USB HOST 
和 USB SLAVE 是 共用 一 个 USB 端口 ， 所 以 两 者 不 可 以 同时 使 用 。 

7. USB 串口 /串口 1 

这 是 USB 串口 同 LMX6U 的 串口 1 进行 连接 的 接口 (JP5)， 标 号 RXD 和 TXD 是 USB f£ 
串口 的 2 个 数据 口 (对 CH340C 来 说 )， 而 Ul1_TX(TXD) 和 Ul RX(RXD) 则 是 LMX6U 串口 1 
的 两 个 数据 口 。 他 们 通过 跳 线 帽 对接 , 就 可 以 和 连接 在 一 起 了 , 从 而 实现 LMX6U 的 串口 通信 。 

设计 成 USB 串口 ， 是 出 于 现在 电脑 上 串口 正在 消失 , 尤其 是 笔记 本 ， 几 乎 清一色 的 没有 串 
口 。 所 以 板 载 了 USB 串口 可 以 方便 大 家 调试 。 而 在 板子 上 并 没有 直接 连接 在 一 起 ， 则 是 出 于 使 
用 方便 的 考虑 。 这 样 设计 ， 你 可 以 把 LMX6U-ALPHA 开发 板 当成 一 个 USB f£ TTL 串口 ， 来 和 
其 他 板子 通信 ， 而 其 他 板子 的 串口 ， 也 可 以 方便 地 接 到 开发 板 上 。 

8. USBSLAVE(OTG) 

这 是 开发 板 板 载 的 一 个 MiniUSB 3k (USB SLAVE)， 用 于 USB 从 机 (SLAVE) 通信 ， 与 
上 面 的 USB HOST 一 起 作为 OTG 功能 。 通 过 此 MiniUSB 头 ， 开 发 板 就 可 以 和 电脑 进行 USB 
通信 了 。 注 意 : 该 接口 不 能 和 USB HOST 同时 使 用 。 

开发 板 总 共 板 载 了 两 个 MiniUSB 头 ， 一 个 (USB TTL) 用 于 USB 转 串 口 ， 连 接 CH340C 
芯片 ;另外 一 个 〈USB_SLAVE) 用 于 I.MX6U 内 部 USB。 同 时 开发 板 可 以 通过 此 MiniUSB 头 
供电 ， 板 载 两 个 MiniUSB 头 〈《 不 共用 )， 主 要 是 考虑 了 使 用 的 方便 性 ， 以 及 可 以 给 板子 提供 更 
大 的 电流 《两 个 USB 都 接 上 ) 这 两 个 因素 。 

9. USB 转 串 口 

这 是 开发 板 板 载 的 另外 一 个 MiniUSB 头 〈USB_TTL)， 用 于 USB 连接 CH340C 芯片 ， 从 
而 实现 USB 转 串 口 。 同 时 ， 此 MiniUSB 接头 也 是 开发 板 的 电源 提供 口 。 

10. 摄像 头 模块 接口 

这 是 开发 板 板 载 的 一 个 摄像 头 模块 接口 (P1)， 摄 像 头 模块 ( 需 自 备 )， 对 准 插 入 到 此 插 横 




































































































































































































































































11. 启动 BOOT) 拨 码 开关 
LMX6U 支持 多 种 启动 方式 比如 SD 卡 、EMMC、NAND、QSPIFALSH 和 USB 等 ， 要 想 
从 某 一 种 设备 启动 就 必须 先 设 置 好 启动 拨 码 开关 。LMX6U-ALPHA 开发 板 用 了 一 个 8P 的 拨 码 
开关 来 选择 启动 方式 ， 正 点 原子 开发 板 支 持 从 SD 卡 、EMCM、NAND 和 USB 这 四 种 启动 方 
式 ， 这 四 种 启动 方式 对 应 的 拨 码 开关 找 动 方式 已 经 写 在 了 开发 板 上 。 大 家 在 使 用 的 时 候 根据 自 
己 的 实际 需求 设置 拨 码 开关 即 可 。 
12. TF 卡 接口 
这 是 开发 板 板 载 的 一 个 标准 TF 卡 接口 CTF_CARD )， 该 接口 在 开发 板 的 背面 ,采用 小 型 的 
TF 卡 接口 ，USDHC 方式 驱动 ， 有 了 这 个 TF 卡 接口 ， 就 可 以 满足 海量 数据 存储 的 需求 。 
13. 光环 境 传感器 
这 是 开发 板 板 载 的 一 个 光环 境 三 合 一 传感器 (U9)， 它 可 以 作为 : 环境 光 传 感 器 、 近 距离 
(接近 ) 传感器 和 红外 传感器 。 通 过 该 传感器 ， 开 发 板 可 以 感知 周围 环境 光线 的 变化 ， 接 近 距 
等 ， 从 而 可 以 实现 类 似 手 机 的 自动 背光 控制 。 
14. SDIO WIFI 接口 
这 是 开发 板 上 的 一 个 SDIO WIFI(P4) 接 口 , 可 以 通过 此 接口 连接 正点 原子 出 品 的 SDIO WIFI 
模块 。SDIO WIFI 接口 和 TF 卡 共 用 一 个 USDHC 接口 ， 因 此 不 能 同时 和 TF 卡 使 用 。 
15. ATK 模块 接口 
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这 是 开发 板 板 载 的 一 个 正点 原子 通用 模块 接口 (JP2)， 目 前 可 以 支持 正点 原子 开发 的 GPS 
模块 、 蓝 牙 模 块 、MPU6050 模块 、 激 光 测 距 模 块 和 手势 识别 模块 等 ， 直 接 插 上 对 应 的 模块 ， 就 
可 以 进行 开发 。 后 续 我 们 将 开发 更 多 兼容 该 接口 的 其 他 模块 ， 实 现 更 强大 的 扩展 性 能 。 

16. 左右 声 道 喇叭 接口 

开发 板 板 载 了 一 个 高 性 能 的 音频 解码 芯片 WM8960， 此 芯片 可 以 驱动 左右 声 道 2 个 8Q， 
1W 的 小 喇叭 ， 这 两 个 接口 用 于 外 接 两 个 左右 声 道 小 喇叭 。 不 过 在 ILMX6U-ALPHA 开发 板 的 背 
面 已 经 默认 焊接 了 一 个 小 喇叭 ， 这 个 小 喇叭 接 到 了 右 声 道 上 ， 因 此 如 果 要 在 此 接口 的 右 声 道 上 
外 接 小 喇叭 ， 那 么 必须 先 将 开发 板 上 自 带 的 喇叭 拆 掉 ， 和 否则 WM8960 驱动 能 力 可 能 不 足 。 

17. 耳机 输出 接口 

这 是 开发 板 板 载 的 音频 输出 接口 (PHONE )， 该 接口 可 以 插 3.5mm 的 耳机 ， 当 WMS960 放 
音 的 时 候 ， 就 可 以 通过 在 该 接口 插入 耳机 ， 欣 赏 音乐 。 此 接口 支持 耳机 插入 检测 ， 如 果 耳 机 不 
插入 的 话 默认 通过 喇叭 播放 音乐 ， 如 果 插 入 耳机 的 话 就 关闭 喇叭 ， 通 过 耳机 播放 音乐 。 

18. 录音 输入 接口 

这 是 开发 板 板 载 的 外 部 录音 输入 接口 (LINE_IN) ,通过 咪 头 我 们 只 能 实现 单 声 道 的 录音 ， 
而 通过 这 个 LINE IN， 我 们 可 以 实现 立体 声 录 音 。 

19. 复位 按键 

这 是 开发 板 板 载 的 复位 按键 (RESET)， 用 于 复位 LIMX6U， 还 具有 复位 液晶 的 功能 ， 因 为 
液晶 模块 的 复位 引 脚 和 LMX6U 的 复位 引 脚 是 连接 在 一 起 的 ， 当 按 下 该 键 的 时 候 ，LMX6U 和 
液晶 一 并 被 复位 。 

20. 用 户 按 键 KEY 

这 是 开发 板 板 载 的 1 个 机 械 式 输入 按键 (KEY0)， 可 以 做 为 普通 按键 输入 使 用 。 

21. 红色 用 户 LED 灯 

这 是 开发 板 板 载 的 1 个 LED 灯 ， 为 红色 ， 用 户 可 以 使 用 此 LED 灯 。 在 调试 代码 的 时 候 ， 
使 用 LED 来 指示 程序 状态 ， 这 是 非常 不 错 的 一 个 辅助 调试 方法 。 

22. 蓝 色 电源 指示 LED 灯 

这 是 开发 板 电源 指示 LED 灯 ， 为 蓝 色 ， 当 板子 供电 正常 的 时 候 此 灯 就 会 常 亮 。 如 果 此 灯 不 
亮 的 话 就 说 明 开发 板 供 电 有 问题 (排除 LED 灯 本 身 损坏 的 情况 )。 

23. WM8960 音频 DAC 

这 是 一 颗 欧 胜 公司 出 品 的 音频 DAC 芯片 ， 用 于 实现 音乐 播放 与 录音 。 

24. MICEX) 

这 是 开发 板 的 板 载 录音 输入 口 (MIC)， 该 咪 头 直接 接 到 WM8960 的 输入 上 ， 可 以 用 来 实 
现 录 音 功 能 。 

25. Nano SIM 卡 接口 

这 是 开发 板 上 的 Nano SIM 卡 接 口 ， 如 果 要 使 用 4G 模块 的 话 就 需要 在 此 接口 中 插入 Nano 
SIM 卡 。 

26. ICM20608 六 轴 传 感 器 

这 是 开发 板 板 载 的 一 个 六 轴 传 感 器 芯片 (U6)， 型 号 为 ICM20608， 此 芯片 采用 SPI 接口 与 
I.MX6U 相连 接 。ICM20608 内 部 集成 1 个 三 轴 加 速度 传感器 和 1 个 三 轴 陀 螺 仪 ， 该 传感器 在 姿 
态 测量 方面 应 用 非常 广泛 。 所 以 喜欢 玩 姿态 测量 的 朋友 ， 也 可 通过 本 开发 板 进行 学 习 。 

27. Mini PCIE 4G 接口 

这 是 开发 板 板 载 的 一 个 Mini PCIE E, 但 是 本 质 上 走 的 USB. 协议 , 通过 此 接口 可 以 连接 4G 
模块 ， 比 如 高 新 兴 物 联 的 ME3630。 接 上 4G 模块 以 后 LMX6U-ALPHA 开发 板 就 可 以 实现 4G 
上 网 功能 ， 对 于 不 方便 布 网 线 或 者 没有 WIFI 的 场合 来 说 是 个 不 错 的 选择 。 
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28. DC6~16V 电源 输入 

这 是 开发 板 板 载 的 一 个 外 部 电源 输入 口 (DC_IN), 采用 标准 的 直流 电源 插座 。 开 发 板 板 载 
T DC-DC 芯片 (JW5060T)， 用 于 给 开发 板 提供 高 效 、 稳 定 的 SV 电源 。 由 于 采用 了 DC-DC 45 
片 ， 所 以 开发 板 的 供电 范围 十 分 宽 ， 大 家 可 以 很 方便 的 找到 合适 的 电源 (只 要 输出 范围 在 
DC6-16V 的 基本 都 可 以 ) 来 给 开发 板 供电 。 在 耗 电 比较 大 的 情况 下 ， 比 如 用 到 4.3 屏 /7 寸 屏 /网 
口 的 时 候 ， 建 议 使 用 外 部 电源 供电 ， 可 以 提供 足够 的 电流 给 开发 板 使 用 。 

29. 电源 开关 

这 是 开发 板 板 载 的 电源 开关 (K1)。 该 开关 用 于 控制 整个 开发 板 的 供电 。 这 是 一 个 两 段 式 波 
动 开 关 ， 拨 到 右边 关闭 开发 板 电 源 ， 整 个 开发 板 都 将 断 电 ， 电 源 指 示 灯 PWR) 会 随 之 熄灭 。 
拨 到 右边 打开 开发 板 电源 ， 整 个 板子 开始 供电 ， 电 源 指示 灯 (PWR) 点 亮 。 

30. 5V 电源 输入 /输出 

这 是 开发 板 板 载 的 一 组 5V 电源 输入 输出 排 针 (2*3 ) (VOUT2 ), 该 排 针 用 于 给 外 部 提供 5V 
的 电源 ， 也 可 以 用 于 从 外 部 接 5V 的 电源 给 板子 供电 。 

同样 大 家 在 实验 的 时 候 可 能 经 常会 为 没有 SV 电源 而 苦恼 不 已 ， 正 点 原子 充分 考虑 到 了 大 
家 需求 ， 有 了 这 组 5V 排 针 ， 你 就 可 以 很 方便 的 拥有 一 个 简单 的 SV 电源 (USB 供电 的 时 候 ， 
最 大 电流 不 能 超过 500mA， 外 部 供电 的 时 候 ， 最 大 可 达 3000mA )。 

31. 3.3V 电源 输入 /输出 

这 是 开发 板 板 载 的 一 组 3.3V 电源 输入 输出 排 针 (2*3) CVOUT1), 用 于 给 外 部 提供 3.3V 的 
电源 ， 也 可 以 用 于 从 外 部 接 3.3V 的 电源 给 板子 供电 。 

大 家 在 实验 的 时 候 可 能 经 常会 为 没有 3.3V 电源 而 苦恼 不 已 ,有 了 ILMX6U-ALPHA 开发 板 ， 
你 就 可 以 很 方便 的 拥有 一 个 简单 的 3.3V 电源 (最 大 电流 不 能 超过 3000mA ) 。 

32. 3 路 USB HOST 接口 

这 是 开发 板 板 载 的 3 路 USB HOST 接口 , LMX6U 有 两 个 USB 接口 , 正点 原子 的 LMX6U- 
ALPHA 开发 板 通过 GL850 芯片 将 LMX6U 的 USB2 扩展 成 了 4 路 USB HOST， 其 中 一 路 用 于 
连接 4G 模块 ， 另 外 3 路 作为 USB HSOT， 用 户 可 以 通过 这 三 路 USB HOST 接口 连接 USB 鼠 
标 、USB 键盘 、U 盘 等 设备 。 

33. 引出 的 IO 口 

这 是 开发 板 IO 引出 端口 卫 6， 采 用 2*16 排 针 ， 总 共 引 出 31 IO 口 。 

34. 以 太 网 接口 1(RJ45) 

LMX6U 有 两 个 网 络 接口 : ENETI 和 ENET2, 这 是 ENETI 网 络 接口 , 可 以 用 来 连接 网 线 ， 
实现 网 络 通信 功能 。 该 接口 使 用 ILMX6U 内 部 的 MAC 控制 器 外 加 PHY 芯片 ， 实 现 10/100M 网 
络 的 支持 。 

35. 以 太 网 接口 2(RJ45) 

这 是 开发 板 板 载 的 以 太 网 接口 2， 也 就 是 LMX6U 的 ENET2 网 络 接口 。 

36. RS232 接口 ( 母 ) 

这 是 开发 板 板 载 的 另外 一 个 RS232 接口 (COM3)， 通 过 一 个 标准 的 DB9 母 尖 和 外 部 的 串 
口 连接 。 通 过 这 个 接口 ， 我 们 可 以 连接 带 有 串口 的 电脑 或 者 其 他 设备 ， 实 现 串口 通信 

37. RS485 接口 

这 是 开发 板 板 载 的 RS485 总 线 接口 (RS485)， 通 过 2 个 端口 和 外 部 485 设备 连接 。 这 里 提 
醒 大 家 ，RS485 通信 的 时 候 ， 必 须 A 接 A，B 接 B。 和 否则 可 能 通信 不 正常 

接 下 来 ， 我 们 来 看 LMX6U 核心 板 的 资源 说 明 : 

l. 核心 板 电源 指示 灯 

这 是 核心 板 板 载 的 一 个 蓝 色 LED 灯 , 用 于 指示 核心 板 供电 是 否 正 常 ,如 果 核 心 板 供电 正常 
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的 话 此 灯 就 会 点 亮 。 

















2. NAND/EMMC 存储 芯片 

这 是 核心 板 上 板 载 的 存储 芯片 , 分 为 NAND 和 EMMC 两 种 。 对 于 NAND 版 本 的 核心 板 共 
有 256MB 和 512MB 两 种 容量 的 NAND， 型 号 分 别 为 MT29F2G08ABAEAWP-IT 或 
MT29F4G08ABADAWP-IT, 这 两 种 型 号 的 NAND FLASH 工作 温度 范围 都 为 工业 级 。 EMMC 版 
本 的 核心 板 使 用 8GB 的 EMMC， 型 号 为 KLM8G1GET。 

3. DDR3L 芯片 

这 是 核心 板 板 载 的 DDR3L 芯片 ， NAND 版 本 核心 板 的 DDR3L 容量 为 236MB ，EMMC 版 
本 的 核心 板 的 DDR3L 容量 为 512MB。 型 号 分 别 为 NT5CC128M16JR-EK 和 NT5CC256M16EP- 
EK。 如 果 要 用 于 UI 开发 ， 那 么 最 好 选择 512MB 的 DDR3L， 当 然 了 ， 正 点 原子 的 ILMX6U 核 
心 板 支 持 定制 ， 具 体 定制 方法 请 联系 销售 。 

4. CPU 

这 是 核心 板 的 CPU， 型 号 为 : MCIMX6Y2CVM05AB 或 MCIMX6Y2CVM08AB 。 这 两 款 型 
号 的 外 设 功能 都 一 摸 一 样 ， 指 示 CPU 主 频 不 同 ，MCIMX6Y2CVM05AB 主 频 为 528MHz. 
MCIMX6Y2CVM08AB 主 频 为 800MHz( 实 际 792MHz)。 该 芯片 采用 Coretx-A7 内 核 , 自 带 32KB 
的 Ll 指令 Cache. 32KB 的 Ll 数据 Cache, 128KB 的 L2Cache、 集 成 NEON 和 SIMDv2、 支 持 
硬件 浮 点 GPU) 计 算 单元 ,， 浮 点 计算 架构 为 VFPv4-D32、1 个 RGB LCD 接口 、2 个 CAN 接口 、 
2 个 10M/100M 网 络 接口 、2 个 USB OTG 接口 (USB2.0)、2 路 ADC、8 个 串口 、3 个 SAL. A 
定时 器 、8 路 PWM、4 路 DC 接口 、4 路 SPI 接口 、 一 路 CSI 摄像 头 接口 、2 USDHC 接口 ， 
支持 4 位 SD FE, 最 高 可 以 支持 UHS-ISDR 104 模式 , 支持 1/4/8 位 的 EMMC, 最 高 可 达 HS200 
模式 、 一 个 外 部 存储 接口 、 支 持 16 位 的 LPDDR2-800、DDR3-800 和 DDR3L-800、 支 持 8 位 的 
MLC/SLC NAND Flash， 支 持 2KB、4KB 和 8KB 页 大 小 ， 以 及 124 个 通用 IO 口 等 。 

5. 32.768KHz 晶振 

这 是 一 个 无 源 的 32.768KHz 晶振 ， 供 LMX6U 内 部 RTC 使 用 。 

6. 24MHz 晶振 

这 是 一 个 无 源 的 24MHz 晶振 ， 供 LMX6U 使 用 。 

另外 ，LMX6U 核心 板 的 接口 在 底部 ， 通 过 两 个 2*30 的 板 对 板 端子 (3710M 母 座 ) 组 成 ， 
总 共 引 出 了 104 个 ID， 通过 这 个 接口 ， 可 以 实现 与 LIMX6U-ALPHA 底板 对 接 。 











































































































5.2.2 软件 资源 说 明 


上 面 我 们 详细 介绍 了 正点 原子 LMX6U-ALPHA 开发 板 的 硬件 资源 。 接 下 来 , 我 们 将 向 大 家 
简要 介绍 一 下 ILMX6U-ALPHA 开发 板 的 软件 资源 。 软 件 资 源 分 为 3 部 分 : Linux 系统 驱动 软件 
资源 、 裸 机 例 程 、Linux 驱动 例 程 ,我 们 依次 来 看 一 下 这 三 类 软件 资源 的 情况 。 关 于 Linux 系统 
软件 资源 如 表 5.2.2.1 所 示 : 
| 
提供 源码 。 
支持 LCD 显示 、 支 持 SD 
uboot uboot 版 本 为 2016.03 卡 和 EMMC.、 支 持 网 络 、 
支持 NAND Flash、 支 持 
环境 变量 修改 等 。 

Linux 内 核 内 核 版 本 为 4.1.15 提供 源码 


i 提供 busybox, buildroot. yocto. ubuntu 2 : 
z FLA EZ HIE H 
根 文件 系统 rootfs 这 四 种 根 文件 系统 及 其 制作 方法 提供 详细 的 制作 教程 
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QTS 根 文件 系统 QT 版 本 为 5.6.1 提供 详细 的 教程 
交叉 编译 器 arm-linux-gnueaihf， 版 本 4.9.4 提供 软件 
系统 烧 写 方法 MFGTOLL 和 SD 卡 两 种 提供 详细 的 使 用 教程 
LCD I RGB LCD 驱动 提供 源码 
FT5xx6、GT9147 等 电容 触摸 屏 ( 仅 限 正 | uu. 
触摸 o ( 提供 源码 
485 RS485 驱动 提供 源码 
232 RS232 驱动 提供 源码 
CAN CAN 驱动 提供 源码 
网 络 PHY 73 LAN8720 提供 源码 
USB HOST USB HUB 为 GL850 提供 源码 
USB OTG USB 从 机 和 主机 提供 源码 
4G 无 线 ME3630 4G 模块 提供 源码 
按键 KEY GPIO 提供 源码 
LED GPIO 提供 源码 
音频 音频 DAC 为 WM8960 提供 源码 
SDIO WIFI 正点 原子 RTL8189 模块 提供 源码 
GPS 正点 原子 GPS 模块 提供 源码 
环境 光 传 感 器 (IIC) AP3216C, IIC 接口 提供 源码 
六 轴 传 感 器 (SPD ICM20608，SPI 接口 提供 源码 
TF 卡 /EMMC USDHC 驱动 提供 源码 
摄像 头 OV5640 驱动 提供 源码 
串口 UARTI 驱动 提供 源码 
PWM 背光 LCD PWM 背光 提供 源码 
RTC LMX6U 内 部 RTC 提供 源码 
USB WIFI RTL8188 提供 源码 




















K 5.2.2.1 开发 板 Linux 系统 软件 资源 
接 下 来 看 一 下 IMX6U-ALPHA 开发 板 的 裸 机 例 程 ， 如 表 5.2.2.2 所 示 : 













































































leds uart 
ledc printf 
ledc stm32 ddr3 
ledc sdk lcd 
ledc bsp rtc 
beep i2c 
key spi 
clk touchscreen 
int pwm ledbacklight 
epit timer 
key filter 
highpreci delay 











表 5222 正点 原子 LIMX6U-ALPHA 开发 板 裸 机 例 程 
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从 上 表 可 以 看 出 , 正点 原子 的 LMX6U-ALPHA 开发 板 裸 机 例 程 似乎 不 是 很 多 , 不 像 STM32、 
RT1052 那样 六 七 十 个 裸 机 例 程 ， 这 是 因为 嵌入 式 Linux 和 单片机 的 开发 方式 以 及 应 用 场合 不 
同 。 单片机 学 名 叫做 Microcontroller， 也 就 是 微 控 制 器 ， 主 要 用 于 控制 相关 的 应 用 ， 因 此 单片机 
的 外 设 都 比较 多 ， 比 如 很 多 路 的 IC、SPI、UART、 定 时 器 等 等 。 嵌 入 式 Linux 开发 主要 注重 于 
高 端 应 用 场合 ， 比 如 音 视频 处 理 、 网 络 处 理 等 等 。 比 如 一 个 机 器 人 ， 高 性 能 处 理 器 加 Linux 系 
统 (或 者 其 他 系统 ) 作 为 机 器 人 的 大 脑 ， 主 要 负责 接收 各 个 传感器 采集 的 数据 然后 对 原始 数据 进 
行 处 理 ， 得 到 下 一 步 执行 指令 ， 这 个 往往 需要 很 高 的 性 能 。 当 处 理 完 成 得 到 下 一 步 要 做 的 动作 
之 后 大 脑 就 会 将 数据 发 给 控制 机 器 人 各 个 关节 电机 的 驱动 控制 器 ， 这 些 驱 动 控 制 嚣 一般 都 是 单 
片 机 做 的 。 所 以 大 家 在 学 习 钥 入 式 Linux 开发 的 时 候 一 定 不 要 深 陷 裸 机 ， 我 们 之 所 以 讲解 裸 机 
EN TARAR Linux 打 基 础 ， 让 大 家 了 解 所 使 用 的 SOC、 了 解 GCC 那 一 套 工 作 流 程 ， 最 终 
HI H AJABE T ERAT Linux 做 准备 的 。 

看 完 裸 机 例 程 以 后 我 们 最 后 再 来 看 一 下 正点 原子 为 LIMX6U-ALPHA FRIE HIRA 











































































































Linux 驱动 例 程 ， 如 表 5.2.2.3 所 示 : 
chrdevbase irq 
led blockio 
newchrled noblockio 
dtsled asyncnoti 
gpioled platform 
beep dtsplatform 
atomic miscbeep 
spinlock input 
semaphore lic 
mutex spi 
key 
timer 
K 5.2.2.3 正点 原子 LMX6U-ALPHA 开发 板 Linux 驱动 例 程 





因为 有 些 外 设 驱 动 在 Linux 内 核 里 面 已 经 集成 了 ， 因 此 并 没有 编写 独立 的 驱动 ， 我 们 会 在 
相应 的 章节 里 面 对 这 些 驱 动 进行 讲解 。 关 于 正点 原子 LMX6U-ALPHA 开发 板 的 软件 资源 就 讲 
解 到 这 里 ， 软 件 资源 我 们 也 会 持续 更 新 的 。 


5.3 开发 板 底 板 原理 图 详解 


5.3.1 核心 板 接口 


LMX6U-ALPHA 开发 板 采 用 底板 + 核心 板 的 形式 ，LMX6U-ALPHA 开发 板 底板 采用 2 个 
2*30 的 3710F 〈 公 座 ) 板 对 板 连 接 器 来 同 核心 板 连 接 ， 接 插 非 常 方便 ， 底 板 上 面 的 核心 板 接口 
原理 图 如 图 5.3.1.1 所 示 : 
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ILMX6UL_ CORE 
CSI HSYNC 
CSI MCLK 
CSI DATA2 
CSI DATAG 
CSI PIXCLK 
CSI DATAS 
LCD DATAO 
LCD DATAI 
LCD DATA2 
LCD DATA3 
LCD DATA4 


CSI VSYNC 
CSI DATA3 
CSI DATAT7 
CSI DATAI 
CSI DATAO 
CSI DATA4 
SDI CLK 

SD1 CMD 

SD1 DATA2 
SD1 DATA3 


USDHC1 CLK 
USDHC1 CMD 
USDHCI DATA2 
USDHCI DATA3 
SD1 DATAI USDHCI DATAI 
LCD DATAS SD1 DATAO USDHCI DATAO 
LCD DATA6 ; SNVS TAMPER9 CT RST 

LCD DATA7 rl GPIO 5 SD1 VSELECT 
LCD DATAS LCD DE 

LCD DATA9 LCD PCLK 
LCD DATAIO LCD HSYNC 
LCD DATAII LCD VSYNC 
LCD DATAI12 

LCD DATAI3 PMIC ON REQ 
LCD DATAI4 | RESET 

LCD DATAIS5 SNVS TAMPER6  ENET2 INT TREE# 
LCD DATA16 

LCD DATAI7 

LCD DATAIS 

LCD DATAI9 

LCD DATA20 

LCD DATA2I 

LCD DATA22 

LCD DATA23 


o[oo| - [o es Bos [u»[ro] — 


VDD COIN 3V 


LMX6UL CORE 


R11 
m |'GND OR} _ USB OTG? VBUS 
[es C81 | 


104 L2 104 J21 7r 

DOR20A[ .— à 23 32]; 

SNVS TAMPER4 — AUD INT n3 | 本 
ON OFF aie USB OTGl VBUS 


USB OTG2 VBUS 


SNVS TAMPERI _ BEEP 
SNVS TAMPERO WIFI REG ON 
BOOT MODEO 


USB OTG2 DP 
USB OTG2 DN 
USB OTGI DP 
BOOT MODEI USB OTGI1 DN 
SNVS TAMPER8 — ENET2 RST nUSB OTG CHD 
SNVS TAMPER7 . ENETI RST E GPIO 0 
ENET1 INT TREE# z UARTI TXD 
WIFI INT p GPIO 1 GBC KEY 
CSI RESET UARTI CTS KEYO 
CSI PWDN | GPIO 3 LEDO 
CT INT UARTI RXD 
BLT PWM GPIO 7 R74 FOR 
SAD TX BCLK i GPIO 6 R75 OR 
SAI2 TX SYNC | RTS 


USB OTGI ID 


ENET MDC 
ENET MDIO 
USDHCI CD B 


SAI2 RX DATA 
SAI2 MCLK 
SAD TX DATA 


ECSPI3 SSO 
ECSPI3 SCLK 
ECSPI3 MISO CAN2 RX 


ECSPI3 MOSI CAN2 TX 


CANI TX 
CANI RX 
I2Cl SDA 
I2Cl1 SCL 
I2C2 SDA 
I2C2 SCL 





5.3.1.1 底板 转 接 板 接口 部 分 原理 网 
图 中 的 J 和 了 就 是 底板 上 的 转 接 板 接口 ， 由 2 个 2*30PIN 的 3710F 板 对 板 公 座 组 成 ， 总 
共 引 出 了 核心 板 上 面 105 个 IO 口 ， 另 外 ， 还 有 : 电源 、PMIC_ ON REQ, ONOFF, USB, 
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VBAT, RESET 等 信号 。 


5.3.2 引出 IO 口 
LMX6U-ALPHA 开发 板 底板 上 面 ， 总 共 引 出 了 314 IO 口 ， 如 图 5.3.2.1 所 示 : 


IO 


UARTS TXD DC2 SCL 
UART4 TXD I2C1 SCL 


UART5 RXD I2C2 SDA 
UART4 RXD I2C1 SDA 


UART3 RTS CAN1 RX UART3 CTS CANI TX 
UART3 RXD UART3 TXD 

UART2 CTS CAN2 TX UART2 RTS CAN2 RX 
UART2 RXD ECSPI3 SCLK UART2 TXD ECSPI3 SSO 
GPIO 8 BLT PWM JIAG MOD 6D INT 
GPIO 3 LEDO GPIO 9 CT INT 
GPIO 1 UART1 CTS KEYO 
GPIO 2 GPIO 4 

GPIO 0 USB OTGI ID SNVS TAMPER2 WIFI INT 


SNVS TAMPER7 ENETI RST 
BOOT MODEI 

SNVS TAMPERO WIFI REG ON 
ON OFF 

SNVS TAMPER4 AUD INT 


SNVS TAMPERS ENETI INT TREE# 
SNVS TAMPER8 ENET2 RST 

BOOT MODEO 

SNVS TAMPER]1 BEEP 





图 5.32.1 引出 IO H 
图 中 JP6 就 是 引出 的 10, 一共 31 个 IO， 外 加 一 个 GND Cortex-A 系列 的 板子 首要 任务 就 
是 保证 板子 的 稳定 性 , 然后 再 考虑 IO 的 引出 。 所 以 相 比 于 STM32 这 种 单片机 , LMX6U-ALPHA 
开发 板 引出 的 IO 就 要 少 很 多 了 。 

















5.3.3 USB 串口 /串口 1 选择 接口 


LMX6U-ALPHA 开发 板 板 载 的 USB 串口 和 LMX6U 的 串口 是 通过 JP5 连接 起 来 的 ， 如 图 
5.3.3.1 所 示 : 








1 UART1 RXD 





SGM3157 


图 5.3.3.1 USB 串口 /串口 1 选择 接口 
rH TXD/RXD 是 相对 CH340C 来 说 的 ,也 就 是 USB 串口 的 发 送 和 接受 脚 ,而 UART1 RXD 
和 UART1_TXD 则 是 相对 于 I.MX6U 来 说 的 。 这 样 , 通过 对 接 , 就 可 以 实现 USB 串口 和 IMX6U 








243 


LMX6U 嵌入 式 Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 

的 串口 通信 了 。 图 5.3.3.1 中 的 U20 和 U21 是 SGM3157 是 模拟 开关 ,在 底板 掉 电 以 后 将 LMX6U 
的 UART1_TXD fll UARTI RXD 这 两 个 IO 与 CH340C 的 TXD 和 RXD WJF, 因为 CH340C 的 
TXD 和 RXD 这 两 个 IO 带 有 微弱 的 3.3V 电压 , 如 果 不 断 开 的 话 会 将 这 微弱 的 3.3V 电压 引入 到 
核心 板 上 ， 可 能 会 影响 到 启动 。 

















5.3.4 RGB LCD 模块 接口 
ALPHA 底板 载 了 RGB LCD 接口 ， 此 部 分 电路 如 图 5.3.4.1 所 示 : 
RGB LCD 








SGM3157 
SGM CTRL 


3 BOOT_DATA7 


'GND 
LCD DATAI5 R114 R LCD DATAISS nd ICD DATATS I 


LCD DATA23 Rlló6 PER LCD DATA23S SGM3157 
LCD DATA7 RI20p XP. LCD DATA7S SGM CTRL 


DCDC 5V 


C9| |104 A 
GND 省 一 DCDC 3V3 


LCD DATA16 LCD RO 
LCD DATA17 LCD RI 39 CT INT R12 10K. 
LCD DATAI8 LCD R2 3812C2 SCL R7GSSSSIOK 


LCD DATAI9 LCD R3 37 R77 OR -一 
LCD DATA20 LCD R4 36DC2 SDA t T SP TX 
LCD DATA2] LCD R5 35 CT RST R14 10K 


LCD DATA22 LCD R6 34 BLT PWM 10K 
LCD DATA23S LCD R7 33 LCD DE RIG 
32 LCD_VSYNC 

LCD _DATA8 LCD GO 31 LCD HSYNC 

LCD DATA9 LCD G1 30LCD PCLK 

LCD DATAIO LCD G2 29 

LCD DATAII LCD G3 28 LCD B7 LCD DATA7S 

LCD DATAI2 LCD G4 27 LCD B6 LCD DATA6 

LCD DATAI3 LCD G5 26 LCD B5 LCD DATAS 

LCD DATAI4 LCD G6 25 LCD B4 LCD DATA4 

LCD DATAISS LCD G7 24 LCD B3 LCD DATA3 
GND:l| 23 LCD B2 LCD DATA2 
LCD DATAO LCD BO 21 22 LCD B1 LCD DATAI 


RGBLCD 


2 
m 
O 
is] 


|I GNp 








图 5.3.4.1 RGB LCD 接口 

图 中 ，RGBLCD 就 是 RGB LCD 接口 ， 采 用 RGB888 数据 格式 ， 并 支持 触摸 屏 (支持 电阻 
屏 和 电容 屏 )。 该 接口 仅 支 持 RGB 接口 的 液晶 (不 支持 MCU 接口 的 液晶 )， 目 前 正点 原子 的 
RGB 接口 LCD 模块 有 : 4.3 寸 (ID:4342, 480*272 和 ID:4384, 800*480)、7 寸 ID:7084，800*480 
和 ID:7016，1024*600) 和 10 寸 ID:1018，1280*800) 等 尺寸 可 选 。 

图 中 3 个 SGM3157 模拟 开关 ， 用 于 控制 来 自 LMX6U 的 LCD DATA23(LCD R7). 
LCD DATAIS(LCD G7) 和 LCD DATA7(LCD B7) 和 来 自 RGBLCD 屏 的 LCD DATA23S 、 
LCD DATAISS 和 LCD DATA7S 的 通 断 。 这 是 因为 这 几 个 信号 有 用 来 设置 LTMX6U 的 
BOOT _CFG4[7]/BOOT_CFG2[7]/BOOT_CFG1[7]， 同 时 又 是 RGBLCD 屏 的 ID 信号 ， 因 此 他 们 
存在 冲突 。 如 果 不 加 切换 ,在 启动 的 时 候 , I.MX6U 就 可 能 读 到 错误 的 启动 配置 信息 ， 从 而 导致 
启动 失败 (不 运行 代码 )。 加 这 三 个 模拟 开关 ， 就 是 为 了 让 LMX6U 在 启动 的 时 候 可 以 正常 读 取 
BOOT_CFG4[7WBOOT_CFG2[7J/BOOT_CFG1[7] 的 值 ， 同 时 在 启动 后 ， 用 户 代 码 又 可 以 读 取 正 
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确 的 RGBLCD ID 值 。 互 不 影响 。 三 个 SGM3157 的 使 能 信号 默认 都 是 由 LCD_VSYNC 控制 ( 刚 
好 满足 LCD 时 序 )。 


图 中 的 I2C2 SCL 和 DC2 SDA 为 DC2 的 两 根 数据 线 ， 分 别 连接 到 UARTS5 TXD 和 
UARTS RXD 这 两 个 IO E» BLT PWM 是 LCD 的 背光 控制 IO， 连 接 在 LMX6U 的 GPIO1 IO8 
上 ， 用 于 控制 LCD 的 背光 。 液 晶 复 位 信号 RESET 则 是 直接 连接 在 开发 板 的 复位 按钮 上 ， 和 
MCU 共用 一 个 复位 电路 。 



































5.3.5 复位 电路 
LMX6U 开发 板 的 复位 电路 如 图 5.3.5.1 Bras: 


RESET 


DCDC 3V3 























图 5.3.5.4 复位 电路 
因为 LMX6U 是 低 电 平复 位 的 ， 所 以 我 们 设计 的 电路 也 是 低 电 平复 位 的 


5.3.6 启动 模式 设置 接口 
LMX6U 开发 板 的 启动 模式 设置 端口 电路 如 图 5.3.6.1 所 示 : 




















BOOT DEVICE 


USB 
MicroSD 
EMMC 
NAND 


BOOT MODEI 
BOOT MODEO 
LCD DATAII 
LCD DATA3 
LCD DATA4 
LCD DATAS 
LCD DATAG 
BOOT DATA7 


BOOT CFG 
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图 5.3.6.1 启动 模式 设置 接口 

LMX6U 有 多 种 启动 方式 ， 并 且 文 持 从 多 重 不 同 的 设备 启动 ， 关 于 LMX6U 的 详细 启动 方 
式 请 参考 《第 九 章 LMX6U 启动 方式 详解 》。 




















5.3.7 VBAT 供电 接口 




















LMX6U-ALPHA 开发 板 的 VBAT 供电 电路 如 图 5.3.7.1 所 示 : 


VBAT 
VDD COIN 3V 

















图 5.3.7.1 启动 模式 设置 接口 

上 图 的 VDD_COIN 3V 通过 核心 板 上 的 BAT54C， 接 VDD SNVS IN 脚 ， 从 而 给 核心 板 
的 SNVS 区 域 供电 。 这 部 分 原理 图 在 核心 板 上 ， 如 图 5.3.8.2 所 示 : 
VDD SNVS IN 













VDD SNVS 3V3 


VDD COIN 3V NGND KELO 
VSSI 
VSS2 


VSS3 


Weca 








图 5.3.7.2 核心 板 VBAT 供电 原理 图 

如 图 5.3.7.2 所 示 ，VDD_SNVS_IN 使 用 VDD COIN 3V ( 接 CRI220 电池 ) 和 
VDD SNVS 3V3 混合 供电 的 方式 ， 在 有 外 部 电源 CVDD_SNVS_3V3) 的 时 候 ，CR1220 不 给 
VDD SNVS IN 供电 , 而 在 外 部 电源 断 开 的 时 候 , 则 由 CR1220 给 其 供电 。 这样 , VDD_SNVS_IN 
总 是 有 电 的 ， 以 保证 RTC 的 走时 。 





































































































5.3.8 RS232 串口 





LMX6U-ALPAH 开发 板 板 载 了 一 个 母 头 的 RS232 接口 ， 电 路 原理 图 如 图 5.3.8.1 所 示 : 
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DCDC 3V3 


RIN2 ROUT2 
SP3232 


JP1 
U3 RX 
UART3 TXD 3 
RS485 RX RS485 TX 








Ud 





图 5.3.8.1 RS232 串口 

因为 RS232 电 平 不 能 直接 连接 到 IMX6U， 所 以 需要 一 个 电 平 转换 芯片。 这 里 我 们 选择 的 
是 SP3232( 也 可 以 用 MAX3232 ) 来 做 电 平 转 接 , 同时 图 中 的 卫 1 用 来 实现 RS232(UART3JRS485 
的 选择 。 所 以 这 里 的 RS232/RS485 都 是 通过 串口 3 来 实现 的 。 图 中 RS485 TX fI RS485 RX 信 
号 接 在 SP3485 I] DI 和 RO 信号 上 。 















































5.3.9 RS485 接口 
LMX6U-ALPAH 开发 板 板 载 的 RS485 接口 电路 如 图 5.3.9.1 所 示 : 


DCDC 3V3 
DCDC 3V3 





图 5.3.9.1 RS485 接口 
RS485 电 平 也 不 能 直接 连接 到 LMX6U， 同 样 需要 电 平 转换 忆 片 。 这 里 我 们 使 用 SP3485 来 


























做 485 电 平 转换 ， 其 中 R21 为 终端 匹配 电阻 ， 而 R20 和 R21， 则 是 两 个 偏 置 电 阻 ， 以 保证 静默 
状态 时 ，485 总 线 维 持 逻 辑 1 。 
RS485 RX/RS485 TX 连接 在 JP1 上 面 ， 通 过 JPl 跳 线 来 选择 是 否 连接 在 LMX6U EH, 
SP3485 的 RE 引 脚 连接 通过 一 系列 的 电路 连接 到 了 RS485 RX 引 脚 上 ， 这 样 就 可 以 通过 
RS485 RX 引 脚 来 控制 RS485 的 接收 和 发 送 状 态 ， 完 全 将 RS485 当做 一 个 串口 来 使 用 。 

































































5.3.10 CAN 接口 


正点 原子 LMX6U-ALPHA 开发 板 板 载 的 CAN 接口 电路 如 图 5.3.10.1 所 示 : 











247 


LMX6U AR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


TJA1050 





图 5.3.10.1 CAN 接口 电路 
CAN 总 线 电 平 也 不 能 直接 连接 到 IMX6U, 同样 需要 电 平 转换 芯片 。 这 里 我 们 使 用 TJA1050 
来 做 CAN 电 平 转换 ， 其 中 RIO 为 终端 匹配 电阻 。 
CANI TX/CANI RX 直接 连接 在 LMX6U 的 UART1_ CTS/UARTI RTS 上 面 。 








5.3.11 USB HUB 接口 


正点 原子 IMX6U-ALPHA 开发 板 板 载 了 一 颗 一 扩 四 的 USB HUB 芯片 , 用 于 将 LMX6U 的 
USB2 扩展 为 4 个 USB HOST 接口 ， 如 图 5.3.15.3 所 示 : 


USB HUB 


USB OTG2 DP26 26 3 28 HUB DPI 
USB OTG2 DN25 um DM 27 HUB DMI 


~» | 3 HUB DP? 
Bid B 3V3 10 D 
DCDC 3V3[ 5: DNE PE AVDI DM2 2 HUB DM2 


27 
= Eg 9 HUB DP3 
04 4104 JlOuF[6 | Lr wa [.8 HUB DM3 


m "| C30] 12MHz 
22pF 


R4 
DCDC 5v OK] 


3 
s GL850G 
R44 RI Tios 


12 HUB DP4 
11 HUB _ DM4 


3 


GND 


DCDC 5V USB HOSTI1 DCDC 5V USB HOST2 


1 
HUB DMI 2 





5.3.11.3 USB HUB 接口 电路 
LMX6U 带 有 两 个 USB 接口 , 但 是 对 于 Linux 应 用 来 说 两 个 USB KLT, 如果 我 们 要 连接 
鼠标 、 键 盘 、U 盘 等 设备 的 时 候 两 个 USB 口 完 全 不 够 用 。 因 此 LMX6U-ALPHA 开发 板 通过 
GL850G 世 片 将 LMX6U 的 USB2 外 扩 出 了 4 个 USB HOST 接口 ， 其 中 有 一 路 (UHB_USB2) 外 
接 了 4G 模块 ,因此 提供 给 用 户 的 用 户 的 就 只 剩 下 了 3 个 USB HOST 接口 ,如 果 3 个 USBHOST 
还 不 够 用 的 话 就 可 以 外 接 一 个 USB HUB. 
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5.3.12 USB OTG 接口 


LMX6U-ALPHA 也 有 一 路 USB OTG 接口 ，USB OTG 接口 使 用 了 LMX6U fj USB1, USB 
OTG 接口 如 图 5.3.12.1 所 示 : 


USB OTG USB OTG VBUS 


USB OTG 


R111 1 
USB OTGI DN 2 
| USB OTGI DP 3 x DCDC SV 
USB OIGI ID lI0K 4 ' 


5 





D3 
USB OTG1 VBUS RU 
MBR0520 
DCDC sy% R lusp OTG VBUS 
DNP 





图 5.3.12.1 USB OTG 接口 
图 中 的 USB OTG 就 是 USB SLAVE 接口 ， 可 以 将 开发 板 作为 USB 从 机 ， 比 如 通过 USB 
进行 系统 烧 写 等 。 右 侧 的 USB1 HOST 是 USB HOST 接口 ， 可 以 将 开发 板 作 为 USB 主机 ， 这 
样 就 可 以 外 接 USB 键盘 /鼠标 、U 盘 等 设备 。 这 里 正点 原子 将 USB OTG 的 SLAVE 和 HOST 接 
口 都 做 到 了 开发 板 上 ， 这 样 大 家 就 不 需要 再 额外 去 购买 一 个 USB OTG 线 了 ， 方 便 大 家 开发 。 





























5.3.13 光环 境 传 感 器 


LMX6U-ALPHA 开发 板 板 载 了 一 个 光环 境 传感器 ， 可 以 用 来 感应 周围 光线 强度 、 接 近 距 离 和 红 
外 线 强 度 等 ， 该 部 分 电路 如 图 5.3.13.1 所 示 : 


ALS&PS SENSOR 


DCDC 3V3 














U9 
VDD 7 SDA 





8 DCl SDA 


SCL 
GND LDR 
LEDA LEDC 


DCDC ava AP3216C 





图 5.3.13.1. 光环 境 传感器 电路 

图 中 的 U9 就 是 光环 境 传感器 : AP3216C,， 它 集成 了 光照 强度 、 近 距离 、 红 外 三 个 传感器 功 
能 于 一 身 , 被 广泛 应 用 于 各 种 智能 手机 。 该 芯片 采用 IC 接口 , 连接 在 LMX6U 的 DCI 接口 上 ， 
IIC SCL 和 IIC_SDA 分 别 连接 在 UART4_ TXD 和 UART4 RXD E, AP_INT 是 其 中 断 输出 脚 ， 
连接 在 IMX6U 的 GOIOI IO01 上 。 





























5.3.14. 六 轴 传 感 器 
LMX6U-ALIPHA 开发 板 板 载 了 一 个 六 轴 传 感 器 ， 电 路 如 图 5.3.14.1 Bras: 
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ECSPI3 SCLK2 


ECSPI3 MOSI3 SDA/SDI 


R17 
sxp 咱 DNP} ECSPI3 SSO 5 CS 
10K | ECSPI3 MISO4 DO/SDO 


GND ||| 8 FSYNC 
6D INT 6 














ICM-20608 





图 5.3.14.1 六 轴 传 感 器 

六 轴 传 感 嚣 心 片 型 号 为 :ICM20608, 该 必 片 内 部 集成 了 : 三 轴 加 速度 传感器 和 三 轴 陀 螺 仪 ， 
这 里 我 们 使 用 SPI 接口 来 访问 。 

ICM20608 支持 IC 和 SPI 两 种 接口 ，LMX6U-ALPHA 开发 板 使 用 SPI 接口 ， 目 的 是 为 了 
在 开发 板 上 防 一 个 SPI 外 设 ,学 习 Linux 下 的 SPI 驱动 开发 (因为 笔者 购买 过 很 多 Linux 开发 板 ， 
发 现 基本 都 没有 SPI 外 设 ， 不 方便 学 习 SPI 驱动 )。ICM20608 通过 SPI 接口 连接 到 IMX6U 的 
ECSPI3 接口 上 , SCLK、SDI、CS 和 SDO 分 别 连接 到 IMX6U 的 UART2 RXD(ECSPI3. SCLK). 
UART2 CTS(ECSPI3 MOSI)、 UART2 TXD(ECSPI3 SS0) 和 UART2 RTS(ECSPI3 MISO). 




















































































































5.3.15 LED 





LMX6U-ALPHA 开发 板 板 载 总 共有 2 个 LED， 其 原理 图 如 图 5.3.15.1 所 示 : 


LED CORE 5V DCDC 5V 


DCDC 3V3 
R9 sior DS 














图 5.3.15.1 LED 
其 中 右 侧 的 PWR BLUE 是 系统 电源 指示 灯 , 为 赣 色 。DS0 为 用 户 LED AT, 连接 在 LMX6U 
的 GPIO1 IO03 上 ， 此 灯 为 红色 。 





5.3.16 按键 
LMX6U-ALPHA 开发 板 板 载 1 个 输入 按键 








其 原理 图 如 图 5.3.16.1 所 示 : 





» 
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KEY 


DUI 3V3 


R15 
KEYO caca ||] GN 
10K KEYO 


图 5.3.16.1 输入 按键 
KEYO 用 作 普 通 按键 和 输入， 分 别 连接 LMX6U 的 UARTI CTS 引 脚 上 ， 这 里 使 用 外 部 10K 


上 拉 电 阻 。 























5.3.7 摄像 头 模 块 接口 
LMX6U-ALPHA 开发 板 板 载 了 一 个 摄像 头 模 块 接口 ， 连 接 在 LMX6U 的 硬件 摄像 头 接口 
(CSI) 上 面 ， 其 原理 图 如 图 5.3.17.1 所 示 : 


CAMERA c2 DCDC 3V3 











DC2 SCL CSI VSYNC 
I2C2 SDA CSI HSYNC 


CSI DATAO CSI RESET 
CSI DATA2 CSI DATAI 
CSI DATA4 CSI DATA3 
CSI DATA6 CSI DATAS 
CSI PIXCLK CSI DATA7 
CSI PWDN CSI MCLK 





Header 9X2 








图 5.3.17.1 摄像 头 模块 接口 

图 中 P1 接口 可 以 用 来 连接 正点 原子 摄像 头 模块 。 其 中 ，I2C2_SCL 和 I2C2_SDA 是 摄像 头 

的 SCCB 接口 ， 分 辨 连接 在 LMX6U 的 UART5 TXD 和 UART5S RXD 引 脚 上 。CSI RESET 和 

CSI PWDN 这 2 个 信号 是 不 属于 LMX6U 硬件 摄像 头 接口 的 信号 ， 通 过 普通 IO 控制 即 可 ， 这 
两 个 线 分 别 接 在 LMX6U 的 GPIO1 IO02 和 GPIO1 IO04。 

此 外 ，CSI VSYNC/CSI HSYNC/CSI DOCSI D1/CSI D2/CSI D3/CSI D4/CSI D5/CSI D6 

/CSI D7/CSI PCLK/CSI MCLK 等 信号 ， 接 ILMX6U 的 硬件 摄像 头 接口 。 
































5.3.18 有 源 蜂 鸣 器 
LMX6U-ALPHA 开发 板 板 载 了 一 个 有 源 蜂 鸣 器 ， 其 原理 图 如 图 5.3.18.1 所 示 : 
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BEEP DCDC 3V3 


BEEP RIS 





图 5.3.18.1 有 源 蜂 鸣 器 
有 源 蜂 鸣 器 是 指 自 带 了 震荡 电路 的 蜂 鸣 器 ， 这 种 蜂 鸣 器 一 接 上 电 就 会 自己 震荡 发 声 。 而 如 
果 是 无 源 蜂 鸣 器 ， 则 需要 外 加 一 定 频率 (2~5Khz) 的 驱动 信号 ， 才 会 发 声 。 这 里 我 们 选择 使 用 
有 源 蜂 鸣 器 ， 方 便 大 家 使 用 。 
BEEP 信号 直接 连接 在 LMX6U 的 SNVS TAMPERI 引 脚 上 ， 可 以 通过 控制 此 引 脚 来 控 各 
蜂 鸣 器 开关 。 
























































AZ 





5.3.19 TF 卡 接口 











号 令 者 RT1052 开发 板 板 载 了 一 个 SD FE (KF) 接口 ， 其 原理 图 如 图 5.3.24.1 所 示 : 
SD CARD 


TF CARD 








SD 3V3 DCDC 3V3 


USDHC1 DATA2 
USDHCI DATA3 
CD/DATA3/CS USDHCI CMD 
USDHCI CLK 


USDHCI DATAO 
USDHCI DAIA1 


VSS 
DATAO/SDO 








CD/SW 
Micro SD 








图 5.3.19.1 SD 卡 接口 
图 中 SD CARD 为 TF 卡 接口 ， 该 接口 在 开发 板 的 底 
TF 卡 采 用 4 位 uSDHC 方式 驱动 ， 非 常 适合 需要 高 速 存储 的 情况 。 图 中 : 
USDHCI DATAO-DATA3/USDHCI CLK/USDHCI CMD 分 别 连 接 在 LMX6U 的 
SD1_ DATAO-DATA3/SDI CLK/SDI CMD 引 脚 上 。 USDHCI CD B 是 TF 卡 检测 引 脚 ， 用 于 
检测 TF FE SDIO WIFI 插 拔 过 程 ， 连 接 到 I.MX6U 的 UARTI1 RTS 引 脚 上 。 注 意 : TF 卡 接口 
和 SDIO WIFI 接口 公用 一 个 SDIO， 因 此 TF 卡 和 SDIO 不 能 同时 使 用 !! 





























E 





























5.3.20 SDIO WIFI 接口 


LMX6U-ALPHA 开发 板 板子 一 个 SDIO WIFI 接口 ， 如 图 5.3.20.1 所 示 : 
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WIFI 


DCDC 3V3 
USDHCI DATAO USDHCI DATAI 
USDHCI DATA2 USDHCI DATA3 


USDHCI CMD USDHCI CLK 
WIFI INT WIFI REG ON 
USDHCI CD B 





Header 6X2 





图 5.3.20.1 SDIO WIFI 接口 
SDIO WIFI 接口 用 于 连接 正点 原子 出 品 的 RTL8189 SDIO WIFI 模块 ， 
USDHCI DATA0~DATA3/USDHC1 CLK/USDHCI CMD 分 别 连接 到 LMX6U 的 LMX6U 的 
SD1 DATA0~DATA3/SD1_CLK/SD1_CMD 引 脚 上 .WIFIL INT 和 WIFI REG_ON 连接 到 IMX6U 
的 SNVS_TAMPER2 和 SNVS TAMPERO 引 脚 上 。 
HX: TF FOM SDIO WIFI 接口 公用 一 个 SDIO， 因 此 TF 卡 和 SDIO 不 能 同时 使 用 











! 





5.3.21 4G 模块 接口 
LMX6U-ALPHA 开发 板 板 载 4G Mini PCIE 接口 ， 如 图 5.3.21.1 所 示 : 
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4G MODULE 


38 HUB DP2 


4G EC20 


cas] 04 SIM VDD CI 


GND 
Nano SIM 


GND 


6 SIM VDD 





5.3221.1 4G 模块 
U8 就 是 Mini PCIE 接口 的 4G 模块 座 子 ， 用 于 连接 Mini PCIE 接口 的 4G 模块 ， 比 如 高 新 
兴 的 ME3630 模块 。U11 是 Nano SIM 卡 座 ， 用 于 插入 Nano SIM F» 4G 模块 虽然 采用 Mini 
PCIE 接口 ， 但 是 实际 走 的 USB 接口 ， 这 里 连接 到 了 GL850G 扩展 出 来 的 一 个 USB HOST 接口 
上 (USB HUB2)。 


5.3.22 ATK 模块 接口 
LMX6U-ALPHA 开发 板 板 载 了 ATK 模块 接口 ， 其 原理 图 如 图 5.3.22.1 所 示 : 
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ATK MODULE 


JP2  ATK MODULE 





DCDC 5V 











2 
1 


Im 
aia 
"s 
J; 
AE 
2|[2 


GBC KEY 
GBC LED 





图 5.3.22.1 ATK 模块 接口 

如 图 所 示 ，JP2 是 一 个 1*6 的 排 座 ， 可 以 用 来 连接 正点 原子 推出 的 一 些 模块 ， 比 如 : 蓝牙 
串口 模块 、GPS 模块 、MPU6050 模块 、 激 光 测 距 模块 、 手 势 识别 模块 和 RGB 彩 灯 模块 等 。 有 
了 这 个 接口 ， 我 们 连接 模块 就 非常 简单 ， 插 上 即 可 工作 。 

图 中 : UART3 RXD/UART3 TXD 连接 到 了 LMX6U 的 UART3 上 ， 和 RS232、RS485 共用 
一 个 串口 ， 在 使 用 ATK 接口 的 时 候 需 要 将 卫 1 跳 线 帽 全 部 拔 掉 ， 防 止 RS232 和 RS485 干扰 到 
模块 。 而 GBC KEY 和 GBC LED 则 分 别 连接 在 LMX6U 的 GPIO1 IO01 和 JTAG MOD 这 两 
个 引 脚 上 。 特 别 注 意 : GBC LED/ GBC KEY 和 AP INT/6D INT 共用 GPIO1 IO01 和 
JTAG MOD. 







































































5.3.03 以 太 网 接口 (RJ45) 


LMX6U-ALPHA 开发 板 板 载 了 两 个 以 太 网 接口 (RJ45)， 分别 为 ENETI 和 ENET2， 其 中 
ENETI 网 口 的 原理 图 如 图 5.3.23.1 所 示 : 
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VENET 3V3 


ENETI Rse]R5s 


Jj i VENET 3V3 


IK 
ENET MDIO : 21 ENETI TXP R57 49.9R 
ENET MDC jd XN L20-ENET! TXN R587——49.9R| 
Í » | 23 ENETI RXP R59 —49.9R 
ENET! TXDO RXN 22ENETI RXN R60 ——]49.9R 
ENETI TXDI = : 
ENETI TXEN cud S 3 ENETI LEDI 
ED * [2 ENET! LED2 
EAM 15 19 VENET 3V3 
ENETI RXER 10 | 0. 1] 1 VENET 3V3 
GND:l| DNEH ENETI CRS DVII 9 VENET 3V3 
uc E I| 6 
VENET 3V3 R63 IK ENET1 INT_TREE#4 25 49 lcsolcsil cs2ksa 
5 04 | rouFio4]to4 [04 
4 


= IZIK  LANS720A ENETI TX CLK 


PHY ADDR:0x0 GND 


VENET 3V3 
ENETI TXP 1 


ENETI TXN 2 


ENETI RXP 3 





图 5.3.23.1 ENETI 接口 电路 
ENET2 网 络 接口 原理 图 如 图 5.3.23.2 所 示 : 
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VENET 3V3 


ENET MDIO 
ENET MDC 





ENET2 TXDO 
ENET2 TXDI 
ENET2 TXEN 3 ENET2 LEDI 


TXEN  LEDI/REGOFF ENEI? LED2 


LED2/nINTSEL 


ENET2 RXDI EXE DUM VENET 3V3 
R70 10K ENET2 RXER 10 VENET 3V3 


E RXER/PHYADO VDD2A 
ENET2 CRS DV 11 CSR. DV/MODE/DDIO VENET 3V3 

R71 RE VDDCR 

DD GEHE 


ENET2 RXDO 








T 1 L. ls 60 [c61 
XTALI/CLKIN 
m 4 04 jouFlo4 hos ho4 
ENET2 TX CLK 一 


VENET 3V3 
9 


ENET2 TXP ue LED(G)- 


ENET2 TXN PESE 
ENET2 RXP 


ENET2 RXN 








图 5.3.23.2 ENET2 网 络 接口 

LMX6U 内 部 自 带 两 个 网 络 MAC 控制 器 ， 每 个 网 络 MAC 需要 外 加 一 个 PHY w, BURJ 
实现 网 络 通信 功能 。 这 里 我 们 选择 的 是 LAN8720A 这 颗 芯 片 作 为 LMX6U 的 PHY 芯片， 该 芯 
片 采用 RMI 接口 与 LIMX6U 通信 ， 占 用 IO 较 少 ， 且 支持 auto mdix《〈 即 可 自动 识别 交叉 / 直 连 
网 线 ) 功能 。 板 载 两 个 自 带 网 络 变压器 的 RJAS 头 “HR91105A )， 一 起 组 成 两 个 10M/100M 自 
适应 网 卡 。 

对 于 ENET1 和 ENET2 共用 ENET MDIO 和 ENET MDC 这 两 根 线 ， 这 两 根 线 连 接 到 了 
I.MX6U 的 GPIO1 IO06 和 GPIO1 I007 这 两 个 IO 上 。ENET1 和 ENET2 都 有 一 个 复位 引 脚 ， 
分 别 为 ENETI RSET 和 ENET2 RESET, ， 这 两 个 IO 分 别 连接 到 了 IMX6U 的 
SNVS TAMPER7/SNVS TAMPERS 这 两 个 引 脚 上 。 














T 





5.3.24 SAT 音频 编 解码 器 


LMX6U 开发 板 板 载 WM8960 高 性 能 音频 编 解 码 芯 片 ， 其 原理 图 如 图 5.3.24.1 所 示 : 











LMX6U 嵌入 式 Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


AUDIO 


VCC3.3A 
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104 : 

AGND 咱 Ourpo4 [10 | 
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C3 
OuE, 


SAD RX DATA 
SAI2 TX DATA 
SAI2 MCLK 


I2C2 SCL 








WMS8960 





图 5.3.24.1 SAI 音频 编 解码 芯 

WM8960 是 一 颗 低 功 耗 、 高 性 能 的 立体 声 多 媒体 数字 信号 编 解码 器 。 该 蕊 片 内 部 集成 了 24 
位 高 性 能 DAC&ADC， 并 且 自 带 段 EQ WIT, XIF 3D 音效 等 功能 。 不 仅 如 此 ， 该 芯片 还 结合 
了 立体 声 差分 麦克 风 的 前 置 放大 与 扬声器 、 耳 机 和 差分 、 立 体 声 线 输出 的 驱动 ， 减 少 了 应 用 时 
必需 的 外 部 组 件 ， 直 接 可 以 驱动 耳机 (168 (40mWO 和 喇叭 (8 Q/1W)， 无 需 外 加 功放 电路 。 

图 中 ，SPK- 和 SPK+ 连 接 了 一 个 板 载 的 8Q 1W 小 喇叭 (在 开发 板 背 面 )。MIC 是 板 载 的 咪 
3k, 可 用 于 录音 机 实验 , 实现 录音 。 PHONE 是 3.5mm 耳机 输出 接口 , n] PAESE HL. LINE IN 
则 是 线路 输入 接口 ， 可 以 用 来 外 接线 路 输入 ， 实 现 立体 声 录 音 。 

该 芯片 采用 SAI 与 LMX6U 的 SAI 接口 连接 ， 图 中 
SAD TX SYNC/SAD TX BCLK/SAI2 RX DATA/SAI2 TX DATA/SAI2 MCLK/ 分 别 接 在 
MCU 的 : JTAG TDO/JTAG TDIJTAG TCK/JTAG nTRST/JTAG TMS 上 。 特别 注意 : WM8960 
MI JTAG 共用 了 很 多 信号 ,所 以 WM8960 fU JTAG 接口 不 能 同时 使 用 ! 并 且 , 经 过 实测 , WM8960 
会 干扰 到 JIAG， 如 果 要 使 用 JTAG 那么 就 必须 将 与 WM8960 复 用 的 这 几 根 线 断 开 ! 这 也 是 为 
什么 正点 原子 IMX6U-ALPHA 开发 板 开发 板 上 面 没 有 留 JTAG 接口 的 原因 。 

WM8960 需要 一 个 DC 接口 去 配置 ， 这 里 使 用 IMX6U 的 I2C2, 12C2_SCL 和 DC2 SDA 
分 别 连接 到 了 LMX6U 的 UART5_TXD 和 UART5 RXD 这 两 个 引 脚 上 。 





























































































































5.3.25 电源 
IMX6U-ALPHA 开发 板 板 载 的 电源 供电 部 分 ， 其 原理 图 如 图 5.3.25.1 所 示 : 




















DC POWER IN 


2 84.5K 1% 
0 | R94 
15K 1% 


T 
C84 
aneas is 


GND 





图 5.3.25.1 电源 
图 中 ， 总 共有 2 个 稳 压 芯片 U16/U17，DC IN 用 于 外 部 直流 电源 输入 ， 经 过 U16 DC-DC 
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芯片 转换 为 5V 电源 输出 ， 其 9 























坏 开发 板 。K1 为 3 





稳 压 忌 片 ， 给 开发 板 提 供 3.3V 电源 
这 里 还 有 USB 供电 部 分 没有 歹 


论坛 :www.opendev.com 


F VD1 是 防 反 接 二 极 管 ， 避 免 外 部 直流 电源 极 性 搞 错 的 时 候 ， 烧 














开发 板 的 总 电源 开关 ，Fl 为 2A 自 恢复 保险 丝 ， 用 于 保护 USB. UI7 为 3.3V 














5.3.26. 电源 输入 输出 接口 
LMX6U-ALPHA 开发 板 板 载 了 两 组 简单 电源 输入 输出 接口 ， 其 原理 图 如 图 5.3.27.1 所 示 : 


CORE 


SV DCDC 3V3 


SMBJ5.0A 
SMBJ3.3A 














JER, Kc VUSB 就 是 来 自 USB 供电 部 分 , 详 见 5.3.26 节 。 


























DCDC 3V3 CORE 5V 








图 5.3.26.1 电源 


图 中 , VOUTI 和 VOUT2 分 别 是 3.3V 和 5V 的 电源 输入 输出 接口 , 有 了 这 2 组 接口 ， 我们 


可 以 通过 开发 板 给 外 部 提供 3.3V 和 5V 
































电源 了 ， 昌 然 功率 不 大 (最 大 1000ma)， 但 是 一 般 情 况 











都 够 用 了 ， 大 家 在 调试 自己 的 小 电路 板 的 时 候 ， 有 这 两 组 电源 还 是 比较 方便 的 。 同 时 这 两 组 端 








口 ， 也 可 以 用 来 由 





外 部 给 开发 板 供电 。 




















图 中 Dl 和 D2 为 TVS 管 , 可 以 有 效 避 免 VOUT 外 接 电源 /负载 不 稳 的 时 候 (尤其 是 开发 板 
外 接 电机 /继电器 /电磁 阀 等 感性 负载 的 时 候 )， 对 开发 板 造成 的 损坏 。 同 时 还 能 一 定 程 度 防止 外 
接 电源 接 反 ， 对 开发 板 造成 的 损坏 。 


5.3.27 USB 串口 





























LMX6U-ALPHA 开发 板 板 载 了 一 个 USB 串口 ， 其 原理 图 如 图 5.3.27.1 所 示 : 
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图 5.3.27.1 USB 串口 

USB $PO, RIDERE CH340C， 是 国内 芯片 公司 南京 沁 恒 的 产品 ， 稳 定性 非常 不 错 
所 以 还 是 多 支持 下 国产 。CH340C 内 置 晶振 ， 因 此 就 不 需要 再 在 外 面 连接 一 个 晶振 。 图 中 可 以 
看 出 CH340C 的 电源 为 3.3V， 并 且 是 独立 供电 的 ，Ul19 是 一 个 LDO 芯片 ， 负 责 给 CH340C 提 
共 3.3V 的 电源 .CH340C 的 电源 不 受 开 发 板 电源 开关 控制 ,只 要 接 上 USB 线 CH340 就 会 上 电 。 
图 中 RXD/TXD 接 JP5 的 RXD/TXD， 是 CH340 芯片 的 串口 接收 和 发 送 脚 ， 可 以 通过 跳 线 帽 连 
接 到 LMX6U 的 串口 1 上 。 

USB TTL 是 一 个 MiniUSB 座 ， 提 供 CH340C 和 电脑 通信 的 接口 ， 同 时 可 以 给 开发 板 和 
CH340C 供电 ，VUSB 就 是 来 自 电脑 USB 的 电源 ，USB_TTL 是 本 开发 板 的 主要 供电 口 。 


5.4 .MX6U 核心 板 原理 图 详解 
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5.4.1 SOC 




















I.MX6U-ALPHA 开发 板 配套 的 ILMX6U 核心 板 ， 采 用 MCIMX6Y2CVM05AB(528MHz) 或 
MCIMX6Y2CVMO8AB (800MHz， 实 际 792MHz) 作为 主 控 CPU， 这 两 款 主 控 都 是 工业 级 的 。 
自 带 32KB 的 LL1 指令 和 数据 Cache. 128KB 的 L2 Cache, EIR NEON, 集成 双 精 度 硬件 浮 点 计 
算 单 元 VFPV3， 并 具有 128KB OCRAM、2 个 通用 定时 器 (GPT)、4 个 周期 定时 器 (EPIT)、8 
个 PWM、1 个 SDMA 控制 器 、4 个 ECSPI、3 个 看 门 狗 、3 个 SAI、4 个 IC、7 个 串口 、2 个 
USB (高 速 ， 带 PHY)、2 个 FlexCAN、2 个 12 位 ADC、1 个 SPDIF 接口 、1 个 SRTC、1 个 
RTC、2 个 USDHC 接口 、1 个 RGB LCD 控制 器 (ELCDIF) 、2 个 10/100M 以 太 网 MAC 控制 
器 、1 个 摄像 头 接口 、1 个 硬件 随机 数 生成 器 、 以 及 124 个 通用 IO 口 等 ， 根 据 芯片 型 号 的 不 同 
主 频 可 以 为 528Mhz、700MHz( 实 际 696MHz)、800MHz( 实 际 792MHz)， 轻 松 应 对 各 种 应 用 。 

SOC 部 分 的 原理 图 如 图 5.4.1.1~ 图 5.4.1.5( 因 为 原理 图 比较 大 , 缩小 下 来 可 能 有 点 看 不 清 ， 
请 大 家 打开 开发 板 光盘 的 原理 图 进行 查看 ) Bron: 
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BOOT MODE! SHIFT SHCP U10 | BOOT -MODE I/GPIO5 XI JTAG ^ TDO/GPT2. CAPTURE2/SAD. TX SYNC/CCM | CLI KO2/CCM : STOP/GPIO! IO12/MQS 1 RIGHT/EPIT2 | OUT 
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图 5.4.1.1 SOC 部 分 原理 图 1 





LMX6ULL-NAND/SD2 


NVCC NAND NVCC NAND 


NAND nCEO 
NAND nCEI 
NAND ALE SD2 
NAND CLE 
NAND nRE SD2 
NAND nWE SD2 
NAND nWP 
NAND nREADY 
NAND DQS 


NAND CEU/USDHCI DATAS/QSPI A DATAOI/ECSPI3 SCLK/EIM DATACK/GPIO4 IO13/UART3 RX 
NAND CEI/USDHCI DATA6/QSPI A DATAO2/ECSPI3 MOSIEIM ADDRIS/GPIO4 IO14/UART3 CTS 
NAND ALE/USDHC2 RESET/QSPI A DQS/PWM3 OUT/EIM ADDRIT/GPIO4 IOI0/ECSPI3 SS1 
NAND CLE/USDHCI DATA7/QSPI A DATAO3/ECSPI3 MISO/EIM. ADDRI6/GPIO4 IO15/UART3 RIS 
NAND RE/USDHC2 CLK/QSPI B SCLK/KPP ROWOO/EIM EB BO0/GPIO4 IOO0/ECSPI3 SS2 

NAND WE/USDHC2 CMD/QSPI B SS0/KPP COLOO/EIM EB BOI/GPIO4 IOOI/ECSPI3 SS3 
NAND.WP/USDHCI RESET/QSPI A SCLK/PWM4 OUT/EIM BCLK/GPIO4 IO1l/ECSPIB RDY 
NAND READY/USDCHI DATA4/QSPI A. DATAOO/ECSPI3 SS0/EIM. CSI/GPIO4 IO12/UART3 TX 
NAND DQS/CSI FIELD/QSPI A SS0 B/PWMS OUT/EIM WAIT/GPIO4 IO16/SPDIF EXT CLK 


一 一 一 -一 NAND DATA00/USDHC2 DATAO/QSPI B SSI/KPP ROWOI/EIM ADOS/GPIO4 IO02/ECSPI4 RDY 
NAND DATA2 NAND DATAOI/USDHC2 DATAI/QSPI B DQS/KPP COLOI/EIM AD09/GPIO4 IOO3/ECSPI4 SS1 
NAND DATA3 NAND DATAO2/USDHC2 DATA2/QSPI B DATAO0/KPP ROWO2/EIM ADIO/GPIO4 IO04/ECSPI4 SS2 
NAND DATA4 NAND DATA03/USDHC2 DATA3/QSPI B DATAOI/KPP COLO2/EIM ADII/GPIO4 IOOS/ECSPI4 SS3 
NAND DATAS NAND DATA04/USDHC2 DATA4/QSPI B DATAO2/ECSPI4 SCLK/EIM ADI2/GPIO4 IO06/UART2 TX 
NAND DATA6 NAND DATAOS/USDHC2 DATAS/QSPI B DATAO3/ECSPI4 MOSI/EIM ADI13/GPIO4 IO07/UART2 RX 
NAND DATA? NAND DATAO06/USDHC2 DATA6/SAD RX BCLK/ECSPI4 . MISO/EIM . ADI4/GPIO4 . IO08/U. ART2 CTS 

NAND DATA07/USDHC2 DATAT7/QSPI A SSI/ECSPI4 SSO/EIM ADIS/GPIO4 IO09/UART2 RTS 
LMX6ULL-CSI 


GND'| 
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CSI VSYNC F2 

CSI HSYNC F3 


CSI. MCLK/USDHC2 CD/NAND CE2/12C1 SDA/EIM. CSO/GPIO4 IO17/UART6 TX/ESAI TX3 RX2 

CSI PIXCLK/USDHC2 WP/NAND CE3/DCl SCL/EIM. OE/GPIO4 IO18/UARTG RX/ESAI TX2. RX3 

CSL VSYNC/USDHC2 CLK/DC2 SDA/EIM. RW/GPIO4 I019/PWM7 OUT/UART6 RIS/ESAI TX4 RXI 

CSIL HSYNC/USDHC2 CMD/DC2. SCL/EIM. LBA B/GPIO4 I020/PWMS OUT/UART6 CTS/ESAI TXI 

CSEDATAL ES] CSI DATAO0/USDHC2 DATAO/ECSPD SCLK/EIM ADO0/GPIO4 IO21/UARTS TX/ESAI TX HF CLK 

CSLDATAL E^] CSI DATAOL/USDHC2 DATAU/ECSPI2 SS/EIM. ADOI/GPIO4 IO22/SAIl. MCLK/UARIS RX/ESAI RX HF CLK 

CI DATA: Ep] C3 DATA02/USDHC2 DATA2/ECSPD MOSUEIM. ADO2/GPIO4 1023/SAII RX SYNC/UARTS RIS/ESAI RX FS 

CSI DATAS EL| CSI DATAOS/USDHC2. DATA3/ECSPI2 MISO/EIM ADO3/GPIO4 IO24/SAII RX BCLK/UARTS CIS/ESAI RX CLK 

CSI DATAL DI CSI DATAO4/USDHC2 DATA4/ECSPII SCLE/EIM ADD04/GPIO4 IO25/SATI TX SYNC/USDHCI WP/ESAI TX FS 

cS PATAS DI CSI DATAOS/USDHC2 DATAS/ECSPII SSO/EIM. ADOS/GPIO4 IO26/SAII TX BCLK/USDHCI CD/ESAI TX CLK 

SPAS DI CSI DATAOS/USDHC2 DATAG/ECSPII, MOSUEIM ADOG/GPIO4 1027/SAII RX DATA/USDHCI. RESET/ESAI TX5 RXO 
CSI DATA07/USDHC2, DATA7/ECSPII. MISO/EIM. ADO7/GPIO4 1O28/SAII TX DATA/USDHCI VSELECT/ESAI TXO 
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5.4.1.2 SOC 部 分 原理 图 2 
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图 5.4.1.3 SOC 部 分 原理 图 3 
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DRAM DATAO 
DRAM DATAI 
DRAM DATA2 
DRAM DATA3 
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MCIMX6Y2CVM05AB 
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图 5.4.1.4 SOC 部 分 原理 图 4 
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图 5.4.1.5 MCU 部 分 原理 图 5 

MCIMX6Y2CVMOSAB/08AB 芯片 的 原理 图 由 5 个 部 分 组 成 ， 接 下 来 依次 看 一 下 这 五 部 分 
的 具体 内 容 : 

图 5.4.1.1: 此 部 分 原理 图 主要 是 LMX6U 的 部 分 IO 原理 图 ， 比 如 SNVS_TAMPER0~9、 
JTAG 外 设 IO、USDHC1 外 设 IO、UART 外 设 IO、USB 外 设 IO 等 。 

图 5.4.1.2: 此 部 分 原理 图 也 是 IMX6U 的 IO 原理 图 ， 主 要 包括 NAND Flash 外 设 IO. 
USDHC2 外 设 IO、CSI 摄像 头 IO 等 。 

图 5.4.1.3: 此 部 分 原理 图 也 是 IMX6U 的 IO 原理 图 ， 包 括 LCD bhis IO. ENET 外 设 IO. 
GPIO1 IO01~09 这 一 组 GPIO。 

图 5.4.1.4: 此 部 分 原理 图 是 LMX6U 的 DRAM 外 设 IO 。 用 于 连接 DDR 设备 ， 比 如 正点 原 
T ALPHA 开发 板 所 使 用 的 DDR3L。 

图 55.4.1.5: 此 部 分 原理 图 是 IMX6U 的 电源 部 分 。 











5.4.2 BTB 接口 


LMX6U 核心 板 采用 2 个 2*30 的 3710M〔( 母 座 ) 板 对 板 连接 器 来 同 底板 连接 (在 转 接 板 底 
面 )， 接 插 非 常 方便 ， 转 接 板 上 面 的 底板 接口 原理 图 如 图 5.4.2.1 所 示 : 
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KEYI 
LEDI 
SD1 nRST 
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UARTII RXD 
GPIO 7 


KEYO 
KEY2 
LEDO 


MDC 


MDIO 
USDHCI CD B 


JTAG TDI 
JIAG TDO 
JIAG TCK 
JIAG TMS 
JTAG nTRST 
JTAG MOD 
ENETI 
ENETI 
ENETI 
ENETI 
ENETI 
ENETI 
ENETI 
ENETI 


SAD TX BCLK 
SAD TX SYNC 
SAD RX DATA 
SAD MCLK 
SAD TX DATA 
SPDIF OUT 


GPIO 6 
UARTI RTS 
UARI2 TXD 
UART? RXD 
UART2 RTS 
UARI2 CTS 
UART3 TXD 
UART3 
UART3 
UART3 
UART4 
UART4 
UART5 
UART5 


CAN2 RX 
CAN2 TX 


CANI TX 
CANI RX 
I2C1L SDA 
I2C1 SCL 
DC2 SDA 
DC2 SCL 


3710M060046G3FT01 





图 5.4.2.1 底板 接口 
图 中 , J1 和 了 有 2 是 2 个 2*30 的 板 对 板 母 座 (3710M)， 和 底板 的 接 插 非 常 方便 ， 方便 大 家 髓 
入 自己 的 项 目 中 去 。 该 接口 总 共 引 出 105 个 IO 口 ， 另 外, 还 有 USB、 电 源 、 复 位 、ONOFF 等 
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信和 号。 


5.4.3 NAND FLASH 


LMX6U NAND 版 本 核心 板 板 载 了 一 个 NAND Flash， 此 部 分 电路 如 图 5.4.3.1 所 示 : 


NAND 


DCDC 3V3 


44 NAND DATAT7 
43 NAND DATA6 
42 NAND DATAS 
41 NAND DATA4 


32 NAND DATA3 
31] NAND DATA2 
30 NAND DATAI 
29 NAND DATAO 


#Flash Typ e: MLC MT29F 16G08CBACA 





5.4.3.1] NAND Flash 

对 于 Linux 系统 而 言 ， 是 需要 一 个 存储 数据 、 系 统 的 存储 芯片 ， 比 如 QSPI Flash; NAND 
Flash, EMMC 等 。 正点 原子 的 ILMX6U-ALPHA 开发 板 有 两 种 核心 板 ， 这 两 种 核心 板 的 FLASH 
存储 心 片 不 同 ， 一 个 使 用 的 NAND FLASH, 一 个 使 用 的 EMMC。 图 5.4.3.1 中 的 是 NAND Flash 
的 原理 图 ， 经 过 测试 ， 可 以 支持 256MB、512MB、2GB 的 NAND FLASH 存储 芯片 。 


5.4.4 EMMC 


LMX6U EMMC 核心 板 板 载 了 7 8GB 的 EMMC， 此 部 分 电路 如 图 5.4.4.1 所 示 : 
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10uFl104 {104 4104 |I Gp 





5.4.4.1 EMMC 
EMMC 也 是 存储 Flash， 相 比 NAND Flash, EMMC 使 用 简单 (和 SD 类 似 )、 速 度 快 、 容 量 
高 。 目 前 EMMC 已 经 逐渐 的 取代 了 NAND Flash， 尤 其 是 在 手机 、 平 板 领域 。 


5.4.5 DDR3L 


LMX6U 核心 板 板 载 了 SDRAM， 此 部 分 电路 如 图 5.4.5.1 所 示 ; 


DRAM ADDRO 
DRAM ADDRI 
DRAM ADDR2 
DRAM ADDR3 
DRAM ADDR4 
DRAM ADDRS 
DRAM ADDR6 
DRAM ADDR7 
DRAM ADDRS$ 
DRAM ADDR9 
DRAM ADDRIO 
DRAM ADDRII 
DRAM ADDRI2 
DRAM ADDRI3 
DRAM ADDRI4 


DRAM SDBAO 
DRAM SDBAI 
DRAM SDBA2 


DRAM CSO0 B 
DRAM RAS B 
DRAM CAS B 
DRAM SDWE B 
DRAM ODTO 
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e31E m B 
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E3 DRAM DATAO 
F7 DRAM DATAI 
F2 DRAM DATA2 
F8 DRAM DATA3 
H3DRAM DATA4 
H8DRAM DATAS 
G2DRAM DATA6 
H7DRAM DATA7 
D7DRAM DATAS 
C3 DRAM DATA9 
C8DRAM DATAIO 
C2DRAM DATAII 
A7DRAM DATAI2 
A2DRAM DATAI3 
B8 DRAM DATAI4 
A3DRAM DAIA15 


F3 DRAM SDQSO P 
G3DRAM SDQSO N 


C7 DRAM SDQSI P 
B7DRAM SDQSI N 


E7 DRAM DQMO 
D3DRAM DQMI 


L8 DRAM ZQO 





R48 240R 
Layout: Route l00ohm DIFF EEEE 


RAM SDCLKO P J7 
JI DRAM ODTI 


DRAM RESET B T2 


L9 

H1 DRAM VREF 224 
C54 

DRAM 1V35 


A9 

[B3 
MI | 
M9 | 
[Pl | 
[P9 | 
Bl | 
Bo 
D1 
DS | 
[E8 | 


lalelslolcle kelk 


MT41K256M16TW 


GND 咱 





5.4.5.1 DDR3L 
中 , US 就 是 DDR3L 芯片 ,根据 配置 的 不 同 , 一 共有 两 种 型 号 , 分别 为 :NT5CC256M16EP- 
EK(512MB) 和 NT5CC128M16JR-EK(256MB)。 该 芯片 挂 在 ILMX6U 的 MMDC 接口 上 。 


5.4.5 核心 板 电 源 


LMX6U 对 于 供电 有 严格 的 要 求 ， 尤 其 是 上 电 顺 序 ， 正 点 原子 的 LMX6U 核心 板 供 电 主 要 
分 5 部 分 : SNVS 供电 、DCDC 3V3 供电 、ARM/SOC 内 核 供电 、DDR3L 供电 和 SD FEE, 
我 们 依次 来 看 一 下 ， 首 先是 SNVS 供电 ，LMX6U 的 数据 手册 要 求 ，SNVS 必须 最 先 上 电 ， 此 部 
分 供电 电路 如 图 5.4.5.1 所 示 : 
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TP4 G VDD SNVS 3V3 
SNVS 3V3 m = 





图 5.4.5.1 SVS_3V3 供电 
图 中 ，U7 是 一 颗 LDO 芯片 ， 将 5V 转化 为 3.3V， 作 为 SNVS 3V3, HF SNVS 3V3 电流 
不 大 ,所 以 一 个 LDO 芯片 就 可 以 了 。 接 下 来 是 DCDC 3V3, 也 就 是 核心 板 主 的 电源 , 如 图 5.4.5.2 
所 示 : 
VDDHIGH/DCDC 3V3 


DCSV 





cec 
GND 咱 2uF [104 


VDD, SNVS 一 一 
C97 


VEC RESET 
104 GND MR 





GND UMSOSRE 








图 5.4.5.2 DCDC 3V3 

U8 是 一 个 DCDC 芯片 ， 用 于 将 5V 转换 为 3.3V， 但 是 电流 大 ，MP2144 最 大 输出 2A KE 
流 ， 因 此 作为 核心 板 的 3.3V 主 电 源 。 这 里 要 注意 ，U8 的 使 能 引 脚 使 用 了 I.MX6U 的 
PMIC_ON_REQ 引 脚 来 控制 , 当 SNVS_3V3 供给 ILMX6U m SNVS IN 引 脚 以 后 ,LMX6U 
的 PMIC ON REQ 引 脚 就 会 输出 高 电 平 ， 从 而 产生 DCDC 3V3，DCDC 3V3 也 是 LMX6U 的 
VDD HIGH IN 电源 。 接 下 来 就 是 ARM/SOC 内 核电 源 ， 如 图 5.4.5.3 Pros: 


ARM/SOC 


ovo] pour] o4 


DCDC 3V3 PG Rq0—]1 


























TP3 VDD ARM SOC IN 


T GND 
GND ||| ^ 1000250 | prscuG EN2 


Vo-Vfb*(RI-R2)/R2-Vfb(1-Rl/R2) 


SRI/R2-(Vo-Vfb)/Vfb 


Z1.4V:RI/R2-213K/160K. 
21.3V:RI/R2-186.7K/160K. 
310.925 V:RI/R2-86.7K/160K. 
Important: GPIO DVFS/ 
PMIC STBY REQ - 0, GPIO DVFS - 0, output is 1.4V (1.375V + 25mV) Z 2p 3 PMIC STBY REQ should be PULL DN 
PMIC : STBY REQ - 0, GPIO | DVFS = 1, output is 1.3V (1.275V + 25mV) when system reboot to ensure the 
PMIC | STBY REQ = 1, GPIO | DVFS - 0, output is 0.925V (0.9V+ 25mV) VDD ARM SOC IN voltage is not 
effected by DVFS 





图 5.4.5.3 ARM/SOC 电源 
U6 也 是 一 片 DCDC， 用 于 产生 ARM/SOC 内 核电 压 ， 此 内 核电 压 可 以 通过 LMX6U 的 
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GPIO DVFS fll PMIC STBY REQ 来 调节 。U6 的 使 能 脚 连接 到 了 DCDC 3V3 PG 信号 上 ， 此 
言 号 是 由 U8 产生 的 ， 当 U8 输出 3.3V 电压 以 后 DCDC 3V3 PG 信号 就 会 产生 ， 为 一 个 高 电 平 
信号 。 通 过 DCDC 3V3 PG 来 控制 VDD ARM SOC IN 电源 的 产生 ， 这 样 就 保证 了 
VDD HIGH IN tk ARM SOC IN 先 上 电 的 要 求 。 接 下 来 看 一 下 DDR3L 电源 ， 正 点 原子 的 
LMX6U 核心 板 使 用 的 是 DDR3L，DDDR3L 的 工作 电压 为 1.35V， 此 部 分 电源 电路 如 图 5.4.5.4 
所 示 : 


LVDDR3 


DC5V 










































































TP7 DRAM 1V35 
101 


" 
osa Bae 
DCDC 3V3 PG 

10K kos i 


区 
GND 








图 5.4.5.4 DDR3L 电路 
U11 也 是 一 个 DCDC 芯片 ， 用 于 将 5V 电源 转换 为 1.35V 供 DDR3L 使 用 。 接 下 来 看 一 下 
SD 卡 部 分 电路 ， 如 图 5.4.5.5 所 示 : 





























NVCC_SD<SD3.0> Wi es 
U9 UMI750S-00 # LSV/A.5V 
2 # Default:3.3V 
2uF[104 


= SDI VSELECT 


# RI/R2 = (Vo-Vfb)/Vfb 
GND # FB = 0.8V £L8V:RI/R2 = 1/0.8 : 200K/160K 


#3.3V:R1/R2 = 2.5/0.8: 5,00K/160K 
# FB = 1.0V #1.8V:R1/R2 = 0.8/1 : 160K/200K 
#3.3V:R1/R2 = 2.3/1: 464K/200K 


DCDC 3V3 PG 





图 5.4.5.5 SD 卡 电源 
Ul1 是 一 片 LDO， 用 于 将 5V 电源 转 为 3.3V 或 1.8V BE SD 卡 使 用 ， 因 为 高 速 SD 卡 需 要 
1.8V 供电 ， 因 此 此 路 电源 电压 是 可 调 的 ， 通 过 SD1_VSELECT 来 选择 使 用 3.3V 还 是 1.8V， 
SD1 VSELECT 连接 到 了 IMX6U 的 GPIOI IO05 上 。 
最 后 还 有 I.MX6U 其 他 外 设 电 源 ， 如 图 5.4.5.6 所 示 ; 
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NVCC xxx 


5.5 开发 板 使 用 注意 事项 


为 了 让 大 家 更 好 的 使 用 正点 原子 LMX6U-ALPHA A 





的 时 候 尤 其 要 注意 的 一 些 问题 ， 


R7 





图 5.4.5.6 LMX6U 





希望 大 家 在 使 用 的 时 候 多 多 注意 ， 
G、1 个 USB 供电 最 多 500mA， 且 由 于 导线 电阻 存在 ， 供 到 开发 板 的 电压 ， 一 般 都 不 会 有 
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VDD HIGH IN 
NVCC LCDIF 


NVCC GPIO 
& E. 

















NVCC ENET 


NVCC UART 


DCDC 3V3[.— — —JNvcc NAND 
DCDC 3V3LL— — —JNvcc cst 
DCDC 3V3[L— — —4JvppA ADC 3P3 


他 外 设 电源 











F 发 板 ， 我 们 在 这 里 总 结 该 开发 板 使 用 
以 减少 不 必要 的 问题 。 














5V， 如 果 使 用 了 很 多 大 负载 外 设 ， 比 如 4.3 寸 屏 、 网 络 、 摄 像 头 模块 等 ， 那 么 可 能 引起 USB 供 
电 不 够 ， 所 以 如 果 是 使 用 4.3 屏 的 朋友 ， 或 者 同时 用 到 多 个 模块 的 时 候 ， 建 议 大 家 使 用 一 个 独 
立 电源 供电 。 如 果 没 有 独立 电源 ， 建 议 可 以 同时 择 2 个 USB 口 ， 并 插 上 仿真 器 ， 这 样 供电 可 
以 更 足 一 些 。 


包 、 当 




















你 想 使 用 某 个 IO 口 





用 作 其 他 用 处 的 时 候 ， 请 先 看 看 开发 板 的 原理 



































图 ， 该 IO 口 是 否 








有 连接 在 开发 板 的 某 个 外 设 上 ， 如 果 有 ， 该 外 设 的 这 个 信号 是 否 会 对 你 的 使 用 造成 干扰 ， 先 确 




















定 无 干扰 ， 


再 使 用 这 个 IO. 


























(、 开 发 板 上 的 跳 线 帽 比较 多 ， 大 家 在 使 用 茶 个 功能 的 时 候 ， 要 先 查 查 这 个 是 否 需 要 设置 


跳 线 帽 ， 以 免 浪 
、 当 液晶 显示 





可 以 同时 使 月 














费时 间 。 




















白 屏 的 时 候 ， 请 9 
©., FRIKI USB OTG 的 USB SLAVE fil USB HOST 
日 。 使 用 的 时 候 多 加 注意 。 























用 同一 个 USB 





Et 检查 液晶 模块 是 否 插 好 〈 拔 下 来 重新 插 试 试 )。 


口 ， 所 以 ， 他 们 不 











@@、 当 需要 从 底板 上 拆 转 接 板 下 来 的 时 候 , 请 左右 晃动 取 下 , 不 要 太 大 幅度 ,否则 有 可 能 拆 


坏 座 子 。 















































坛 www.openedv.com 下 载 到 ， 大 家 可 以 经 常 去 这 个 论坛 获取 更 新 的 信息 。 
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至 此 ， 本 手册 的 实验 平台 (正点 原子 IMX6U-ALPHA 开发 板 ) 的 硬件 部 分 就 介绍 完了 ， 了 
解 了 整个 硬 人 


可 以 事半功倍 ， 和 希望 大 家 细 读 ! 另外 正点 原子 3 














F 对 我 们 后 面 的 学 习 会 有 很 大 帮助 ， 有 助 于 理解 后 面 的 代码 ， 在 编写 软件 的 时 候 ， 
开发 板 的 其 他 资料 及 教程 更 新 ， 都 可 以 在 技术 论 
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第 六 章 Coretx-A7 MPCore 架构 


LILMX6UL 使 用 的 是 Cortex-A7 内 核 ， 本 章 就 给 大 家 介绍 一 下 Cortex-A7 架构 的 一 些 基 本 知 
识 。 了 解 了 Cortex-A7 架构 以 后 有 利于 我 们 后 面 的 学 习 ， 因 为 后 面 有 很 多 例 程 涉及 到 Cortex-A7 
架构 方面 的 知识 ， 比 如 处 理 器 模型 、Cortex-A7 寄存 器 组 等 等 ， 但 是 Cortex-A7 架构 很 庞大 ， 远 
不 是 一 章 就 能 讲 完 的 ， 所 以 本 章 只 是 对 Cortex-A7 架构 做 基本 的 讲解 ， 主 要 是 为 我 们 后 续 的 试 
验 打 基 础 。 
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本 章 参考 了 《Cortex-A7 Technical ReferenceManua.pdf》 和 (ARM Cortex-A(armV7) 编 程 手 
册 V4.0.pdf》 这 俩 份 文档 ， 这 两 份 文档 都 是 ARM 官方 的 文档 ,详细 的 介绍 了 Cortex-A7 架构 和 
ARMv7-A 指令 集 。 这 两 份 文档 我 们 都 已 经 放 到 了 开发 板 光 盘 中 ， 路 径 为 : 开发 板 光盘 ->4、 参 
考 资料 。 






































6.1 Cortex-A7 MPCore 简介 


Cortex-A7 MPcore 处 理 器 支持 1~4 核 ， 通 常 是 和 Cortex-A15 组 成 big.LITTLE 架构 的 ， 
Cortex-A15 作为 大 核 负 责 高 性 能 运算 ,比如 玩 游 戏 喻 的 ， Cortex-A7 负责 普通 应 用 ,因为 Cortex- 
A7 省 电 。Cortex-A7 本 身 性 能 也 不 弱 ， 不 要 看 它 叫 做 Cortex-A7 但 是 它 可 是 比 Cortex-A8 性 能 
要 强大 ， 而 且 更 省 电 。ARM 官网 对 于 Cortex-A7 的 说 明 如 下 : 

“在 28nm 工艺 下 ，Cortex-A7 可 以 运行 在 1.2~1.6GHz， 并 且 单 核 面积 不 大 于 0.45mm?( 含 
有 浮 点 单元 、NEON 和 32KB 的 L1 缓存 )， 在 典型 场景 下 功 耗 小 于 100mW， 这 使 得 它 非 常 适 
合 对 功 耗 要 求 严格 的 移动 设备 ， 这 意味 着 Cortex-A7 在 获得 与 Cortex-A9 相似 性 能 的 情况 下 ， 
其 功 耗 更 低 ”。 

Cortex-A7 MPCore 支持 在 一 个 处 理 器 上 选 配 1~4 个 内 核 ， Cortex-A7 MPCore 多 核 配 置 如 图 
6.1.1 所 示 : 














































































































LI 指令 | L1 数据 Ll 指令 | L1 数据 
Cache Cache Cache Cache 
处 理 器 1 处 理 器 3 
































由 也 可 选中 断 可 选 L2 
中 断 控制 器 Snoop Control Unit(SCU) Cache 控 制 器 


ACE 主 接 


i 


图 6.1.1 多 核 配 置 图 

Cortex-A7 MPCore 的 Ll 可 选择 8KB、16KB、32KB、64KB，L2 Cache 可 以 不 配 ， 也 可 以 
选择 128KB, 256KB, 512KB, 1024KB. I.MX6UL 配置 了 32KB 的 Ll 指令 Cache 和 32KB 的 
L1 数据 Cache， 以 及 128KB ff] L2 Cache. Cortex-A7MPCore 使 用 ARMv7-A 架构 ， 主 要 特性 如 
下 : 

Q)、SIMDv2 扩展 整形 和 浮 点 向 量 操作 。 

©., EET ARM VFPv4 体系 结构 兼容 的 高 性 能 的 单 双 精 度 浮 点 指令 ， 文 持 全 功能 也 
IEEE754。 



















































































回 、 支 持 大 物理 扩展 (LPAE)， 最 高 可 以 访问 40 位 存储 地 址 ， 也 就 是 最 高 可 以 支持 ITB 的 
内 存 。 

Q@、 支 持 硬件 虚拟 化 。 
@@、 支 


TF Generic Interrupt Controller(GIC)V2.0. 





` 


273 


LMX6U AR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 

















人、 支持 NEON， 可 以 加 速 多 媒体 和 信和 号 处 理 算 法 。 
6.2 Cortex-A 处 理 器 运行 模型 


以 前 的 ARM 处 理 器 有 7 中 运行 模型 : User、FIQ、IRQ、Supervisor(SVC)、Abort、Undef 
和 System, HF User 是 非特 权 模式 ， 其 余 6 中 都 是 特权 模式 。 但 新 的 Cortex-A 架构 加 入 了 
TrustZone 安全 扩展 ， 所 以 就 新 加 了 一 种 运行 模式 : Monitor， 新 的 处 理 器 架构 还 支持 虚拟 化 扩 


















































展 ， 因 此 又 加 入 了 男 一 个 运行 模式 : Hyp， 所 以 Cortex-A7 处 理 器 有 9 中 处 理 模 式 ， 如 表 6.2.1 
所 示 : 

User(USR) 用 户 模式 ， 非 特权 模式 ， 大 部 分 程序 运行 的 时 候 就 处 于 此 模式 。 

FIQ 快速 中 断 模式 ， 进 入 FIQ "PIRE 

IRQ 一 般 中 断 模式 。 








Supervisor(SVC) | 超级 管理 员 模 式 ， 特 权 模 式 ， 供 操作 系统 使 用 。 
Monitor(MON) 监视 模式 ?这 个 模式 用 于 安全 扩展 模式 ， 只 用 户 安全 。 




















Abort(ABT) 数据 访问 终止 模式 ， 用 于 虚拟 存储 以 及 存储 保护 。 
Hyp(HYP) 超级 监视 模式 ?用 于 虚拟 化 扩展 。 
Undef(UND) 未 定义 指令 终止 模式 。 














System(SYS) 系统 模式 ， 用 于 运行 特权 级 的 操作 系统 任务 
表 6.2.1 九 种 运行 模式 

在 表 6.2.1.9 中 ， 除 了 User(USR) 用 户 模 式 以 外 ， 其 它 8 种 运行 模式 都 是 特权 模式 ， 在 特权 
模式 下 ， 程 序 可 以 访问 所 有 的 系统 资源 。 这 几 个 运行 模式 可 以 通过 软件 进行 任意 切换 ， 也 可 以 
通过 中 断 或 者 异常 来 进行 切换 。 大 多 数 的 程序 都 运行 在 用 户 模式 ， 用 户 模式 下 是 不 能 访问 系统 
所 有 资源 的 ， 有 些 资源 是 受 限 的 ， 要 想 访问 这 些 受 限 的 资源 就 必须 进行 模式 切换 。 但 是 用 户 模 
式 是 不 能 直接 进行 切换 的 ， 用 户 模式 下 需要 借助 异常 来 完成 模式 切换 ， 当 要 切换 模式 的 时 候 ， 
应 用 程序 可 以 产生 异常 ， 在 异常 的 处 理 过 程 中 完成 处 理 器 模式 切换 。 

当中 断 或 者 异常 发 生 以 后 ， 处 理 器 就 会 进入 到 相应 的 异常 模式 种 ， 每 一 种 模式 都 有 一 组 寄 
存 器 供 异常 处 理 程序 使 用 ， 这 样 的 目的 是 为 了 保证 在 进入 异常 模式 以 后 ， 用 户 模式 下 的 寄存 器 
不 会 被 破坏 。 

如 果 学 过 STM32 和 UCOS、FreeRTOS 就 会 知道 ，STM32 只 有 两 种 运行 模式 ， 特 权 模 式 和 
非特 权 模 式 ， 但 是 Cortex-A 就 有 9 种 运行 模式 。 


6.3 Cortex-A 寄存 器 组 


本 节 我 们 要 讲 的 是 Cortex-A 的 内 核 寄存 器 组 ， 注 意 不 是 芯片 的 外 设 寄存 器 ， 本 节 主 要 参考 
(ARM Cortex-A(armV7) 编 程 手 册 V4.0.pdf》 的 “第 3 章 ARM Processor Modes And Registers". 

ARM 架构 提供 了 16 个 32 位 的 通用 寄存 器 (R0~R15) 供 软件 使 用 ， 前 15 个 (RO0~R14) 可 以 用 
作 通 用 的 数据 存储 ，R15 是 程序 计数 器 PC， 用 来 保存 将 要 执行 的 指令 。ARM 还 提供 了 一 个 当 
前 程序 状态 寄存 器 CPSR 和 一 个 备份 程序 状态 寄存 器 SPSR，SPSR 寄存 器 就 是 CPSR 寄存 器 的 
备份 。 这 18 个 寄存 器 如 图 6.3.1 所 示 : 
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入 低 寄存 器 组 





和 > 高 寄存 器 组 


|. SPSR —M-eeuiketés— 
图 6.3.1 Cortex-A 寄存 器 。 

上 一 小 节 我 们 讲 了 Cortex-A7 有 9 种 运行 模式 ， 每 一 种 运行 模式 都 有 一 组 与 之 对 应 的 寄存 
器 组 。 每 一 种 模式 可 见 的 寄存 器 包括 15 个 通用 寄存 器 (R0~R14)、 一 两 个 程序 状态 寄存 器 和 一 个 
程序 计数 器 PC。 在 这 些 寄存 器 中 ， 有 些 是 所 有 模式 所 共用 的 同一 个 物理 寄存 器 ， 有 一 些 是 各 模 
式 自己 所 独立 拥有 的 ， 各 个 模式 所 拥有 的 寄存 器 如 表 6.3.2 所 示 : 


Sys FIQ IRQ ABT SVC UND MON YP 
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RIP 
R13 (sp) 


R15 (pc) 


























H 

R8 fiq 

R9 fiq 

R10 fiq 

R11 fiq 

R12 fiq 

SP fe STR 可 SP abt SP svc SP und SP mon SP hyp 
RENG UREE] LR_abt RESNE LR_und LR_mon 


[ osr | 
SPSR SPSR Tr SPSR abt SPSR svc SPSR und SPSR mon SPSR hyp 
ELR hyp 


图 6.3.2” 九 种 模式 所 对 应 的 寄存 器 
从 图 6.3.2 中 浅 色 字 体 的 是 与 User 模式 所 共有 的 寄存 器 ， 蓝 绿色 背景 的 是 各 个 模式 所 独 有 
的 寄存 器 。 可 以 看 出 ， 在 所 有 的 模式 中 ， 低 寄存 器 组 (R0~R7) 是 共享 同一 组 物理 寄存 器 的 ， 只 是 
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一 些 高 寄存 器 组 在 不 同 的 模式 有 自己 独 有 的 寄存 器 ， 比 如 FIQ 模式 下 R8-RIA 是 独立 的 物理 寄 
存 器 。 假 如 某 个 程序 在 FIQ 模式 下 访问 R13 寄存 器 ， 那 它 实际 访问 的 是 寄存 器 R13_fiq， 如 果 
程序 处 于 SVC 模式 下 访问 R13 寄存 器 ， 那 它 实 际 访问 的 是 寄存 器 了 13_svc。 总 结 一 下 ，Cortex- 
A 内 核 寄 存 器 组 成 如 下 : 

D, 34 个 通用 寄存 器 ， 包 括 RIS 程序 计数 器 PC)， 这 些 寄存 器 都 是 32 位 的 。 

@、8 个 状态 寄存 器 ， 包 括 CPSR 和 SPSR. 

(3). Hyp 模式 下 独 有 一 个 ELR_Hyp 寄存 器 。 



























































6.3.1 通用 寄存 器 


R0~R15 就 是 通用 寄存 器 ， 通 用 寄存 器 可 以 分 为 一 下 三 类 : 

D, REHAT BI RO~R7。 

@、 备 份 寄存 器 ， 即 R8~R14。 

@)、 程 序 计 数 器 PC， 即 RIS. 

分 别 来 看 一 下 这 三 类 寄存 器 : 

1、 未 备份 寄存 器 

为 备份 寄存 器 指 的 是 RO0~R7 3X 8 个 寄存 器 , 因为 在 所 有 的 处 理 器 模式 下 这 8 个 寄存 器 都 是 
同一 个 物理 寄存 器 ， 在 不 同 的 模式 下 ， 这 8 个 寄存 器 中 的 数据 就 会 被 破坏 。 所 以 这 8 个 寄存 器 
并 没有 被 用 作 特 殊 用 途 。 

2、 备 份 寄存 器 

备份 寄存 器 中 的 RS-RI2 这 5 个 寄存 器 有 两 种 物理 寄存 器 ， 在 快速 中 断 模式 下 CIQ) 它 们 对 
应 着 Rx_irq(x=8~12) 物 理 寄存 器 ， 其 他 模式 下 对 应 着 Rx(8~12) 物 理 寄 存 器 。FIQ 是 快速 中 断 模 
式 ， 看 名 字 就 是 知道 这 个 中 断 模 式 要 求 快 速 执行 ! FIQ 模式 下 中 断 处 理 程序 可 以 使 用 R8~R12 
寄存 器 ， 因 为 FIQ 模式 下 的 RS-RI2 是 独立 的 ， 因 此 中 断 处 理 程 序 可 以 不 用 执行 保存 和 恢复 中 
断 现场 的 指令 ， 从 而 加 速 中 断 的 执行 过 程 。 

备份 寄存 器 R13 一 共有 8 个 物理 寄存 器 ， 其 中 一 个 是 用 户 模 式 (User) 和 系统 模式 (Sys) 共 用 
的 ， 剩 下 的 7 个 分 别 对 应 7 种 不 同 的 模式 。R13 也 叫做 SP， 用 来 做 为 栈 指针 。 基 本 上 每 种 模式 
都 有 一 个 自己 的 R13 物理 寄存 器 ， 应 用 程序 会 初始 化 R13， 使 其 指向 该 模式 专用 的 栈 地 址 ， 这 
就 是 常 说 的 初始 化 SP 指针 。 

备份 寄存 器 R14 一 共有 7 个 物理 寄存 器 ， 其 中 一 个 是 用 户 模式 (User)、 系 统 模式 (Sys) 和 起 
级 监视 模式 (Hyp) 所 共有 的 , 剩 下 的 6 个 分 别 对 应 6 种 不 同 的 模式 .R14 也 称 为 连接 寄存 器 (LR)， 
LR 寄存 器 在 ARM 中 主要 用 作 如 下 两 种 用 途 : 

QD、 每 种 处 理 器 模式 使 用 R14(LR) 来 存放 当前 子 程序 的 返回 地 址 ， 如 果 使 用 BL 或 者 BLX 
来 调用 子 函 数 的 话 ，R14(LR) 被 设置 成 该 子 函数 的 返回 地 址 ， 在 子 函 数 中 , 将 R14(LR) 中 的 值 赋 
给 R15(PC) 即 可 完成 子 函 数 返回 ， 比 如 在 子 程序 中 可 以 使 用 如 下 代码 : 

MOV PC, LR @ 寄 存 器 LR 中 的 值 赋值 给 PC， 实现 跳 转 

或 者 可 以 在 子 函 数 的 入 口 出 将 LR AG 

PUSH {LR} @ 将 LR 寄存 器 压 栈 
在 子 函 数 的 最 后 面 出 栈 即 可 : 

POP {PC} ”@ 将 上 面 压 栈 的 LR 寄存 器 数据 出 栈 给 PC 寄存 器 

名 、 当 异常 发 生 以 后 ,该 异常 模式 对 应 的 R14 寄存 器 被 设置 成 该 异常 模式 将 要 返回 的 地 址 ， 
R14 也 可 以 当 作 普 通 寄 存 器 使 用 。 

3、 程 序 计数 器 R15 
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程序 计数 器 R15 也 叫做 PC,R15 保存 着 当前 执行 的 指令 地 址 值 加 8 个 字 节 , 这 是 因为 ARM 
的 流水 线 机 制导 致 的 。ARM 处 理 器 3 级 流水 线 : 取 指 -> 译 码 -> 执行 ， 这 三 级 流水 线 循环 执行 ， 
比如 当前 正在 执行 第 一 条 指令 的 同时 也 对 第 二 条 指令 进行 译 码 ， 第 三 条 指令 也 同时 被 取出 存放 
在 R15(PC) 中 。 我 们 喜欢 以 当前 正在 执行 的 指令 作为 参考 点 ， 也 就 是 以 第 一 条 指令 为 参考 点 ， 
那么 R15(PC) 中 存放 的 就 是 第 三 条 指令 ， 换 句 话说 就 是 R15(PC) 总 是 指向 当前 正在 执行 的 指令 



































地 址 再 加 上 2 条 指令 的 地 址 。 对 于 32 位 的 ARM 处 理 器 ， 每 条 指令 是 4 个 字 节 ， 所 以 : 
R15 (PCE = 当前 执行 的 程序 位 置 + 8 个 字 节 。 





6.3.2 程序 状态 寄存 器 


所 有 的 处 理 器 模式 都 共用 一 个 CPSR 物理 寄存 器 ， 因 此 CPSR 可 以 在 任何 模式 下 被 访问 。 
CPSR 是 当前 程序 状态 寄存 器 , 该 寄存 器 包含 了 条 件 标志 位 、 中 断 禁 止 位 、 当 前 处 理 器 模式 标志 
等 一 些 状态 位 以 及 一 些 控制 位 。 所 有 的 处 理 器 模式 都 共用 一 个 CPSR 必然 会 导致 冲突 ， 为 此 ， 
除了 User 和 Sys 这 两 个 模式 以 外 ， 其 他 7 个 模式 每 个 都 配备 了 一 个 专用 的 物理 状态 寄存 器 ， 叫 
做 SPSR( 备 份 程序 状态 寄存 器 )， 当 特定 的 异常 中 断 发 生 时 ，SPSR 寄存 器 用 来 保存 当前 程序 状 
态 寄存 器 (CPSR) 的 值 ， 当 异常 退出 以 后 可 以 用 SPSR 中 保存 的 值 来 恢复 CPSR。 

因为 User 和 Sys 这 两 个 模式 不 是 异常 模式 ， 所 以 并 没有 配备 SPSR， 因 此 不 能 在 User 和 
Sys 模式 下 访问 SPSR， 会 导致 不 可 预知 的 结果 。 由 于 SPSR 是 CPSR 的 备份 ， 因 此 SPSR 和 
CPSR 的 寄存 器 结构 相同 ， 如 图 6.3.2.1 所 示 : 
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图 6.3.2.1 CPSR 寄存 器 
N(bit31): 当 两 个 补 码 表示 的 有 符号 整数 运算 的 时 候 , N=1 表示 运算 对 的 结果 为 负数 , N=0 
表示 结果 为 正 数 。 
Z(bit30): Z-1 表示 运算 结果 为 零 ，Z=0 表示 运算 结果 不 为 零 ， 对 于 CMP HS, Z1 表示 
进行 比较 的 两 个 数 大 小 相等 。 
















































































Cit29): 在 加 法 指令 中 ， 当 结果 产生 了 进位 ， 则 C=1， 表 示 无 符号 数 运算 发 生 上 游 ， 其 它 
情况 下 C=0。 在 减法 指令 中 ， 当 运算 中 发 生 借 位 ， 则 C=0， 表 示 无 符号 数 运算 发 生 下 洲 ， 其 它 






































情况 下 C=1。 对 于 包含 移 位 操作 的 非 加 /减法 运算 指令 ，C 中 包含 最 后 一 次 溢出 的 位 的 数值 ， 对 
于 其 它 非 加 / 城 运 算 指 令 ，C 位 的 值 通常 不 受 影响 。 
V(bit28): 对 于 加 /减法 运算 指令 ， 当 操作 数 和 运算 结果 表示 为 二 进 制 的 补 码 表示 的 带 符号 
数 时 ，V=1 表示 符号 位 溢出 ， 通 常 其 他 位 不 影响 V 位 。 
Qit27): [X ARM v5TE J 架构 支持 ， 表 示 饱 和 状态 ，Q=1 表示 累积 饱和 ，Q=0 表示 累积 
不 饱和 。 
IT[1:0](bit26:25): 和 了 IT[7:2](bit15:bit10) 一 起 组 成 IT[7:0]， 作 为 下 -THEN 指令 执行 状态 。 
J(bit24): 仅 ARM_v5TE-J 架构 支持 ,=1 表示 处 于 Jazelle 状态 ， 此 位 通常 和 (bit5) 位 一 起 
表示 当前 所 使 用 的 指令 集 ， 如 表 6.3.2.1 所 示 : 










































































0 0 ARM 

0 1 Thumb 

1 1 ThumbEE 
l 0 Jazelle 





X632. 指令 类 型 
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GE[3:0](bit19:16): SIMD 指令 有 效 ， 大 于 或 等 于 。 

IT[7:2](bit15:10): 参考 IT[1:0]。 

E(bit9): 大 小 端 控制 位 ，E=1 表示 大 端 模式 ，E=0 表示 小 端 模式 。 

A(bit8): 禁止 异步 中 断 位 ，A=1 表示 禁止 异步 中 断 。 

I(bit7); I-1 禁止 IRQ，I=0 使 能 IRQ. 

F(bit6): F=1 禁止 FIQ，F=0 使 能 FIQ. 

T(bits): 控制 指令 执行 状态 ， 表 明 本 指令 是 ARM 指令 还 是 Thumb 指令 , 通常 和 J(bit24) — 
起 表明 指令 类 型 ， 参 考 J(bit24) 位 。 

MI[4:0]: 处 理 器 模式 控制 位 ， 含 义 如 表 6.3.2.2 所 示 ; 

































































10000 User 模式 

10001 FIQ 模式 

10010 IRQ 模式 

10011 Supervisor(SVC) 模 式 
10110 Monitor(MON) 模 式 
10111 Abort(ABT) 模 式 
11010 Hyp(HYP) 模 式 
11011 UndeffUND) 模 式 
11111 System(SYS) 模 式 





表 6.3.2.2 处 理 器 模式 位 
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第 七 章 ARM 汇编 基础 


我 们 在 学 习 STM32 的 时 候 几 乎 没有 用 到 过 汇编 ， 可 能 在 学 习 UCOS、FreeRTOS 等 RTOS 





类 操作 系统 移植 的 时 候 可 能 会 接触 到 
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指针 等 等 ， 当 汇编 把 C 环境 设置 好 了 以 
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Cii BERTET ARAR Linux 开发 的 时 候 是 绝 














对 要 掌握 基本 的 ARM 汇编 ， 因 为 Cortex-A 芯片 一 上 电 SP 指针 还 没 初始 化 ，C 环境 还 没准 备 
好 ， 所 以 表 定 不 能 运行 C 代码 ， 必 须 先 用 汇编 语言 设置 好 C 环境 ， 比 如 初始 化 DDR、 设 置 SP 
后 才 可 以 运行 C 代码 。 所 以 Cortex-A 一 开始 肯定 是 汇 
编 代 码 ， 其 实 STM32 也 一 样 的 ， 一 开始 也 是 汇编 ， 以 STM32F103 为 例 ， 启 动 文件 






































startup_stm32f10x_hd.s 就 是 汇编 文件 ， 只 是 这 个 文件 ST CASET, 我 们 根本 不 用 去 修改 , 所 


以 大 部 分 学 习 者 都 没有 深入 的 去 研究 。Y 
满足 我 们 后 续 学 习 即 可 。 








Cá 








的 知识 很 庞大 , 本 章 我 们 只 讲解 最 常用 的 一 些 指令 ， 
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LMX6U-ALPHA 使 用 的 是 NXP 的 LMX6UL 芯片 ， 这 是 一 款 Cortex-A7 内 核 的 芯片 ， 所 以 

我 们 主要 讲 的 是 Cortex-A 的 汇编 指令 。 为 此 我 们 需要 参考 两 份 跟 Cortex-A 内 核 有 关 的 文档 ; 

(ARM ArchitectureReference Manual ARMv7-A and ARMv7-R edition.pdf) 4l (ARM Cortex- 
A(armV7) 编 程 手册 V4.0.pdf》， 第 一 份 文 档 主 要 讲解 ARMv7-A 和 ARMv7-R 指令 集 的 开发 ， 
Cortex-A7 使 用 的 是 ARMv7-A 指令 集 ， 第 二 份 文档 主要 讲解 Cortex-A(armV7) 编 程 的 ， 这 两 份 
文档 是 学 习 Cortex-A 不 可 或 缺 的 文档 。 在 《ARM ArchitectureReference Manual ARMv7-A and 
ARMYV7-R edition.pdf》 的 A4 章 详细 的 讲解 了 Cortex-A 的 汇编 指令 ， 要 想 系统 的 学 习 Cortex-A 
的 指令 就 要 认真 的 阅读 A4 章节 。 

对 于 Cortex-A 蕊 片 来 讲 ， 大 部 分 芯片 在 上 电 以 后 C 语言 环境 还 没准 备 好 ,所 以 第 一 行程 序 
肯定 是 汇编 的 ， 至 于 要 写 多 少 汇编 程序 ， 那 就 看 你 能 在 哪 一 步 把 C 语言 环境 准备 好 。 所 谓 的 C 
语言 环境 就 是 保证 C 语言 能 够 正常 运行 。C 语言 中 的 函数 调用 涉及 到 出 栈 入 栈 ， 出 栈 入 栈 就 要 
对 堆栈 进行 操作 ， 所 谓 的 堆栈 其 实 就 是 一 段 内 存 ， 这 段 内 存 比较 特殊 ， 由 SP 指针 访问 ，SP 指 
针 指 向 栈 顶 。 芯 片 一 上 电 SP 指针 还 没有 初始 化 ， 所 以 C 语言 没 法 运行 ， 对 于 有 些 心 片 还 需要 
初始 化 DDR， 因 为 芯片 本 身 没 有 RAM， 或 者 内 部 RAM 不 开放 给 用 户 使 用 ， 用 户 代码 需要 在 
DDR 中 运行 ， 因 此 一 开始 要 用 汇编 来 初始 化 DDR 控制 器 。 后 面 学 习 Uboot 和 Linux. 内 核 的 时 
候 汇编 是 必须 要 会 的 ， 是 不 是 觉得 好 难 啊 ”还 要 会 汇编 ! 前 面 都 说 了 只 是 在 芯片 上 电 以 后 用 汇 
编 来 初始 化 一 些 外 设 ， 不 会 涉及 到 复杂 的 代码 ， 而 且 使 用 到 的 指令 都 是 很 简单 的 ， 用 到 的 就 那 
么 十 几 个 指令 。 所 以 ， 不 要 看 到 汇编 就 觉得 复杂 ， 打 击 学 习 信心 。 
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7.1 GNU 汇编 语法 


如 果 大 家 使 用 过 STM32 的 话 就 会 知道 MDK 和 IAR 下 的 启动 文件 startup stm32f10x hd.s 
其 中 的 汇编 语法 是 有 所 不 同 的 ， 将 MDK 下 的 汇编 文件 直接 复制 到 IAR 下 去 编译 就 会 出 错 ， 因 
为 MDK 和 IAR 的 编译 器 不 同 ， 因 此 对 于 汇编 的 语法 就 有 一 些小 区 别 。 我 们 要 编写 的 是 ARM 
汇编 ， 编 译 使 用 的 GCC 交叉 编译 器 ， 所 以 我 们 的 汇编 代码 要 符合 GNU 语法 。 

GNU 汇编 语法 适用 于 所 有 的 架构 , 并 不 是 ARM 独 享 的 , GNU 汇编 由 一 系列 的 语句 组 成 ， 
每 行 一 条 语句 ， 每 条 语句 有 三 个 可 选 部 分 ， 如 下 : 

label: instruction @ comment 

label 即 标 号 ， 表 示 地 址 位 置 ， 有 些 指令 前 面 可 能 会 有 标号 ， 这 样 就 可 以 通过 这 个 标号 得 到 
外 令 的 地 址 ， 标 号 也 可 以 用 来 表示 数据 地 址 。 注 意 label 后 面 的 冒号 “:” 任何 以 冒号 “:” 结 
尾 的 标识 符 都 会 被 认识 是 一 个 标号 。 

instruction 即 指令 ， 也 就 是 汇编 指令 或 伪 指 令 。 

@ 符 号 ， 表 示 后 面 的 是 注释 ， 就 跟 Cie BH] "1 t" —RE, KS GNU 汇编 文 












































































































































































































































件 中 我 们 也 可 以 使 用 “/*” 和 “*/” 来 注释 。 
comment 就 是 注释 内 容 。 
比如 如 下 代码 : 





add: 
MOVS R0, #0X12 @ 设 置 R0=0X12 
上 面 代码 中 “add:” 就 是 标号 ,“MOVS R0,#0X12” 就 是 指令 ， 最 后 的 “@ 设 置 R0=0X12” 就 是 
HX! ARM 中 的 指令 、 伪 指令 、 伪 操作 、 寄 存 器 名 等 可 以 全 部 使 用 大 写 ， 也 可 以 全 部 使 用 
小 写 ， 但 是 不 能 大 小 写 混用 。 
用 户 可 以 使 用 .section 伪 操 作 来 定义 一 个 段 ， 汇 编 系统 预定 义 了 一 些 段 名 : 
.text 表示 代码 段 。 
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.data 初始 化 的 数据 段 。 

.bss 未 初始 化 的 数据 段 。 

.rodata 只 读数 据 段 。 

我 们 当然 可 以 自己 使 用 .section 来 定义 一 个 段 ， 每 个 段 以 段 名 开始 ， 以 下 一 段 名 或 者 文件 结 
尾 结 束 ， 比 如 : 

.Section .testsection @ 定 义 一 个 testsetcion 段 

汇编 程序 的 默认 入 口 标 号 是 _start， 不 过 我 们 也 可 以 在 链接 脚本 中 使 用 ENTRY 来 指明 ] 
的 入 口 点 ， 下 面 的 代码 就 是 使 用 _start 作为 入 口 标号 : 

.global start 























pus 
m} 

















_start: 
ldr r0, =0x12 @r0=0x12 
上 面 代码 中 .global 是 伪 操 作 ， 表 示 start 是 一 个 全 局 标号 ， 类 似 C 语言 里 面 的 全 局 变量 一 
样 ， 常 见 的 伪 操 作 有 : 
byte ”定义 单字 节 数 据 ， 比 如 .byte 0x12。 
.Short ”定义 双 字 节 数 据 ， 比 如 .byte 0x1234。 
Jong ”定义 一 个 4 字 节 数据 ， 比 如 .long 0x12345678。 
.equ 武 值 语句 ， 格 式 为 : .equ 变量 名 ,表达 式 ， 比 如 .equ num, 0x12, 表示 num-0x12. 
.align ”数据 字 节 对 齐 ， 比 如 : .align 4 表示 4 字 节 对 齐 。 
.end 表示 源 文件 结束 。 
.global ”定义 一 个 全 局 符号 ， 格式 为 : .global symbol， 比 如 : .global start. 
GNU 汇编 还 有 其 它 的 伪 操 作 , 但 是 最 常见 的 就 是 上 面 这 些 ,， 如果 想 详 细 的 了 解 全 部 的 伪 操 
作 ， 可 以 参考 《ARM Cortex-A(armV7) 编 程 手册 V4.0.pdf》 的 57 Xi. 
GNU 汇编 同样 也 支持 函数 ， 函 数 格式 如 下 : 
函数 名 : 
函数 体 
返回 语句 
GNU 汇编 函数 返回 语句 不 是 必须 的 ， 如 下 代码 就 是 用 汇编 写 的 Cortex-A7 中 断 服务 函数 ; 
示例 代码 7.1.1.1 汇编 函数 定义 
































= 


































































































/* 未 定义 中 断 */ 

Undefined Handler: 
ldr r0, -Undefined Handler 
bx r0 





/* SVC 中断 */ 

SVC Handler: 
ldr r0, -SVC Handler 
loz () 


/* 预 取 终 止 中 断 */ 

Emacs masa kender: 
lele z0, =PrerAoorrt Hancler 
PERO 
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上 述 代码 中 定义 了 三 个 汇编 函数 : Undefined Handler. SVC _Handler 和 
PrefAbort Handler。 以 函数 Undefined Handler 为 例 我 们 来 看 一 下 汇编 函数 组 成 ， 
“Undefined Handler” 就 是 函数 名 ,“ldrr0, -Undefined Handler” 是 函数 体 ,“bxr0” 是 函数 
返回 语句 ,“bx” 指 令 是 返回 指令 ， 函 数 返回 语句 不 是 必须 的 。 


7.2 Cortex-A7 常用 汇编 指令 


本 节 我 们 将 介绍 一 些 常 用 的 Cortex-A7 汇编 指令 ， 如 果 想 系统 的 了 解 Cortex-A7 的 所 有 汇 
编 指令 请 参考 《ARM ArchitectureReference Manual ARMv7-A and ARMV7-R edition.pdf》 的 A4 
章节 。 





















































7.2.1 处 理 器 内 部 数据 传输 指令 











使 用 处 理 器 做 的 最 多 事情 就 是 在 处 理 器 内 部 来 回 的 传递 数据 ， 常 见 的 操作 有 : 

GD、 将 数据 从 一 个 寄存 器 传递 到 另外 一 个 寄存 器 。 

@、 将 数据 从 一 个 寄存 器 传递 到 特殊 寄存 器 ， 如 CPSR 和 SPSR 寄存 器 。 

作 、 将 立即 数 传递 到 寄存 器 。 

数据 传输 常用 的 指令 有 三 个 : MOV、MRS 和 MSR， 这 三 个 指令 的 用 法 如 表 7.2.1.1 所 











MOV RO RI 将 RI 里 面 的 数据 复制 到 RO 中 。 
MRS RO CPSR | 将 特殊 寄存 器 CPSR 里 面 的 数据 复制 到 RO 中 。 
MSR CPSR |RI 将 RI 里 面 的 数据 复制 到 特殊 寄存 器 CPSR 里 中 。 
表 7.2.1.1 常用 数据 传输 指令 

分 别 来 详细 的 介绍 一 下 如 何 使 用 这 三 个 指令 : 

1. MOV 指令 

MOV 指令 用 于 将 数据 从 一 个 寄存 器 拷贝 到 另外 一 个 寄存 器 ， 或 者 将 一 个 立即 数 传递 到 寄 
存 器 里 面 ， 使 用 示例 如 下 : 















































MOV RO, RI @ 将 寄存 器 R1 中 的 数据 传递 给 R0， 即 RO=R1 
MOV RO, #0X12 @ 将 立即 数 0X12 传递 给 RO 寄存 器 ， 即 RO-0XI2 
2、MRS 指令 


MRS 指令 用 于 将 特殊 寄存 器 (如 CPSR 和 SPSR) 中 的 数据 传递 给 通用 寄存 器 ， 要 读 取 特殊 
寄存 器 的 数据 只 能 使 用 MRS 指令 ! 使 用 示例 如 下 : 

MRS R0, CPSR: @ 将 特殊 寄存 器 CPSR 里 面 的 数据 传递 给 RO0， 即 RO=CPSR 

3、MSR 指令 

MSR 指令 和 MRS 刚好 相反 ，MSR 指令 用 来 将 普通 寄存 器 的 数据 传递 给 特殊 寄存 器 ， 也 就 
是 写 特殊 寄存 器 ， 写 特殊 寄存 器 只 能 使 用 MSR， 使 用 示例 如 下 : 

MSRCPSR,RO (Qt RO 中 的 数据 复制 到 CPSR 中 ， 即 CPSR-RO 


























7.2.2 存储 器 访问 指令 

ARM 不 能 直接 访问 存储 器 ， 比 如 RAM 中 的 数据 ，I.MX6UL 中 的 寄存 器 就 是 RAM 类 型 
的 , 我 们 用 汇编 来 配置 IMX6UL 寄存 器 的 时 候 需 要 借助 存储 器 访问 指令 , 一般 先 将 要 配置 的 值 
写 入 到 Rx(x=0~12) 寄 存 器 中 , 然后 借助 存储 器 访问 指令 将 Rx 中 的 数据 写 入 到 IMX6UL 寄存 器 
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中 。 读 取 工 MX6UL 寄存 器 也 是 一 样 的， 只 是 过 程 相 反 。 常 用 的 存储 器 访问 指令 有 两 种 : LDR 和 
STR， 用 法 如 表 7.2.1.2 所 示 ; 














LDR Rd, [Rn , Zoffset] 从 存储 器 Rntoffset 的 位 置 读 取 数 据 存放 到 Rd 中 。 
STR Rd, [Rn, #offset] 将 Rd 中 的 数据 写 入 到 存储 器 中 的 Rntoffset 位 置 。 
表 7.2.1.2 存储 器 访问 指令 

分 别 来 详细 的 介绍 一 下 如 何 使 用 这 两 个 指令 : 

1. LDR 指令 

LDR 主要 用 于 从 存储 加 载 数据 到 寄存 器 Rx 中 ,LDR 也 可 以 将 一 个 立即 数 加 载 到 寄存 器 Rx 
中 ，LDR 加 载 立 即 数 的 时 候 要 使 用 “=” 而 不 是 “#”。 在 嵌入 式 开 发 中 ，LDR 最 常用 的 就 是 读 
取 CPU 的 寄存 器 值 ， 比 如 I.MX6UL 有 个 寄存 器 GPIO1_GDIR， 其 地 址 为 0X0209C004， 我 们 
现在 要 读 取 这 个 寄存 器 中 的 数据 ， 示 例 代码 如 下 : 

示例 代码 7.2.2.1 LDR 指令 使 用 

1 LDR RO0，=0X0209C004 @ 将 寄存 器 地 址 0X0209C004 加 载 到 R0 中 ， 即 RO=0X0209C004 
2 DR RI, IROI] @ 读 取 地 址 oxo209coo4 中 的 数据 到 RI 寄存 器 中 

上 述 代码 就 是 读 取 寄 存 器 GPIO1_ GDIR 中 的 值 ， 读 取 到 的 寄存 器 值 保 存在 R1 寄存 器 中 ， 
上 面 代码 中 offset 是 0， 也 就 是 没有 用 到 offset. 

2、STR 指令 

LDR 是 从 存储 器 读 取 数据 ，STR 就 是 将 数据 写 入 到 存储 器 中 ， 同 样 以 LMX6UL 寄存 器 
GPIO1_GDIR 为 例 ， 现 在 我 们 要 配置 寄存 器 GPIOI. GDIR 的 值 为 0X2000002， 示 例 代码 如 下 : 

示例 代码 7.2.2.2 STR 指令 使 用 

1 LDR RO, s0x0209co04 Q@ 将 寄存 器 地 址 0x0209c004 加 载 到 R0 中 ， 即 ROSOX0209C004 
2 LDR R1, 20X20000002 QR1 保存 要 写 入 到 寄存 器 的 值 ， 即 R1=0X20000002 
> STR R, [RO] @ 将 Ri 中 的 值 写 入 到 RO 中 所 保存 的 地 址 中 

LDR 和 STR 都 是 按照 字 进 行 读 取 和 写 入 的 ， 也 就 是 操作 的 32 位 数据 ， 如 果 要 按照 字 节 、 
半 字 进行 操作 的 话 可 以 在 指令 “LDR” 后 面 加 上 B 或 了 ， 比 如 按 字 节操 作 的 指令 就 是 LDRB 和 
STRB， 按 半 字 操作 的 指令 就 是 LDRH 和 STRH. 
























































7.2.3 压 栈 和 出 栈 指令 


我 们 通常 会 在 A 函数 中 调用 B 函数 ， 当 B 函数 执行 完 以 后 再 回 到 A 函数 继续 执行 。 要 想 
在 跳 回 A 函数 以 后 代码 能 够 接着 正常 运行 , 那 就 必须 在 跳 到 B 函数 之 前 将 当前 处 理 器 状态 保存 
起 来 (就 是 保存 RO-RIS 这 些 寄存 器 值 )， 当 B 函数 执行 完成 以 后 再 用 前 面 保存 的 寄存 器 值 恢复 
RO-RIS5 即 可 。 保存 RO-RIS 寄存 器 的 操作 就 叫做 现场 保护 ,恢复 RORIS 寄存 器 的 操作 就 叫做 
恢复 现场 。 在 进行 现场 保护 的 时 候 需 要 进行 压 栈 (入 栈 ) 操 作 , 恢复 现场 就 要 进行 出 栈 操作 。 压 栈 
的 指令 为 PUSH， 出 栈 的 指令 为 POP，PUSH 和 POP 是 一 种 多 存储 和 多 加 载 指 令 ， 即 可 以 一 次 
操作 多 个 寄存 器 数据 , 他 们 利用 当前 的 栈 指针 SP 来 生成 地 址 , PUSH 和 POP 的 用 法 如 表 7.2.3.1 
所 示 : 















































PUSH <reg list 将 寄存 器 列表 存 入 栈 中 。 
POP <reg list 从 栈 中 恢复 寄存 器 列表 。 
d 7.2.3.1 压 栈 和 出 栈 指令 
假如 我 们 现在 要 将 RO-R3 和 R12 这 5 个 寄存 器 压 栈 ， 当 前 的 SP 指针 指向 0X80000000, 
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处 理 器 的 堆栈 是 向 下 增长 的 ， 使 用 的 汇编 代码 如 下 : 

PUSH (RO-R3, R12} (2f RO-R3 和 R12 压 栈 
压 栈 完成 以 后 的 堆栈 如 图 7.2.3.1 所 示 : 






































一 0X80000000 





OX7FFFFFEC 
P 





co NN 


图 7.2.3.1. 压 栈 以 后 的 堆栈 

图 7.2.3.1 就 是 对 R0~R3,R12 进行 压 栈 以 后 的 堆栈 示意 图 ,此 时 的 SP 指向 了 0X7FFFFFEC， 
假如 我 们 现在 要 再 将 LR 进行 压 栈 ， 汇 编 代码 如 下 : 

PUSH (LR) @ LR 进行 压 栈 

对 LR 进行 压 栈 完成 以 后 的 堆栈 模型 如 图 7.2.3.2 所 示 : 
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图 7.2.3.2 LR 压 栈 以 后 的 堆栈 

















图 7.2.3.2 就 是 分 两 步 对 RO-R3,R2 和 LR 进行 压 栈 以 后 的 堆栈 模型 ， 如 果 我 们 要 出 栈 的 话 
就 是 使 用 如 下 代码 : 

POP {LR} @ 先 恢复 LR 

POP {R0~R3,R12} @ 在 恢复 R0~R3,R12 

出 栈 的 就 是 从 栈 顶 ， 也 就 是 SP 当前 执行 的 位 置 开始 ， 地 址 依次 减 小 来 提取 堆栈 中 的 数据 
到 要 恢复 的 寄存 器 列表 中 。PUSH 和 POP 的 另外 一 种 写法 是 “STMFD SP!" fll *LDMFD SP!”， 
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因此 上 面 的 汇编 代码 可 以 改 为 : 
示例 代码 7.2.3.1 STMFD fe LDMFD 指令 









































1 STMED SP!,{RO~R3, R12} CRO~R3, R12 AJ 
2 STMFD SP!,(LR) CLR 出 栈 
3 
4 LDMFD SP!, (LR) @ 先 恢复 LR 
5 LDMFD SP!, {RO~R3, R12} ”Q@ 在 恢复 RO~R3，R12 
STMFD 可 以 分 为 两 部 分 : STM 和 FD, 同 理 , LDMFD 也 可 以 分 为 LDM 和 FD。 看 到 STM 
和 LDM 有 没有 觉得 似曾相识 (不 是 STM32 啊 啊 啊 啊 )， 前 面 我 们 讲 了 LDR 和 STR， 这 两 个 是 








数据 加 载 和 存储 指令 ， 但 是 每 次 只 能 读 写 存储 器 中 的 一 个 数据 。STM 和 LDM 就 是 多 加 载 和 多 
存储 ， 可 以 连续 的 读 写 存储 器 中 的 多 个 连续 数据 。 

FD 是 Full Descending 的 缩写 ， 即 满 递 减 的 意思 。 根 据 ATPCS 规则 ,ARM 使 用 的 FD 类 型 
的 堆栈 ，SP 指向 最 后 最 后 一 个 入 栈 的 数值 ， 堆 栈 是 由 高 地 址 向 下 增长 的 ， 也 就 是 前 面 说 的 向 下 
增长 的 堆栈 ， 因 此 最 常用 的 指令 就 是 STMFD fll LDMFD. STM 和 LDM 的 指令 寄存 器 列表 中 
编号 小 的 对 应 低地 址 ， 编 号 高 的 对 应 高 地 址 。 


























~ 



































7.2.4 跳 转 指令 


有 多 种 跳 转 操作 ， 比 如 : 

(DD、 直 接 使 用 跳 转 指令 B、BL、BX 等 。 

©, EE PC 寄存 器 里 面 写 入 数据 。 

上 述 两 种 方法 都 可 以 完成 跳 转 操 作 , 但 是 一 般 常用 的 还 是 B. BL È BX, 用 法 如 表 7.2.4.1: 
































跳 转 到 label， 如 果 跳 转 范 围 超过 了 +/-2KB， 可 以 指定 B.W 




















B <label> <label> 使 用 32 位 版 本 的 跳 转 指 令 ， 这 样 可 以 得 到 较 大 范围 的 
跳 转 

BX <Rm> 间接 跳 转 ， 跳 转 到 存放 于 Rm 中 的 地 址 处 ， 并 且 切 换 指令 集 

BL «label 跳 转 到 标号 地 址 ， 并 将 返回 地 址 保存 在 LR 中 。 








结合 BX 和 BL 的 特点 ， 跳 转 到 Rm 指定 的 地 址 ， 并 将 返回 地 
址 保存 在 LR 中 ， 切 换 指令 集 。 
表 7.2.4.1 跳 转 指令 

我 们 重点 来 看 一 下 B 和 BL 指令 ， 因 为 这 两 个 是 我 们 用 的 最 多 的 ， 如 果 要 在 汇编 中 进行 函 
数 调用 使 用 的 就 是 B 和 BL 指令 : 

1、B 指令 

这 是 最 简单 的 跳 转 指令 ，B 指令 会 将 PC 寄存 器 的 值 设置 为 跳 转 目标 地 址 ， 一 旦 执行 B 指 
S, ARM 处 理 器 就 会 立即 跳 转 到 指定 的 目标 地 址 。 如 果 要 调用 的 函数 不 会 再 返回 到 原来 的 执行 
处 ， 那 就 可 以 用 B 指令 ， 如 下 示例 : 
示例 代码 7.2.4.1 B 指令 示例 








BLX <Rm> 


















































1 
2 

3 ldr sp,20x80200000 ”@ 设 置 栈 指针 

1 — b mein @ 跳 转 到 main 函数 

上 述 代 码 就 是 典型 的 在 汇编 中 初始 化 C 运行 环境 , 然后 跳 转 到 C 文件 的 main 函数 中 运行 ， 
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上 述 代码 只 是 初始 化 了 SP 指针 ， 有 些 处 理 器 还 需要 做 其 他 的 初始 化 ， 比 如 初始 化 DDR 等 等 。 
因为 跳 转 到 C 文件 以 后 再 也 不 会 回 到 汇编 了 ， 所 以 在 第 4 行使 用 了 B 指令 来 完成 跳 转 。 

2、BL 指令 

BL 指令 相 比 B 指令 , 在 跳 转 之 前 会 在 寄存 器 LR(R14) 中 保存 当前 PC 寄存 器 值 ， 所 以 可 以 









































通过 将 LR 寄存 器 中 的 值 重 新 加 载 到 PC 中 来 继续 从 跳 转 之 前 的 代码 处 运行 ， 这 是 子 程序 调用 
一 个 基本 但 常用 的 手段 。 比 如 Cortex-A 处 理 器 的 irq 中 断 服 务 函 数 都 是 汇编 写 的 ， 主 要 用 汇编 
来 实现 现场 的 保护 和 恢复 、 获 取 中 断 号 等 。 但 是 具体 的 中 断 处 理 过 程 都 是 C 函数 ， 所 以 就 会 存 
在 汇编 中 调用 C 函数 的 问题 。 而 且 当 C 语言 版 本 的 中 断 处 理 函 数 执行 完成 以 后 是 需要 返回 至 
irq 汇编 中 断 服务 函数 ， 因 为 还 要 处 理 其 他 的 工作 ， 一 般 是 恢复 现场 。 这 个 时 候 就 不 能 直接 使 用 
B 指令 了 , 因为 B 指令 一 旦 跳 转 就 再 也 不 会 回来 了 , 这 个 时 候 要 使 用 BL 指令 , 如 是 示例 代码 : 
示例 代码 7.2.4.2 BL 指令 示例 















































一 



































1 pusa fix. sen @ 保 存 r0, r1 

2 cps #0x13 @ 进 入 svc 模式 ， 人 允许 其 他 中 断 再 次 进去 
3 

5 bl system irghandler @ 加 载 C 语言 中 断 处 理 函 数 到 v2 寄存 器 中 
6 

7 cps #0x12 @ 进 入 IRQ 模式 

$ jx (0, se 

So str 0, izi, 40710] @ 中 断 执行 完成 ， 写 EOIR 














上 上述 代码 中 第 5 行 就 是 执行 C 语言 版 的 中 断 处 理 函 数 ， 当 处 理 完成 以 后 是 需要 返回 来 继续 
执行 下 面 的 程序 ， 所 以 使 用 了 BL 指令 。 








72.5 算术 运算 指令 

汇编 中 也 可 以 进行 算术 运算 ， 比如 加 
ADD Rd, Rn, Rm 
ADD Rd, Rn, #immed | Rd= Rn + #immed 






































减 乘除 ， 常 用 的 运算 指令 用 法 如 表 7.2.5.1 所 示 : 


pav 














加 法 运算 ， 指 令 为 ADD 
































ADC Rd, Rn, Rm Rd- Rn + Rm + 进位 
i" mes 带 进位 的 加 法 运算 ， 指 令 为 ADC 
ADC Rd, Rn, Zimmed | Rd= Rn + Zimmed 二 进位 T Har 
SUB Rd, Rn, Rm Rd- Rn- Rm 
SUB Rd, Zimmed Rd 7 Rd - Zimmed 减法 





SUB Rd, Rn, #immed Rd = Rn - £immed 
SBC Rd, Rn, Zimmed | Rd= Rn- Zimmed 一 借 位 















































SBC Rd, Rn ,Rm Rd-Rn- Rm- 借 位 人 
MUL Rd, Rn, Rm Rd- Rn * Rm 乘法 (32 位 ) 
UDIV Rd, Rn, Rm Rd-Rn/Rm 无 符号 除法 
SDIV Rd, Rn, Rm Rd-Rn/Rm 有 符号 除法 








表 7.2.5.1 常用 运算 指令 














在 嵌入 式 开 发 中 最 常会 用 的 就 是 加 减 指 令 ， 乘 除 基 本 用 不 到 。 
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72.6 逻辑 运算 指令 


我 们 用 C 语言 进行 CPU 寄存 器 配置 的 时 候 常 











论坛 :Www.opendev.com 


常 需 要 用 到 逻辑 运算 符号 ， 比如 ER” gg 等 





逻辑 运算 符 。 使 用 汇编 语言 的 时 候 也 可 以 使 用 逻辑 运算 指令 ,常用 的 运算 指令 用 法 如 表 7.2.6.1 














所 示 : 





AND Rd, Rn 


Rd= Rd &Rn 
























































AND Rd, Rn, Zimmed | Rd = Rn &Zimmed 按 位 与 
AND Rd, Rn, Rm Rd= Rn & Rm 

ORR Rd, Rn Rd=Rd|Rn 

ORR Rd, Rn, Zimmed | Rd= Rn | Zimmed 按 位 或 
ORR Rd, Rn, Rm Rd-Rn|Rm 

BIC Rd, Rn Rd= Rd & (-Rn) 

BIC Rd, Rn, Zimmed Rd = Rn & (-Zimmed) 位 清除 
BIC Rd, Rn, Rm Rd= Rn & (-Rm) 

ORN Rd, Rn, #immed Rd = Rn | (wZimmed) 校 位 或 非 
ORN Rd, Rn, Rm Rd= Rn | (wRm) 

EOR Rd, Rn Rd= Rd^ Rn 

EOR Rd, Rn, Zimmed | Rd- Rn | Zimmed 按 位 异 或 
EOR Rd, Rn, Rm Rd=Rn|Rm 

















ARM 汇编 就 讲解 到 这 里 ， 本 节 主 要 计 





K 7.2.6.1 逻辑 运算 指令 
逻辑 运算 指令 都 很 好 理解 ， 后 面 时 候 汇 编 配 置 LMX6UL 的 外 设 寄存 器 的 时 候 可 能 会 用 到 ， 


















































F 解 了 一 些 最 常用 的 指令 ， 还 有 很 多 不 常用 的 指令 没有 讲 
解 ， 但 是 够 我 们 后 续 学 习 用 了 。 要 想 详细 的 学 习 ARM 的 所 有 指令 请 参考 《ARM 
ArchitectureReference Manual ARMv7-A and ARMv7-R edition.pdf》 和 《ARM Cortex-A(armV7) 编 
程 手册 V4.0.pdf》 这 两 份 文档 。 
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第 八 章 汇编 LED 灯 试 验 


本 章 开始 编写 本 教程 第 一 个 裸 机 例 程 一 一 经 典 的 点 灯 试 验 ， 这 也 是 我 们 租 入 式 Linux 学 习 








的 第 一 步 。 本 章 使 用 汇编 语言 来 编写 ， 通 过 本 章 了 解 如 何 使 用 汇编 语言 来 初始 化 IMX6U 外 设 
寄存 器 、 了 解 LMX6UL 最 基本 的 IO 输出 功能 。 万 里 长 征 第 一 步 ， 祝 愿 大 家 学 习 愉 快 ! 
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8.1 LMX6U GPIO 详解 


8.1.1 STM32 GPIO 回顾 


我 们 一 般 拿 到 一 款 全 新 的 芯片 ， 第 一 个 要 做 的 事情 的 就 是 驱动 其 GPIO， 控 制 其 GPIO 输 
出 高 低 电 平 ， 我 们 学 习 IMX6U 也 一 样 的 ， 先 来 学 习 一 下 IMX6U 的 GPIO。 在 学 习 IMX6U 
的 GPIO 之 前 ， 我 们 先 来 回顾 一 下 STM32 的 GPIO 初始 化 (如 果 没 有 学 过 STM32 就 不 用 回顾 
了 )， 我 们 以 最 常见 的 STM32F103 为 例 来 看 一 下 STM32 的 GPIO 初始 化 ， 示 例 代码 如 下 : 
示例 代码 8.1.1.1 STM32 GPIO 初始 化 
void LED Init (void) 
( 
GPIO InitTypeDet GPIO Initgtructure,; 


































































































GPIO InitStructure.GPIO Pin = GPIO Pin 5; //PB5 端口 配置 
GPIO InitStructure.GPIO Mode = GPIO Mode Out PP; // 推 挽 得 出 
GPTO InitStructure.CPITO Speed = GPIO Speed UNMRz p //10 口 速度 
10 GPIO Init(GPIOB, &GPIO InitStructure); // 根 据 设 定 参数 初始 化 GPIOB .5 
11 


1 
2 
3 
4 
5 RCC APB2PeriphClockCmd(RCC APB2Periph GPIOB, ENABLE) ;// 使 能 PB 端口 时 钟 
6 
7 
8 
9 


12 GPIO SetBits(GPIOB,GPIO Pin 5); //PB.5 输出 高 

13 } 

上 述 代码 就 是 使 用 库 函 数 来 初始 化 STM32 的 一 个 IO 为 输出 功能 ， 可 以 看 出 上 述 初始 化 代 

重点 要 做 的 事情 有 一 下 几 个: 

Q、 使 能 指定 GPIO 的 时 钟 。 

名 、 初 始 化 GPIO， 比 如 输出 功能 、 上 拉 、 速 度 等 等 。 

©, STM32 有 的 IO 可 以 作为 其 它 外 设 引 脚 ， 也 就 是 IO 复 用 ， 如 果 要 将 IO 作为 其 它 外 设 

引 脚 使 用 的 话 就 需要 设置 IO 的 复 用 功能 。 
©, RERA GPIO 输出 高 电 平 或 者 低 电 平 。 

STM32 的 GPIO 初始 化 就 是 以 上 四 步 ， 那 么 会 不 会 也 适用 于 LMX6U 的 呢 ? LMX6U 的 
GPIO 是 不 是 也 需要 开启 相应 的 时 钟 ?是 不 是 也 可 以 设置 复 用 功能 ?是 不 是 也 可 以 设置 输出 或 
输入 、 上 下 拉 、 速 度 等 等 这 些 ? 我 们 现在 都 不 知道 ， 只 有 去 看 ILMX6U 的 数据 手册 和 参考 手册 
才能 知道 ，LMX6U 的 数据 手册 和 参考 手册 我 们 已 经 放 到 了 开发 板 光 盘 中 了 ，LMX6U 有 
I.MX6UL 和 I.MX6ULL 两 种 ,这 两 种 型 号 基本 是 一 样 的 ,我 们 以 IMX6UL 为 例 来 讲解 .LMX6UL 
的 参考 手册 路 径 为 : 开发 板 光盘 ->1、LMX6UL 芯片 资料 ->IMX6UL 参考 手册 .pdf, I.MX6UL 的 
数据 手册 有 三 种 ， 分 别 对 应 : 车 规 级 、 工 业 级 和 商用 级 。 从 我 们 写 代码 的 角度 看 ， 这 三 份 数据 
手册 一 模 一 样 的 ， 做 硬件 的 在 选 型 的 时 候 才 需要 注意 一 下 ， 我 们 就 用 商用 级 的 手册 ， 商 用 级 数 
据 手册 路 径 为 : 开发 板 光 盘 ->1、LMX6UL 芯片 资料 ->IMX6UL 数据 手册 (商用 级 )pdf。 带 着 上 面 
四 个 疑问 打开 这 两 份 手册 ， 然 后 就 是 “ 哺 ” 手 册 。 














f 




































































































































































8.1.2 LMX6U IO 命名 





STM32 中 的 IO 都 是 PA0~15、PB0~15 这 样 命名 的 ，I.MX6U 的 IO 是 怎么 命名 的 呢 ? 打开 
LMX6UL 参考 手册 的 第 30 章 “Chapter 30: IOMUX ControllerIOMUXC)” 第 30 章 的 书签 如 图 
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8.1.2.1 所 示 : 
- A Chapter 30: IOMUX Controller (IOMUXC) 
由 -内 Overview 
JR clocks 
JR Functional description 


* 由 IOMUXC GPR Memory Map/Register Definition 
= 由 IOMUXC Memory Map/Register Definition 
5- romuxc 

A IOMUXC SW MUX CTL PAD BOOT MODEO 

J IOMUXC_SW_MUX_CTL_PAD_BOOT_MODE1 
IOMUXC_SW_MUX_CTL_PAD_SNVS_TAMPERO 
IOMUXC_SW_MUX_CTL_PAD_SNVS_TAMPER1 
IOMUXC_SW_MUX_CTL_PAD_SNVS_TAMPER2 
IOMUXC_SW_MUX_CTL_PAD_SNVS_TAMPER3 
IOMUXC_SW_MUX_CTL_PAD_SNVS_TAMPER4 
IOMUXC_SW_MUX_CTL_PAD_SNVS_TAMPER5 
IOMUXC_SW_MUX_CTL_PAD_SNVS_TAMPER6 
IOMUXC_SW_MUX_CTL_PAD_SNVS_TAMPER7 
IOMUXC SW MUX CTL PAD SNVS TAMPER8 
IOMUXC SW MUX CTL PAD SNVS TAMPER9 
IOMUXC SW MUX CTL PAD JTAG MOD 
IOMUXC SW MUX CTL PAD JTAG TMS 
IOMUXC SW MUX CTL PAD JTAG TDO 
IOMUXC SW MUX CTL PAD JTAG TDI 
IOMUXC SW MUX CTL PAD JTAG TCK 
IOMUXC SW MUX CTL PAD JTAG TRST B 
IOMUXC SW MUX CTL PAD GPIO1 IO00 
IOMUXC SW MUX CTL PAD GPIO1 IOO1 
IOMUXC SW MUX CTL PAD GPIO1 IO02 
IOMUXC SW MUX CTL PAD GPIO1 I1O03 
IOMUXC SW MUX CTL PAD GPIO1 IO04 
IOMUXC SW MUX CTL PAD GPIO1 IO05 
IOMUXC SW MUX CTL PAD GPIO1 IO06 
IOMUXC SW MUX CTL PAD GPIO1 IO07 
IOMUXC SW MUX CTL PAD GPIO1 IO08 
IOMUXC SW MUX CTL PAD GPIO1 IO09 
IOMUXC SW MUX CTL PAD UART1 TX DATA 
A IOMUXC_SW_MUX_CTL_PAD_UART1_RX_DATA 


图 8.1.2.1 LMX6U GPIO 命名 




















220 2020 3020 20204 3020 0203020020430 3020 02 3023020302 02 020202 0 RR RR RR 





8.12.1 中 的 形 如 “IOMUXC SW MUC CTL PAD GPIOI I000” 的 就 是 GPIO 命名 , d 
*[OMUXC SW MUC CTL PAD XX XX", 后 面 的 “XX XX” 就 是 GPIO 命名 ， 
比如 : GPIO1 IO01, UARTI TX DATA, JTAG MOD. SNVS TAMPERI 等 等 .LMX6U 的 GPIO 
并 不 像 STM32 一 样 以 PA0~15 这 样 命名 ， 他 是 根据 某 个 IO 所 拥有 的 功能 来 命名 的 。 比 如 我 们 


名 形式 就 是 


一 看 到 GPIO1_IO01 就 知道 这 个 肯定 能 做 GPIO， 看 到 UARTI TX DATA FH 
肯定 能 做 为 UART1 的 发 送 引 脚 。 





























肯定 就 知道 这 个 IO 


“Chapter 30: IOMUX ControllerIOMUXC)” 这 一 章 列 出 了 





LMX6U 的 所 有 IO， 如 果 你 找 遍 第 30 章 的 书签 ， 你 会 发 现 貌 似 GPIO 只 有 
GPIO1 IO00~GPIO_IO09, 难道 IMX6U 的 GPIO 只 有 这 10 个? 显然 不 是 的 ， 
的 很 多 IO 是 可 以 复 用 为 其 它 功 能 的 ， 那 么 IMX6U 的 其 它 IO 也 是 可 以 复 月 
样 的 ，GFPIO1 IO00~GPIO_IO09 也 是 可 以 复 用 为 其 它 外 设 引 脚 的 ， 接 下 来 








我 们 知道 STM32 
HX GPIO 功能 。 同 
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用 。 


8.1.3 LMX6U IO 复 用 


以 IO *WIOMUXC SW MUX CTL PAD GPIOI IO00” 为 例 ， 打 开 人 参考 手册 的 1329 页 ， 如 
图 8.1.3.1 所 示 : 


30.5.19 SW MUX CTL PAD GPIO1 IO00 SW MUX Control 
Register (IOMUXC SW MUX CTL PAD GPIO1 1OO00) 


SW MUX CTL Register 





Address: 20E 0000h base + 5Ch offset = 20E 005Ch 

Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 

R 

aooo Rd SOS 
Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 


Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 1 
IOMUXC SW MUX CTL PAD GPIO1 1OO0 field descriptions 
Z e 














31-5 This field is reserved. 

- Reserved 

4 Software Input On Field. 
SION 


Force the selected mux mode Input path no matter of MUX_MODE functionality. 


1 ENABLED — Force input path of pad GPIO1 IOO0 
0 DISABLED — Input Path is determined by functionality 
MUX MODE  |MUX Mode Select Field. 


Select 1 of 9 iomux modes to be used for pad: GPIO1 1OO0. 


0000 ALTO — Select mux mode: ALTO mux port: I2C2 SCL of instance: i2c2 

0001  ALT1 — Select mux mode: ALT1 mux port: GPT1 CAPTURE!1 of instance: gpt1 

0010  ALT2 — Select mux mode: ALT2 mux port: ANATOP OTG1 ID of instance: anatop 
0011  ALT3 — Select mux mode: ALT3 mux port: ENET1 REF CLK1 of instance: enet1 

0100 ALTA — Select mux mode: ALT4 mux port: MQS RIGHT of instance: mqs 

0101  ALT5 — Select mux mode: ALT5 mux port: GPIO1 1OO0 of instance: gpio1 

0110  ALT6 — Select mux mode: ALT6 mux port: ENET1 1588 EVENTO IN of instance: enet1 
0111  ALT7 — Select mux mode: ALT7 mux port: SRC SYSTEM RESET of instance: src 
1000 ALTS8 — Select mux mode: ALT8 mux port: WDOG3 WDOG B of instance: wdog3 








8.1.3.1 GPIO1 IO00 复 用 

从 图 8.1.3.1. 可 以 看 到 有 个 名 为 : IOMUXC SW MUX CTL PAD GPIOI 1000 的 寄存 器 ， 
寄存 器 地 址 为 0X020E005C， 这 个 寄存 器 是 32 位 的 ， 但 是 只 用 到 了 最 低 5 位 ， 其 中 
bit0~bit3(MUX_MODE) 就 是 设置 GPIO1 IO00 的 复 用 功能 的 。GPIO1_IO00 一 共 可 以 复 用 为 9 
种 功能 IO， 分 别 对 应 ALT0~ALT8， 其 中 ALTS 就 是 作为 GPIO1_ I000. GPIOI IO00 还 可 以 作 
为 12C2 SCL、GPT1 CAPTURE1、ANATOP OTGI ID 等 。 这 个 就 是 LMX6U 的 IO 复 用 ， 我 
们 学 习 STM32 的 时 候 STM32 的 GPIO 也 是 可 以 复 用 的 。 
在 来 看 一 个 “IOMUXC SW MUX CTL PAD UARTI TX DATA" XÑ IO, 3X^* IO 对 应 
的 复 用 如 图 8.1.3.2 所 示 : 
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30.5.27 SW MUX CTL PAD GPIO1 1I008 SW MUX Control 
Register (IOMUXC SW MUX CTL PAD GPIO1 1008) 


SW MUX CTL Register 


Address: 20E 0000h base + 7Ch offset = 20E 007Ch 


Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
R 
W 


Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 





Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
R 
W 


Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 3 





This field is reserved. 
Reserved 


Software Input On Field. 
Force the selected mux mode Input path no matter of MUX MODE functionality. 


1 ENABLED — Force input path of pad GPIO1 1O08 
0 DISABLED — Input Path is determined by functionality 


MUX Mode Select Field. 





MUX MODE 
Select 1 of 9 iomux modes to be used for pad: GPIO1 1OO08. 


0000 ALTO 一 Select mux mode: ALTO mux port: PWM1. OUT of instance: pwm1 
0001  ALT1 — Select mux mode: ALT1 mux port: WDOG1. WDOG B of instance: wdog1 
0010  ALT2 — Select mux mode: ALT2 mux port: SPDIF OUT of instance: spdif 
0011  ALTS3 — Select mux mode: ALT3 mux port: CSI VSYNC of instance: csi 
0100 ALT4 — Select mux mode: ALT4 mux port: USDHC2 VSELECT of instance: usdhc2 
0101  ALT5 — Select mux mode: ALT5 mux port: GPIO1 1O08 of instance: gpio1 
0110  ALT6 — Select mux mode: ALT6 mux port: CCM PMIC  RDY of instance: ccm 
1000 ALTS8 — Select mux mode: ALT8 mux port: UART5 RTS B of instance: uart5 
图 8.1.3.2UARTI TX DATA IO & Hi 

同样 的 ， 从 图 8.1.3.2 可 以 看 出 ，UART1 TX DATA 可 以 复 用 为 7 种 不 同 功能 的 IO， 分 为 
ALTO-ALTS 和 ALT8， 其 中 ALTS 表示 UART1_TX_DATA 可 以 复 用 为 GPIO1 IO16。 
由 此 可 见 ，LMX6U 的 GPIO 不 止 GPIO1 IO00~GPIO1 IO09 这 10 个 , 其 它 的 IO 都 可 以 复 
用 为 GPIO 来 使 用 。LMX6U 的 GPIO 一 共有 5 组: GPIO1、GPIO2、GPIO3、GPIO4 和 GPIOS, 
其 中 GPIO1 有 32 个 IO，GPIO2 有 22 个 IO，GPIO3 有 29 个 IO、GPIO4 有 29 ^* IO, GPIOS 
最 少 ， 只 有 12 个 IO， 这样 一 共有 124 个 GPIO。 如 果 只 想 看 每 个 IO 能 复 用 什么 外 设 的 话 可 以 
直接 查阅 《IMX6UL 参考 手册 》 的 第 4 章 “Chapter 4 External Signals and Pin Multiplexing”。 如 
果 我 们 要 编写 代码 ， 设 置 某 个 IO 的 复 用 功能 的 话 就 需要 查阅 第 30 章 “Chapter 30: IOMUX 
ControllerIOMUXC)”, 第 30 章 详 细 的 列 出 了 所 有 IO 对 应 的 复 用 配置 寄存 器 。 

至 此 我 们 就 解决 了 8.1.1 中 的 第 3 个 疑问 , 那 就 是 LMX6U 的 IO 是 有 复 用 功能 的 , 和 STM32 
一 样 ， 如 果 某 个 IO 要 作为 某 个 外 设 引 脚 使 用 的 话 ， 是 需要 配置 复 用 寄存 器 的 。 
















































































8.1.4 LMX6U IO 配置 


细心 的 读者 应 该 会 发 现在 《LMX6UL 参考 手册 》 第 30 3& " Chapter 30: IOMUX 
ControllerIOMUXC)” 的 书签 中 ， 每 一 个 IO 会 出 现 两 次 ， 它 们 的 名 字 差 别 很 小 ， 不 仔细 看 就 看 
不 出 来 ， 比 如 GPIO1 1000 有 如 下 两 个 书签 : 
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IOMUXC SW. MUX CTL PAD GPIOI IO00 
IOMUXC SW PAD CTL PAD GPIOI IO00 
上 面 两 个 都 是 跟 GPIO I1O00 有 关 的 寄存 器 , 名 字 上 的 区 别 就 是 红色 部 分 , 一 个 是 ^MUX?” 








一 个 是 “PAD”。IOMUX SW MUX CTL PAD GPIOI 1000 我 们 前 面 已 经 说 了 ， 是 用 来 配置 

GPIO1 IO00 复 用 功能 的 , 那么 IOMUXC SW PAD CTL PAD GPIOI 1000 是 做 什么 的 呢 ? dX 

到 这 个 书签 对 应 的 1582 页 ， 如 图 8.1.4.1 所 示 : 

30.5.182 SW PAD CTL PAD GPIO1 IO00 SW PAD Control 
Register (IOMUXC SW PAD CTL PAD GPIO1 1OO00) 


SW PAD CTL Register 








Address: 20E 0000h base + 2E8h offset = 20E 02bE8h 


Bit 
R 














w 

Reset 
Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
R| PUS | PUE | PKE | ODE SPEED | DSE SRE 











Reset 0 0 0 1 0 0 0 0 1 0 1 1 0 0 0 0 


IOMUXC SW PAD CTL PAD GPIO1 1OO0 field descriptions 


Description 








31-17 This field is reserved. 
- Reserved 
16 Hyst. Enable Field 
HYS 
Select one out of next values for pad: GPIO1 1OO00 
0 HYS 0 Hysteresis Disabled 一 Hysteresis Disabled 
1 HYS 1 Hysteresis Enabled — Hysteresis Enabled 
15-14 Pull Up / Down Config. Field 
PUS 


Select one out of next values for pad: GPIO1 1OO0 


00 PUS 0 100K Ohm Pull Down — 100K Ohm Pull Down 
01 PUS 1 47K Ohm Pull Up — 47K Ohm Pull Up 

10 PUS 2 100K Ohm Pull Up — 100K Ohm Pull Up 

11 PUS 3 22K Ohm Pull Up — 22K Ohm Pull Up 


8.1.4.1] IOMUXC SW PAD CTL PAD GPIOI 1000 寄存 器 
从 图 8.1.4.1 中 可 以 看 出 ，IOMUXC SW PAD CTL PAD GPIOI 1000 也 是 个 寄存 器 ， 寄 
存 器 地 址 为 0X020E02E8。 这 也 是 个 32 位 寄存 器 ， 但 是 只 用 到 了 其 中 的 低 17 位 ， 在 看 这 写 位 
具体 含义 之 前 ， 先 来 看 一 下 图 8.1.4.2 所 示 的 GPIO 功能 
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output buffer enable (OBE) 






论坛 :www.opendev.com 








PAD 
DSE Output < 
Driver LN 
SRE 
Driver PUS 
SPEED | Config 
Logic 
ODE Noo Resd 
PU / PD / Keeper 
PKE - Logic 
D pull_en_b 
input buffer enable (IBE) 
IND Pa 
ss 
ri Input ES 
o<] Receiver esd clamp or 
HYS trigger circuit 
图 8.1.4.2 GPIO 功能 
我 们 对 照 着 图 8.1.4.2 来 详细 看 一 下 寄存 器 IOMUXC SW PAD CTL PAD GPIOI IO00 的 
各 个 位 的 含义 


HYS(bit16): 对 应 图 8.1.4.2 中 HYS， 用 来 使 能 迟滞 比较 器 ， 当 IO 作为 输入 功能 的 时 候 有 





















































效 ， 用 于 设置 输入 接收 器 的 施 密 特 触发 器 是 否 使 能 。 如 果 需 要 对 输入 波形 进行 整形 的 话 可 以 使 
能 此 位 。 此 位 为 0 的 时 候 禁止 迟滞 比较 器 ， 为 1 的 时 候 使 能 迟滞 比较 器 。 
PUS(bit15:14): 对 应 图 8.1.4.2 中 的 PUS， 用 来 设置 上 下 拉 电 阻 的 ， 一 共有 四 种 选项 可 以 选 
择 ， 如 表 8.1.4.1 所 示 : 
00 100K 下 拉 
01 471K 上 拉 
10 100K 上 拉 
11 22K Li 
表 8.1.4.1 上 下 拉 设 置 
PUE(bit13): 图 8.1.4.2 没有 给 出 来 ， 当 IO 作为 输入 的 时 候 ， 这 个 位 用 来 设置 IO 使 用 上 下 











拉 还 是 状态 保持 器 。 当 为 0 的 时 候 使 用 状态 保持 器 ， 当 为 1 的 时 
IO 作为 输入 的 时 候 才 有 用 ， 故 名 思 意 ， 


dx 


A o 

















PKE(bit12): 对 应 图 8.1.4.2 中 的 PKE， 此 为 用 来 使 能 
0 时 禁止 上 下 拉 / 状 态 保持 器 ， 为 1 时 使 能 上 下 拉 和 状态 保持 器 。 
ODE(bit11): 对 应 图 8.1.4.2 中 的 ODE， 当 IO 作为 输 
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革 使 用 上 下 拉 。 状 态 保持 器 在 
就 是 当 外 部 电路 断 电 以 后 此 IO 口 可 以 保持 住 以 前 的 状 





或 者 禁止 上 下 拉 / 状 态 保持 器 功能 ， 为 


出 的 时 候 ， 此 位 用 来 禁止 或 者 使 能 
路 输出 ， 此 位 为 0 的 时 候 禁 止 开路 输出 ， 当 此 位 为 1 的 时 候 就 使 能 开路 输 





功能 


LMX6U 嵌入 式 Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


SPEED(bit7:6): 对 应 图 8.1.4.2 中 的 SPEED， 当 IO 用 作 输 出 的 时 候 ， 此 位 用 来 设置 IO 速 
度 ， 设 置 如 表 8.1.4.2 所 示 : 























00 低速 50M 

01 中 速 100M 

10 中 速 100M 

11 最 大 速度 200M 








表 8.1.4.2 速度 配置 
DSE(bit5:3): 对 应 图 8.1.4.2 中 的 DSE， 当 IO 用 作 输 出 的 时 候 用 来 设置 IO 的 驱动 能 力 ， 
总 共有 8 个 可 选 选项 ， 如 表 8.1.4.3 所 示 : 






































000 输出 驱动 关闭 

001 R0(G3.3V 下 R0 是 260Q，1.8V 下 R0 是 1308， 接 DDR 的 时 候 是 2409) 
010 R0/2 

011 R0/3 

100 R0/4 

101 R0/5 

110 R0/6 

111 R0/7 














K 8.1.4.3. 驱动 能 力 设置 

SRE(bit0): 对 应 图 8.1.4.2 中 的 SRE， 设 置 压 摆 率 ， 当 此 位 为 0 的 时 候 是 低压 摆 率 ， 当 为 1 
的 时 候 是 高 压 摆 率 。 这 里 的 压 摆 率 就 是 IO 电 平 跳 变 所 需要 的 时 间 ， 比 如 从 0 到 1 需要 多 少时 
间 ， 时 间 越 小 波形 就 越 陡 ， 说 明 压 摆 率 越 高 ， 反之， 时 间 越 多 波形 就 越 缓 ， 压 摆 率 就 越 低 。 如 
果 你 的 产品 要 过 EMC 的 话 那 就 可 以 使 用 小 的 压 摆 率 ， 因 为 波形 缓和 ， 如 果 你 当前 所 使 用 的 IO 
做 高 速 通信 的 话 就 可 以 使 用 高 压 摆 率 。 

通过 上 面 的 介绍 ， 可 以 看 出 寄存 器 IOMUXC SW PAD CTL PAD GPIOI IO00 是 用 来 配 
置 GPIO1_IO00 的 ， 包 括 速度 设置 、 驱 动能 力 设 置 、 压 摆 率 设置 等 等 。 至 此 我 们 就 解决 了 8.1.1 
中 的 第 2 个 疑问 ， 那 就 是 LMX6U 的 IO 是 可 以 设置 速度 的 、 而 且 比 STM32 的 设置 要 更 多 。 但 
是 我 们 没有 看 到 如 何 设置 IO 为 输入 还 是 输出 ? IO 的 默认 电 平 如 何 设置 等 等 ， 所 以 我 们 接着 继 






















































































8.1.5 LMX6U GPIO 配置 


IOMUXC SW MUX CTL PAD XX XX 和 IOMUXC SW PAD CTL PAD XX XX 这 两 
种 寄存 器 都 是 配置 IO 的 , 注意 是 IO! 不 是 GPIO, GPIO 是 一 个 IO 众多 复 用 功能 中 的 一 种 。 比 
如 GPIOI 1000 这 个 IO 可 以 复 用 为 : PC2 SCL, GPTI CAPTURE1、ANATOP OTGI ID. 
ENET1 REF CLK 、 MQS RIGHT 、  GPIOI IO00 、 ENET1 1588 EVENTO IN 
SRC SYSTEM RESET 和 WDOG3 WDOG B 这 9 个 功能 ，GPIO1 IO00 是 其 中 的 一 种 ， 我 们 
想 要 把 GPIO1_IO00 用 作 哪 个 外 设 就 复 用 为 哪个 外 设 功能 即 可 。 如 果 我 们 要 用 GPIO1_IO00 来 
点 个 灯 、 作 为 按键 输入 啥 的 就 是 使 用 其 GPIO( 通 用 输入 输出 ) 的 功能 。 将 其 复 用 为 GPIO 以 后 还 
需要 对 其 GPIO 的 功能 进行 配置 ， 关 于 LMX6U 的 GPIO 请 参考 《IMX6UL 参考 手册 》 的 第 26 
章 “Chapter 26 General Purpose Input/Ouput(GPIO)", GPIO 结构 如 图 8.1.5.1 所 示 : 
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Block 


This block not 


configured as a GPIO 






IOMUX 
GPIO.DR input on 
GPIO.GDIR or J 
GPIO.PSR 
[Das oi A 
GPIOICR1 — GPIO.ICR2 KDaa in ^ r4 
GPIO.EDGE. SEL PAD1 
GPIO.IMR 
GPIO.ISR 
IOMUXC alternate input 
SW MUX CTL PAD * 
SW PAD CTL PAD * 
pad settings 
IOMUX input on 


图 8.1.5.1 GPIO 结构 图 
在 图 8.1.5.1 的 左下 角 的 IOMUXC 框图 里 面 就 有 SW MUX CTL PAD * 和 
SW PAD CTL PAD * 两 种 寄存 器 。 这 两 种 寄存 器 前 面 说 了 用 来 设置 IO 的 复 用 功能 和 IO 属性 
配置 .左上 角 部 分 的 GPIO 框图 就 是 , 当 IO 用 作 GPIO 的 时 候 需 要 设置 的 寄存 器 , 一 共有 八 个 : 
DR、GDIR、PSR、ICR1、ICR2、EDGE SEL. IMR 和 ISR。 前 面 我 们 说 了 LMX6U 一 共有 
GPIO1-GPIOS5 共 五 组 GPIO， 每 组 GPIO 都 有 这 8 个 寄存 器 。 我 们 来 看 一 下 这 8 个 寄存 器 都 是 
什么 含义 。 
首先 来 看 一 下 DR 寄存 器 ， 此 寄存 器 是 数据 寄存 器 ， 结 构图 如 图 8.1.5.2 所 示 : 


Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16|15 14 13 12 1! 10 9 8 7 6 5 4 3 2 1 0 
















































































R 
w DR 
Rst0.0.00000000000000j0000000000000000 


GPIOx DR field descriptions 


[er Demi 





DR Data bits. This register defines the value of the GPIO output when the signal is configured as an output 
(GDIR[n]21). Writes to this register are stored in a register. Reading GPIO DR returns the value stored in 
the register if the signal is configured as an output (GDIR[n]-1), or the input signal's value if configured as 
an input (GDIR[n]-O). 


NOTE: The I/O multiplexer must be configured to GPIO mode for the GPIO DR value to connect with the 
signal. Reading the data register with the input path disabled always returns a zero value. 
8.1.5.2 DR 寄存 器 结构 图 
此 寄存 器 是 32 位 的 ， 一 个 GPIO 组 最 大 只 有 32 个 IO， 因 此 DR 寄存 器 中 的 每 个 位 都 对 应 
一 个 GPIO。 当 GPIO 被 配置 为 输出 功能 以 后 ， 向 指定 的 位 写 入 数据 那么 相应 的 IO 就 会 输出 相 
应 的 高 低 电 平 ， 比 如 要 设置 GPIO1_IO00 输出 高 电 平 ， 那 么 就 应 该 设置 GPIO1.DR=1。 当 GPIO 
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被 配置 为 输入 模式 以 后 , 此 寄存 器 就 保存 着 对 应 IO 的 电 平 值 , 每 个 位 对 对 应 一 个 GPIO, 例如 ， 














当 GPIOI IO00 这 个 引 脚 接地 的 话 ， 那 么 GPIO1.DR 的 bito 就 是 0。 

看 完 DR 寄存 器 ， 接 着 看 GDIR 寄存 器 ， 这 是 方向 寄存 器 ， 用 来 设置 某 个 GPIO 的 工作 方 
向 的 ， 即 输入 /输出 ，GDIR 寄存 器 结构 如 图 8.1.5.3 所 示 : 
Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16|15 14 13 12 11 109 8 7 6 5 4 3 2 1 0 
wi GDIR | 
Rsec00000000000000000000000000000000 


GPIOx GDIR field descriptions 

















| Fea | Dewtpion | 


GDIR GPIO direction bits. Bit n of this register defines the direction of the GPIO[n] signal. 


NOTE: GPIO GDIR affects only the direction of the VO signal when the corresponding bit in the I/O MUX 
is configured for GPIO. 


0 INPUT — GPIO is configured as input. 
1 OUTPUT — GPIO is configured as output. 





图 8.1.5.3 GDIR 寄存 器 
GDIR 寄存 器 也 是 32 位 的 ， 此 寄存 器 用 来 设置 某 个 IO 的 工作 方向 ， 是 输入 还 是 输出 。 同 
样 的 ， 每 个 IO 对 应 一 个 位 ， 如 果 要 设置 GPIO 为 输入 的 话 就 设置 相应 的 位 为 0， 如 果 要 设置 为 
输出 的 话 就 设置 为 1。 比 如 要 设置 GPIO1 IO00 为 输入 ， 那 么 GPIOI.GDIR-0; 
接 下 来 看 PSR 寄存 器 ， 这 是 GPIO 状态 寄存 器 ， 如 图 8.1.5.4 所 示 : 


Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16|15 14 13 12 1! 10 9 8 7 6 5 4 3 2 1-0 











R PSR 





Rst:0000000000000000/0000000000000000 
GPIOx PSR field descriptions 


[= Fed jl 0 Desmrpon ooo 


GPIO pad status bits (status bits). Reading GPIO PSR returns the state of the corresponding input signal. 
Settings: 


NOTE: The IOMUXC must be configured to GPIO mode for GPIO PSR to reflect the state of the 
corresponding signal. 


图 8.1.5.4 PSR 状态 寄存 器 
同样 的 PSR 寄存 器 也 是 一 个 GPIO 对 应 一 个 位 ， 读 取 相 应 的 位 即 可 获取 对 应 的 GPIO 的 状 
态 ， 也 就 是 GPIO 的 高 低 电 平 值 。 功 能 和 输入 状态 下 的 DR 寄存 器 一 样 。 
接 下 来 看 ICR1 和 ICR2 这 两 个 寄存 器 , 都 是 中 断 控 制 寄 存 器 ,ICR1 用 于 配置 低 16 个 GPIO, 
ICR2 用 于 配置 高 16 个 GPIO，ICR1 寄存 器 如 图 8.1.5.5 所 示 : 
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Bit 
R 
W 


Reset 





Bit 
R 
W 


Reset 












Interrupt configuration 1 fields. This register controls the active condition of the interrupt function for GPIO 
ICR15 interrupt 15. 


Settings: 










Bits ICRn[1:0] determine the interrupt condition for signal n as follows: 


00 LOW LEVEL — Interrupt n is low-level sensitive. 

01 HIGH LEVEL — Interrupt n is high-level sensitive. 

10 RISING EDGE — Interrupt n is rising-edge sensitive. 
11 FALLING EDGE — Interrupt n is falling-edge sensitive. 











图 8.1.5.5 ICR1 寄存 器 
ICR1 用 于 IO0-15 的 配置 ， ICR2 用 于 1016-31 的 配置 。ICR1 寄存 器 中 一 个 GPIO 用 两 个 
位 ， 这 两 个 位 用 来 配置 中 断 的 触发 方式 ， 和 STM32 的 中 断 很 类 似 ， 可 配置 的 选 线 如 表 8.1.5.1 

















所 示 : 
00 低 电 平 触发 
01 高 电 平 触发 
10 上 升 沿 触发 
11 下 降 沿 触发 

















K 8.1.5.1 中 断 触发 配置 
以 GPIO1 IO15 为 例 , 如 果 要 设置 GPIO1 1015 为 上 升 沿 触 发 中 断 ,那么 GPIO1.ICR1=2<<30， 
如 果 要 设置 GPIO1 的 IO16~31 的 话 就 需要 设置 ICR2 寄存 器 了 。 
接 下 来 看 IMR 寄存 器 ， 这 是 中 断 屏蔽 寄存 器 ， 如 图 8.1.5.6 所 示 : 


Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16|15 14 13 12 11 109 8 7 6 5 4 3 2 1 0 
R 
w IMR 


Rst0000000000000000]|000000000000000 00 
GPIOx IMR field descriptions 


CT nm | 


IMR Interrupt Mask bits. This register is used to enable or disable the interrupt function on each of the 32 GPIO 
signals. 
Settings: 

















Bit IMR[n] (n=0...31) controls interrupt n as follows: 


0 UNMASKED — Interrupt n is disabled. 
1 MASKED — Interrupt n is enabled. 
图 8.1.5.6 IMR 寄存 器 
IMR 寄存 器 也 是 一 个 GPIO 对 应 一 个 位 ，IMR 寄存 器 用 来 控制 GPIO 的 中 断 禁 止 和 使 能 ， 
如 果 使 能 某 个 GPIO 的 中 断 ， 那 么 设置 相应 的 位 为 1 即 可 ， 反 之 ， 如 果 要 禁止 中 断 ， 那 么 就 设 
置 相应 的 位 为 0 即 可 。 例 如 ， 要 使 能 GPIOI IO00 的 中 断 ， 那 么 就 可 以 设置 GPIO1.MIR=1 即 
可 。 
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接 下 来 看 寄存 器 ISR，ISR 是 中 断 状态 寄存 器 ， 寄 存 器 如 图 8.1.5.7 所 示 : 


Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16|15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 











R | ISR 





w| wic 





hesst0 000000000000000J0000000000000000 
GPIOx ISR field descriptions 


| Ped | pscptm | 





ISR Interrupt status bits - Bit n of this register is asserted (active high) when the active condition (as 
determined by the corresponding ICR bit) is detected on the GPIO input and is waiting for service. The 
value of this register is independent of the value in GPIO IMR. 


When the active condition has been detected, the corresponding bit remains set until cleared by software. 
Status flags are cleared by writing a 1 to the corresponding bit position. 


图 8.1.5.7 ISR 寄存 器 
ISR 寄存 器 也 是 32 位 寄存 器 ， 一 个 GPIO 对 应 一 个 位 ， 只 要 某 个 GPIO 的 中 断 发 生 ， 那 么 
ISR 中 相应 的 位 就 会 被 置 1。 所 以 ， 我 们 可 以 通过 读 取 ISR 寄存 器 来 判断 GPIO 中 断 是 否 发 生 ， 
相当 于 ISR 中 的 这 些 位 就 是 中 断 标 志 位 。 当 我 们 处 理 完 中 断 以 后 ， 必 须 清除 中 断 标志 位 ， 清 除 
方法 就 是 向 ISR 中 相应 的 位 写 1， 也 就 是 写 1 清 零 。 
最 后 来 看 一 下 EDGE_SEL 寄存 器 ， 这 是 边沿 选择 寄存 器 ， 寄 存 器 如 图 8.1.5.8 所 示 : 
Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16|15 14 13 12 11 10 9 09 7 6 5 4 3 2 1 0 


: GPIO EDGE SEL | 


Reset0 000000000000000|0000000000000000 
GPIOx EDGE SEL field descriptions 


TE BemWin 






























































GPIO EDGE  |Edge select. When GPIO EDGE SEL[n] is set, the GPIO disregards the ICR[n] setting, and detects any 
SEL edge on the corresponding input signal. 


图 8.1.5.8 EDGE SEL 寄存 器 
EDGE SEL 寄存 器 用 来 设置 边沿 中 断 , 这 个 寄存 器 会 覆盖 ICR1 和 ICR 的 设置 , 同样 是 一 
个 GPIO 对 应 一 个 位 。 如 果 相 应 的 位 被 置 1， 那么 就 相当 与 设置 了 对 应 的 GPIO 是 上 升 沿 和 下 降 
































沿 ( 双 边沿 ) 触 发 。 例 如 ， 我 们 设置 GPIO1.EDGE_SEL=1， 那 么 就 表示 GPIOI IO01 是 双边 沿 触 
发 中 断 ， 无 论 GFPIO1_CR1 的 设置 为 多 少 ， 都 是 双边 沿 触发 。 

关于 GPIO 的 寄存 器 就 讲解 到 这 里 ， 因 为 GPIO 是 最 常用 的 功能 ， 我 们 详细 的 讲解 了 GPIO 
的 8 个 寄存 器 。 至 此 我 们 就 解决 了 8.1.1 中 的 第 3 个 和 第 4 个 疑问 ， 那 就 是 LIMX6U 的 IO 是 需 
要 配置 和 输出 的 、 是 可 以 设置 输出 高 低 电 平 ， 也 可 以 读 取 GPIO 对 应 的 电 平 。 























Sg 


























8.1.6LMX6U GPIO 时 钟 使 能 











还 有 最 后 一 个 疑问 ， 那 就 是 ILMX6U 的 GPIO 是 否 需 要 使 能 时 钟 ? STM32 的 每 个 外 设 都 有 
一 个 外 设 时 钟 ，GPIO 也 不 例外 ， 要 使 用 某 个 外 设 ， 必 须要 先 使 能 对 应 的 时 钟 。LMX6U 其 实 也 
一 样 的 ， 每 个 外 设 的 时 钟 都 可 以 独立 的 使 能 或 禁止 ， 这 样 可 以 关闭 掉 不 使 用 的 外 设 时 钟 ， 起 到 
省 电 的 目的 。 如 果 要 使 用 某 个 外 设 的 话 必须 要 先 使 能 其 时 钟 。LMX6U 的 系统 时 钟 参考 
(LMX6UL 参考 手册 》 的 第 18 Æ “Chapter 18: Clock Controller Module(CCM)”， 这 一 个 章 主 要 
讲解 LMX6U 的 时 钟 系统 ， 很 复杂 。 我 们 先 不 研究 LIMX6U 的 时 钟 系统 , 我 们 只 看 一 下 CCM 里 
面 的 外 设 时 钟 使 能 寄存 器 。CMM 有 CCM_CCGRO~CCM_CCGR6 这 7 个 寄存 器 ， 这 7 个 寄存 
器 控制 着 LMX6U 的 所 有 外 设 时 钟 开关 , 我 们 以 CCM. CCGRO 为 例 来 看 一 下 如 何 禁止 或 使 能 一 
个 外 设 的 时 钟 ，CCM_CCGR0 结构 体 如 图 8.1.6.1 所 示 : 
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Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
M CG15 CG14 CG13 CG12 CG11 CG10 CG9 CG8 
Reset 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
li CG7 CG6 CG5 CG4 CG3 CG2 CG1 CGO 











Reset 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
CCM CCGRO field descriptions 


[mar [ nm | 





























31-30 
CG15 gpio2_clocks (gpio2_clk_enable) 
29-28 uart2 clock (uart2_clk_enable) 
CG14 
27—26 gpt2 serial clocks (gpt2 serial clk enable) 
CG13 
25-24 dcic1 clocks (dcic1 clk enable)gpt2 bus clocks (gpt2 bus clk enable) 
CG12 
23-22 CPU debug clocks (arm dbg clk enable) 
CG11 
21-20 can2 serial clock (can2 serial clk enable) 
CG10 
19-18 can2 clock (can2. clk enable) 

CG9 
17-16 cani serial clock (can1 serial clk enable) 

CG8 
15-14 cani clock (cani clk enable) 

CG7 
13-12 caam_wrapper_ipg clock (caam wrapper ipg enable) 
CG6 
11-10 caam_wrapper_aclk clock (caam_wrapper_aclk_enable) 
CG5 

9-8 caam secure mem clock (caam secure mem clk enable) 
CG4 

7-6 asrc clock (asrc_clk_enable) 

CG3 

5-4 apbhdma hclk clock (apbhdma hclk enable) 

CG2 

3-2 aips tz2 clocks (aips tz2 clk enable) 

CG1 

CGO aips tz1 clocks (aips tz1 clk enable) 











8.1.6.1CCM CCGRO0 寄存 器 
CCM CCGRO 是 个 32 为 寄存 器 ， 其 中 每 2 位 控制 一 个 外 设 的 时 钟 ， 比 如 bit31:30 控制 着 
GPIO2 的 外 设 时 钟 ， 两 个 位 就 有 4 中 操作 方式 ， 如 表 8.1.6.1 所 示 : 




















00 所 有 模式 下 都 关闭 外 设 时 钟 。 

01 只 有 在 运行 模式 下 打开 外 设 时 钟 ， 等 待 模式 和 停止 模式 下 均 关闭 外 设 时 钟 。 
10 未 使 用 (保留 )。 

11 除了 停止 模式 以 外 ， 其 他 所 有 模式 下 时 钟 都 打开 。 




















K 8.1.6.1 外 设 时 钟 控制 

根据 表 8.1.6.1 中 的 位 设置 ， 如 果 我 们 要 打开 GPIO2 的 外 设 时 钟 ， 那 么 只 需要 设置 
CCM CCGRO 的 bit31 和 bit30 都 为 1 即 可 ， 也 就 是 CCM_CCGR0=3 <<30。 反 之 ， 如 果 要 关闭 
GPIO2 的 外 设 时 钟 ， 那 就 设置 CCM CCGRO 的 bit31 和 bit30 都 为 0 即 可 。 
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CCM CCGR0-CCM CCGR6 ix 7 个 寄存 器 操作 都 是 类 似 的 ， 只 是 不 同 的 寄存 器 对 应 不 同 的 外 











设 时 钟 而 已 ， 为 了 方便 开发 ， 本 教程 后 面 所 有 的 例 程 将 IMX6U 的 所 有 外 设 时 钟 都 打开 了 。 至 
此 我 们 就 解决 了 8.1.1 中 的 所 有 问题 都 解决 了 ，LMX6U 的 每 个 外 设 的 时 钟 都 可 以 独立 的 禁止 和 
使 能 ， 这 个 和 STM32 是 一 样 。 总 结 一 下 ， 要 将 LMX6U 的 IO 作为 GPIO 使 用 ， 我 们 需要 一 下 
A: 

CD. ERE GPIO 对 应 的 时 钟 。 

@、 设 置 家 在 器 IOMUXC SW MUX CTL PAD XX XX, 设置 IO 的 复 用 功能 ， 使 其 复 用 
为 GPIO 功能 。 

余 、 设 置 寄 存 器 IOMUXC SW PAD CTL PAD XX XX, 设置 IO 的 上 下 拉 、 速 度 等 等 。 

由、 第 @ 步 已 经 将 IO 复 用 为 了 GPIO 功能 ， 所 以 需要 配置 GPIO， 设 置 输 /输出 、 是 否 使 用 
中 断 、 默 认输 出 电 平等 。 


8.2 硬件 原理 分 析 


打开 LMX6U-ALPHA 开发 板 底板 原理 图 ， 底 板 原理 图 和 核心 板 原 理 图 都 放 到 了 开发 板 光 
AP, KAK: 开发 板 光盘 ->2、 开 发 板 原理 图 ->IMX6UL ALPHA_V1.0( 底 板 原理 图 )。LMX6U- 
ALPHA 开发 板 上 有 一 个 LED 灯 ， 原 理 图 如 下 8.2.1 所 示 : 
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17 
图 8.2.1 LED 原理 图 

从 图 8.2.1 可 以 看 出 , LEDO 接 到 了 GPIO 3 E, GPIO 3 就 是 GPIO1 IO03, 当 GPIOI IO03 
输出 低 电 平 (0) 的 时 候 发 光 二 极 管 LEDO 就 会 导 通 点 亮 ， 当 GPIO1_IO03 输出 高 电 平 (1) 的 时 候 发 
光 二 极 管 LED0 不 会 导 通 ， 因 此 LEDO 也 就 不 会 点 亮 。 所 以 LEDO 的 亮 灭 取决 于 GPIOI 1003 
的 输出 电 平 ， 输 出 0 就 亮 ， 输 出 1 就 灭 。 


8.3 实验 程序 编写 


按照 8.1 小 节 中 讲 的 ， 我 们 需要 对 GPIO1_IO03 做 如 下 设置 : 

1、 使 能 GPIO1 时 钟 

GPIOI 的 时 钟 由 CCM_CCGR1 的 bit27 和 bit26 这 两 个 位 控制 ， 将 这 两 个 位 都 设置 位 11 即 
可 。 本 教程 所 有 例 程 已 经 将 LMX6U 的 所 有 外 设 时 钟 都 已 经 打开 了 ， 因 此 这 一 步 可 以 不 用 做 。 

2、 设 置 GPIO1 IO03 的 复 用 功能 

找到 GPIO1 IO03 的 复 用 寄存 器 “IOMUXC SW MUX CTL PAD GPIOI I003” 的 地 址 为 
0X020E0068， 然 后 设置 此 寄存 器 ， 将 GPIO1 IO03 这 个 IO 复 用 为 GPIO 功能 ， 也 就 是 ALTS. 

3、 配 置 GPIO1 IO03 

找到 GPIO1 IO03 的 配置 寄存 器 “IOMUXC SW PAD CTL PAD GPIOI I003” 的 地 址 为 
0X020E02F4， 根 据 实际 使 用 情况 ， 配 置 此 寄存 器 。 































































































301 


LMX6U 嵌入 式 Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
4、 设 置 GPIO 
我 们 已 经 将 GPIO1 IO03 复 用 为 了 GPIO 功能 ， 所 以 我 们 需要 配置 GPIO。 找 到 GPIO3 对 























应 的 GPIO 组 寄存 器 地 址 ， 在 《IMX6UL 参考 手册 》 的 1154 页 ， 如 图 8.3.1 所 示 : 









































20A_4000 |GPIO data register (GPIO3_DR) 32 R/W | 0000_0000h | 26.5.1/1155 
20A_4004 |GPIO direction register (GPIO3_GDIR) 32 R/W | 0000_0000h | 26.5.2/1156 
20A_4008 |GPIO pad status register (GPIO3_PSR) 32 R 0000_0000h | 26.5.3/1156 
20A 400C |GPIO interrupt configuration register1 (GPIO3_ICR1) 32 R/W | 0000 0000h | 26.5.4/1157 
20A 4010 |GPIO interrupt configuration register2 (GPIO3 ICR2) 32 R/W | 0000 0000h | 26.5.5/1161 
20A 4014 |GPIO interrupt mask register (GPIO3 IMR) 32 R/W | 0000 0000h | 26.5.6/1164 
20A 4018 |GPIO interrupt status register (GPIOS ISR) 32 wic 0000_0000h | 26.5.7/1165 
20A 401C |GPIO edge select register (GPIO3_EDGE_SEL) 32 R/W | 0000 0000h | 26.5.8/1166 











图 8.3.1 GPIO3 对 应 的 GPIO 寄存 器 地 址 

本 实验 中 GPIO1 1003 是 作为 输出 功能 的 ， 因 此 GPIO3 GDIR 的 bit3 要 设置 为 1， 表示 输 
出 。 

5、 控 制 GPIO 的 输出 电 平 

经 过 前 面 几 步 ，GPIO1_ IO03 已 经 配置 好 了 ， 只 需要 向 GPIO3_DR 寄存 器 的 bit3 写 入 0 BẸ 
可 控制 GPIO1 IOO3 输出 低 电 平 ， 打 开 LED， 向 bit3 写 入 1 可 控制 GPIO1 IO03 输出 高 电 平 ， 
关闭 LED。 

本 实验 完整 工程 在 开发 板 光 盘 中 , 路径 为 : 开发 板 光盘 -> 1、 例 程 源码 -> 1、 裸 机 例 程 -> 1_leds， 

如 果 要 打开 这 个 工程 的 话 一 定 要 将 “1_leds” 整 个 文件 夹 复 制 到 一 个 没有 中 文 路 径 的 目录 中 , 否 
则 直接 打开 工程 可 能 会 报错 。 

所 有 的 裸 机 实验 我 们 都 在 Ubuntu 下 完成 ， 使 用 VSCode 编辑 器 ! 

所 有 的 裸 机 实验 我 们 都 在 Ubuntu 下 完成 ， 使 用 VSCode 编辑 器 ! 

所 有 的 裸 机 实验 我 们 都 在 Ubuntu 下 完成 ， 使 用 VSCode 编辑 器 ! 

既然 是 实验 , 肯定 要 自己 动手 创建 工程 , 新 建 一 个 名 为 “1_leds ”的 文件 夹 , 然后 在 “1_leds” 
这 个 目录 下 新 建 一 个 名 为 “led.s” 的 汇编 文件 和 一 个 名 为 “.vscode ”的 目录 , 创建 好 以 后 “1 leds" 
文件 夹 如 图 8.3.2 所 示 : 





























































































































$ ls -a 
Led .s 





图 8.3.2 新 建 的 1 leds 工程 文件 夹 
图 8.3.2 中 .vscode 文件 夹 里 面 存放 VSCode 的 工程 文件 ，led.s 就 是 我 们 新 建 的 汇编 文件 ， 
我 们 稍 后 会 在 led.s 这 个 文件 中 编写 汇编 程序 。 使 用 VSCode 打开 1_leds 这 个 文件 夹 , 打开 以 后 
如 图 8.3.3 所 示 : 
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led.s - 1_leds - Visual Studio Code 





4 打开 的 编辑 器 
x led.s 
4 1_LEDS 
L E: 


La 








图 8.3.3 VSCode 工程 





在 led.s 中 输入 如 下 代码 : 





示例 代码 8.3.1 led.s 文件 源码 


/玉米 矿业 火炎 类 大 火炎 类 大 火炎 类 大 火炎 类 大 类 类 类 大 类 类 大 大 类 类 大 大 类 大大 大 类 类 大 大 类 类 大 大 大大 大 大 大大 大 大 大业 大大 大大 大 大 类 大 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 


AX r4 a YXed.s 

作者 : 左 忠 则 

版 本 3 Va 

描述 : 裸 机 实验 1 汇编 点 灯 














使 用 汇编 来 点 亮 开 发 板 上 的 LED 灯 ， 学 习 和 掌握 如 何 用 汇编 语言 来 






































完成 对 工 .MX6U 处 理 器 的 GPIO 初始 化 和 控制 。 
其 他 3 JE 
论坛 : WwWww.openedv.co 
E ss : 初版 V1.0 2019/1/3 左 忠 凯 创建 
KOKCKCKCKCkCkCkCk k kk kCkCk Ck kCkCk kCk ck k kc k k kk Ck kCkCk kCk Ck k kc k k kc k Ck k k Ck kckck kck ck ckck ck ckck ck k ke kk / 
il 
2 .global start /* 全 局 标号 */ 
3 
4 /* 
5  * 描述 : _start 函数 ， 程 序 从 此 函数 开始 执行 此 函数 完成 时 钟 使 能 、 
6 * GPIO 初始 化 、 最 终 控 制 GPIO 输出 低 电 平 来 点 亮 LED 灯 。 
qoc 
ONES a 
9  /* PERE */ 
10 /* 1. Bae */ 
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11 ldr r0, -0X020C4068 /* 寄存 器 CCGRO */ 


12 ldr ri, zOXFFFFFFFF 
ILS). Swe mile [40] 


14 
15 ldr r0, 20X020C406C /* 9$ff3& CCGR1 */ 
Temer ri E [Ere 04] 

il 

18 ldr r0, 20X020C4070 /* W$4f3& CCGR2 */ 
IS eere sdb [exe] 

20 

21 ldr r0, 20X020C4074 /* ERS 
22 Str mre pos O1] 

23 

24 ldr r0, -20X020C4078 /* Adre CCGRA */ 
25 Swe el | 

26 

27 ldr r0, =0X020C407C a e CCGR5 */ 
Ze. Se ell OH 

29 

30 Idr r0, =0x020C4080 /* Adras CCGR6 */ 
SH. muere ale [pe] 

32 

33 


34 /* 2. WE GPIOl 1003 MHi?yGPIOl 1003 */ 
35 ldr r0, 20X020E0068 /* 将 寄存 器 SW MUX GPIOl IO03 BASE 加 载 到 r0 中 */ 





S36 lge rl, 0x5 /* 设置 寄存 器 SW_MUX GPIO1 IO03 BASE 的 MUX MODE 为 5 */ 
SU ex ad [0] 
38 


39 /* 3. Bü! GPIO1 1003 Ñ 10 属性 
40  *bit 16:0 HYS XH] 

41  *bit [15:14]: 00 默认 下 拉 

42  *bit [13]: 0 kepper Hik 

43  *bit [12]: 1 pull/keeper IERE 
44  *bit [11]: 0 关闭 开路 输出 

45  *bit [7:6]: 10 速度 100Mhz 

46  *bit [5:3]: 110 R0/6 TRAZ 
47  *bit [0]: 0 低 转换 率 

48  */ 

49 ldr r0, 20X020E02F4 /x* 寄 存 器 SW PAD GPIO1 IO03 BASE */ 
50 Tar ri, -0X10B0 

Si mese ael [De] 

52 

53 /* 4. KEGPIOl IO03 AH */ 
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54 ldr r0, =0X0209C004 /* 寄 存 器 GPIOl GDIR */ 
55 ldr r1, -20X0000008 
se eee ei Ez] 
5 
56 Reb JF uani 
59  * 设置 GPIO1 1003 输出 低 电 平 
60 e 
61 ldr r0, -20x0209c000 /* 寄 存 器 GPIO1 DR */ 
62 lar r1, z0 
| 
64 
S 
66 * 描述 : loop 死 循环 
Gu E 
68 loop: 
69 b loop 
我 们 来 详细 的 分 析 一 下 上 面 的 汇编 代码 ， 我 们 以 后 分 析 代 码 都 根据 行 号 来 分 析 。 

































































第 2 行 定义 了 一 个 全 局 标号 _start， 代 码 就 是 从 _start 这 个 标号 开始 顺序 往 下 执行 的 。 














第 11 行使 用 ldr 指令 向 寄存 器 r0 写 入 0X020C4068， 也 就 是 r0=0X020C4068， 这 个 是 





CCM CCGRO 寄存 器 的 地 址 。 




















第 12 行使 用 ldr 指令 向 寄存 器 r1 写 入 OXFFFFFFFF， 也 就 是 人 r1=0XFFFFFFFF。 因 为 我 
们 要 开启 所 有 的 外 设 时 钟 ， 因 此 CCM_CCGR0~CCM_CCGR6 所 有 的 寄存 器 都 32 为 位 都 要 置 














1， 也 就 是 写 入 OXFFFFFFFF。 








第 13 行使 用 str 将 rl 中 的 值 写 入 到 r0 所 保存 的 地 址 中 去 ， 也 就 是 给 0X020C4068 这 个 地 
址 写 入 0XFFFFFFFF， 相 当 于 CCM_CCGR0=0XFFFFFFFF， 就 是 打开 CCM CCGRO 寄存 器 所 





cx 


空 制 的 所 有 外 设 时 钟 。 














第 15-31 行 都 是 向 CCM_CCGRX(CX=1~6) 寄 存 器 写 入 0XFFFFFFFF。 这 样 我 就 通过 汇编 代 














码 使 能 了 LMX6U 的 所 有 外 设 时 钟 。 





























第 35~37 行 是 设置 GPIO1 1003 的 复 用 功能 ,GPIO1 1003 的 复 用 寄存 器 地 址 为 0X020E0068&， 





寄存 器 IOMUXC SW MUX CTL PAD GPIOI 1003 的 MUX MODE 设置 为 5 就 是 将 


GPIO1 IO03 设置 为 GPIO。 
第 49-5] 行 是 设置 GPIO1IO03 的 配置 寄存 器 ， 也 就 是 寄 
IOMUX SW PAD CTL PAD GPIOI 1003 的 值 ， 此 寄存 器 地 址 为 0X020E02F4， 代 码 里 





存 器 








用 已 经 





























给 出 了 这 个 寄存 器 详细 的 位 设置 。 





第 54~63 行 是 设置 GPIO 功能 ， 经 过 上 面 几 步 操作 ，GPIO1_IO03 这 个 IO 已 经 被 配置 为 了 
GPIO 功能 ,所 以 还 需要 设置 跟 GPIO 有 关 的 寄存 器 。 第 54~56 行 是 设置 GPIO1->GDIR 寄存 器 ， 





将 GPIO1_1003 设置 为 输出 模式 ， 也 就 是 寄存 器 的 GPIO1_GDIR 的 bit3 & 1. 




















第 61~63 行 设置 GPIO1->DR 寄存 器 ， 也 就 是 设置 GPIO1 IO03 的 输出 ， 我 们 要 点 亮 开发 
板 上 的 LED0， 那 么 GPIO1_IO03 就 必须 输出 低 电 平 ， 所 以 这 里 设置 GPIO1_DR 寄存 器 为 0。 
第 68~69 行 是 死 循环 ， 通 过 b 指令 ，CPU 重复 不 断 的 跳 到 loop 函数 执行 ， 进 入 一 个 死 循 












































环 。 
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8.4 编译 下 载 验证 


8.4.1 编译 代码 


如 果 你 是 在 Windows 下 使 用 Source Insight 编写 的 代码 ， 就 需要 通过 FileZilla 将 编写 好 的 
代码 发 送 的 Ubuntu 中 去 编译 ,FileZilla 的 使 用 参考 4.1 小 节 。 因 为 我 们 现在 是 直接 在 Ubuntu 下 
使 用 VSCode 编译 的 代码 ， 所 以 不 需要 使 用 FileZilla 将 代码 发 送 到 Ubuntu 下 ， 可 以 直接 进行 编 
译 ， 在 编译 之 前 我 们 先 了 解 几 个 编译 工具 。 

1. arm-linux-gnueabihf-gcc 编译 文件 

我 们 是 要 编译 出 在 ARM 开发 板 上 运行 的 可 执行 文件 ， 所 以 要 使 用 我 们 在 4.3 小 节 安 装 的 
交叉 编译 器 arm-linux-gnueabihf-gcc 来 编译 。 因 此 本 试验 就 一 个 led.s 源 文件 ， 所 以 编译 比较 简 
单 。 先 将 led.s 编译 为 对 应 的 .o 文件 ， 在 终端 中 输入 如 下 命令 : 























































































































arm-linux-gnueabihf-gcc -g -c led.s -o led.o 

上 述 命令 就 是 将 led.s 编译 为 led.o， 其 中 “-g” 选 项 是 产生 调试 信息 ，GDB 能 够 使 用 这 些 
调试 信息 进行 代码 调试 。“-c” 选 项 是 编译 源 文件 ， 但 是 不 链接 。“-o” 选 项 是 指定 编译 产生 的 文 
件 名 字 ， 这 里 我 们 指定 led.s 编译 完成 以 后 的 文件 名 字 为 led.o。 执 行 上 述 命令 以 后 就 会 编译 生 
成 一 个 led.o 文件 ， 如 图 8.4.1.1 所 示 : 




































































$ ls 
Led.0 Led.s 
$ 


图 8.4.1.1 编译 生成 led.o 文件 
图 8.4.1.1 中 led.o 文件 并 不 是 我 们 可 以 下 载 到 开发 板 中 运行 的 文件 ， 一 个 工程 中 所 有 的 C 
文件 和 汇编 文件 都 会 编译 生成 一 个 对 应 的 .o 文件 ， 我 们 需要 将 这 .o 文件 链接 起 来 组 合成 可 执行 
文件 。 
2, arm-linux-gnueabihf-ld 链接 文件 


arm-linux-gnueabihf-ld 用 来 将 众多 的 .o 文件 链接 到 一 个 指定 的 链接 位 置 。 我 们 在 学 习 
SMT32 的 时 候 基本 就 没有 听 过 “链接 ”这 个 词 ， 我 们 一 般 用 MDK 编写 好 代码 ， 然 后 点 击 “ 编 
FÉ", MDK 或 者 IAR 就 会 自动 帮 有 我们 编译 好 整个 工程 ， 最 后 再 点 击 “ 下 载 ” 就 可 以 将 代码 下 载 
到 开发 板 中 。 这 是 因为 链接 这 个 操作 MDK 或 者 IAR 已 经 帮 你 做 好 了 ， 后 面 我 就 以 MDK 为 例 
给 大 家 讲解 。 大 家 可 以 打开 一 个 STM32 的 工程 ， 然 后 编译 一 下 ， 肯 定 能 找到 很 多 .o 文件 ， 如 图 
8.4.1.2 所 示 : 














































































































^ 


^ 名称 修改 日 期 类 型 大 小 

| | stm32f10x dbgmcu.crf 2019-01-17 1:21 CRF 文件 341 KB 
|_| stm32f10x dbgmcu.d 2019-01-17 1:21 D 文件 2 KB 
| | stm32f10x dbgmcu.o 2019-01-17 1:21 O 文件 376 KB 
| stm32f10x gpio.crf 2019-01-17 1:21 — CRF 文件 345 KB 

stm32f10x gpio.d 2019-01-17 1:21 D 文件 2 KB 

stm32f10x gpio.o 2019-01-17 1:21 | O 文件 400 KB 
| | stm32f10x it.crf 2019-01-17 1:21 CRF 文件 341 KB 
|_| stm32f10x it.d 2019-01-17 1:21 D 文件 2KB 
|] stm32f10x it.o 2019-01-17 1:21 O 文件 384 KB 
|] stm32f10x rcc.crf 2019-01-17 1:21 CRF 文件 348 KB 
|_| stm32f10x rcc.d 2019-01-17 1:21 D 文件 2 KB 
pD stm32f10x_rcc.o 2019-01-17 1:21 O 文件 421 KB 
[ ] stm32f10x usart.crf 2019-01-17 1:21 — CRF 文件 347 KB 
|_| stm32f10x usart.d 2019-01-17 1:21 D 文件 2 KB 

stm32f10x usart.o 2019-01-17 1:21 O 文件 416 KB 
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图 8.4.1.2 STM32 编译 生成 的 .o 文件 

8.4.1.2 中 的 这 些 .o 文件 肯定 会 被 MDK 链接 到 某 个 地 址 去 ， 如 果 使 用 MDK 开发 STM32 
的 话 肯 定 对 图 8.4.1.3 所 示 界 面 很 熟悉 : 


E Options for Target 'LED' x 




















Device Target | Output | Listing | User | C/C++ | Asm | Linker | Debug | Utilities | 


STMicroelectronics STM32F103ZE 
Code Generation 


Xtal (MHz): ARM Compiler: [Use default compiler version v] 
Operating system: |None z | 


System Viewer File: 厂 Use Cross-Module Optimization 


[ETM32F 103o svd E] [- Use MicroLIB [- Big Endia 


[ Use Custom File 


Read/Only Memory Areas Read/Write Memory Areas 
default off-chip Start Size Startup | | default off-chip Stat Nolnit 


[ ROMI: C [ RAMI: r 
[ | ROMZ | C [ | RAMZ 三 
[ . RAM E 


I^  iRom1: (08000000 — |Qx80000 [v  IRAMi: (020000000 |Qx10000 























8.4.1.3 STM32 配置 界面 
图 8.4.1.3 中 左 侧 的 IROMI 我 们 都 知道 是 设置 STM32 45 rH) ROM 起 始 地 址 和 大 小 的 , 右 
边 的 IRAMI 是 设置 STM32 451 RAM 起 始 地 址 和 大 小 的 。 其 中 0X08000000 就 是 STM32 内 
部 ROM 的 起 始 地 址 ， 编 译 出 来 的 指令 肯定 是 要 从 0X08000000 这 个 地 址 开始 存放 的 。 对 于 
STM32 来 说 0X08000000 就 是 它 的 链接 地 址 , 图 8.4.1.2 中 的 这 些 .o 文件 就 是 这 个 链接 地 址 开始 
依次 存放 ， 最 终生 成 一 个 可 以 下 载 的 hex 或 者 bin 文件 ， 我 们 可 以 打开 .map 文件 查看 一 下 这 些 
文件 的 链接 地 址 ， 在 MDK 下 打开 一 个 工程 的 .map 文件 方法 如 图 8.4.1.4 所 示 : 


EA E\STM32F103 战 觅 V3 资料 \ 战 有 舰 V3 资料 盘 (A 盘 )\4， 程 序 源码 \2， 标 准 例 程 - 库 函 数 版 本 \ 实 验 1 跑马 灯 实 验 \USER\LED.uvprojx - pVision 一 [m] x 


File Edit View Project Flash Debug Peripherals Tools SVCS Window Help 
18$ id Bi| & cs | [€ »|t* | R| E GE JE f| B9 kaore — [ R || 5 oela] 


ij ES € ES| Y v Š 2. 
RE + | Wi us A s - T A eto magst 


日 .各 Project: LED 








-A USER 
CES HARDWARE Section Cross References 


EL] led.c Rainiosdinain refers to gela oli delay init) for delay_init 
id A main. o (i. main) refers to led.o(i.LED Init) for LED Init 
Gm Ca SYSTEMI、 双 击 打开.map 文 main.o(i.main) refers to delay.o(i.delay ms) for delay ms 
a- CORE 件 system stm32flÜx.o(i.SetSysClock) refers to system_stm32f10x.ofi.SetSysClockTo72) for 
H system stm32flÜx.o(i.SystemCoreClockUpdate) refers to system stm32flÜx.o(.data) for Sy 
由 国 FWLIB system_stm32f 10x. o (i. SystemInit) refers to system stm32flÜx.o(i.SetSysClock) for SetSy 
aE README led.o(i.LED Init) refers to stm32f10x_rcc. o(i.RCC_APB2PeriphClockCmd) for RCC APB2Peri 
led.o(i.LED Init) refers to stm32flÜx gpio.o(i.GPIO Init) for GPIO Init 
led.o(i.LED Init) refers to stm32flÜx gzpio.o(i.GPIO SetBits) for GPIO SetBits 
delay.o(i.delay init) refers to misc.o(i.SysTick CLKSourceConfig) for SysTick CLKSourc 
delay.o(i.delay init) refers to system stm32flÜx.o(.data) for SystemCoreClock 
delay.o(i.delay init) refers to delay.o(.data) for fac us 
delay.o(i.delay ms) refers to delay.o(.data) for fac ms 
delay.o(i.delay us) refers to delay.o(.data) for fac us 
usart.o(i. USARTi IRQHandler) refers (Special) to use no semi 2.o0(.text) for ^ use no s 
usart.o(i. USART| IRQHandler) refers to stm32flÜx usart.o(i. USART GetITStatus) for USAR 
usart.o(i. USART1 IRQHandler) refers to stm32flÜx usart.o(i. USART ReceiveData) for USAR V 
国 Project Q Books {} Func.. Ü, Temp = > 





图 8.4.1.4 .map 文件 打开 方法 
8.4.1.4 中 的 .map 文件 就 详细 的 描述 了 各 个 .o 文件 都 是 链接 到 了 什么 地 址 ， 如 图 8.4.1.5 
所 示 : 
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Memory Map of the image 


Image Entry point : Ox080001cd 
Load Region LR 1 (Base: 0x08000000, Size: 0x0000078c, Max: Oxffffffff, ABSOLUTE) 


Execution Region ER RO (Base: 0x08000000, Size: 0x0000076c, Max: Oxffffffff, ABSOLUTE) 

















Base Addr Size Type  Attr Idx E Section Name Object 

0x08000000  0x00000130 Data RO 361 RESET startup stm32flOx hd.o 

0x08000130 0x00000008 Code RO 926 * !!!main c w.l( main.o) 

0x08000138 . 0x00000034 Code RO 1081 !!!scatter c w.l( scatter. o) 

0x0800016c  0x0000001a Code RO 1083 !'handler copy c w.l( scatter copy. o) 

0x08000186  0x00000002 PAD 

0x08000188 “0x0000001lc Code RO 1085 !!handler_zi c w.l( scatter zi.o 

0x080001a4 . 0x00000002 Code RO 955 . ARM. Collect$$libinit$$00000000 c w.l(libinit. o) 

0x080001a6  0x00000000 Code RO 962 . ARM. Collect$$1ibinit$$00000002 Gc w.l(libinit2. o) 

0x080001a6 0x00000000 Code RO 964 .ARM. Collect$$libinit$$00000004 «c w.l(libinit2. o) 

0x080001a6 0x00000000 Code RO 967 . ARM. Collect$$libinit$$0000000A c w.l(libinit2. o) 

0x080001a6  0x00000000 Code RO 969 . ARM. Collect$$1ibinit$$0000000C c w.l(libinit2. o) 

0x080001a6 — 0x00000000 Code RO 971 .ARM.Collect$$libinit$$0000000E c w.l(libinit2. o) 

0x080001a6 | 0x00000000 Code RO 974 . ARM. Collect$$libinit$$00000011 c w.l(libinit2. o) 

0x080001a6 — 0x00000000 Code RO 976 . ARM. Collect$$1ibinit$$00000013 c w.l(libinit2. o) 

0x080001a6 — 0x00000000 Code RO 978 . ARM. Collect$$libinit$$00000015 «c w.l(libinit2. o) 

0x080001a6 0x00000000 Code RO 980 . ARM. Collect$$libinit$$00000017 c w.l(libinit2. o) 

0x080001a6 0x00000000 Code RO 982 . ARM. Collect$$libinit$$00000019 c w.l(libinit2. o) 

0x080001a6  0x00000000 Code RO 984 .ARM. Collect$$libinit$$0000001B c w.l(libinit2. o) 

0x080001a6 0x00000000 Code RO 986 . ARM. Collect$$libinit$$0000001D c w.l(libinit2. o) 

0x080001a6 0x00000000 Code RO 988 . ARM. Collect$$libinit$$0000001F «c w.l(libinit2. o) 

0x080001a6 0x00000000 Code RO 990 . ARM. Collect$$libinit$$00000021 c w.l(libinit2. o) 

0x080001a6 | 0x00000000 Code RO 992 . ARM. Collect$$libinit$$00000023 c w.l(libinit2. o) 

0x080001a6 | 0x00000000 Code RO 994 .ARM.Collect$$libinit$$00000025 «c w.l(libinit2. o) 

0x080001a6  0x00000000 Code RO 998 . ARM. Collect$$1ibinit$$0000002C c w.l(libinit2. o) 

0x080001a6 0x00000000 Code RO 1000 . ARM. Collect$$1ibinit$$0000002E c w.l(libinit2. o) 

图 8.4.1.5 STM32 镜像 映射 文件 
从 图 8.4.1.5 中 就 可 以 看 出 STM32 的 各 个 .o 文件 所 处 的 位 置 ， 起 始 位 置 是 0X08000000。 由 
SIZ sd ` xA Sd 

此 可 以 得 知 ， 我 们 用 MDK 开发 STM32 的 时 候 也 是 有 链接 的 ， 只 是 这 些 工作 MDK 都 帮 有 我 们 全 
E " XE AN x P 3 cs y H ` p 
部 做 好 了 ， 我 们 不 用 关心 而 已 。 但 是 我 们 在 Linux 下 用 交叉 编译 器 开发 ARM 的 是 时 候 就 需要 








自己 处 理 这 些 了 。 

因此 我 们 现在 需要 做 的 就 是 确定 一 下 本 试验 最 终 的 可 执行 文件 其 运行 起 始 地 址 ， 也 就 是 
链接 地 址 。 这 里 我 们 要 区 分 “存储 地 址 ”和 “运行 地 址 ”这 两 个 概念 ,“ 存 储 地址 ”就 是 可 执 
行文 件 存储 在 哪里 ， 可 执行 文件 的 存储 地 址 可 以 随意 选择 “运行 地 址 ”就 是 代码 运行 的 时 候 
所 处 的 地 址 ， 这 个 我 们 在 链接 的 时 候 就 已 经 确定 好 了 ， 代 码 要 运行 ， 那 就 必须 处 于 运行 地 址 
处 ， 否 则 代码 肯定 运行 出 错 。 比 如 ILMX6U 支持 SD 卡 、EMMC、NAND 启动 ， 因 此 代码 可 以 
存储 到 SD F, EMMC 或 者 NAND 中 ， 但 是 要 运行 的 话 就 必须 将 代码 从 SD 卡 、EMMC 或 者 
NAND 中 拷贝 到 其 运行 地 址 (链接 地 址 ) 处 ,“ 存 储 地 址 ”和 “运行 地 址 ”可 以 一 样 ， 比 如 
STM32 的 存储 起 始 地 址 和 运行 起 始 地 址 都 是 0X08000000。 

本 教程 所 有 的 裸 机 例 程 都 是 烧 写 到 SD 卡 中 ， 上 电 以 后 LMX6U 的 内 部 boot rom 程序 会 将 
可 执行 文件 拷贝 到 链接 地 址 处 ， 这 个 链接 地 址 可 以 在 LMX6U 的 内 部 128KB RAM 中 
(0X900000~0X91FFFF)， 也 可 以 在 外 部 的 DDR 中 。 本 教程 所 有 裸 机 例 程 的 链接 地 址 都 在 DDR 
中 ， 链 接 起 始 地 址 为 0X87800000. LMX6U-ALPHA 开发 板 的 DDR 容量 有 两 种 : 512MB 和 
256MB， 起 始 地 址 都 为 0X80000000， 只 不 过 512MB 的 终止 地 址 为 OX9FFFFFFF, 而 256MB 容 
量 的 终止 地 址 为 0X8FFFFFFF。 之 所 以 选择 0X87800000 这 个 地 址 是 因为 后 面 要 讲 的 Uboot 其 
链接 地 址 就 是 0X87800000， 这 样 我 们 统一 使 用 0X87800000 这 个 链接 地 址 ， 不 容易 记 混 。 

确定 了 链接 地 址 以 后 就 可 以 使 用 arm-linux-gnueabihf 1d 来 将 前 面 编译 出 来 的 led.o 文件 链 
接 到 0X87800000 这 个 地 址 ， 使 用 如 下 命令 : 

arm-linux-gnueabihf-ld -Ttext 0X87800000 led.o -o led.elf 

上 述 命令 中 -Ttext 就 是 指定 链接 地 址 ,“-o” 选 项 指定 链接 生成 的 elf 文件 名 ,这 里 我 们 命名 
为 led.elf。 上 述 命令 执行 完 以 后 就 会 在 工程 目录 下 多 一 个 led.elf 文件 ， 如 图 8.4.1.6 所 示 : 
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$ LS 


led.o led.s 





9 

图 8.4.1.6 链接 生成 led.elf 文件 
led.elf 文件 也 个 是 我 们 最 终 烧 写 到 SD 卡 中 的 可 执行 文件 ， 我 们 要 烧 写 的 .bin 文件 ， 因 此 还 
需要 将 led.elf 文件 转换 为 .bin 文件 ， 这 里 我 们 就 需要 用 到 arm-linux-gnueabihf-objcopy 这 个 工具 











P 


3. arm-linux-gnueabihf-objcopy 格式 转换 


arm-linux-gnueabihf-objcopy 更 像 一 个 格式 转换 工具 ， 我 们 需要 用 它 将 led.elf 文件 转换 为 
led.bin 文件 ， 命 令 如 下 : 
arm- -gnueabihf-objcopy -O binary -S -g led.elf led.bin 
述 命令 中 ,“-O” 选 项 指定 以 什么 格式 输出 ， pA “binary” 表 示 以 二 进 制 格式 输出 ， 
选项 E ”表示 不 要 复制 源 文件 中 的 重 定位 信息 和 符号 信息 ,“-g” 表 示 不 复制 源 文 件 中 的 调试 
信息 。 上 述 命令 执行 完成 以 后 ， 工 程 目录 如 图 8.4.1.7 所 示 : 






































: $ ls 
led.o led.s 
: $ 

图 8.4.1.7. 生成 最 终 的 led.bin 文件 
至 此 我 们 终于 等 到 了 想 要 的 东西 一 一 led.bin 文件 。 
4、arm-linux-gnueabihf-objdump 反 汇 编 


大 多 数 情况 下 我 们 都 是 用 C 语言 写 试验 例 程 的 ， 有 时 候 需 要 查看 其 汇编 代码 来 调试 代码 ， 
因此 就 需要 进行 反 汇 编 ， 一 般 可 以 将 ef 文件 反 汇 编 ， 比 如 如 下 命令 : 

arm-linux-gnueabihf-objdump -D led.elf >  led.dis 

上 述 代码 中 的 “-D” 选 项 表示 反 汇 编 所 有 的 段 ， 反 汇编 完成 以 后 就 会 在 当前 目录 下 出 现 一 
个 名 为 led.dis 文件 ， 如 图 8.4.1.8 所 示 : 

































































led.dis 








图 8.4.1.8 反 汇编 生 成 led.dis 
可 以 打开 led.dis 文件 看 一 下 ， 看 看 是 不 是 汇编 代码 ， 如 图 8.4.1.9 所 示 : 
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Led .elLf : 文件 格式 elf32-littlearm 


DisassembLy of section .text: 


87800000 < start»: 
87800000: e59f0068 ldr ; 87800070 <loop+0x4> 
87800004: e3e01000 mvn 

87800008: e5801000 str 

8780000c: e59f0060 ldr ; 87800074 «loop«0x8» 
87800010: e5801000 str 
87800014: e59f005c ldr 
87800018: e5801000 SEF 
8780001c: e59f0058 ldr 
8780002]: e5801000 str 
87800024: e59f0054 Ldr 
87800028: e5801000 SEE 
8780002c: e59f0050 ldr 
87800030: e5801000 str 
87800034: e59f004c ldr 
87800038: e5801000 Str 
8780003c: e59f0048 tan 


; 87800078 <loop+0xc> 


ti 


; 8780007c <loop+0x10> 
; 87800080 <loop+0x14> 
; 87800084 <loop+0x18> 


; 87800088 <loop+0x1c> 


NONONONONON 


; 8780008c «loop«0x20» 











图 8.4.1.9 反 汇 编 文 件 

从 图 8.4.1.9 可 以 看 出 led.dis 里 面 是 汇编 代码 ， 而 且 还 可 以 看 到 内 存 分 配 情况 。 在 
0X87800000 处 就 是 全 局 标号 _start， 也 就 是 程序 开始 的 地 方 。 通 过 led.dis 这 个 反 汇 编 文 件 可 以 
明显 的 看 出 到 我 们 的 代码 已 经 链接 到 了 以 0X87800000 为 起 始 地 址 的 区 域 。 

总 结 一 下 我 们 为 了 编译 ARM 开发 板 上 运行 的 led.o 这 个 文件 使 用 了 如 下 命 

arm-linux-gnueabihf-gcc -g -c led.s -o led.o 

arm-linux-gnueabihf-ld -Ttext 0X87800000 led.o -o led.elf 

arm-linux-gnueabihf-objcopy -O binary -S -g led.elf led.bin 











































































































arm-linux-gnueabihf-objdump -D led.elf >  led.dis 
如 果 我 们 修改 了 led.s 文件 ， 那 么 就 需要 在 重复 一 次 上 面 的 这 些 命令 ， 太 麻烦 了 ， 这 个 时 候 
我 们 就 可 以 使 用 第 三 章 讲解 的 Makefile 文件 了 。 
































E 





8.4.2 创建 Makefile 文件 
是 用 “touch” 命 令 在 工程 根 目录 下 创建 一 个 名 为 “Makefile” 的 文件 ， 如 图 8.4.1.12 所 示 : 


$ touch Makefile 
$ 1s 















Led.dis led.o led.s Makefile 


su 
图 8.4.1.12 创建 Makefile 文件 
创建 好 Makefile 文件 以 后 就 需要 根据 Makefile 语法 编写 Makefile 文件 了 ，Makefile 基本 语 
法 我 们 已 经 在 第 三 章 讲解 了 ， 在 Makefile 中 输入 如 下 内 容 : 
示例 代码 8.4.2.1 Makefile 文件 源码 


























led.bin:led.s 
eue lbepe-gabeee3it-—gee 三 可 =€ led. -s =0 ledo 
arm-linux-gnueabihf-ld -Ttext 0X87800000 led.o -o led.elf 
arm-linux-gnueabihf-objcopy -O binary -S -g led.elf led.bin 





arm-linux-gnueabihf-objdump -D led.elf » led.dis 


clean: 
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iw oll nl level. elis 

创建 好 Makefile EJ 4E 1390.3 EAT — A make " dp 4 BI ERRE. 过 程 如 图 8.4.1.13 
所 示 : 





- $ make 
-linux-gnueabihf-gcc -g -c Led.s -o led.o 
-linux-gnueabihf-ld -Ttext 0X87800000 led.o -o led.elf 
-linux-gnueabihf-objcopy -0 binary -S -g led.elf led.bin 
-linux-gnueabihf-objdump -D led.elf » led.dis 
: $ ls 





I .dis led.o Lled.s Makefile 


图 8.4.1.13 Makefile 执行 过 程 
如 果 我 们 要 清理 工程 的 话 执 行 “make clean” 即 可 ， 如 图 8.4.1.14 所 示 : 

















z $ ls 
led.dis led.o led.s Makefile 
$ make clean 


rm -rf *.o led.bin led.elf led.dis 


$ ls 
led.s Makefile 





$ 














图 8.4.1.14 make clean 清理 工程 
至 此 ， 有 关 代 码 编译 、arm-linux-gnueabihf 交叉 编译 器 的 使 用 就 到 这 里 了 ,我 们 接 下 来 讲 角 
如 何 将 led.bin 烧 写 到 SD 卡 中 。 























E 























8.4.5 代码 烧 写 


我 们 学 习 STM32 等 其 他 的 单片机 的 时 候 ， 编 译 完 代码 以 后 可 以 直接 通过 MDK 或 者 IAR 
下 载 到 内 部 的 flash 中 。 但 是 LMX6U 虽然 内 部 有 96K 的 ROM， 但 是 这 96K 的 ROM 是 NXP 
自己 用 的 , 不 向 用 户 开 放 。 所 以 相当 于 说 IMX6U 是 没有 内 部 flash 的 , 但 是 我 们 的 代码 得 有 地 
方 存放 啊 ， 为 此 ，I.MX6U 支持 从 外 置 的 NOR Flash, NAND Flash、SD/EMMC、SPINOR Flash 
和 QSPI Flash 这 些 存储 介质 中 启动 ， 所 以 我 们 可 以 将 代码 烧 写 到 这 些 存 储 介质 中 中 。 在 这 些 存 
储 介 质 中 ， 除 了 SD 卡 以 外 ， 其 他 的 一 般 都 是 焊接 到 了 板子 上 的 ， 我 们 没 法 直接 烧 写 。 但 是 SD 
卡 是 活动 的 ， 是 可 以 从 板子 上 插 拔 的 ， 我 们 可 以 将 SD 卡 插 到 电脑 上 ， 在 电脑 上 使 用 软件 将 .bin 
文件 烧 写 到 SD 卡 中 ， 然 后 再 插 到 板子 上 就 可 以 了 。 其 他 的 几 种 存储 介质 是 我 们 量 产 的 时 候 用 
到 的 ， 量 产 的 时 候 代码 就 不 可 能 放 到 SD 卡 里 面 了 ， 毕 竟 SD 是 活动 的 , 不 牢固 ， 而 其 他 的 都 是 
焊接 到 板子 上 的 ， 很 牢固 。 

因此 ， 我 们 在 调试 裸 机 和 Uboot 的 时 候 是 将 代码 下 载 到 SD 中 ， 因 为 方便 嘛 ， 当 调试 完成 
以 后 量 产 的 时 候 要 将 裸 机 或 者 Uboot 烧 写 到 SPI NOF Flash, EMMC, NAND 等 这 些 存储 介质 
中 的 。 那 么 ， 如 何 将 我 们 前 面 编译 出 来 的 led.bin 烧 写 到 SD 卡 中 呢 ? 肯定 有 人 会 认为 直接 复制 
led.bin 到 SD 卡 中 不 就 行 了 , 错 ! 编译 出 来 的 可 执行 文件 是 怎么 存放 到 SD 中 的 , 存放 的 位 置 是 
什么 ? 这 个 NXP 是 有 详细 规定 的 ! 我 们 必须 按照 NXP 的 规定 来 将 代码 烧 写 到 SD FRF, AU 
代码 是 绝对 运行 不 起 来 的 。《IMX6UL 参考 手册 》 的 第 8 章 “Chapter 8 System Boot” 就 是 专门 
讲解 LMX6U 启动 的 ， 我 们 下 一 章 会 详细 的 讲解 IMX6U 启动 方式 的 。 

正点 原子 专门 编写 了 一 个 软件 来 将 编译 出 来 的 .bin 文件 烧 写 到 SD 卡 中 ， 这 个 软件 叫做 
“imxdownload” 软件 我 们 已 经 放 到 了 开发 板 光 盘 中 ， 路径 为 : 开发 板 光盘 ->5、 开 发 工具 ->2、 
Ubuntu 下 裸 机 烧 写 软件 ->imxdownload，imxdownlaod 只 能 在 Ubuntu 下 使 用 ， 使 用 步 又 如 下 : 

1、 将 imxdownload 拷贝 到 工程 根 目录 下 
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我 们 要 将 imxdownload 拷贝 到 工程 根 目录 下 ， 也 就 是 和 led.bin 处 于 同一 个 文件 夹 下 ， 要 不 
然 烧 写 会 失败 的 ， 找 贝 完 成 以 后 如 图 8.4.3.1 所 示 : 





$ ls 


imxdownload led.dis led.o led.s Makefile 





图 8.4.3.1 拷贝 imxdownload 软件 
2、 给 予 imxdownload 可 执行 权限 


我 们 直接 将 软件 imxdownload 从 Windows 下 复制 到 Ubuntu 中 以 后 ，imxdownload 默认 是 
没有 可 执行 权限 的 。 我 们 需要 给 予 imxdownload 可 执行 权限 ， 使 用 命令 “chmod”， 命 令 如 下 : 


$ chmod 777 imxdownload 


























LI IS 


Led.dis led.o led.s Makefile 
$ 


图 8.4.3.2 给 予 imxdownload 可 执行 权限 

通过 对 比 图 8.4.3.1 和 图 8.4.3.2 可 以 看 到 ， 当 给 予 imxdownload 可 执行 权限 以 后 其 名 字 编 
程 了 绿色 的 , 如 果 没 有 可 执行 权限 的 话 其 名 字 颜 色 是 白色 的 。 所 以 在 Ubuntu 中 我 们 可 以 初步 的 
从 文件 名 字 的 颜色 判断 其 是 否 具 有 可 执行 权限 。 

3、 确 定 要 烧 写 的 SD 卡 。 

准备 一 张 新 的 SD(TF) 卡 ,确保 SD 卡 里 面 没 有 数据 ， 因 为 我 们 在 烧 写 代码 的 时 候 可 能 会 
式 话 SD F!!! 
Ubuntu 下 所 有 的 设备 文件 都 在 目录 “/dev” 里 面 ， 所 以 插 上 SD 卡 以 后 也 会 出 现在 “/dev” 
里 面 ， 其 中 存储 设备 都 是 以 “/devsd” 开 头 的 。 我 们 要 先 看 一 下 不 择 SD 卡 的 时 候 电脑 都 有 哪些 
存储 设备 ， 以 防 插 入 SD 卡 以 后 分 不 清 谁 是 谁 。 输 入 如 下 所 示 命 令 : 

Is /dev/sd* 

当前 电脑 的 存储 文件 如 图 8.4.3.3 所 示 : 


$ ls /dev/sd* 
: $ 


图 8.4.3.3 Ubuntu 当前 存储 文件 

从 图 中 可 以 看 到 当前 电脑 有 /dewsda、/dewsdal /dev/sda2 和 /dewsdas 这 5 个 存储 设备 ， 使 
用 读 卡 器 将 SD 卡 插 到 电脑 ， 一 定 要 确保 SD 卡 是 挂 载 到 了 Ubuntu 系统 中 ， 而 不 是 Windows 
Fo SD 卡 挂 载 到 电脑 以 后 ，VMware 右 下 角 会 出 现 如 图 8.4.3.4 所 示 图 标 : 
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(B) Ubuntu 64 位 -VMware Workstation aes x 
文件 上 9 RAD 查看 W MM RRD 帮助 由 | HD = | | (O (D ES E A rm 

库 Ax QER x | C Ubuntu 64 fz X 

QW_、 在 此 处 键入 内 容 进行 搜 v m 


zuozhongkai(pubuntu: -/linux/driver/board driver/1, leds 





$ ls /dev/sd* 


su 


z UI 我 的 计算 机 
C> Ubuntu 64 位 
CE 共享 的 虚拟 机 

















z > 
要 将 输入 定向 到 该 虚拟 机 ， 请 在 虚拟 机 内 部 单 击 或 按 Ctrl+G。 Qus dc] ü um 
L Realtek USB3.0 Card Reader 














图 8.4.3.4 插 上 SD 卡 以 后 的 提示 

如 图 8.4.3.4 所 示 ， 在 VMware 右 小 角 有 个 图 标 看 着 像 硬 盘 一 样 的 图 标 : 己 ， 这 个 图 标 就 表 
示 当 前 有 存储 设备 插入 , 我们 将 鼠标 放 上 去 就 会 有 提示 当前 设备 名 字 , 比如 我 这 里 提示 “Realtek 
USB3.0 Card Reader”， 这 是 我 的 读 卡 器 的 名 字 。 如 果 轧 是 灰色 的 话 就 表示 SD 卡 挂 载 到 了 
Windows 下 ， 而 不 是 Ubuntu 上 ， 所 以 我 现在 这 个 电脑 的 SD 卡 就 是 挂 载 到 了 Windiows F, R 
肯定 要 将 其 挂 载 到 Ubuntu 中 ， 因 为 我 要 在 Ubuntu FSR. MARHA, Ahm, A 


击 以 后 如 图 8.4.3.5 所 示 : 
mh 

























































































更 改 图 标 (1).… 
隐藏 图 标 (H) 





图 8.4.3.5 将 SD 卡 连 接 到 Ubuntu 中 
点 击 图 8.4.3.5 中 的 “连接 ( 断 开 与 主机 的 连接 )(C)” 点 击 以 后 会 弹出 如 图 8.4.3.6 所 示 提 示 


界面 : 





















































Ubuntu 64 位 - VMware Workstation x 


o 某 个 USB Ut iG pf EA EL HEX BEBTVUIETUIL. 
LJ! 。 设备 将 先 停 止 以 实现 安全 移 除 。 对 于 某 些 设备 ， 主 机 
可 能 会 显示 消息 ` 现 在 可 以 安全 地 移 除 设备 。” 


He zs EJ 





不 再 显示 此 消息 (S) 











确定 取消 




















图 8.4.3.6 提示 界 

图 8.4.3.6 提示 你 有 个 USB 要 从 主机 (Windows) 拔 出 ， 插 入 虚拟 机 中 ， 点 击 “ 确 定 ” 按 钮 即 

"f. SD 卡 出 入 到 Ubuntu 以 后 , 图 标 马 就 会 变 为 国 , 不 是 灰色 的 了 。 在 输入 命令 “ls /dev/sd*” 
来 查看 当前 Ubuutu 下 的 存储 设备 ， 如 图 8.4.3.7 Bros: 
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: $ ls /dev/sd* 
: sl 


图 8.4.3.7. 当前 系统 存储 设备 

从 图 8.4.3.7 中 可 以 看 到 ， 我 的 电脑 多 出 了 /dewsdb 、/dewsdc、/dewsdd、/dev/sddl1、/dev/sda 
和 /dev/sdf 这 6 个 存储 设备 。 这 是 因为 我 的 读 卡 器 是 多 合 一 读 卡 器 ， 所 以 会 多 出 来 这 么 多 ， 如 果 
你 用 的 单一 读 卡 器 那么 应 该 只 会 出 现 一 个 或 者 两 个 , 那 这 6 个 存储 设备 哪个 才 是 我 的 SD 卡 呢 ? 
/dev/sdd 和 /dev/sdd1 是 我 的 SD F, 为 什么 昵 ? 因为 只 有 /devsdd 有 个 对 应 的 /dev/sdd1, /dev/sdd 
是 我 的 SD F, /dev/sddl 是 SD 卡 的 第 一 个 分 区 。 如 果 你 的 SD 卡 有 多 个 分 区 的 话 可 能 会 出 现 
/dev/sdd2、/dev/sdd3 等 等 。 确 定好 SD 卡 以 后 我 们 就 可 以 使 用 软件 imxdownload 向 SD 卡 烧 写 
led.bin 文件 了 。 

如 果 你 的 电脑 没有 找到 SD 卡 的 话 ， 尝 试 重启 一 下 Ubuntu 操作 ! 

4、 向 SD 卡 烧 写 bin 文件 

使 用 imxdownload 向 SD FS led.bin 文件 ,命令 格 式 如 下 : 

.-Amxdownload <.bin file> <SD Card> 

其 中 .bin 就 是 要 烧 写 的 .bin 文件 ，SD Card 就 是 你 要 烧 写 的 SD 卡 ， 比 如 我 的 电脑 使 用 如 下 
命令 烧 写 led.bin 到 /dev/sdd "P: 

./imxdownload led.bin /dev/sdd 

烧 写 的 过 程 中 可 能 会 让 你 输入 密码 ， 输 入 你 的 Ubuntu 密码 即 可 完成 烧 写 ， 烧 写 过 程 如 图 
8.4.3.8 所 示 : 




































































$ ./imxdownload Led.bin /dev/sdd 


I.MX6UL bin download software 
Edit by:zuozhongkai 


Date:2018/8/9 

Version:V1.0 

file led.bin size = 160Bytes 

Delete Old load.imx 

Create New load.imx 

Download load.imx to /dev/sdd 

[sudo] zuozhongkai 的 密码 : 

记录 了 6+1 的 读 入 

记录 了 6+1 的 写 出 

3232 bytes (3.2 kB, 3.2 KiB) copied, 0.0160821 s, 201 kB/s 





图 8.4.3.8 imxdownload 烧 写 过 程 
在 图 8.4.3.8 中 ， 烧 写 的 最 后 一 行 会 显示 烧 写 大 小 、 用 时 和 速度 ， 比如 led.bin 烧 写 到 SD 卡 
中 的 大 小 是 3.2KB， 用 时 0.0160821s， 烧 写 速度 是 201KB/s。 注 意 这 个 烧 写 速度 ， 如 果 这 个 烧 写 
速度 在 几 百 KB/s 一 下 那么 就 是 正常 烧 写 。 

如 果 这 个 烧 写 速度 大 于 几 十 MB/s、 甚 至 几 百 MB/s 那么 肯定 是 烧 写 失败 了 ! 

如 果 这 个 烧 写 速度 大 于 几 十 MB/s、 甚 至 几 百 MB/s 那么 肯定 是 烧 写 失败 了 ! 

如 果 这 个 烧 写 速度 大 于 几 十 MB/s、 甚 至 几 百 MB/s 那么 肯定 是 烧 写 失败 了 ! 

解决 方法 就 是 重新 揪 拔 SD 卡 , 一 般 出 现 这 种 情况 ,重新 插 拔 SD 卡 基本 没 喻 用 ,只 有 重启 
Ubuntu， 至 于 原因 ， 我 也 不 清楚 。 

烧 写 完成 以 后 会 在 当前 工程 目录 下 生成 一 个 load.imx 的 文件 ， 如 图 8.4.3.9 所 示 : 


$ ls 
led.dis led.o led.s |load.imx | Makefile 






















































































图 8.4.3.9 生成 的 load.imx 文件 
load.imx 这 个 文件 就 是 软件 imxdownload 根据 NXP 官方 启动 方式 介绍 的 内 容 , 在 led.bin XC 



































件 前 面 添加 了 一 些 数据 头 以 后 生成 的 。 最 终 烧 写 到 SD 卡 里 面 的 就 是 这 个 load.imx 文件 ， 而 非 
led.bin。 人 至 于 具体 添加 了 些 什么 内 容 ， 我 们 会 在 下 一 章 讲解 。 
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8.4.4 代码 验证 


代码 已 经 烧 写 到 了 SD 卡 中 了 ， 接 下 来 就 是 将 SD 卡 插 到 开发 板 的 SD 卡 模 中 ,然后 设置 拨 
人 码 开 关 为 SD 卡 启 动 ， 拨 码 开关 设置 如 图 8.4.4.1 所 示 : 














m 
» 8 BEN a 
下 
NS 8.4.4.1. REFR SD 卡 启 动 设 置 


设置 好 以 后 按 一 下 开发 板 的 复位 键 ,如 果 代 码 运行 正常 的 话 LEDO 就 会 被 点 亮 , 如 图 8.4.4.2 
所 示 : 











图 8.4.4.2 LEDO 点 亮 
如 图 8.4.4.2 所 示 , LEDO 被 正常 点 亮 ,可 能 LED0 之 前 会 有 一 点 微 亮 ， 到 那 时 因为 LTMX6U 
的 IO 默认 电 平 可 能 让 LEDO 导 通 了 ， 但 是 IO 的 默认 配置 内 部 可 能 有 很 大 的 电阻 ， 所 以 电流 就 
很 小 ， 倒 是 LEDO 微 亮 。 但 是 我 们 自己 编写 代码 、 配 置 好 IO 以 后 就 不 会 有 这 个 问题 ，LED0 就 
很 亮 了 。 
本 小 节 我 们 详细 的 讲解 了 如 何 编译 代码 ， 并 且 如 何 将 代码 烧 写 进 SD 卡 中 进行 测试 。 后 续 
我 们 的 所 有 裸 机 实验 和 Uboot 实验 都 使 用 的 这 种 方法 进行 代码 的 烧 写 和 测试 。 
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第 九 章 LMX6U 启动 方式 详解 


LMX6U 支持 多 种 启动 方式 以 及 启动 设备 , 比如 可 以 从 SD/EMMC.NAND Flash, QSPI Flash 








等 启动 。 用 户 可 以 根据 实际 情况 ， 选 择 合适 的 局 动 设备 。 不 同 的 启动 方式 其 启动 方式 和 启动 要 
求 也 不 一 样 ， 比 如 上 一 章 中 的 从 SD 卡 启动 就 需要 在 bin 文件 前 面 添加 一 个 数据 头 ， 其 它 的 启 
动 设备 也 是 需要 这 个 数据 头 的。 本 章 我 们 就 来 学 习 一 下 IMX6U 的 局 动 方式 ， 以 及 不 同 设备 启 
动 的 要 求 。 
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9.1 启动 方式 选择 
BOOT 的 处 到 














过 程 是 发 生 在 工 


论坛 :www.opendev.com 


MX6U 蕊 片上 电 以 后 , 芯片 会 根据 BOOT MODE[1:0] 的 设置 








来 选择 BOOT FI. BOOT_MODEI[1:0] 的 值 是 可 以 改变 的 , 有 两 种 方式 , 一 种 是 改写 eFUSE( 熔 





第 只 能 修改 一 次 , 后 面 就 不 能 








种 修改 eFUSE 的 方式 





££), 一 种 是 修改 相应 的 GPIO ARH 


H YE 
G o 





从 用 








EE 














在 修改 了 ， 所 以 我 们 不 使 用 。 我 们 使 用 的 是 通过 修改 BOOT MODE[1:0] 对 应 的 GPIO 高 低 电 平 
来 选择 启动 方式 ， 所 有 的 开发 板 都 使 用 的 这 种 方式 ，LMX6U 有 一 个 BOOT MODEI 引 脚 和 





BOOT MODEO 引 脚 ， 这 两 个 引 脚 对 应 这 BOOT_ MODE[1:0]。LMX6U-ALPHA H 





个 引 脚 原理 图 如 图 9.1.1 所 示 : 





BOOT MODEO SHIFT SDI 


BOOT MODEI 










图 9.1.1 BOOT. MODE 原理 


C 3V3 
OFF ON[ 16 BOOT MODE! 
[0K] (= 15 BOOT MODEO 
E re LRO0 3 | : 





F 发 板 的 这 两 


T10 


SHIFT SECP Dio BOOT MODEO/GPIOS 1010 


BOOT MODEI/GPIOS5 1011 





LCD DAIAI 
LCD DATA3 
LCD DATA4 
LCD DATAS 
LCD DATA6 
LCD DATA7 






13 
12 
11 
10 
9 









BOOT_CFG 











ER] 


其 中 BOOT MODEI 和 BOOT MODEO 7E: Hr Vj SEE t 100K O 下 拉 电 阻 的 ， 所 以 默认 是 
0. BOOT MODEI 和 BOOT MODE0 这 两 个 引 脚 我 们 也 接 到 了 底板 的 拨 码 开关 上 ， 这 样 我 们 


Af 
通过 R88 这 个 10K 电阻 接 到 了 3. 























可 以 通过 拨 码 开关 来 控制 BOOT MODEI 和 BOOT MODEO 的 高 低 电 平 。 以 BOOT_MODE1 
1， 当 我 们 把 BOOT. CFG 的 第 一 个 





开关 拨 到 “ON ”的 时 候 ， 就 相当 于 BOOT MODEI 引 脚 
3V 电源 ， 芯 片 内 部 的 BOOT MODEI 又 是 100K 下 拉 电 阻 接 








电压 就 是 100/(10+100)*3.3V= 3V， 这 是 个 高 电 平 ，BOOT CFG 





地 ， 因 此 此 时 BOOT MODEI 的 日 











这 个 拨 码 开关 的 不 管 哪个 位 拨 到 


“ON” 就 是 高 电 平 ， 拨 到 “OFF” 就 是 低 电 平 。 


而 ILMX6U 有 四 个 BOOT 模式 ， 这 四 个 BOOT 模式 由 BOOT MODE[1:0] 来 控制 ， 也 就 是 


BOOT MODEI 和 BOOT MODE0 这 两 O，BOOT 模式 配置 如 表 9.1.1 所 示 : 

















从 FUSE 启动 
01 串 行 下 载 
10 内 部 BOOT 模式 
11 保留 























在 表 9.1.1 中 ， 我 们 用 到 的 只 





9.1.1 串 行 下 载 
当 BOOT MODEI 为 0，BO 


以 通过 USB 或 者 UART 将 代码 下 载 到 板子 上 的 外 置 存储 设备 中 ,我 们 可 以 使 月 
FA ERI SD/EMMC. NAND 等 存储 设备 下 载 代码 。 我 们 需要 将 BOOT_MODE1 拨 到 








口 向 


“OFF”, 将 BOOT MODEO 拨 到 “ON ”。 这 个 下 载 是 需要 用 到 NXP 提供 的 一 个 软件 ， 一 般 月 


表 9.1.1 BOOT 类 型 
有 第 二 和 第 三 中 BOOT 方式 。 








g 
A 





行 下 载 的 意思 就 是 可 
H OTGI 这 个 USB 


eu 
H5» 


OT MODEO 为 1 的 时 候 此 模式 使 














H 
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来 最 终 量 产 的 时 候 将 代码 烧 写 到 外 置 存储 设备 中 的 ， 我 们 后 面 讲解 如 何 使 用 。 




















9.1.2 内 部 BOOT 模式 


当 BOOT_MODE 为 1，BOOT_MODE0 为 0 的 时 候 此 模式 使 能 ， 在 此 模式 下 ， 沪 片 会 执行 
内 部 的 boot ROM 代码 ， 这 段 boot ROM 代码 会 进行 硬件 初始 化 (一 部 分 外 设 )， 然 后 从 boot 设 
备 (就 是 存放 代码 的 设备 、 比 如 SD/EMMC、NAND) 中 将 代码 拷贝 出 来 复制 到 指定 的 RAM rn, 
一 般 是 DDR. 




















9.2 BOOT ROM 初始 化 内 容 


当 我 们 设置 BOOT 模式 为 “内 部 BOOT 模式 ”以 后 ，LMX6U 内 部 的 boot ROM 代码 就 会 
执行 ， 这 这 个 boot ROM 代码 都 会 做 什么 处 理 呢 ?首先 肯定 是 初始 化 时 钟 ，boot ROM 设置 的 系 
统 时 钟 如 图 9.2.1 所 示 : 


Frequency (MHz) Frequency (MHz) 
BT_FREQ=0 BT_FREQ=1 


























ARM PLL pll1_sw_clk 396 396 

System PLL [pll2_sw_clk | |528 |528 | 
USB PLL |pll3 sw clk | |480 |480 | 
AHB [ahb clk root |528 MHz PLL/PFD352 |132 |88 | 
IPG lipg_clk_root |528 MHz PLL/PFD352 |66 |44 | 





图 9.2.1 boot ROM 系统 时 钟 设置 
在 图 9.2.1 中 BT_FREQ 模式 为 0， 可 以 看 到 ，boot ROM 会 将 LMX6U 的 内 核 时 钟 设置 为 
396MHz， 也 就 是 主 频 为 396Mhz。System PLL-528Mhz, USB PLL-480MHz, AHB-132MHz. 
IPG-66MHz. XT LMX6U 的 系统 时 钟 ， 我 们 后 面 会 详细 讲解 。 

内 部 boot ROM 为 了 加 快 执行 速度 会 打开 MMU 和 Cache， 下 载 镜像 的 时 候 LI1ICache 会 打 
开 ， 验 证 镜像 的 时 候 LI1DCache、L2 Cache 和 MMU 都 会 打开 。 一 旦 镜像 验证 完成 ，bootROM 
就 会 关闭 Ll DCache、L2 Cache 和 MMU. 

中 断 向 量 偏 移 会 被 设置 到 boot ROM 的 起 始 位 置 ， 当 boot ROM 启动 了 用 户 代 码 以 后 就 可 
以 重新 设置 中 断 向 量 偏 移 了 。 一 般 是 重新 设置 到 我 们 用 户 代 码 的 开始 地 方 ， 关 于 中 断 的 内 容 后 
面 会 详细 讲解 。 


9.3 启动 设备 


当 BOOT MODE 设置 为 内 部 BOOT 模式 以 后 ， 可 以 从 一 下 设备 中 启动 : 

D, $F] EIM 接口 的 CS0 上 的 16 位 NOR Flash. 

@、 接 到 EIM 接口 的 CS0 上 的 OneNAND Flash. 

@、 接 到 GPMI 接 口上 的 MLC/SLC NAND Flash, NAND Flash 页 大 小 支持 2KByte、 4KByte 
和 SKByte, 8 位 宽 。 

©, Quad SPI Flash。 

@、 接 到 USDHC 接口 上 的 SD/MMC/eSD/SDXC/eMMC 等 设备 。 

(60. SPI 接口 的 EEPROM。 

这 些 启动 设备 如 何 选择 呢 ? LMX6U 同样 提供 了 eFUSE 和 GPIO 配置 两 种 ，eFUSE 就 不 讲 
解 了 。 我 们 重点 看 如 何 通过 GPIO 来 选择 启动 设备 ， 因 为 所 有 的 ILMX6U 开发 板 都 是 通过 GPIO 
来 配置 启动 设备 的 。 正 如 启动 模式 由 BOOT MODE[1:0] 来 选择 一 样 ， 启 动 设备 是 通过 
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BOOT _CFG1[7:0]、BOOT_CFG2[7:0] 和 BOOT_CFG4[7:0] 这 24 个 配置 JO， 这 24 个 配置 IO MI 
好 对 应 着 LCD 的 24 根 数据 线 LCD DATA0~LCDDATA23， 当 启动 完成 以 后 这 24 个 IO 就 可 以 
作为 LCD 的 数据 线 使 用 。 这 24 根 线 和 BOOT MODEI. BOOT MODE0 共同 组 成 了 LMX6U 
的 启动 选择 引 脚 ， 如 图 9.3.1 所 示 : 


Boor moos fa eBoorMooe Selecton 
moorwoxo | 
LCDiDATMD — [mu — [BOOCFGN) — | 
BOO CFGi( 
immer C — — — — — Boxe — — — 
Ln DAT — |mu — poor | 
LCD DATK4 — —— [mu — — — [BOOTCFGNi | 
eps — [mu — — oorceg | 
biao — (mu —— [BOOLCFGNS — 
cpm — C — oorcem | 
cot — (mua — e | 
LCD DATMO — [mu — — — Ee | 
tao — (mu — oorceam — 
pi — — — (mua —— once 
cD DA — imu — — oorcecm | 
LcDiDAMG — (mu —— [BOOLCFGdS — 
LCD DATAM — leoorcreael | 
LcDiDATMS — — — imu — orcem —— 
ore — — — — [mu ——  [BOOTCFG4Q) — 
LCDiDATM] —— C —— orcem 
LODiDATMS — [mu —— orceam 
LcDiDATMG — T — orcea 
LcDiDATMO lwp —  [BOOTCFGAÀ] | 
ACD DAZ lw — E e | 
pi lm —— orce 
eps lm ——  [BOOrCFG4/] | 
9.3.1 启动 引 脚 

通过 图 9.3.1 中 的 26 个 启动 IO 即 可 实现 ILMX6U 从 不 同 的 设备 启动 ， BOOT MODEI 和 
BOOT MODE0 已 经 讲 过 了 。 看 到 这 24 个 IO 是 不 是 头 大 ? 调整 这 24 个 IO 的 高 低 电 平 得 多 复 
杂 啊 ? REDA BRA 24 个 IO， 但 是 实际 需要 调整 的 只 有 那 几 个 IO， 其 它 的 IO 全 部 下 拉 
接地 即 可 ， 也 就 是 设置 为 0。 打开 LMX6U-ALPHA 开发 板 的 核心 板 原理 图 ， 这 24 个 IO 的 默认 
设置 如 图 9.3.1 所 示 : 
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DCDC 3V3 
RI R3 [R2 
cl 
a Ul 
IOK II10NI0K 
R4 ppp% BT CFGII0] LCD DATAO 
R87 Snp OK By BT CFGINI] LCD DATAI 
[R5 lOK | BT CFGi] LCD DATA2 
( R6 [——À0K | BT CFGIB] LCD DATA3 
R88 OK BT_CFG1[4] LCD DATA4 
Ln BT CFGI[5] LCD DATAS 


BT CFGI[6] LCD DATA6 
BT CFGI LCD DATA7 


BT CFG2[0] LCD DATAS 


E 
© 
S 
5 


RI OK — | BT CFG2[I] LCD DATA9 

RI2 OK — | BT CFG2D] LCD DATA10 

BT CFG3] LCD DATAII 

[ORIS OK — | BT CFG[4] LCD DATAI2 

[RIA -一 IOK — | BT CFG2[5] LCD DATA13 

[RIS =K | Br CFG2[6] LCD DATIA14 
R16 ——J0K Br CFG2[71 LCD DATAIS 
R17 0K BT CEG4[0] LCD DATAI6 
R18 [—7]0K BT CFG4[1 LCD DATA17 
RI9 mK BT _CFG4[2] LCD DATA18 
R20 mK BT CFG4[3] LCD DATAI9 
R21 [LOK BT CFG4[4] LCD DATA20 
R22 一 二 LOK BT CFG4[5] LCD DATA2I 
R23 LOK BT CFG4[6] LCD DATA22 
R24 10K BT CFG4[7] LCD DATA23 

jose] 
GND 


9.3.1 BOOT CFG 默认 设置 
可 以 看 出 在 图 9.3.1 中 大 部 分 的 IO 都 接地 了 ， 只 有 几 个 IO 接 高 , 尤其 是 BOOT. CFG4[7:0] 
这 8 个 IO 都 10K 电阻 下 拉 接地 ， 所 以 我 们 压根 就 不 需要 去 关注 BOOT_CFG4[7:0]。 我 们 需要 
重点 关注 的 就 只 剩 下 了 BOOT CFG2[7:0]fll BOOT_CFG1[7:0] 这 16 个 IO. 3X 16 个 配置 IO 含 
义 在 原理 图 的 左 侧 已 经 贴 出 来 了 ， 如 图 9.3.2 所 示 : 
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FUSE MAP v; A 3 à 5 á á 





Memory Type: 
0 - NOR Flash 
- OneNAND 
www) s |l mE taris 


ED W- No cycle A50 ang SORIA only) 
SD/eSD Fast Boot: CMM T.E Y rough SD pad 
0 - Regular - SDRSO. T'- direct 
1- 他 niy) 








MMC/eMMC Fast Boot: SD/MMC Speed 


0 - Regular 0 - Highl 
1 - Fast Boo 1- Normal 
BT TOGGLEMODE 
| 








Boot 
Reserved Reserved Reserved 


m] H D 
SD/eSD 


MMC/eMMC 





图 9.3.2 BOOT CFG 引 脚 含义 
9.32 看 着 是 不 是 也 很 头 大 ，BOOT CFGI[7:0]fll BOOT _CFG2[7:0] 这 16 个 IO 还 能 
在 减少 呢 ? 可 以 ! 打开 ILMX6U-ALPHA 开发 板 的 底板 原理 图 , 底板 上 启动 设备 选择 拨 码 开关 原 
理 图 如 图 9.3.3 所 示 : 


DCDC 3V3 
















16 BOOT MODEI 
15 BOOT MODEO 
14 LCD DATAII 
13 LCD DATA3 
12 LCD DATA4 
11 LCD DATAS 
10 LCD DATA6 
LCD DATA7 
















BOOT CFG 


9.3.3 BOOT 选择 拨 码 开关 
在 9.33 中 ， 除 了 BOOT MODEI 和 BOOT MODEO 必须 引出 来 ， 
LCD DATA3-LCDDATA7. LCD DATA11 这 6 个 IO 也 被 引出 来 了 ， 可 以 通过 拨 码 开关 来 设置 
其 对 应 的 高 低 电 平 ， 拨 码 开关 拨 到 “ON ”就 是 1， 拨 到 “OFF” 就 是 0。 其 中 LCD_DAIAI11 就 
是 BOOT_CFG2[3], LCD_DATA3~LCD_DATA7 就 是 BOOT_CFG1[3]~BOOT_CFG1[7], 这 6 个 
IO 的 配置 含义 如 表 9.3.1 所 示 : 
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为 0 时 从 SDHCI 上 的 SD/EMMC 启动 ,为 1 时 从 
SDHC2 上 的 SD/EMMC 启动 。 

当 从 SD/EMMC 启动 的 时 候 设 置 启动 速度 ， 当 从 
NAND 启动 的 话 设置 NAND 数量 。 


BOOT CFG2[3] LCD DATAII1 





BOOT CFGI[3] LCD DATA3 
































BOOT CFGI[4] LCD DATA4 BOOT CFGI[7:4]: 
0000 ”NOR/OneNAND(EIM) 启 动 。 
BOOT CFGI[5] LCD DATAS 0001  QSPI 启动 。 
0011 SPI 启动 。 
BOOT CFGI[6] LCD DATA6 010x SD/eSD/SDXC 启动 。 
011x MMC/eMMC 启动 。 
BOOT CFG1[7] LCD DATAT7 lxxx NAND Flash 启动 。 

















K 9.3.1BOOT IO 含义 
根据 表 9.3.1 中 的 BOOTIO 含义 ，LMX6U-ALPHA 开发 板 从 SD 卡 、EMMC、NAND 启动 
的 时 候 拨 码 开关 各 个 位 设置 方式 如 表 9.3.2 所 示 : 


[4 














x | FEAT FAX, "TER USB 烧 写 镜像 文件 。 
0 | SD 卡 启 动 。 
0 | EMMC 启动 。 
1 | NAND FLASH 启动 。 
表 9.3.2 LMX6U-ALPHA 开发 板 启动 设置 
我 们 在 “第 八 章 汇编 LED 灯 试 验 ” 中 ， 最 终 的 可 执行 文件 led.bin 烧 写 到 了 SD 卡 里 面 ， 
然后 开发 板 从 SD 卡 启动 ， 其 拨 码 开关 就 是 根据 表 9.3.2 来 设置 的 ， 通 过 上 面 的 讲解 就 知道 为 什 
么 拨 码 开关 要 这 么 设置 了 。 


9.4 镜像 烧 写 


注意 ! 本 小 节 会 分 析 bin 文件 添加 的 头 部 信息 , 但 是 在 笔者 写本 教程 的 时 候 关 于 LMX 系列 
SOC 头 部 信息 的 资料 很 少 ， 基 本 只 能 参考 NXP 官方 资料 ， 而 官方 资料 有 些 地 方 讲 解 的 又 不 是 
很 详细 。 所 以 本 节 有 部 分 内 容 是 笔者 根据 NXP 官方 u-boo.imx 文件 的 头 部 信息 反 推 出 来 的 ， 
此 难免 有 错误 的 地 方 ， 还 望 大 家 谅解 ! 如 有 发 现 错误 之 处 ， 欢 迎 大 家 在 www.openedv.com 论坛 
ER Se 

前 面 我 们 设置 好 BOOT 以 后 就 能 从 指定 的 设备 启动 了 ,但 是 你 的 设备 里 面 得 有 代码 啊 ， 在 
第 八 章 中 我 们 使 用 imxdownload 这 个 软件 将 led.bin 烧 写 到 了 SD 卡 中 。imxdownload 会 在 led.bin 
前 面 添加 一 些 头 信息 ， 重 新 生成 一 个 叫做 load.imx 的 文件 ， 最 终 实际 烧 写 的 是 laod.imx。 那 么 
肯定 就 有 人 问 : imxdownload 究竟 做 了 什么 ? load.imx 和 led.bin 究竟 是 什么 关系 ? 本 节 我 们 就 
来 详细 的 讲解 一 下 imxdownload 是 如 何 将 led.bin 打包 成 load.imx 的 。 

学 习 STM32 的 时 候 我 们 可 以 直接 将 编译 生成 的 .bin 文件 烧 写 到 STM32 内 部 flash 里 面 , 但 
是 LMX6U 不 能 直接 烧 写 编译 生成 的 .bin 文件 ， 我 们 需要 在 .bin 文件 前 面 添加 一 些 头 信息 构成 
满足 ILMX6U 需求 的 最 终 可 烧 写 文件 ，I.MX6U 的 最 终 可 烧 写 文件 组 成 如 下 : 

(D. Image vector table， 简 称 IVT, IVT 里 面包 含 了 一 系列 的 地 址 信息 ， 这 些 地 址 信息 在 
ROM 中 按照 固定 的 地 址 存放 着 。 


>< 











—|—|—|Io!| 





oO[—oo|x 





—|ojo!|x 





oOoj=|ojx 
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©, Boot data， 局 动 数据 ， 包 含 了 镜像 要 拷贝 到 哪个 地 址 ， 拷 贝 的 大 小 是 多 少 等 等 。 

(3. Device configuration data， 简 称 DCD， 设 备 配置 信息 ， 重 点 是 DDR3 的 初始 化 配置 。 

@、 用 户 代码 可 执行 文件 ， 比 如 led.bin。 

可 以 看 出 最 终 烧 写 到 LMX6U 中 的 程序 其 组 成 为 : IVT+Boot data+DCD+.bin。 所 以 第 八 章 
中 的 imxdownload 所 生成 的 laod.imx 就 是 在 led.bin 前 面 加 上 IVT+Boot data+DCD。 内 部 Boot 
ROM 会 将 load.imx 拷贝 到 DDR 中 ， 用 户 代码 是 要 一 定 要 从 0X87800000 这 个 地 方 开 始 的 ， 
为 链接 地 址 为 0X87800000, laod.imx 在 用 户 代 码 前 面 又 有 3KByte 的 IVT+Boot Data+DCD 数 
据 ， 下 面 会 讲 为 什么 是 3KByte， 因 此 load.imx Æ DDR 中 的 起 始 地址 就 是 0X87800000- 
3072=0X877FF400。 









































9.4.1 IVT 和 Boot Data 数据 





























针 和 一 些 用 作 其 它 用 途 的 指针 。 内 部 Boot ROM 要 求 IVT 应 该 放 到 指定 的 位 置 ， 不 同 的 启动 设 
AMANDE, M IVT 在 整个 load.imx 的 最 前 面 ， 其 实 就 相当 于 要 求 load.imx 在 烧 写 的 时 候 应 该 
伐 写 到 存储 设备 的 指定 位 置 去 。 整 个 位 置 都 是 相对 于 存储 设备 的 起 始 地 址 的 偏 移 ， 如 图 9.4.1.1 


所 示 : 
Boot Device Type Image Vector Table Offset Initial Load Region Size 


4 Kbyte = Ox1000 bytes Entire Image Size 
256 bytes = 0x100 bytes 1 Kbyte 


load.imx 最 前 面 的 就 是 IVT 和 Boot Data, IVT 包含 了 镜像 程序 的 入 口 点 、 指 向 DCD 的 指 









































SD/MMC/eSD/eMMC/SDXC 1 Kbyte = 0x400 bytes 4 Kbyte 
SPI EEPROM 1 Kbyte = 0x400 bytes 4 Kbyte 





图 9.4.1.1. IVT 偏 移 
以 SD/EMMC 为 例 ，IVT 偏 移 为 IKbyte，IVT+Boot data+DCD 的 总 大 小 为 4KByte- 
1KByte=3KByte。 假 如 SD/EMMC 每 个 扇 区 为 512 字 节 ， 那 么 load.imx 应 该 从 第 三 个 扇 区 开始 
烧 写 ， 前 两 个 扇 区 要 留 出 来 。load.imx 从 第 3KByte 开始 才 是 真正 的 .bin 文件 。 那 么 IVT 里 面 究 
竟 存 放 着 什么 东西 呢 ? IVT 里 面 存放 的 内 容 如 图 9.4.1.2 所 示 : 


header 















































entry: Absolute address of the first instruction to execute from the image 





reserved1: Reserved and should be zero 


dcd: Absolute address of the image DCD. The DCD is optional so this field may be set to NULL if no DCD is required. See 
Device Configuration Data (DCD) for further details on DCD. 


boot data: Absolute address of the Boot Data 
self: Absolute address of the IVT. Used internally by the ROM 


csf: Absolute address of Command Sequence File (CSF) used by the HAB library. See High Assurance Boot (HAB) for 
details on secure boot using HAB. This field must be set to NULL when not performing a secure boot 




















reserved2: Reserved and should be zero 





图 9.4.1.2 IVT 格式 
从 图 9.4.1.2 可 以 看 到 ， 第 一 个 存放 的 就 是 header( 头 )，header 格式 如 图 9.4.1.3 所 示 : 


9.4.1.3 IVT header 格式 
在 图 9.4.1.3 F, Tag 为 一 个 字 节 长 度 ， 固 定 为 0XD1，Length 是 两 个 字 节 ， 保 存 着 IVT 长 
度 ， 为 大 端 格式 ， 也 就 是 高 字 节 保存 在 低 内 存 中 。 最 后 的 Version 是 一 个 字 节 ， 为 0X40 或 者 
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0X41. 
Boot Data 的 数据 格式 如 图 9.4.1.4 所 示 : 





start Absolute address of the image 
Size of the program image 








Plugin flag (see Plugin Image) 


9.4.1.4 Boot Data 数据 格式 
实际 情况 是 不 是 这 样 的 呢 ? 我 们 用 winhex 软件 打开 load.imx 一 看 便 知 ，winhex 可 以 直接 
查看 一 个 文件 的 二 进 制 格式 数据 ，winhex 软件 我 们 已 经 放 到 了 开发 板 光盘 中 ， 路 径 为 : 开发 板 
光盘 ->3、 软 件 -> winhexv19.7.zip， 大 家 自行 安装 。 用 winhex 打开 以 后 的 load.imxd 如 图 9.4.1.4 
所 示 : 























Offset Ü L1 2 3 £4 5 6 7 8 9 AB C D E F 1011 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F 
00000000 D1 00 20 40 00 00 80 87 00 00 00 00 2C F4 7F 87 20 F4 7F 87 00 F4 7F 87 00 00 00 00 00 00 00 00 
00000020 00 FO 7F 87 00 00 20 00 00 00 00 00 D2 01 E8 40 CC O1 E4 04 02 OC 40 68 FF FF FF FF 02 OC 40 6C 
00000040 FF FF FF FF 02 OC 40 70 FF FF FF FF 02 OC 40 74 FF FF FF FF 02 OC 40 78 FF FF FF FF 02 OC 40 7C 
00000060 FF FF FF FF 02 OC 40 80 FF FF FF FF 02 OE 04 B4 00 OC 00 00 02 OE 04 AC 00 00 00 00 02 OE 02 7C 
00000080 00 00 00 30 02 OE 02 50 00 00 00 30 02 OE 02 4C 00 00 00 30 02 OE 04 90 00 00 00 30 02 OE 02 88 
000000A0 00 OC 00 30 02 OE 02 70 00 00 00 00 02 OE 02 60 00 00 00 30 02 OE 02 64 00 00 00 30 02 OE 04 AO 
000000CO0 00 00 00 30 02 OE 04 94 00 02 00 00 02 OE 02 80 00 00 00 30 02 OE 02 84 00 00 00 30 02 OE 04 BO 
000000E0 00 02 00 00 02 OE 04 98 00 00 00 30 02 OE 04 A4 00 00 00 30 02 OE 02 44 00 00 00 30 02 OE 02 48 
00000100 00 00 00 30 02 1B 00 1C 00 00 80 00 02 1B 08 00 A1 39 00 03 02 1B 08 OC 00 03 00 OB 02 1B 08 3C 
00000120 01 48 01 44 02 1B 08 48 40 40 2C 30 02 1B 08 50 40 40 3E 34 02 1B 08 1C 33 33 33 33 02 1B 08 20 
00000140 33 33 33 33 02 1B 08 2C F3 33 33 33 02 1B 08 30 F3 33 33 33 02 1B 08 CO 00 94 40 09 02 1B 08 B8 
00000160 00 00 08 00 02 1B 00 04 00 02 00 2D 02 1B 00 08 1B 33 30 30 02 1B 00 OC 67 6B 52 F3 02 1B 00 10 
00000180 B6 6D OB 63 02 1B 00 14 01 FF 00 DB 02 1B 00 18 00 20 17 40 02 1B 00 1C 00 00 80 00 02 1B 00 2C 
000001A0 00 00 26 D2 02 1B 00 30 00 6B 10 23 02 1B 00 40 00 00 00 4F 02 1B 00 00 $84 18 00 00 02 1B 08 90 
000001CO 00 40 00 00 02 1B 00 1C 02 00 80 32 02 1B 00 1C 00 00 80 33 02 1B 00 1C 00 04 80 31 02 1B 00 1C 
000001E0 15 20 80 30 02 1B 00 1C 04 00 80 40 02 1B 00 20 00 00 08 00 02 1B 08 18 00 00 02 27 02 1B 00 04 
00000200 00 02 55 2D 02 1B 04 04 00 01 10 06 02 1B 00 1c 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00000220 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00000240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 


图 9.4.1.4 load.imx 部 分 内 容 
9.4.1.4 是 我 们 截取 的 load.imx 的 一 部 分 内 容 ， 从 地 址 0X00000000~0X000025F， 共 608 
个 字 节 的 数据 。 我 们 将 前 44 个 字 节 的 数据 按照 4 个 字 节 一 组 组 合 在 一 起 就 是 : 0X402000D1、 
OX87800000、0X00000000、0X877FF42C、0X877FF420、0X877FF400、0X00000000、0X00000000、 
0X877FF000、0X00200000、0X00000000。 这 44 个 字 节 的 数据 就 是 TVT 和 Boot Data 数据 ， 按 
ER 9.4.1.2 和 图 9.4.1.4 所 示 的 IVT 和 Boot Data 所 示 的 格式 对 应 起 来 如 表 9.4.1.1 所 示 : 





根据 图 9.4.1.3 的 header 格式 ， 第 一 个 字 节 Tag 为 
0XD1， 第 二 三 这 两 个 字 节 为 IVT 大 小 ， 为 大 端 模 











header 0X402000D1 . nd n Eo 
式 ， 所 以 IVT 大 小 为 0X20=32 字 节 。 第 四 个 字 节 
为 0X40。 完 全 符合 图 9.4.1.3 中 的 格式 。 
口 地 址 ， 也 就 是 镜像 第 一 行 指令 所 在 的 位 置 。 
— Ce 入 就 是 镜像 第 一 行 指 令 所 在 的 位 置 


0X87800000 就 是 我 们 的 链接 地 址 。 

reservedl 0X00000000 未 使 用 ， 保 留 。 

DCD 地 址 ， 镜 像 地 址 为 0X87800000, IVT+Boot 
Data+DCD 整个 大 小 为 3KByte。 因 此 load.imx 的 起 
始 地 址 就 是 0X87800000-0XC00=0X877FF400。 
dcd 0X877FF42C 此 DCD 起 始 地 址 相对 于 load.imx 起 始 地 址 的 偏 移 
就 是 0X877FF42C-0X877FF400=0X2C, 也 就 是 说 从 
图 9.4.1.4 中 的 OX2C 这 个 地 址 开始 就 是 DCD 数据 
fa 
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boot 地 址 ，header 里 面 已 经 设置 了 IVT 大 小 是 32 
boot data 0X877FF420 个 字 节 ， 所 以 boot data 的 地 址 就 是 
0X877FF400+32=0X877FF420。 
self 0X877FF400 IVT 复制 到 DDR 中 以 后 的 首 地 址 。 
csf 0X00000000 CSF 地 址 。 
reserved2 0X00000000 保留 ， 未 使 用 。 






整个 load.imx 的 起 始 地 址 ， 包 括 前 面 IKByte 的 地 








start 0X877FF000 
址 偏 移 。 
镜像 大 小 ， 这 里 设置 2MByte。 镜 像 大 小 不 能 超过 
length 0X00200000 HERD LERE yte。 镜 像 大 小 不 能 超过 
2MByte。 
plugin 0X00000000 插件 。 




















表 9.4.1.1 load.imx 结构 分 析 
在 表 9.4.1.1 P, 我们 详细 的 列 出 了 load.imx 的 IVT+Boot Data 每 32 位 数据 所 代表 的 意义 。 
这 些 数据 都 是 由 imxdownload 这 个 软件 添加 进去 的 。 














9.4.2 DCD 数据 


复位 以 后 ，LMX6U 片 内 的 所 有 寄存 器 都 会 复位 为 默认 值 ， 但 是 这 些 默 认 值 往往 不 是 我 们 
想 要 的 值 , 而 且 有 些 外 设 我 们 必须 在 使 用 之 前 初始 化 它 。 为 此 IMX6U 提出 了 一 个 DCD(Device 
Config Data) 的 概念 ， 和 IVT、Boot Data 一 样 ，DCD 也 是 添加 到 load.imx 里 面 的 ， 紧 跟 在 IVT 
和 Boot Data 后 面 , IVT 里 面 也 指定 了 DCD WME. DCD 其 实 就 是 ILMX6U 寄存 器 地 址 和 对 应 
的 配置 信息 集合 ，Boot ROM 会 使 用 这 些 寄存 器 地 址 和 配置 集合 来 初始 化 相应 的 寄存 器 ， 比 如 
开启 某 些 外 设 的 时 钟 、 初 始 化 DDR 等 等 。DCD 区 域 不 能 超过 1768Byte，DCD 区 域 结构 如 图 
9.4.2.1 所 示 : 


























9.4.2.1 DCD 区 域 结构 
DCD 的 header 和 TVT 的 header 类 似 ， 结 构 如 图 9.4.2.2 所 示 : 


图 9.4.2.2 DCD 的 header 结构 














其 中 Tag 是 单字 节 , 固定 为 0XD2,Length 为 两 个 字 节 , 表示 DCD 区域 的 大 小 ,包含 header, 
同样 是 大 端 模 式 ，Version 是 单字 节 ， 固 定 为 0X40 或 者 0X41。 
9.4.2.1 中 的 CMD 就 是 要 初始 化 的 寄存 器 地 址 和 相应 的 寄存 器 值 ， 结 构 如 图 9.4.2.3 所 
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Tag | Length | Parameter 
Address 
| Value/Mask 
| [Address] 
[Value/Mask] 
[Address] 
| [Value/Mask] 








图 9.4.2.3 DCD CMD 命令 格式 

图 9.4.2.3 中 Tag 为 一 个 字 节 ， 固 定 为 0XCC。Length 是 两 个 字 节 ， 包 含 写 如 的 命令 数据 的 
KE, 包含 header, 同样 是 大 端 模式 。 Parameter 为 一 个 字 节 , 这 个 字 节 的 每 个 位 含义 如 图 9.4.2.4 
所 示 : 



































| flags | 
图 9.4.2.4 Parameter 结构 
图 9.4.2.4 中 的 bytes 表示 是 目标 位 置 宽 度 ， 单 位 为 byte， 可 以 选择 

是 命令 控制 标志 位 。 
图 9.4.2.3 中 的 Address 和 Vlalue/Mask 就 是 要 初始 化 的 寄存 器 地 址 和 相应 的 寄存 器 值 ， 注 
意 采 用 的 是 大 端 模式 ! DCD 结构 就 分 析 到 这 里 ， 在 分 析 IVT 的 时 候 我 们 就 已 经 说 过 了 ，DCD 
数据 是 从 图 9.4.1.4 的 0X2C 地 址 开始 的 。 根 据 我 们 分 析 的 DCD 结构 可 以 得 到 load.imx 的 DCD 


bytes 











1、2、 和 4 字 节 。flags 
























































数据 如 表 9.4.2 


DCI 





.1 所 示 : 


















































根据 图 9.4.2.2 的 header 格式 ， 第 一 个 字 节 Tag 为 0XD2， 第 
jap 三 这 MEETA D D A , y 端 模 p D D 
header 0X40E801D2 和 RA s De Ad Josiane 所 以 E 大 
小 为 0X01E8-488 字 节 。 第 四 个 字 节 为 0X40。 完 全 符合 
9.4.2.2 中 的 格式 。 
根据 图 9.4.2.3， 第 一 个 为 Tag， 固 定 为 0XCC， 第 三 和 三 这 两 
Write Data Ee 个 字 节 是 大 端 模 式 的 命令 总 长 度 , 为 0X01E4=484 个 字 节 。 第 
Command 四 个 字 节 是 Parameter， 为 0X04， 表 示 目 标 位 置 宽度 为 4 个 字 
i 
Address 0X020C4068 | 寄存 器 CCGR0 地 址 
TEE x ^ z Ji~ zm 
e EIE 要 号 入 寄存 器 CCGR0 的 值 ， 表 示 打 开 CCGRO 控制 的 所 有 外 
设 时 钟 。 
| CCGRI-CCGRS 这 些 寄存 器 的 地 址 和 值 。 
Address 0X020C4080 | 寄存 器 CCGR6 地 址 
Tes x ^ f Ji~ zs l| BA 
TT ORRE 要 号 入 寄存 器 CCGR6 的 值 ， 表 示 打 开 CCGR6 控制 的 所 有 外 
设 时 钟 。 
& IOMUXC SW PAD CTL GRP DDR TYPE Z 地 
Address 0X020E04B4 r ns ME d ML bi 
Value 0X000C0000 | 设置 DDR 的 所 有 IO 为 DDR3 模式 。 
Address 0X020E04AC | 寄存 器 IOMUXC SW PAD CTL GRP DDRPKE 地 址 。 
Value 0X00000000 | 所 有 DDR 引 脚 关 闭 Pull/Keeper 功能 。 
Address 0X020E027C | 寄存 器 IOMUXC SW PAD CTL PAD DRAM SDCLKO0 P 
Value 0X00000030 | DRAM SDCLKO P 引 脚 为 R0/6。 
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| 全 部 是 DDR 引 脚 设 置 
Address 0X020E0248 | 寄存 器 IOMUXC SW PAD CTL PAD DRAM DOMI 
Value 0X00000030 | DRAM DOMI 引 脚 驱动 能 力 为 R0/6 
Address 0X021B001C | MMDC MDSCR 寄存 器 
Value 0X00008000 | MMDC MDSCR 寄存 器 值 
| MMDC 相关 寄存 器 地 址 及 其 寄存 器 值 。 
Address 0X021B0404 | MMDC MAPSR 寄存 器 
Value 0X00011006 | MMDC MAPSR 寄存 器 配置 值 
Address 0X021B001C | MMDC MDSCR 寄存 器 
Value 0X00000000 | MMDC MDSCR 寄存 器 清 零 
表 9.42.1 DCD 数据 结构 
从 图 9.4.2.1 中 可 以 看 出 ，DCD 里 面 的 初始 化 配置 主要 包括 三 方面 : 



































(D. WE CCGRO-CCGR6 这 7 个 外 设 时 钟 使 能 寄存 器 ， 默 认 打 开 所 有 的 外 设 时 钟 。 

©, MA DDR3 所 用 的 所 有 IO. 

©, NIE MMDC 控制 器 ， 初 始 化 DDR3. 

LMX6U 的 启动 过 程 我 们 就 讲解 到 这 里 ， 本 章 我 们 详细 的 讲解 了 LIMX6U 的 启动 模式 、 启 
动 设备 类 型 和 镜像 烧 写 过 程 。 总 结 一 下 , 我 们 编译 出 来 的 .bin 文件 不 能 直接 烧 写 到 SD 卡 中 ， 需 
要 在 .bin 文件 前 面 加 上 IVT, Boot Data 和 DCD 这 三 个 数据 块 。 这 三 个 数据 块 是 有 指定 格式 的 ， 
我 们 必须 按照 格式 填写 ， 然 后 将 其 放 到 .bin 文件 前 面 ， 最 终 合 成 的 才 是 可 以 直接 烧 写 到 SD F 
中 的 文件 。 
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第 十 章 C 语言 版 LED 灯 实 验 




















第 八 章 我 们 讲解 了 如 何 用 汇编 语言 编写 LED 灯 实 验 ， 但 是 实际 开发 过 程 中 汇编 用 的 很 少 ， 
大 部 分 都 是 C 语言 开发 ,汇编 只 是 用 来 完成 C 语言 环境 的 初始 化 。 本 章 我 们 就 来 学 习 如 何 用 汇 
编 来 完成 C 语言 环境 的 初始 化 工作 ， 然 后 从 汇编 跳 转 到 C 语言 代码 里 面 去 。 
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10.1 C 语言 版 LED 灯 简 介 
第 八 章 的 汇编 LED 灯 实 验 中 ， 我 们 讲解 了 如 何 使 用 汇编 来 编写 LED 灯 驱 动 ， 实 际 工作 中 




















是 很 少 用 到 汇编 去 写 符 入 式 驱 动 的 ， 毕 竟 汇 编 太 难 ， 而 且 写 出 来 也 不 好 理解 ， 大 部 分 情况 下 都 
是 使 用 C 语言 去 编写 的 。 只 是 在 开始 部 分 用 汇编 来 初始 化 一 下 C 语言 环境 , 比如 初始 化 DDR、 
设置 堆栈 指针 SP 等 等 ， 当 这 些 工 作 都 做 完 以 后 就 可 以 进入 C 语言 环境 ， 也 就 是 运行 C 语言 代 
码 ， 一 般 都 是 进入 main 函数 。 所 以 我 们 有 两 部 分 文件 要 做 : 

D、 汇 编 文件 

汇编 文件 只 是 用 来 完成 C 语言 环境 搭建 。 

D, C 语言 文件 

C 语言 文件 就 是 完成 我 们 的 业务 层 代 码 的 ， 其 实 就 是 我 们 实际 例 程 要 完成 的 功能 。 

其 实 STM32 也 是 这 样 的 ， 只 是 我 们 在 开发 STM32 的 时 候 没 有 想到 这 一 点 ， 以 STM32F103 为 
例 ， 其 启动 文件 startap_stm32f10x_hdis 这 个 汇编 文件 就 是 完成 C 语言 环境 措 建 的 ， 当 然 还 有 一 
些 其 他 的 处 理 ， 比 如 中 断 向 量 表 等 等 。 当 startup stm32f10x hd.s 把 C 语言 环境 初始 化 完成 以 后 
就 会 进入 C 语言 环境 。 


10.2 硬件 原理 分 析 
本 章 使 用 到 的 硬件 资源 和 第 八 章 一 样 ， 就 是 一 个 LED0。 


10.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光 盘 -> 1、 裸 机 例 程 ->2_ ledc。 
新 建 VScode 工程 ， 工 程 名 字 为 “ledc”， 新 建 三 个 文件 : start.S. main.c 和 mian.h。 其 中 start.S 
是 汇编 文件 ，main.c 和 main.h Æ C 语言 相关 文件 。 

























































































































































































































































































10.3.1 汇编 部 分 实验 程序 编写 


在 STM32 中 ， 启 动 文件 startup stm32fl0x hd.s 就 是 完成 C 语言 环境 搭建 的 ， 当 然 还 有 一 
些 其 他 的 处 理 ， 比 如 中 断 向 量 表 等 等 。startup_stm32fl10x hd.s 中 堆栈 初始 化 代码 如 下 所 示 : 
示例 代码 10.3.1.1 STM32 启动 文件 堆栈 初始 化 代码 
Stack Size EQU 0x00000400 












































AREA STACK, NOINIT, READWRITE, ALIGN=3 
Stack Mem SPACE Stack Size 











; €«h» Heap Configuration 


1 

2 

3 

4 

5 _ imitial 5p 
6 

j 

8 ; «o» Heap Size (in Bytes) «0x0-O0xFFFFFFFF:8» 
9 








; «/h» 
10 
11 Heap Size EQU 0x00000200 
12 
lS AREA HEAP, NOINIT, READWRITE, ALIGN-3 

















124 Iweeg base 





15 Heap Mem SPACE Heap Sulze 
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二 lea limit 


I7. 大 火炎 大 大 大 大 火 大 大 大 大 大 大 大 大 大 大 大 关上 略 掉 部 分 代码 交大 大 大大 大 大 大 大 大 大 大 大 大 大火 大 大 火炎 大 大 类 


coi militem PROC 











19 EXPORT Reset Handler [WEAK] 
20 IMPORT . main 

2l IMPORT SystemInit 

22 LDR RO, -SystemInit 

25 BLX RO 

24 LDR RO, = main 

29 BX RO 

26 ENDE 








第 1 行 代码 就 是 设置 栈 大 小 ， 这 里 是 设置 为 0X400=1024 FI. 

第 5 行 的 _initial_ sp 就 是 初始 化 SP 指针 。 

第 11 行 是 设置 堆 大 小 。 

第 18 行 是 复位 中 断 服 务 函 数 ，STM32 复位 完成 以 后 会 执行 此 中 断 服务 函数 。 

第 22 行 调用 SystemInitO 函 数 来 完成 其 他 初始 化 工作 。 

第 24 行 调用 main， ”main 是 库 函 数 ， 其 会 调用 maino Až. 

LMX6U 的 汇编 部 分 代码 和 STM32 的 启动 文件 startup. stm32f10x hd.s 基本 类 似 的 , 只 是 本 
实验 我 们 不 考虑 中 断 向 量 表 , 只 考虑 初始 化 C 环境 即 可 。 在 前 面 创建 的 start.s 中 输入 如 下 代码 : 

示例 代码 10.3.1.2 starts. 文件 代码 


J[KCKCKCKCKCKCkCk KCkCk kCkCk kk kCKCkCk KCkCk kCkCK CC KC KCkCk kCkCk kCk Ck Ck kc k Ck kc k ck k kc k k kc k kck ck ck kck ck ck ck k 
































Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 8 BUEGBUEIE S 





作者 : ABL 

版 本 EVD 

描述 : I.MX6U-ALPHA/I.MX6ULL 开发 板 启动 文件 ， 完 成 C 环境 初始 化 ， 
C 环境 初始 化 完成 以 后 跳 转 到 C 代码 。 

其 他 s 3t 

[is : 初版 2019/1/3 左 忠 凯 修 改 


KOkCkckckckck ck ck ck ck ckck ck ck ckck ck ck ckck ck ck ckck ckck ck ck ckck ckck ck k ck k ck k ck k ck k ck ck ckck ck k ck ck ck ok ckokckok ck ok kk k 








1 .global start /* 全 局 标号 */ 

2 

kr i 

4  * 描述 : start 函数 ， 程 序 从 此 函数 开始 执行 ， 此 函数 主要 功能 是 设置 C 

DS 运行 环境 。 

my 

7  Btarts 

8 

9 /* 进入 SVC 模式 */ 

10 «see TO, GOST 

ia bic r0, r0, #0x1f  /* 将 r0 的 低 5 位 清 零 ， 也 就 是 cpsr 的 MO~M4 */ 
12 orr r0, r0, 40x13  /* r0 或 上 0x13, 表 示 使 用 svc 模式 “i 
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is msr cpsr, r0 /* 将 r0 的 数据 写 入 到 cpsr c 中 */ 
14 

15 ldr sp，=0X80200000 /* 设置 栈 指针 o 

16 b main /* 跳 转 到 main 函数 */ 


MSR 将 修改 后 的 RO 重新 写 入 到 CPSR 中 。 





第 1 行 定义 了 一 个 全 局 标号 _start。 














第 7 行 就 是 标号 start 开始 











的 地 方 ， 相 当 于 是 一 个 _start 函数 ， 这 个 _start 就 是 第 一 行 代码 。 


第 10~13 行 就 是 设置 处 理 器 进入 SVC 模式 ,在 6.2 小 节 的 “Cortex-A 处 理 器 运行 模型 ”中 
我 们 说 过 Cortex-A 有 九 个 运行 模型 ， 这 里 我 们 设置 处 理 器 运行 在 SVC 模式 下 。 处 理 器 模式 的 
设置 是 通过 修改 CPSR( 程 序 状态 ) 寄 存 器 来 完成 的 ， 在 6.3.2 小 节 中 我 们 详细 的 讲解 了 CPSR 寄 
存 器 ， 其 中 M[4:0](CPSR 的 bit[4:0]) 就 是 设置 处 理 器 运行 模式 的 ， 参 考 表 6.3.2.2， 如 果 要 将 处 
理 器 设置 为 SVC 模式 ,那么 M[4:0] 就 要 等 于 0X13.11-13 行 代码 就 是 先 使 用 指令 MRS 将 CPSR 
寄存 器 的 值 读 取 到 RO 中 ， 然 后 修改 RO 中 的 值 ， 设 置 RO 的 bit[4:0] 为 0X13， 然 后 再 使 用 指令 











第 15 行 通过 ldr 指令 设置 


& 板 上 的 DDR3 地 
0X80000000~0X90000000(256MB)， 不 管 是 512MB 版 本 还 是 256MB 版 本 的 ， 其 DDR3 起 始 地 



























































SVC 模式 下 的 SP 指针 =0X80200000， 因 为 LMX6U-ALPHA Jf 
hk 范 Æ] 是 0X80000000~0XA0000000(512MB) 或 者 


























三 | 























址 都 是 0X80000000。 由 于 Cortex-A7 的 堆栈 是 向 下 增长 的 ,所 以 将 SP 指针 设置 为 0X80200000， 











如 果 做 裸 机 开发 的 话 绰绰有余 。 


化 SP 指针 、 最 终 跳 转 到 C 文 伯 
话 会 知道 我 们 在 使 用 SDRAM 或 者 DDR 之 前 必须 先 初始 化 SDRAM 或 者 DDR。 所 以 S3C2440 
F 里 面 是 一 定 会 有 SDRAM 或 者 DDR 初始 化 代码 的 。 我 们 上 面 编写 的 








x 











或 者 SSPV210 的 汇编 文 位 








至 此 汇编 部 分 程序 执行 完 


























因此 SVC 模式 的 栈 大 小 0X80200000-0X80000000=0X200000=2MB,2MB 的 栈 空 间 已 经 很 大 了 ， 


第 15 行 就 是 跳 转 到 main 函数 ，main 函数 就 是 C 语言 代码 了 。 








， 就 几 行 代码 ， 用 来 设置 处 理 器 运行 到 SVC 模式 下 、 然 后 初始 
FI] mian 函数 中 。 如 果 有 玩 过 三 星 的 S3C2440 或 者 SSPV210 的 









































start.s 文件 中 却 没有 初始 化 DDR3 的 代码 ， 但 是 确 将 SVC 模式 下 的 SP 指针 设置 到 了 DDR3 的 
地 址 范围 中 , 这 不 会 出 问题 吗 ? 



































肯定 不 会 的 , DDR3 肯定 是 要 初始 化 的 , 但 是 不 需要 在 starts X 





件 中 完成 。 在 9.4.2 小 节 里 面 分 析 DCD 数据 的 时 候 就 已 经 讲 过 了 ，DCD 数据 包含 了 DDR 配置 














参数 ，I.MX6U 内 部 的 Boot ROM 会 读 取 DCD 数据 中 的 DDR 配置 参数 然后 完成 DDR 初始 化 


的 。 




















10.3.2 C 语言 部 分 实验 程序 编写 
C 语言 部 分 有 两 个 文件 main.c 和 main.h，main.h 里 面 主要 是 定义 的 寄存 器 地 址 ， 在 mian.h 








里 面 输入 代码 : 











#ifndef _ MAIN H 
tdefine _ MAIN H 


/玉米 矿业 火炎 火炎 火炎 类 大 火炎 类 大 类 火炎 类 类 炎炎 大 类 类 类 大 类 类 类 大 类 炎炎 大 类 类 大 大 类 类 大 大 类 类 大 大 类 类 类 大 类 类 大 大 类 类 大 大 类 大 大 大 类 大 





示例 代码 10.3.2.1 main.h 文件 代码 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 SET 


TE 
版 本 
DAS 


其 他 




















S 左 忠 凯 
SO 


: 时 钟 SPIO1 1003 相关 寄存 器 地 址 定义 。 
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ps : VIR v1.0 2019/1/3 左 忠 凯 创建 


CKCKCKCKCKCkCkCkCk Ck k Ck k k k kCk kCkCkCk Ck k kc k kCk kk kCk Ck k Ck k kc k kc k kc k k k kc k kc k k ck kckckckckckck ck kk ke X ke x k f 








d eL 

2 * CCM 相关 寄存 器 地 址 

Sr en 

4 $detine CCM CCGRO *((volatile unsigned int *)0X020C4068) 
5 petine CCM CCORI *((volatile unsigned int *)0X020C406C) 
DNE docct» *((volatile unsigned int *)0X020C4070) 
1 petine CCM CCGRI *((volatile unsigned int *)0X020C4074) 
8 4define CCM CCGRA *((volatile unsigned int *)0X020C4078) 
PE poetine CEM eS *((volatile unsigned int *)0X020C407C) 
10 4$define COM CCGR6 *((volatile unsigned int *)0X020C4080) 
al 

1A Jes 

13 * IOMUX 相关 寄存 器 地 址 

qa, 


15 $define SW MUX GPIOÍ1 I0O03 *((volatile unsigned int *)0X020E0068) 
Ee paefine SW PAD GPTOI TOO: *((volatile unsigned int *)0X020E02F4) 




















1g. A 

19 * GPIO1 相关 寄存 器 地 址 

Z 

2il petine GPIOL DR *((volatile unsigned int *)0X0209C000) 
22 $define GPIOT CDIR *((volatile unsigned int *)0X0209C004) 
25 petine GPIOL PSR *((volatile unsigned int *)0X0209C008) 
24. pdetine (GIIQU ICE *((volatile unsigned int *)0X0209C00C) 
25 petine (CIIOL ICRZ *((volatile unsigned int *)0X0209C010) 
26 $define GPIOT IMR *((volatile unsigned int *)0X0209C014) 
ER *((volatile unsigned int *)0X0209C018) 
23 detine CPTOL EDEE SEL *((volatile unsigned int *)0X0209C01C) 
29 

30 #endif 


在 mian.h 中 我 们 以 宏 定义 的 形式 定义 了 要 使 用 到 的 所 有 寄存 器 ， 后 面 的 数字 就 是 其 地 址 ， 
比如 CCM. CCGRO 寄存 器 的 地 址 就 是 0X020C4068， 这 个 很 简单 ， 很 好 理解 。 

接 下 看 一 下 main.c 文件 ， 在 mian.c 里 面 输入 如 下 所 示 代 码 : 
示例 代码 10.3.2.2 main.c 文件 代码 


/大大 大 大 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 火炎 大 火炎 大 大 火炎 大 大 火炎 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 








Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 name 


NE : ARI 
版 本 VAIO 
HR : I.MX6U 开发 板 裸 机 实验 2 Cc 语言 点 灯 
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使 用 c 语言 来 点 亮 开发 板 上 的 LED 灯 ， 学 习 和 掌握 如 何 用 C 语言 
完成 对 工 .MX6U 处 理 器 的 GPIO 初始 化 和 控制 。 
其 他 8 JE 
5 : 初版 V1.0 2019/1/3 左 忠 凯 创建 


KOKCKCKCKCkCKCkCk kCkCk k kc k Ck kCkCk k kk k kc k k kk Ck kCk Ck kCk Ck k kc k k kc k Ck kc k Ck kck ck kck ck ckck ck ckckck kk k kx f 


ij dinclude "main.h" 











2 
3 — ge 

4 * Qdescription : 使 能 I.MxX6U 所 有 外 设 时 钟 
5 * (üiparam B JE 

6 * Qreturn E 

7 B 

8 void elk enable (void) 

2 

10 OCMNCOGRÜ E 0 EGE 

T COM COGRI 三 USERRPERRE. 

12 COM COCER E OXPPPRIPRPE; 

13 UCHSCOGRONSDOSEPIPÉPPT. 

14 CO 

15 UCCMECOGROSESDSESBIERRI 

16 COM COGRG e OxFTTTTIff; 

To 

18 

TOR 

20 * @description : 初始 化 LED 对 应 的 GPIO 
21 = Qaarian : JE 

22  * Qreturn E OE 

2. ey 

24 void led init (void) 

25 f 

26 /* 1. Hk 10 MH, RHA GPIO 1003 */ 
27 SW MUX GPIO1 IO03 = 0x5; 

28 

29 /* 2. MÆ GP1O1 1003 Í ro 属性 

30 xbit 16:0 HYS XH] 

EHI *bit [15:14]: 00 默认 下 拉 

32 *bit [13]: 0 kepper 功能 

SE spit [12]: 1 pull/keeper 使 能 

34 *pit [11]: 0 关闭 开路 输出 

35 *bit [7:6]: 10 速度 100Mhz 

36 xbit [5:3]: 110 R0/6 驱动 能 

2] *pit [0]: 0 低 转 换 率 

38 i 
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39 SW PAD GPIO1 IO03 = OX10B0; 
40 

41 /* 3、 初 始 化 GPIO，GPIO1 1003 设置 为 输出 */ 
42 GPIOl GDIR = 0X0000008; 

43 

44 /* 4. RA GPIOl 1003 输出 低 电 平 ， 打 开 LEDO */ 
45 GPIO1 DR = 0X0; 

46 ] 

47] 

48 /* 

49  * Qdescription Ta LED AJ 

50 * (üparam e JE 

51  * Greturn s XE 

Ed. y 

25) Vore SO 

54 ( 

55 [F5 

56 * 将 GPIO1 DR 的 bit3 W% 

57 aa 

58 GPIO1 DR &= ~(1<<3); 

Se 

60 

Gi 

62  * @description : XRM LED $J 

63  * @param H E 

64  * Qreturn S JE 

65 Br 

Gio VOe leel ER 

GU 

68 f 

69 * 将 GPIO1 DR 的 pit3 置 1 

70 =y 

yal GPIOT DR |= (1««3); 

qu nay 

TS) 

TAR 


75 * Qdescription : 短 时 间 延 时 函数 
76  * eparam - n  : 要 延 时 循环 次 数 ( 空 操作 循环 次 数 ， 模 式 延 时 ) 





7] > Qreturn 8 JE 

de cce 

79) volc ls hone (le vasignecl imie d) 
80 ( 

81 while (n--)(]) 


334 


LMX6U BEAR Linux 驱动 开发 指南 


e31E B B 





原子 哥 在 线 教 学 ，www.yuanzige.com 





论坛 :www.opendev.com 


5 
a 


二 


pul 
D 


^ 
A) 


82 ]) 

33 

84 /* 

85  * Qdescription : 延 时 函数 ,在 396Mhz 的 主 频 下 延 时 时 间 大 约 为 1ms 
86 * @param - n  : 要 延 时 的 ms 2X 

87  * Qreturn S JE 

88 wh 

89 void delay(volatile unsigned int n) 
OONMEET 

9i while (n--) 

92 ( 

9S delay short (0x7ff); 

94 } 

Ss 4j 

96 

OX 

98  * Qdescription : mian 函数 

99 * (üparam B JE 

100 * Greturn 8 JE 

MO 9 

102 int main(void) 

103 ( 

104 clk enable(); /* 使 能 所 有 的 时 钟 
105 lea imit) p /* IW led 
106 

107 while(1l) /* 死 循环 

108 { 

109 led ori N); E ARD 

110 delay (500);  /* 延 时 大 约 500ms 
Walai 

Ti led on(); /* 打开 LED 

Ts delay(500);  /* 延 时 大 约 500ms 
114 ) 

dL 

TANS return 0; 

Di) 














main.c 文件 里 面 一 共有 7 个 函数 ， 这 7 个 函数 都 很 简单 。clk_enable 函数 是 使 能 


CCGRO0-CCGR6 Pra 
IO 的 复 用 功能 、IO BUS TER 




















出 的 所 有 外 设 时 钟 。led_init 函数 是 初始 化 LE 
CHM GPIO 功能 ， 最 终 控 M 





D 灯 所 使 用 的 IO， 包括 设置 








B] GPIO 输出 低 电 平 来 打开 LED 4T. 


led on 和 1led_o 任 这 两 个 函数 看 名 字 就 知道 ， 用 来 控制 LED 灯 的 亮 灭 的 。delay_short0 和 delay) 
这 两 个 函数 是 延 时 函数 ，delay_short0 函 数 是 靠 空 循环 来 实现 延 时 的 ，delay0 是 对 delay_short() 
的 简单 封装 ， 在 IMX6U 工作 在 396MHz(Boot ROM 设置 的 396MHz) 的 主 频 的 时 候 
delay_short(0x7 伯 基本 能 够 实现 大 约 1ms 的 延 时 ， 所 以 delay0 函 数 我 们 可 以 用 来 完成 ms 延 时 。 
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main 函数 就 是 我 们 的 主 函 数 了 ， 在 main 函数 中 先 调用 函数 clk_enable0 和 led_init0 来 完成 时 钟 























使 能 和 LED 初始 化 ， 最 终 在 while(1) 循 环 中 实现 LED 循环 亮 灭 ， 亮 灭 时 间 大 约 是 500ms。 
本 实验 的 程序 部 分 就 是 这 些 了 ， 接 下 来 即使 编译 和 测试 了 。 


10.4 编译 下 载 验证 


10.4.1 编写 Makefile 





























新 建 Makefile 文件 ， 在 Makefile 文件 里 面 输入 如 下 内 容 : 
示例 代码 10.3.2.2 main.c 文件 代码 








L (logs BE start © nim. 

2 

3 ledc.bin:$(0bjs) 

4 lam ln en le — 05x 7:90(000(0(0 -=o lede eli $^ 

5 arm-linus-gnvueabihit=-0b]coby -O binary =$ lede eli $C 

6  arm-linux-gnueabihf-objdump -D -m arm ledc.elf » ledc.dis 
7 

So "8008958 

E euo mele Wall -eostolis =e -902 -o $E $< 
10 


m 
je 
oe 
o 

op 
ca 


15 arm-linux-gnueabihf-gcc -Wall -nostdlib -c -02 -o $8 $< 


17 clean: 
JH$) sen cx *945) liexeleslosum Jbexele.ebr miede sois 
上 述 的 Makefile 就 比 第 八 章 的 Makefile 要 复杂 一 点 了 , 里 面 用 到 了 Makefile 变量 和 自动 变 
量 ， 关 于 Makefile 的 变量 和 自动 变量 的 请 参考 “3.4 Makefile 语法 ”。 
第 1 行 定 义 了 一 个 变量 objs，objs 包含 着 要 生成 ledc.bin 所 需 的 材料 : start.o 和 main.o, t 
就 是 当前 工程 下 的 starts 和 main.c 这 两 个 文件 编译 后 的 .o 文件 。 这 里 要 注意 start.o 一 定 要 放 到 
最 前 面 ! 因为 在 后 面 链接 的 时 候 start.o 要 在 最 前 面 ， 因 为 start.o 是 最 先 要 执行 的 文件 ! 
第 3 行 就 是 默认 目标 , 目的 是 生成 最 终 的 可 执行 文件 ledc.bin, ledc.bin 依赖 start.o 和 main.o 
如 果 当 前 工程 没有 starto 和 main.o 的 时 候 就 会 找到 相应 的 规则 去 生成 start.o 和 main.o。 比 如 
start.o 是 start.s 文件 编译 生成 的 ， 因 此 会 执行 第 8 行 的 规则 。 
第 4 行 是 使 用 arm-linux-gnueabihf-ld 进行 链接 ， 链 接 起 始 地 址 是 0X87800000, 但 是 这 一 行 
用 思 了 自动 变量 “$^”“$^” 的 意思 是 所 有 依赖 文件 的 集合 ， 在 这 里 就 是 objs 这 个 变量 的 值 : 
start.o 和 main.o。 链 接 的 时 候 start.o 要 链接 到 最 前 面 ， 因 为 第 一 行 代码 就 是 start.o 里 面 的 ， 因 
此 这 一 行 就 相当 于 : 
arm-linux-gnueabihf-ld -TOX87800000 -o ledc.elf start.o main.o 
第 5 行使 用 arm-linux-gnueabihf-objcopy 来 将 ledc.elf 文件 转 为 ledc.bin， 本 行 也 用 到 了 自动 变量 
“$@”“$@” 的 意思 是 目标 集合 ， 在 这 里 就 是 “ledc.bin”， 那么 本 行 就 相当 于 : 
arm-linux-gnueabihf-objcopy -O binary -S ledc.elf ledc.bin 
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第 6 行使 用 arm-linux-gnueabihf-objdump 来 反 汇 编 ， 生 成 ledc.dis 文件 。 

第 8~15 行 就 是 针对 不 同 的 文件 类 型 将 其 编译 成 对 应 的 .o 文件 ， 其 实 就 是 汇编 .s(.S) 和 .c 文 
件 ， 比 如 starts 就 会 使 用 第 8 行 的 规则 来 生成 对 应 的 start.o 文件 。 第 9 行 就 是 具体 的 命令 ， 这 
行 也 用 到 了 自动 变量 “$@” 和 “$<” 其 中 “$<” 的 意思 是 依赖 目标 集合 的 第 一 个 文件 。 比 如 
start.s 要 编译 成 start.o 的 话 第 8 行 和 第 9 行 就 相当 于 : 

start.o:start.s 

arm-linux-gnueabihf-gcc -Wall -nostdlib -c -O2 -o start.o start.s 

第 17 行 就 是 工程 清理 规则 ， 通 过 命令 “make clean” 就 可 以 清理 工程 。 
Makefile 文件 就 讲 到 这 里 ,我们 可 以 将 整个 工程 拿 到 Ubuntu 下 去 编译 ， 编 译 完 成 以 后 可 以 使 用 
软件 imxdownload 将 其 下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload // 给 予 imxdownoad 可 执行 权限 ， 一 次 即 可 

./imxdownload ledc.bin /dev/sdd /下 载 到 SD 卡 中 






























































































































































10.4.2 链接 脚本 


在 上 面 的 Makefile 中 我 们 链接 代码 的 时 候 使 用 如 下 语句 : 

arm-linux-gnueabihf-ld -TOX87800000 -o ledc.elf $^ 

上 面 语句 中 我 们 是 通过 “-T” 来 指定 链接 地 址 是 0X87800000 的 , 这 样 的 话 所 有 的 文件 都 会 
链接 到 以 0X87800000 为 起 始 地 址 的 区 域 。 但 是 有 时 候 我 们 很 多 文件 需要 链接 到 指定 的 区 域 ， 
或 者 叫做 段 里 面 ， 比 如 在 Linux 里 面 初始 化 函数 就 会 放 到 init 段 里 面 。 因 此 我 们 需要 能 够 自 定 
义 一 些 段 ， 这 些 段 的 起 始 地 址 我 们 可 以 自由 指定 ， 同 样 的 我 们 也 可 以 指定 一 个 文件 或 者 函数 应 
该 存放 到 哪个 段 里 面 去 。 要 完成 这 个 功能 我 们 就 需要 使 用 到 链接 脚本 ， 看 名 字 就 知道 链接 脚本 
主要 用 于 链接 的 ， 用 于 描述 文件 应 该 如 何 被 链接 在 一 起 形成 最 终 的 可 执行 文件 。 其 主要 目的 是 
描述 输入 文件 中 的 段 如 何 被 映射 到 输出 文件 中 ， 并 且 控 制 输 出 文件 中 的 内 存 排 布 。 比 如 我 们 编 
译 生 成 的 文件 一 般 都 包含 text 段 、data 段 等 等 。 

链接 脚本 的 语法 很 简单 ， 就 是 编写 一 系列 的 命令 ， 这 些 命令 组 成 了 链接 脚本 ， 每 个 命令 是 
一 个 带 有 参数 的 关键 字 或 者 一 个 对 符号 的 赋值 ， 可 以 使 用 分 号 分 隔 命令 。 像 文件 名 之 类 的 字符 
串 可 以 直接 键入 , 也 可 以 使 用 通配符 “* ”最 简单 的 链接 脚本 可 以 只 包含 一 个 命令 “SECTIONS ”， 
我 们 可 以 在 这 一 个 “SECTIONS ”里 面 来 描述 输出 文件 的 内 存 布局 。 我 们 一 般 编 译 出 来 的 代码 
都 包含 在 text、data、bss 和 rodata 这 四 个 段 内 ， 假 设 现 在 的 代码 要 被 链接 到 0X10000000 这 个 
地 址 ， 数 据 要 被 链接 到 0X30000000 这 个 地 方 ， 下 面 就 是 完成 此 功能 的 最 简单 的 链接 脚本 : 
示例 代码 10.4.2.1 链接 脚本 演示 代码 











































































































































































































































































































1L SIC ONIS 

2 . * 0X10000000; 

3 .text : (*(.text)) 

4 . * 0X30000000; 

5 .data ALIGN(4) : ( *(.data) ) 
6 .bss ALIGN(4) : ( *(.bss) ) 
UT 











第 1 行 我 们 先 写 了 一 个 关键 字 “SECTIONS”， 后 面 跟 了 一 个 大 括号 ， 这 个 大 括号 和 第 7 行 
的 大 括号 是 一 对 ， 这 是 必须 的 。 看 起 来 就 跟 C 语言 里 面 的 函数 一 样 。 
第 2 行 对 一 个 特殊 符号 “.” 进 行 赋值 ,，“.” 在 链接 脚本 里 面 叫做 定位 计数 器 ， 默 认 的 定位 
计数 器 为 0。 我 们 要 求 代 码 链接 到 以 0X10000000 为 起 始 地 址 的 地 方 ， 因 此 这 一 行 给 “.” 赋 值 
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0X10000000， 表 示 以 0X10000000 开始 ， 后 面 的 文件 或 者 段 都 会 以 0X10000000 为 起 始 地 址 开 





始 链接 。 

第 3 行 的 “.text” 是 段 名 ， 后 面 的 冒号 是 语法 要 求 ， 冒 号 后 面 的 大 括号 里 面 可 以 填 上 要 链 
接 到 “.text” 这 个 段 里 面 的 所 以 文件 ，“*(.text)” 中 的 “*” 是 通配符 ， 表 示 所 有 输入 文件 的 .text 
段 都 放 到 “.text” 中 。 

第 4 行 ， 我 们 的 要 求 是 数据 放 到 0X30000000 开始 的 地 方 ， 所 以 我 们 需要 重新 设置 定位 计 
数 器 “.”, 将 其 改 为 0X30000000。 如 果 不 重新 设置 的 话 会 怎么 样 ? 假设 “.text” 段 大 小 为 0X10000， 
那么 接 下 来 的 .dtata 段 开 始 地 址 就 是 0X10000000+0X10000=0X10010000， 这 明显 不 符合 我 们 的 
要 求 。 所 以 我 们 必须 调整 定位 计数 器 为 0X30000000。 

第 5 行 跟 第 3 行 一 样 ， 定 义 了 一 个 名 为 “.data” 的 段 ， 然 后 所 有 文件 的 “.data” 段 都 放 到 
这 里 面 。 但 是 这 一 行 多 了 一 个 “ALIGN(4)” 这 是 什么 意思 昵 ? 这 是 用 来 对 “.data” 这 个 段 的 起 
始 地 址 做 字 节 对 齐 的 ，ALIGN(4) 表 示 4 字 节 对 齐 。 也 就 是 说 段 “.data” 的 起 始 地 址 要 能 被 4 整 
除 ， 一 般 常 见 的 都 是 ALIGN(4) 或 者 ALIGN(8)， 也 就 是 4 字 节 或 者 8 字 节 对 齐 。 

第 6 行 定义 了 一 个 “.bss” 段 ， 所 有 文件 中 的 “.bss” 数 据 都 会 被 放 到 这 个 里 面 ,“.bss” 数 
据 就 是 那些 定义 了 但 是 没有 被 初始 化 的 变量 。 
上 面 就 是 链接 脚本 最 基本 的 语法 格式 ， 我 们 接 下 来 就 按照 这 个 基本 的 语法 格式 来 编写 我 们 本 试 
验 的 链接 脚本 ， 我 们 本 试验 的 链接 脚本 要 求 如 下 : 

Q@、 链 接 起 始 地 址 为 0X87800000。 
©, start.o 要 被 链接 到 最 开始 的 地 方 ， 因 为 start.o 里 面包 含 这 第 一 个 要 执行 的 命令 。 

根据 要 求 ， 在 Makefile 同 目录 下 新 建 一 个 名 为 “imx6ul.lds” 的 文件 ， 然 后 在 此 文件 上 
入 如 下 所 示 代 码 : 
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示例 代码 10.4.2.2 imx6ul.lds 链接 脚本 代码 





TEES STI NISI 

2 . = 0X87800000; 

3 Res 

4 { 

5 start. ® 

6 main.o 

p *(.text) 

8 } 

9 .rodata ALIGN(4) : {*(.rodata*)} 
10 .data ALIGN (4) : ( *(.data) ) 
det T bss stort = 

ill? .bss ALIGN(4) : ( *(.bss) *(COMMON) } 
13 — ose ewel S o? 

14 } 





上 面 的 链接 脚本 文件 和 示例 代码 10.4.2.1 基本 一 致 的 ， 第 2 行 设置 定位 计数 器 为 
0X87800000, 因为 我 们 的 链接 地 址 就 是 0X87800000。 第 5 行 设置 链接 到 开始 位 置 的 文件 为 start.o， 
因为 start.o 里 面包 含 着 第 一 个 要 执行 的 指令 ,所 以 一 定 要 链接 到 最 开始 的 地 方 。 第 6 行 是 main.o 
这 个 文件 ， 其 实 可 以 不 用 写 出 来 ， 因 为 main.o 的 位 置 就 无 所 谓 了 ， 可 以 由 编译 器 自行 决定 链接 
位 置 ,在 第 11、13 行 有 “bss_start” 和 “ bss_end” 这 两 个 东西 ? 这 个 是 什么 昵 ?“__bss_start” 
和 ”“_bss_end” 是 符号 , 第 11、13 这 两 行 其 实 就 是 对 这 两 个 符号 进行 赋值 ， 其 值 为 定位 符 “.”， 
这 两 个 符号 用 来 保存 .bss 段 的 起 始 地 址 和 结束 地 址 。 前 面 说 了 .bss 段 是 定义 了 但 是 没有 被 初始 
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化 的 变量 , 我 们 需要 手动 对 .bss 段 的 变量 清 零 的 , 因此 我 们 需要 知道 .bss 段 的 起 始 和 结束 地 址 ， 




















这 样 我 们 直接 对 这 段 内 存 赋 0 即 可 完成 清 零 。 通 过 第 11、13 行 代码 ，.bss 段 的 起 始 地 址 和 结束 
地 址 就 保存 在 了 “__bss_start” 和 “__bss_end” 中 ， 我 们 就 可 以 直接 在 汇编 或 者 C 文件 里 面 使 
用 这 两 个 符号 。 
































10.4.3 修改 Makefile 


在 上 一 小 节 中 我 们 已 经 编写 好 了 链接 脚本 文件 ， imx6ul.lds， 我 们 肯定 是 要 使 用 这 个 链接 肢 
本 文件 的 ， 将 Makefile 中 的 如 下 一 行 代码 : 

arm-linux-gnueabihf-ld -TOX87800000 -o ledc.elf $^ 

改 为 : 

arm-linux-gnueabihf-ld -Timx6ul.lds -o ledc.elf $^ 

起 始 就 是 将 -T 后 面 的 0X87800000 改 为 imx6ulLlds， 表 示 使 用 imx6ul.lds 这 个 链接 脚本 文 
件 。 修 改 完 成 以 后 使 用 新 的 Makefile 和 链接 脚本 文件 重新 编译 工程 ， 编 译 成 功 以 后 就 可 以 烧 写 
到 SD 卡 中 验证 了 。 

































































10.4.4 下 载 验证 
使 用 软件 imxdownload 将 编译 出 来 的 ledc.bin 烧 写 到 SD 卡 中 ， 命 令 如 下 : 
chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 


Jimxdownload ledc.bin /dev/sdd // 烧 写 到 SD 卡 中 
烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 ， 如 果 代 码 运行 正常 的 
话 LED0 就 会 以 500ms 的 时 间 间 隔 亮 ? 






































Eni 
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第 十 一 章 模仿 STM32 驱动 开发 格式 实验 


在 上 一 章 使 用 C 语言 编写 LED 条 驱动 的 时 候 ， 每 个 寄存 器 的 地 址 我 们 都 需要 写 宏 定义 ， 




















使 用 起 来 非常 的 不 方便 。 我 们 在 学 习 STM32 的 时 候 ， 可 以 使 用 “GPIOB->ODR ”这 种 方式 来 给 
GPIOB 的 寄存 器 ODR 赋值 , 因为 在 STM32 中 同属 于 一 个 外 设 的 所 有 寄存 器 地 址 基本 是 相 邻 的 
(有 些 会 有 保留 寄存 器 )。 因 此 我 们 可 以 借助 C 语言 里 面 的 结构 体 成 员 地 址 递增 的 特点 来 将 某 个 
外 设 的 所 有 寄存 器 写 入 到 一 个 结构 体 里 面 ， 然 后 定义 一 个 结构 体 指针 指向 这 个 外 设 的 寄存 器 基 
地 址 , 这 样 我 们 就 可 以 通过 这 个 结构 体 指针 来 访问 这 个 外 设 的 所 有 寄存 器 。 同 理 , LMX6U 也 可 
以 使 用 这 种 方法 来 定义 外 设 寄存 器 ， 本 章 我 们 就 模仿 STM32 里 面 的 寄存 器 定义 方式 来 编写 
LMX6U 的 驱动 ， 通 过 本 章 的 学 习 也 可 以 对 STM32 的 寄存 器 定义 方式 有 一 个 深入 的 认识 。 
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11.1 模仿 STM32 寄存 器 定义 


11.1.1 STM32 寄存 器 定义 简介 

















为 了 开发 方便 ，ST 官方 为 STM32F103 编写 了 一 个 叫做 stm32f10x.h 的 文件 ， 在 这 个 文件 
里 面 定义 了 STM32F103 所 有 外 设 寄存 器 ， 我 们 可 以 使 用 其 定义 的 寄存 器 来 进行 开发 ， 比 如 我 
们 可 以 用 如 下 代码 来 初始 化 一 个 GPIO: 
GPIOE->CRL&=0XFF0FFFFF; 
GPIOE->CRL|=0X00300000; /IPE5 推 挽 输出 
GPIOE->ODR|=1<<5; //PES 输出 高 
上 述 代 码 是 初始 化 STM32 的 PES 这 个 GPIO 为 推 挽 输出 ， 需 要 配置 的 就 是 GPIOE 的 寄存 
器 CRL 和 ODR， “GPIOE” 的 定义 : 
#define GPIOE ((GPIO TypeDef *) GPIOE BASE) 
可 以 看 出 “GPIOE” 是 个 宏 定义 ， 是 一 个 指向 地 址 GPIOE BASE 的 结构 体 指 针 ， 结 构 体 为 
GPIO TypeDef, GPIO TypeDef 和 GPIOE BASE 的 定义 如 下 : 
typedef struct 
{ 
. IO uint32 t CRL; 
. JO uint32 t CRH; 
. IO uint32 t IDR; 
. JO uint32 t ODR; 
. IO uint32 t BSRR; 
. JO uint32 t BRR; 
. JO uint32 tLCKR; 
} GPIO TypeDef, 































































































#define GPIOE BASE (APB2PERIPH BASE + 0x1800) 
#define APB2PERIPH BASE (PERIPH BASE + 0x10000) 
#define PERIPH BASE ((uint32 £)0x40000000) 








上 述 定义 中 GPIO _TypeDef 是 个 结构 体 , 结构 体 里 面 的 成 员 变 量 有 CRL、CRH、IDR、ODR、 
BSRR、BRR 和 LCKR， 这 些 都 是 mA 的 寄存 器 ， 每 个 成 员 变 量 都 是 32 位 (4 字 节 )， 这 些 寄存 
器 在 结构 体 中 的 位 置 都 是 按照 其 地 址 值 从 小 到 大 排序 的 -GPIOE_BASE 就 是 GPIOE 的 基地 址 ， 
其 为 : 

GPIOE BASE=APB2PERIPH BASE+0x1800 

= 了 PERIPH BASE + 0x10000 + 0x1800 
=0x40000000 + 0x10000 + 0x1800 
=0x40011800 

GPIOE BASE 的 基地 址 为 0x40011800， 宏 GPIOE 指向 这 个 地 址 ， 因 此 GPIOE 的 寄存 器 
CRL 的 地 址 就 是 0X40011800， 寄 存 器 CRH 的 地 址 就 是 0X40011800+4=0X40011804， 其 他 寄存 
器 地 址 以 此 类 推 。 我 们 要 操作 GPIOE 的 ODR 寄存 器 的 话 就 可 以 通过 “GPIOE->ODR” 来 实现 
这 个 方法 是 借助 了 结构 体 成 员 地 址 连续 递增 的 原理 。 

THET STM32 的 寄存 器 定义 以 后 ， 我 们 就 可 以 参考 其 原理 来 编写 LMX6U 的 外 设 寄 存 器 
定义 了 。NXP 官方 并 没有 为 LMX6UL 编写 类 似 stm32f10x.h 这 样 的 文件 , NXP 只 为 IMX6ULL 
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提供 了 类 似 stm32f10x.h 这 样 的 文件 ， 名 为 MCIMX6Y2.h, 但 是 IMX6UL fll LMX6ULL 几乎 一 
模 一 样 ,所 以 文件 MCIMX6Y2.h 可 以 用 在 LMX6UL 上 。 关 于 文件 MCIMX6Y2.h 的 移植 我 们 在 
下 一 章 讲解 ， 本 章 我 们 参考 stm32fl0x.h 来 编写 一 个 简单 的 MCIMX6Y2.h 文件 。 




















11.1.2 LMX6U 寄存 器 定义 

参考 STM32 的 官方 文件 来 编写 LMX6U 的 寄存 器 定义 ， 比 如 IO 复 用 寄存 器 组 
“IOMUX SW MUX CIL PAD XX” 步 又 如 下 : 

1、 编 写 外 设 结构 体 
先 将 同属 于 一 个 外 设 的 所 有 寄存 器 编写 到 一 个 结构 体 里 面 ， 如 IO 复 用 寄存 器 组 的 结构 体 





























如 下 : 
示例 代码 11.1.2.1 寄存 器 IOMUX_SW_MUX_Type 
Vr 
* IOMUX 寄存 器 组 
«f 


1  typedef struct 

E 

3 OO 
4 volatile unsigned int BOOT MODEI; 
5 
6 








volatile unsigned int SNVS TAMPERO; 
volatile unsigned int SNVS TAMPERI; 





WON volatile unsigned imite CSI DATAOO? 
108 yoletile twasigoec imne CSI DATAOLS 
109 volatile vnasigned ime CST DATAOZE 
TIO eae en tasignecl ime CST DATAOS? 
JUS volatile unsigned int CSI DATATA} 
1327 Eee 人 Eee 
IAS; volatile unsignecl int CST DATAOG? 
114 volatile unsigned int CSI DATAO7; 




















/* 为 了 缩短 代码 ， 其 余 10 复 用 寄存 器 省 略 */ 

115)IOMUX SW MUX Tpye; 

上 述 结构 体 IOMUX. SW MUX Type 就 是 IO 复 用 寄存 器 组 , 成 员 变量 是 每 个 IO 对 应 的 复 
用 寄存 器 ， 每 个 寄存 器 的 地 址 是 32 位 ， 每 个 成 员 都 使 用 “volatile” 进 行 了 修饰 ， 目 的 是 防止 编 
译 器 优化 。 

2、 定 义 IO 复 用 寄存 器 组 的 基地 址 

根据 结构 体 IOMUX SW MUX Type 的 定义 ， 其 第 一 个 成 员 变 量 为 BOOT MODE0， 也 就 
是 BOOT MODEO 这 个 IO 的 IO 复 用 寄存 器 ， 查 找 LMX6U 的 参考 手册 可 以 得 知 其 地 址 为 
0X020E0014， 所 以 IO 复 用 寄存 器 组 的 基地 址 就 是 0X020E0014， 定 义 如 下 : 

#define IOMUX SW MUX BASE (0X020E0014) 

3、 定 义 访 问 指针 


访问 指针 定义 如 下 : 
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#define IOMUX SW MUX ~ (IOMUX SW MUX Type *)IOMUX SW. MUX BASE) 














通过 上 面 三 步 我 们 就 可 以 通过 “IOMUX _SW_MUX->GPIO1 IO03” 来 访问 GPIO1 1003 的 
IO 复 用 寄存 器 了 。 同 样 的 ， 其 他 的 外 设 寄存 器 都 可 以 通过 这 三 步 来 定义 。 
11.2 硬件 原理 分 析 

本 章 使 用 到 的 硬件 资源 和 第 八 章 一 样 ， 就 是 一 个 LED0。 


11.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 3 ledc stm32. 

创建 VSCode 工程 , 工作 区 名 字 为 “ledc_stm32”, 新 建 三 个 文件 : start.S. main.c 和 imx6ulh。 
其 中 start.S 是 汇编 文件 ,start.S 文件 的 内 容 和 第 十 章 的 start.S 一 样 ,直接 复制 过 来 就 可 以 .main.c 
和 imx6ul.h 是 C 文件 ， 完 成 以 后 如 图 11.3.1 所 示 : 










































































imx6ul.h main.c start.S 











图 11.3.1 工程 文件 目录 
文件 imx6ulh 用 来 存放 外 设 寄存 器 定义 ， 在 imx6ulh 中 输入 如 下 代码 : 
示例 代码 11.2.1 imx6ul.h 文件 代码 


/大 炎炎 火 大 炎炎 火 大 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大 大 








Ga on eC onenels nn (Ceo mes ES 9 2009 A ES eserevec: 
文件 名 ml 





Mr : ABL 

版 本 RU 

描述 : IMX6UL 相关 寄存 器 定义 ， 参 考 STM32 寄存 器 定义 方法 
其 他 3 无 

lis : 初版 V1.0 2019/1/3 左 忠 凯 创建 


KOKCKCKCKCkCkCkCk kCkCk k kk Ck k kCk k kk k kc k k kk Ck k Ck Ck kCkCk k kk k kc k Ck kc k Ck kck ck kck ck ckck ck ckck ck kck e kx kx f 


























/ * 

* 外 设 寄存 器 组 的 基地 址 

$7. 

1  4define CCM BASE (0X020C4000) 
2  $define CCM ANALOG BASE (0X020C8000) 
3  4define IOMUX SW MUX BASE (0X020E0014) 
4 define IOMUX SW PAD BASE (0X020E0204) 
5 #define GPIO1 BASE (0x0209C000) 
6  4define GPIO2 BASE (0x020A0000) 
7 #define GPIO3 BASE (0x020A4000) 
8  4define GPIO4 BASE (0x020A8000) 
9  4define GPIO5 BASE (0x020AC000) 
10 

1i ye 

12  * CCM 寄 存 器 结构 体 定 义 ， 分 为 CCM 和 CCM ANALOG 
$5. wf 
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14 typedef struct 

ia 4 

16 volatile unsigned int CCR; 

17 volatile unsigned int CCDR; 

18 volatile unsigned int CSR; 

46 volatile unsigned int CCGR6; 

47 volatile unsigned int RESERVED 3[1]; 
48 volatile unsigned int CMEOR; 

25 p CEM Type; 

50 

51 typedef struct 

S c 

53 võlatile iususuboysrexel ime PEL ANMA 

54 volatile vasgigned. int PLO ARM SHI; 
55 volatile unsigned int PLL ARM CHR? 
56 võlatile nsrened ibant Phi ARM TOG; 
3L) volatile unsigned int MISC2; 

ANL volatile unsigoet! ime MISC? SHTA 
Z volatile nsronee inte MISCZ CURA 
IRS volatile se MISC TOG? 
11,2 p CCM ANALOG Tees 

TES 

HE 

117 * IOMUX 寄存 器 组 

1 9e e 

119 typedef struct 

20 1 

JL volatile unsigned int BOOT MODEO0; 
122 volatile unsigned int BOOT MODEI; 
128 volatile unsigned int SNVS TAMPERO; 
241 区 Se 
242 volatile Unsionee imit CSI IDENIEAS P 
243 volatile jusussbeyeexl ine CSI DATAS? 
244 volatile uasigaed 3hane CSI DATAOT? 
245 }IOMUX SW MUX Type; 

246 

247 typedef struct 

248 ( 

249 volatile unsigned int DRAM ADDR00; 
250 volatile unsigned int DRAM ADDRO1; 
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419 volate neonne REEDRIEEIEY 

420 volatile unsigned int GRP DDRMODE; 

421 volacile ne CRE DDR TYBPE? 

422 }IOMUX SW PAD Type; 

423 

424 /* 

425 * GPIO 寄存 器 结构 体 

426 */ 

427 typedef struct 

428 ( 

429 volatile unsigned int DR; 

430 volatile unsigned int GDIR; 

431 volatile unsigned int PSR; 

432 volatile unsigned int TERI 

433 volatile unsigned int ICR2; 

434 volatile unsigned int IMR; 

435 volatile unsigned int ISR; 

436 pointe qumisntene crm EM RID C EUR S ET 

457 pOebIO Typs 

438 

439 

440 /* 

441 * AMETE 

442 */ 

443 4define CCM ((CCM Type *)CCM BASE) 

444 $define CCM ANALOG ((CCM ANALOG Type *)CCM ANALOG BASE) 
445 $define IOMUX SW MUX ((IOMUX SW MUX Type *)IOMUX SW MUX BASE) 
446 $define IOMUX SW PAD ((IOMUX SW PAD Type *)IOMUX SW PAD BASE) 
447 4define GPIOl ( (GPIO Type *)GPIO1 BASE) 

448 4$define GPIO2 ((GPIO Type *)GPIO2 BASE) 

449 $define GPIOS3 ((GPIO Type *)GPIO3 BASE) 

450 define GPIOA ((GPIO Type *)GPIO4 BASE) 

451 $define GPIO5 ((GPIO Type *)GPIO5 BASE) 














在 编写 寄存 器 组 结构 体 的 时 候 注意 寄存 器 的 地 址 是 否 连续 ， 有 些 外 设 的 寄存 器 地 址 可 能 不 
是 连续 的 , 会 有 一 些 保留 地 址 ,因此 我 们 需要 在 结构 体 中 留 出 这 些 保 留 的 寄存 器 。 比 如 CCM 的 
CCGR6 寄存 器 地 址 为 0X020C4080， 而 寄存 器 CMEOR 的 地 址 为 0X020C4088。 按 照 地 址 顺序 
递增 的 原理 ， 寄 存 器 CMEOR 的 地 址 应 该 是 0X020C4084， 但 是 实际 上 CMEOR 的 地 址 是 
0X020C4088， 相 当 于 中 间 跳 过 了 0X020C4088-0X020C4080=8 个 字 节 ， 如 果 寄 存 器 地 址 连续 的 
话 应 该 只 差 4 个 字 节 (32 位 )， 但 是 现在 差 了 8 个 字 节 ， 所 以 需要 在 寄存 器 CCGR6 和 CMEOR 
直接 加 入 一 个 保留 寄存 器 ， 这 个 就 是 “示例 代码 11.3.1” 中 第 47 ff RESERVED 3[1] 的 来 源 。 
如 果 不 添加 保留 为 来 占 位 的 话 就 会 导致 寄存 器 地 址 错位 ! 
main.c 文件 中 输入 如 下 所 示 内 容 : 
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示例 代码 11.3.2 main.c 文件 代码 











1 ice 过 GUY 

2 

S we 

4 * Qdescription : 使 能 I.Mx6U 所 有 外 设 时 钟 
5 * (üparam B JE 

6 * Qreturn 无 

7 =y 

8 void elk enable (void) 

2 N 

10 CCM-»CCGRO = OXFFFFFFFF; 

dl CCM-»CCGR1 = OXFFFFFFFF; 

Ie CCM->CCGR2 = OXFFFFFFFF; 

13 CCM-»CCGR3 = OXFFFFFFFF; 

14 CCM-»CCGRA = OXFFFFFFFF; 

15 CCM-»CCGR5 = OXFFFFFFFF; 

16 CCM-»CCGR6 = OXFFFFFFFF; 

iy; Y 

18 

19 5 

20  * Qdescription : 初始 化 LED 对 应 的 GPIO 
21  * Gparam e JE 

22  * Qreturn BOE 

2g up 

24 void led init (void) 

95 1 

26 /* 1. WB ioXH */ 

2 IOMUX SW MUX-»GPIO1 IO03 = 0X5; /* 复 用 为 GBIO1 1003 */ 
28 
29 

30 /* 2、 配 置 GEIO1L I003 的 I0 属 性 

om *pit 16:0 HYS XH] 

32 *bpit [15:14]: 00 SUA Pix 

33 *bit [13]: 0 kepper mike 

34 *bit [12]: 1 pull/keeper 使 能 

35 *bit [11]: 0 关闭 开路 输出 

36 *bit [7:6]: 10 速度 100Mhz 

37 *bit [5:3]: 110 RO/6 驱动 能 

38 *pit [0]: 0 低 转 换 率 

39 Bul 

40 IOMUX SW PAD-»GPIO1 IO03 = 0X10B0; 
41 

42 
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43 /* 3. 初始 化 GETO */ 

44 GPIO1-»GDIR = 0X0000008; | /* GPIOl IO03 设置 为 输出 */ 

45 

46 /* 4. RA GPIOl 1003 输出 低 电 平 ， 打 开 LEDO */ 

47 GPIO1-»DR &- «(1 << 3); 

48 

49 } 

50 

Sui yw 


52 = Qdescription s 1]7f LED AJ 


53 = param 无 

54  * Qreturn e JE 

55 E 

56 void led on(void) 

STER 

58 /* 将 GPIO1 DR 的 pit3 清 零 ui 
59 GPIO1-»DR &- ~(1<<3) ; 
60 } 

61 

62 /* 

63  * Qdescription : 关闭 LED 灯 
64 * (üiparam E JE 

65  * Qreturn 3 JE 

O6 wf 

67 void led off (void) 

68 ( 

69 /* XtGPIOl DRÜJbit3 É1 */ 
70 GPIOl-»DR |= (1<<3) : 
NEL 

112 

qs que 


74  * Qdescription : 短 时 间 延 时 函数 
75  * @param - n :要 延 时 循环 次 数 ( 空 操作 循环 次 数 ， 模 式 延 时 ) 





76  * Qreturn JEU 

M ey 

78 void delay short(volatile unsigned int n) 
"9 4 

80 while (n--)(]) 

9 ] 

82 

eg qme 

84  * Qdescription : 延 时 函数 ,在 396Mhz 的 主 频 下 
DES 延 时 时 间 大 约 为 Ims 
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86 * @param - n  : 要 延 时 的 ms 2X 

87  * Qreturn 8 JE 

88 P 

89 void delay(volatile unsigned int n) 

90 ( 

EI while (n--) 

92 { 

SIS) delay short (0x7ff); 

94 ) 

95M 

96 

9 qne 

98  * Qdescription : mian 函数 

99 * (üiparam e JE 

100 * Greturn 8 JE 

dd. y 

102 int main(void) 

TOS 

104 clk enable(); /* 使 能 所 有 的 时 钟 er 
105 led init(); /* 初始 化 led ay 
106 

10077 while (!) /* 死 循环 i 
108 { 

109 les ori N) p /* XH] LED */ 
110 delay (500); /* 延 时 500ms Eu 
Jalal 

TA led on(); /* T LED */ 
HS delay (500); /* 延 时 500ms */ 
114 } 

IHs 

116 return 0; 

1139 








main.c 中 7 个 函数 ， 这 7 个 函数 的 含义 和 第 十 章 中 的 main.c 文件 一 样 ， 只 是 函数 体 写 法 变 
了 , 寄存 器 的 访问 采用 imx6ul.h 中 定义 的 外 设 指针 。 比 如 第 27 行 设置 GPIO1_IO03 的 复 用 功能 
就 可 以 通过 “IOMUX SW_MUX->GPIO1 IO03” 来 给 寄存 SW MUX CTL PAD GPIOI IO03 
赋值 。 


11.4 编译 下 载 验 证 


11.4.1 编写 Makefile 和 链接 脚本 


Makefile 文件 的 内 容 基 本 和 第 十 章 的 Makefile 一 样 ， 如 下 : 
示例 代码 11.4.1 Makefile 文件 代码 











348 


LMX6U 嵌入 式 Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教学 : www.yuanzige.com 论坛 :www.opendev.com 
于 二 

2 

3S lede bun:s9b5s) 

4 arm-linux-gnueabihf-ld -Timx6ul.lds -o ledc.elf $^ 

5 enm- linuz-gnusabihni-0b]copy =0 binary = lede. elt $8 

6 arm-linux-gnueabihf-objdump -D -m arm ledc.elf > ledc.dis 
3] 

ONE SCORES 

9 eucum-ligen-gpaneeloxlair-Grece Mell -maosteisilb -e -02 -o 98 $< 
10 

JL $9859 

1 arm-linux-gnueabihf-gcc -Wall -nostdlib -c -02 -o $8 $< 
3 

AO CE 

ills arm-linux-gnueabihf-gcc -Wall -nostdlib -c -02 -o $8 $< 
16 

eedem: 

18 rm -rf *.o ledc.bin ledc.elf ledc.dis 





链接 脚本 imx6ul.lds 的 内 容 和 上 一 章 一 样 ， 可 以 直接 使 用 上 一 章 的 链接 脚本 文件 。 








11.4.2 编译 下 载 


使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 ledc.bin 文 
件 下 载 到 SD Er. dp: 

chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

./imxdownload ledc.bin /dev/sdd / 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 ， 如 果 代 码 运行 正常 的 
话 LEDO 就 会 以 500ms 的 时 间 间 隔 亮 灭 ， 实 验 现 象 和 上 一 章 一 样 。 















































x 
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第 十 二 章 官方 SDK 移植 试验 


在 上 一 章 中 ， 我 们 参考 ST 官方 给 STM32 编写 的 stm32f10x.h 来 自行 编写 LMX6U 的 寄存 














器 定义 文件 。 自 己 编写 这 些 寄存 器 定义 不 仅 费 时 费力 ， 没 有 任何 意义 ， 而 且 很 容易 写 错 ， 幸 好 
NXP 官方 为 LMX6ULL 编写 了 SDK 包 ， 在 SDK 包 里 面 NXP 已 经 编写 好 了 寄存 器 定义 文件 ， 
所 以 我 们 可 以 直接 移植 SDK 包 里 面 的 文件 来 用 。 虽 然 NXP 是 为 IMX6ULL 编写 的 SDK 包 ， 
但 是 LMX6UL 也 是 可 以 使 用 的 ! 本 章 我 们 就 来 讲解 如 何 移植 SDK 包 里 面 重 要 的 文件 ， 方 便 我 
们 的 开发 。 
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12.1 I.MX6ULL 官方 SDK 包 简 介 








论坛 :Www.opendev.com 


NXP 针对 LMX6ULL 编写 了 一 个 SDK 包 ， 这 个 SDK 包 就 类 似 于 STM32 的 STD 库 或 者 














HAL 库 ， 这 个 SDK 包 提 供 





Linux。 








tf Windows 和 Linux 两 种 版 本 ， 
因为 我 们 是 在 Windows 下 使 用 Source Insight 来 编写 代码 的 , 因此 我 们 使 用 的 是 Windows 
版 本 的 。Windows 版 本 SDK 里 面 的 例 程 提 供 








分 别针 对 主机 系统 是 Windows 和 





EY IAR 版 本 ,肯定 有 人 会 问 既 然 NXP 提供 了 IAR 


版 本 的 SDK， 那 我 们 为 什么 不 用 IAR 来 完成 裸 机 试验 ， 偏 偏 要 用 复杂 的 GCC? 因为 我 们 要 从 


简单 N E 








掌握 Linux 下 的 GCC 开发 方法 ， 包 括 Ubuntu 操作 系统 的 使 用 、Makefile 的 编 











写 、shell 等 


。 如 果 为 了 偷懒 而 使 用 IAR 开发 裸 机 的 话 ， 











那么 后 续 学 习 Uboot 移植 、Linux 移 

















植 和 Linux 哎 动 开发 就 会 很 难 上 手 ， 因为 








开发 环境 都 不 熟悉 ! 再 者 ， 不 是 所 有 的 半导体 厂商 都 





会 为 Cortex-A 架构 的 芯片 编写 裸 机 SDK 包 ， 我 使 用 过 那么 多 的 Cotex-A 系列 芯片 ， 也 就 发 现 

















了 NXP 给 LMX6ULL 编写 了 裸 机 SDK 包 。 而 且 去 NXP 官网 看 一 下 ， 
这 一 款 Cotex-A 内 核 的 芯片 有 裸 机 SDK 包 ，NXP 的 其 它 Cotex-A 芯片 都 没有 。 








定位 里 面 ，LMX6ULL 5 
么 多 的 目的 就 是 想 告 诉 大 家 ， 使 用 Cortex- 
东西 ，LMX6ULL 是 一 个 特例 ， 基 本 所 有 


JE 























会 发 现 只 有 LMX6ULL 


说 明 在 NXP 的 








是 一 个 Cotex-A 内 核 的 高 端 单片机 ， 定 位 类 似 ST 的 STM32H7。 说 这 


A 内 核 芒 片 的 时 候 不 要 想 着 有 类 似 STM32 库 一 样 的 


的 Cortex-A 内 核 的 芯片 都 不 会 提供 裸 机 SDK B. [X 














此 在 使 用 STM32 的 时 候 那 些 用 起 来 很 顺手 的 库 文件 ， 在 Cotex-A 芯片 下 基本 都 需要 我 们 自行 











编写 ， 比 如 .s 启动 文件 














` 寄存 器 定义 等 等 。 


因为 本 教程 是 教 大 家 Linux 驱动 开发 入 门 的 ， 本 教程 需要 尽 可 能 的 降低 入 门 难度 ， 这 也 是 





为 什么 本 教程 会 选择 LMX6U 芯片 的 一 个 重要 的 原因 








包 ， 大 家 上 手 会 很 容易 。 





73 i.MX 6ULL Applications Proc 


C o 9$ 


Lab and Test Software (1 


C & https nxp.com 
Simulation and Models - BSDL (1 
Simulation and Models - IBIS Model 
Software Development Kits 
Standalone Compilers and Build Tools TANS 
UI Build Tools 

Run-time Software (12 
Middleware - APIs (3 
Middleware - Protocol Stacks 


Operating System Software - Board Support 
Packages (5 


Operating System Software - Hypervisors 


Operating System Software - Operating 
Systems 


Embedded Board Solutions (25 
Custom (5 
Other Standard Form Factors (4 
SOM (13 








我 们 下 载 
载 好 放 到 光盘 中 ， 路 径 为 : 开发 板 光 盘 





图 12.1.1 LMX6ULL SDK marem 
图 12.1.1 中 的 WIN 版 本 SDK, 














， 因 为 其 提供 了 LMXGULL 的 裸 机 SDK 


LMX6ULL 的 SDK GE NXP 官网 下 载 ， 下 载 界面 如 图 12.1.1 所 示 : 





e*t = 
muci vv uyY rur vvu optio vivos yororvpn nv uy 
Green Hills Probe, Slingshot or P&E Wiggler or, if no board is 
available, to the MULTI instruction set simulator. 
STORYBOARD DEMO IMAGES Ø 

by Crank Software Inc 


Binary SD card demo image that contains NXP's Yocto Linux and 
Crank Software's graphical demo launcher. Great for users who want 
to evaluate and understand the graphical capabilities of the platform. 


SDK2.2 iMX6ULL, LINUX(REV SDK22) @ 


Linux installer - MCUXpresso SDK2 2 for i.MX 6ULL 


SDK2.2 iMX6ULL. WIN(REV SDK22) @ 
Windows installer - MCUXpresso SDK2 2 for i. MX 6ULL 


[2] t REGI 























也 就 是 “SDK2.2 iMX6ULL WIN”， 我 们 已 经 下 


-> 7. LMX6U 参考 资料 ->23、IMX6ULL SDK 包 -> 


SDK 2.2 MCIM6ULL RFP Win.exe。 双 击 SDK 2.2 MCIM6ULL RFP Win.exe 安装 SDK 包 ， 
安装 的 时 候 需 要 设置 好 安装 位 置 ， 安 装 完成 以 后 的 SDK 包 如 图 12.1.2 所 示 : 
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> 仓库 (G] > IMX6 ，SDK 2.2 MCIMGULL 


^ 








名 称 修改 日 期 大 小 

boards 2019-02-14 22:43 

CMSIS 2019-02-14 22:44 

CORTEXA 2019-02-14 22:44 

devices 2019-02-14 22:44 

docs 2019-02-14 22:44 

middleware 2019-02-14 22:44 

rtos 2019-02-14 22:44 

| | tools 2019-02-14 22:44 ”文件 去 

|_| EVK-MCIMXGULL manifest.xml 2017-06-07 13:23 XML 文档 459 KB 

€| LA OPT Base License.htm 2017-06-07 13:23 — 360 se HTML Do... 148 KB 

[-] SW-Content-Register.txt 2017-06-07 13:23 XXE 5 KB 
图 12.1.2 SDK & 




















我 们 本 教程 不 是 讲解 SDK 包 如 何 开发 的 ， 我 们 只 是 需要 SDK 包 里 面 的 几 个 文件 ， 所 以 就 
不 详细 的 这 个 SDK 包 了 ， 感 兴趣 的 可 以 看 一 下 ， 所 有 的 例 程 都 在 boards 这 个 文件 夹 里 面 。 我 
们 重点 是 需要 SDK 包 里 面 与 寄存 器 定义 相关 的 文件 ， 一 共和 需要 如 下 三 个 文件 : 

fs! common.h: 位 置 为 SDK 2.2 MCIM6ULL\devicesMCIMX6Y2\drivers\fsl common.h. 

fsl iomuxc.h: ”位置 为 SDK 2.2 MCIM6ULL\devices\MCIMX6Y2\drivers\fsl_iomuxc.ho 

MCIMX6Y2.h: 位 置 为 SDK 2.2 MCIM6ULLMevices MCIMX6Y2MCIMX6YH2.h. 

整个 SDK 包 我 们 就 需要 上 面 这 三 个 文件 ， 把 这 三 个 文件 准备 好 ， 我 们 后 面 移植 要 用 。 


12.2 硬件 原理 图 分 析 
本 章 使 用 到 的 硬件 资源 和 第 八 章 一 样 ， 就 是 一 个 LED0。 


12.3 试验 程序 编写 
本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 4 ledc_sdk。 



















































































12.3.1 SDK 文件 移植 


使 用 VSCode 新 建 工程 ， 将 fsl common.h. fsl iomuxc.h 和 MCIMX6Y2.h 这 三 个 文件 拷贝 
到 工程 中 ， 这 三 个 文件 直接 编译 的 话 肯 定 会 出 错 的 ! 需要 对 其 做 删 减 ， 因 为 这 三 个 文件 里 面 的 
代码 都 比较 大 ， 所 以 就 不 详细 列 出 这 三 个 文件 删 减 以 后 的 内 容 了 。 大 家 可 以 参考 我 们 提供 的 裸 
机 例 程 来 修改 这 三 个 文件 ， 很 简单 的 。 修 改 完成 以 后 的 工程 目录 如 图 12.3.1.1 所 示 : 


$ ls -a 












































fsl_common.h fsl iomuxc.h MCIMX6Y2.h 
- $ | 


图 12.3.1.1 工程 目录 








12.3.2 创建 cc.h 文件 


新 建 一 个 名 为 cch KAX, cch 里 面 存放 一 些 SDK 库 文件 需要 使 用 到 的 数据 类 型 ， 在 
cc.h 里 面 输入 如 下 代码 : 



































示例 代码 12.3.2.1 cch 文件 代码 
1  spaimelei — CE H 
2 #define _ CC H 
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3 /汪汪 业 类 类 类 类 大 火炎 火炎 火炎 大大 大大 大大 炎炎 类 类 类 大 类 火炎 大 类 大 类 类 类 大 类 大 大 大 大大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 
4 Copyright © zuozhongkai Co., Ltd. 1998-2019. AUL rights reserved. 
5 文件 名 EC 
6 作者 : EM 
7 版 本 8 WIL 
8 描述 : 有 关 变 量 类 型 的 定义 ，NXP 官方 SDK 的 一 些 移植 文件 会 用 到 。 
9 其 他 SE 
10 HS : 初版 V1.0 2019/1/3 左 忠 凯 创 建 
3n KECKCKCKCkCKCk kCkCk k kk k kk Ck kCkCk k kk k kk k kc k Ck k Ck Ck kCkCk k kk k kc k Ck kc k ck kck ck kck ck ckck ck ckck ck kock e ke k f 
112 
JS) fes 
14 * 自 定义 一 些 数据 类 型 供 库 文件 使 用 
dg 
16 #define mi volatile 
17 #define EN volatile 
18 #define EC volatile 
T9 
20 #define ON il 
21 #define OFF 0 
212) 
23 typedef signed char aane) mp 
24 typedef signed ehoze Tat acle Ep 
25 typedef signed int duc 3 qp 
26 typedef unsigned char qms ip 
27 typedef unsigned short int ined. ip 
28 typedef unsigned int uint Ep 
29 typedef unsigned long long uint64 t; 
30 typedef signed char SION 
31 typedef signed short int S165 
32 typedef signed int SIZE 
33 typedef signed long Tong NE s64; 
34 typedef unsigned char u8; 
35 typedef unsigned short int ql E 
36 typedef unsigned int u52? 
37 typedef unsigned long long LE u64; 
38 
S9 denda 
在 cc.h 文件 只 我 们 定义 了 很 多 的 数据 类 型 ， 因 为 有 些 第 三 方 库 会 用 到 这 些 变量 类 型 。 








12.3.3 编写 实验 代码 











创建 完成 以 后 工程 目录 如 图 12.3.3.1 Bras: 





新 建 start.S 和 main.c 这 两 个 文件 , start.s 文件 的 内 容 和 上 一 章 








样 ,直接 复制 过 来 就 可 以 ， 
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$ ls 





: -a 
cc.h fsl common.h fsl iomuxc.h main.c MCIMX6Y2.h start.S 
: $ 


图 12.3.3.1 工程 目录 文件 
在 main.c 中 输入 如 下 所 示人 代码 : 
示例 代码 12.3.3.1 main.c 文件 代码 


/大 大 大 大 大大 大大 炎炎 炎炎 炎炎 炎炎 炎炎 大 火炎 火炎 大 炎炎 大 火炎 大 大 火炎 炎炎 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 








(GO yrs OR ZOZhomcsddwe e Oe MEd eb 9ier IO OT EEANININ gie see EG SCTVIG c. 
文件 名 E 
































作者 : 左 忠 凯 
版 本 Vs 

DS : I.MX6U 开发 板 裸 机 实验 4 使 用 NXP 提供 的 工 .MX6ULLI ÈN IAR SDK 包 开 发 
其 他 : 前 面 其 他 所 有 实验 中 ， 寄 存 器 定义 都 是 我 们 自己 手写 的 ， 但 是 工 .MX6U 











的 寄存 器 有 很 多 ， 全 部 自己 写 太 费时 间 ， 而 且 没 意义 。NXP 官方 提供 了 

针对 I.MX6ULL 的 SDK 开发 包 ， 是 基于 IAR 环境 的 ， 这 个 SDK 包 里 面 已 经 提 
HET I.MX6ULL 所 有 相关 寄存 器 定义 ， 昌 然 是 针对 I.MX6ULL 编写 的 ， 但 是 同样 
适用 于 工 .MX6UL。 本 节 我 们 就 将 相关 的 寄存 器 定义 文件 移植 到 Linux 环境 下 ， 
要 移植 的 文件 有 : 


fsl common.h 




















iE. me 
MCIMX6Y2.h 
HEX XTF cc.h 
E ss : 初版 V1.0 2019/1/3 左 忠 凯 创建 


KOKCKCKCKCkCkCkCk k kk k kk Ck kk Ck kCkCk k kc k k kk Ck kCk Ck kCk Ck k kc k k kc k Ck k ck ck kck ck kck ck ckck ck ckck ck sk sk e kx kx 

















1 wabeedberele Wisil rexewntea lai ^ 

2 inele "isl donem" 

S #include "MCIMX6Y2.h" 

4 

S> 

6 * @description : 使 能 工 .MX6U 所 有 外 设 时 钟 
T param SEE 

8 * Qreturn JE 

9 x 

10 void clk enable (void) 

id 4 

下 多 CCM-»CCGRO = OXFFFFFFFF; 
13 CCM->CCGR1 = OXFFFFFFFF; 
14 

15 CCM-»-CCGR2 - OXFFFFFFFFE; 
16 CCM-»CCGR3 2 OXFFFFFFFF; 
151 CCM->CCGR4 = OXFFFFFFFF; 
18 CCM-»CCGR5 = OXFFFFFFFF; 
31$ CCM=>CCGR6 = OXFFFFFFFFE; 
20 
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2 
22 
23 
24 
25 
26 
ZT 
28 
29 
30 
Sil 
92. 
33 
34 
ENS 
36 
27] 
38 
29 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
x 
52 
53 
54 
ES 
56 
S 
58 
59 
60 
61 
62 
63 


} 


/* 
* 
* 


* 


i 


Qdescription : 初始 化 LED 对 应 的 GPIO 
Qparam 3776 
SEE 





Qreturn 


void led init (void) 


{ 


* 


/* 1、 初始化 IO SH */ 


e31E B B 


论坛 :www.opendev.com 


IOMUXC SetPinMux(IOMUXC GPIO1 IO03 GPIO1 1003,0); 


/* 2. ~ Bi GPIO1 1003 Ñ 10 属性 
*bit 16:0 HYS XH] 

soie [15:14]: 00 SUA TÉ 
*bit [13]: 0 kepper 功能 

*bit [12]: 1 pull/keeper NRE 
*bit [11]: 0 关闭 开路 输出 

*bit [7:6]: 10 速度 100Mhz 
*bit [5:3]: 110 RO/6 驱动 能 
*bit [0]: 0 低 转 换 率 


IOMUXC SetPinConfig(IOMUXC GPIO1 IO03 GPIO1 1003,0X10B0); 


/* 3、 初 始 化 GPIO, E GPIOl 1003 设置 为 输出 */ 


GPIOT-»2GDIR | (1 «« 3); 


/* 4. WE GPIOl 1003 输出 低 电 平 ， 打 开 卫 





GPIO1->DR &= «(i << 3); 


QGdescription : IIF LED AJ 
Qparam JE 
@return 3 JE 


void led on(void) 


{ 


/ * 


/* 将 GPIOl DR 的 bit3 HF 2 
GPIO1->DR &= ~(1<<3); 
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64  * Qdescription : XM LED $J 


GS * (üparam e 3E 

66  * Qreturn 8 XE 

GL EY 

Se en MR E- To fon ob a (vonid) 

SS d 

70 /* ft GPIOl DR 的 pit3 置 1 */ 
了 人 GPIO1-»DR |= (i««3); 

LUN 

TAS) 

qa. qe 


75  * Qdescription : 短 时 间 延 时 函数 
76 * eparam - n  : 要 延 时 循环 次 数 ( 空 操作 循环 次 数 ， 模 式 延 时 ) 








J Qreturn S E 

pom, 

19 volc Celay chort (volatile vngigrec ime m) 
80 ( 

81 while (n--)(]) 

82 ) 

83 

arr ies 

85  * Qdescription : 延 时 函数 ,在 396Mhz 的 主 频 下 
Jo. 延 时 时 间 大 约 为 Ims 

87 [Cosa — am : 要 延 时 的 ms 数 

88  * Qreturn & JE 

99  *f 

90 void delay(volatile unsigned int n) 

St 

07 while (n--) 

DE { 

94 delay short (0x7ff); 

95 } 

96 ) 

97 

Ox. ue 

99  * Qdescription : mian KÆ 

100 * @param S EE 

101 * Q8return EET 

WOZ = 

103 int main(void) 

104 ( 

105 clk enable(); /* 使 能 所 有 的 时 钟 */ 
106 lea ims) /* 初始 化 led 3 
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KOT 

108 while (1) /* 死 循环 s 
TOS) { 

110 led ofi); /* SRi LED a 
iid delay(500); /* 延 时 500ms */ 
12 

WaS leed onl) 7 /* 打开 LED */ 
1114] delay(500); /* fW] 500ms */ 
T3 } 

G 

Ia return 0; 

1189] 











和 上 一 章 一 样 ，main.c 有 7 个 函数 ， 这 7 个 函数 的 含义 都 一 样 ， 只 是 本 例 程 我 们 使 用 的 是 
移植 好 的 NXP 官方 SDK 里 面 的 寄存 器 定义 。main.c 文件 的 这 7 个 函数 的 内 容 都 很 简单 ， 前 面 
都 讲 过 很 多 次 了 ,我们 重点 来 看 一 下 led_init 函数 中 的 第 31 行 和 第 43 行 , 这 两 行 的 内 容 如 下 : 

IOMUXC SetPinMux(IOMUXC GPIOI IO03 GPIOI IO03, 0); 

IOMUXC SetPinConfig(IOMUXC GPIOI IO03 GPIO1 IO03, 0X10B0); 

这 里 使 用 了 两 个 函数 IOMUXC SetPinMux 和 IOMUXC SetPinConfig ， 其 中 函数 
IOMUXC SetPinMux 是 用 来 设置 IO 复 用 功能 的 ， 最 终 肯 定 设 置 的 是 寄存 器 

“IOMUXC SW MUX CTL PAD XX". 函数 IOMUXC SetPinConfig 设置 的 是 IO 的 上 下 拉 、 
速度 等 的 , 也 就 是 寄存 器 “IOMUXC SW PAD CTL PAD XX", 所 以 上 面 两 个 函数 其 实 就 是 上 
一 章 中 的 : 

IOMUX SW_MUX->GPIO1 IO03 = 0X5; 

IOMUX SW_PAD->GPIO1 IO03 = 0X10B0; 

函数 IOMUXC SetPinMux 在 文件 fl iomuxc.h 中 定义 ， 函 数 源码 如 下 : 

static inline void IOMUXC SetPinMux(uint32 t muxRegister, 


uint32 t muxMode, 



































































































































uint32 t inputRegister, 
uint32 t inputDaisy, 
uint32 t configRegister, 
uint32 tinputOnfield) 








1 
*((volatile uint32 t *)muxRegister) — 
IOMUXC SW MUX CTL PAD MUX MODE(muxMode) | 
IOMUXC SW MUX CTL PAD SION(inputOnfield); 
if (inputRegister) 
1 
*((volatile uint32 t *)inputRegister) = 
IOMUXC SELECT INPUT DAISY (inputDaisy); 
} 
} 


函数 IOMUXC_SetPinMux 有 6 个 参数 ， 这 6 个 参数 的 函数 如 下 : 
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muxRegister : IO 的 复 用 寄存 器 地 址 ， 比 如 GPIOI I003 的 IO 复 用 寄存 器 
SW MUX CTL PAD GPIO1 IO03 的 地 址 为 0X020E0068。 

muxMode: ”IO 复 用 值 ， 也 就 是 ALTO~ALT8， 对 应 数字 0~8， 比 如 要 将 GPIOI IO03 设置 
为 GPIO 功能 的 话 此 参数 就 要 设置 为 5。 

inputRegister: 外 设 输入 IO 选择 寄存 器 地 址 ， 有 些 IO 在 设置 为 其 他 的 复 用 功能 以 后 还 需 
要 设置 IO 输入 寄存 器 ， 比 如 GPIOI 1003 要 复 用 为 UARTI RX 的 话 还 需要 设置 寄存 器 
UARTI RX DATA SELECT INPUT， 此 寄存 器 地 址 为 0X020E0624. 

inputDaisy: 寄存 器 inputRegister 的 值 ， 比 如 GPIO1 IO03 要 作为 UART1_RX 引 脚 的 话 此 

configRegister: 未 使 用 ， 函 数 IOMUXC SetPinConfig 会 使 用 这 个 寄存 器 。 

inputOnfield : IO 软件 输入 使 能 ， 以 GPIOlIO03 为 例 就 是 寄存 器 
SW MUX CTL PAD GPIOI IO03 的 SION 位 (bit4)。 如 果 需 要 使 能 GPIO1 IO03 的 软件 输入 功 
能 的 话 此 参数 应 该 为 1， 否则 的 话 就 为 0。 

IOMUXC SetPinMux 的 函数 体 很 简单 ,就 是 根据 参数 对 寄存 器 muxRegister 和 inputRegister 
进行 赋值 。 在 “示例 代码 12.3.3.1” 中 的 31 行使 用 此 函数 将 GPIO1 1003 的 复 用 功能 设置 为 
GPIO, WF: 

IOMUXC SetPinMux(IOMUXC GPIOI IO03 GPIOI IO03, 0); 

第 一 次 看 到 上 面 代码 的 时 候 肯定 会 奇怪 ， 为 何 只 有 两 个 参数 ?” 不 是 应 该 6 个 参数 的 吗 ? 不 
要 着 急 ， 先 看 一 个 IOMUXC GPIOI 1003 GPIOI 1003 是 个 什么 玩意 。 这 是 个 宏 ， 在 文件 
fsl iomuxc.h 中 有 定义 ，NXP 的 SDK 库 将 一 个 IO 的 所 有 复 用 功能 都 定义 了 一 个 宏 ， 比 如 
GPIO1 IO03 就 有 如 下 9 个 宏 定义 : 

IOMUXC GPIOI IO03 PC1 SDA 

IOMUXC GPIOI IO03 GPT1 COMPARE3 

IOMUXC GPIOI IO03 USB OTG2 OC 

IOMUXC GPIOI IO03 USDHCI CD B 

IOMUXC GPIO1 IO03 GPIOI IO03 

IOMUXC GPIOI IO03 CCM DIO EXT CLK 

IOMUXC GPIOI IO03 SRC TESTER ACK 

IOMUXC GPIOI IO03 UARTI RX 

IOMUXC GPIOI IO03 UARTI TX 

EH 9 个 宏 定义 分 别 对 应 着 GPIO1 1003 的 九 种 复 用 功能 ， 比 如 复 用 为 GPIO 的 宏 定义 就 
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#define IOMUXC GPIO1 IO03 GPIO! IO03 ].0x020E0068U, OxSU, 0x00000000U, 
0x0U, 0x020E02F4U 

将 这 个 宏 带 入 到 “示例 代码 12.3.3.1" 8531 行 以 后 就 是 : 

IOMUXC SetPinMux (0x020E0068U, 0x5U, 0x00000000U, 0x0U, 0x020E02F4U, 0); 

这 样 就 与 函数 IOMUXC_SetPinMux 的 6 个 参数 对 应 起 来 了 , 如 果 我 们 要 将 GPIO1_I003 复 
用 为 12C1_SDA 的 话 就 可 以 使 用 如 下 代码 ; 

IOMUXC SetPinMux(IOMUXC GPIO1 IO03 I2C1 SDA, 0) 

函数 IOMUXC SetPinMux 就 讲解 到 这 里 ， 接 下 来 看 一 下 函数 IOMUXC SetPinConfig, Hk 
函数 同样 在 文件 fsl iomuxc.h 中 有 定义 ， 函 数 源码 如 下 : 

static inline void IOMUXC SetPinConfig(uint32 t muxRegister, 

uint32 t muxMode, 
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uint32 t inputRegister, 


uint32 t inputDaisy, 
uint32 t configRegister, 
uint32 t configValue) 


1 
if (configRegister) 
1 
*((volatile uint32 t *)configRegister) = config Value; 
j 
j 


函数 IOMUXC SetPinConfig 有 6 个 参数 ， 其 中 前 五 个 参数 和 函数 IOMUXC. SetPinMux 一 
样 ， 但 是 此 函数 只 使 用 了 参数 configRegister 和 configValue，cofigRegister 参数 是 IO 配置 寄存 
器 地 址 ， 比 如 GPIO1 IO03 的 IO 配置 寄存 器 为 IOMUXC SW PAD CTL PAD GPIOI IO03， 
其 地 址 为 0X020E02F4， 参 数 configValue 就 是 要 写 入 到 寄存 器 configRegister 的 值 。 同 理 ,“ 示 
例 代码 12.3.3.1” 的 43 行 展开 以 后 就 是 : 

IOMUXC SetPinConfig(0x020E0068U, 0x5U, 0x00000000U, 0x0U, 0x020E02F4U, 0X 10B0); 

根据 函数 IOMUXC  SetPinConfig 的 源码 可 以 知道 ， 上 面 函数 就 是 将 寄存 器 0x020E02F4 的 
值 设 置 为 0X10B0。 函 数 IOMUXC SetPinMux 和 IOMUXC SetPinConfig 就 讲解 到 这 里 ， 我 们 
以 后 就 可 以 使 用 这 两 个 函数 来 方便 的 配置 IO 的 复 用 功能 和 IO 配置 。 

main.c 就 讲 到 这 里 ， 基 本 和 上 一 章 一 样 ， 只 是 我 们 使 用 了 NXP 官方 号 好 的 寄存 器 定义 ， 另 
外 中 断 讲 解 了 函数 IOMUXC SetPinMux 和 IOMUXC SetPinConfig. 


12.4 编译 下 载 验证 


12.4.1 编写 Makefile 和 链接 脚本 


新 建 Makefile 文件 ，Makefile 文件 内 容 如 下 : 
示例 代码 12.4.1.1 Makefile 文件 代码 

































































































































































1 CROSS COMPILE ?-2 arm-linux-gnueabihf- 

2 NAME ?2 ledc 

3 

ab eio :2 S(CROSS COMPILE)gcc 

5 UD := $(CROSS COMPILE)l1d 

6 OBJCOPY = (CROSS COMPILE)objcopy 
7 OBJDUMP = $ (CROSS COMPILE)objdump 
8 

9 OBJS cauce e O MALNO 

10 

11 S(NAME).bin:$(OBJS) 

3122 S (ED) -Timx6ul.lds -o $(NAME).elf $^ 
13 SNO EWIG GUN On S e (NAME TERES (d 
14 S$(OBJDUMP) -D -m arm $(NAME).elf » S$(NAME).dis 
I5 

NS TORS 
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$(CC) -Wall -nostdlib -c -02 -o $0 $< 

18 

JEN ORE PONO 

20 $(CC) -Wall -nostdlib -c -02 -o $0 $< 

2 

2 

23 $(CC) -Wall -nostdlib -c -02 -o $0 $< 

24 

25 clean: 

26 rm -rf *.o $(NAME).bin S(NAME).elf $(NAME).dis 











[m 





本 章 实验 的 Makefile 文件 是 在 第 十 一 章 中 的 Makefile 上 修改 的 ， 只 是 使 用 到 了 变量 。 
脚本 imx6ul.lds 的 内 容 和 上 一 章 一 样 ， 可 以 直接 使 用 上 一 章 的 链接 脚本 文件 。 


链接 





[i3 








12.4.2 编译 下 载 


使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 ledc.bin X 
件 下 载 到 SD Er. dr Wr: 

chmod 777 imxdownload // 给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

./imxdownload ledc.bin /dev/sdd / 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 ， 如 果 代 码 运行 正常 的 
话 LEDO 就 会 以 500ms 的 时 间 间 隔 亮 灭 ， 实 验 现 象 和 上 一 章 一 样 。 
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第 十 三 章 BSP 工程 管理 实验 


在 前 面 的 章节 中 ， 我 们 都 是 将 所 有 的 源码 文件 刚 到 工程 的 根 目录 下 ， 如 果 工 程 文件 比较 少 























的 话 这样 做 无 可 厚 非 ， 但 是 如 果 工 程 源 文件 达到 几 十 、 甚 至 数 百 个 的 时 候 ， 这 样 一 股 脑 全 部 放 
到 根 目 录 下 就 会 使 工程 显得 混乱 不 堪 。 所 以 我 们 必须 对 工程 文件 做 管理 ， 将 不 同 功能 的 源码 文 
件 放 到 不 同 的 目录 中 。 另 外 我 们 也 需要 将 源码 文件 中 ， 所 有 完成 同一 个 功能 的 代码 提取 出 来 放 
到 一 个 单独 的 文件 中 ， 也 就 是 对 程序 分 功能 管理 。 本 章 我 们 就 来 学 习 一 下 如 何 对 一 个 工程 进行 
整理 ， 使 其 美观 、 功 能 模块 清晰 、 易 于 阅读 。 
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13.1 工程 管理 简介 
打开 我 们 上 一 章 的 工程 根 目录 ， 如 图 13.1.1 所 示 : 





$ LS -3 
cc.h fsl_iomuxc.h  imxdownload load.imx Makefile start.S 


fsl common.h  imx6ul.lds ledc sdk.code-workspace main.c MCIMX6Y2 .h 
$ 





图 13.1.1 工程 根 目录 

在 图 13.1.1 中 我 们 将 所 有 的 源码 文件 都 放 到 工程 根 目 录 下 ， 即 使 这 个 工程 只 是 完成 了 一 个 
简单 的 流水 灯 的 功能 ， 但 是 其 工程 根 目录 下 的 源码 文件 就 己 经 不 少 了 。 如 果 在 添加 一 些 其 他 的 
功能 文件 ， 那 么 文档 就 会 更 大 ， 显 得 很 混乱 ， 所 以 我 们 需要 对 这 个 工程 进行 整理 ， 将 源码 文件 
分 模块 、 分 功能 整理 。 我 们 可 以 打开 一 个 STM32 的 例 程 ， 如 图 13.1.2 所 示 : 

































































名 称 修改 日 其 类 型 大 小 

T CORE 2017-12-25 12:55 文件 夹 

^ HARDWARE 2017-12-25 12:55 文件 夹 

7 OBJ 2017-12-25 12:55 文件 夹 

STM32F10x_ FWLib 2017-12-25 12:55 文件 夹 

7 SYSTEM 2017-12-25 12:55 文件 夹 

T USER 2017-12-25 12:55 文件 夹 

[Œ] keilkilll.bat 2011-04-23 10:24 Windows 批 处 理 文件 1KB 
=| README.TXT 2015-03-23 20:17 文本 文档 2KB 


图 13.1.2 STM32F103 例 程 工程 文件 
图 13.1.2 中 的 工程 目录 就 很 美观 、 不 同 的 功能 模块 文件 放 到 不 同 的 文件 夹 中 ， 比 如 驱动 文 
秆 就 放 到 HARDWARE 文件 夹 中 ，ST 的 官方 库 就 放 到 STM32F10x_FWLib 文件 夹 中 ， 编 译 产 
生 的 过 程 文件 放 到 OBJ 文件 夹 中 。 我 们 可 以 参考 这 个 工程 目录 结构 来 整理 第 十 二 章 的 例 程 工 
程 ， 新建 名 为 “5_ledc_bsp” 的 文件 夹 , 在 里 面 新 建 bsp、imx6ul、obj 和 project 这 3 个 文件 夹 ， 
完成 以 后 如 图 13.1.3 所 示 : 





















































aa 





$i 








图 13.1.3 新 建 的 工程 根 目录 文件 夹 

其 中 bsp 用 来 存放 驱动 文件 ，imx6ul 用 来 存放 跟 芯 片 有 关 的 文件 ， 比 如 NXP 官方 的 SDK 
库 文 件 ; obj 用 来 存放 编译 生成 的 .o 文件 ; project 存放 start.S 和 main.c 文件 , 也 就 是 应 用 文件 ; 
将 十 二 章 实验 中 的 cc.h、fsl common.h. fsl iomuxc.h 和 MCIMX6Y2.h 这 四 个 文件 拷贝 到 文件 
3€ imx6ul FP; 将 start.S 和 main.c 这 两 个 文件 拷贝 到 文件 夹 project 中 。 我 们 前 面 的 实验 中 所 有 
的 驱动 相关 的 函数 都 号 到 了 main.c 文件 中 ， 比 如 函数 clk_enable、led init 和 delay， 这 三 个 函数 
可 以 分 为 三 类 : 时 钟 驱动 、LED 驱动 和 延 时 驱动 。 因 此 我 们 可 以 在 bsp 文件 夹 下 创建 三 个 子 文 
件 夹 : clk、delay 和 led， 分 别 用 来 存放 时 钟 驱动 文件 、 延 时 驱动 文件 和 LED 驱动 文件 ， 这 样 
main.c 函数 就 会 清 惕 很 多 ， 程 序 功能 模块 清晰 。 工 程 文件 夹 都 创建 好 了 ， 接 下 来 就 是 编写 代码 
了 ， 其 实 就 是 将 时 钟 驱动 、LED 驱动 和 延 时 驱动 相关 的 函数 从 main.c 中 提取 出 来 做 成 一 个 独立 
的 驱动 文件 。 


13.2 硬件 原理 分 析 
本 章 使 用 到 的 硬件 资源 和 第 八 章 一 样 ， 就 是 一 个 LED0。 
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13.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光 盘 -> 1、 裸 机 例 程 -> 5 ledc bsp. 
使 用 VScode 新 建 工 程 ， 工 程 名 字 为 “ledc_bsp”。 











13.3.1 创建 imx6ul.h 文件 


新 建文 件 imx6ul.h， 然 后 保存 到 文件 夹 imx6ul 中 ， 在 imx6ul.h 中 输入 如 下 内 容 : 
示例 代码 13.3.1.1 imx6ul.h 文件 代码 














1 #ifndef IMX6UL H 

2 #define IMX6UL H 

3 J[ KCRCKCKCk kk kk ckCkCkCk kk kk ckckckckckckckckckckck ckck ckck ck ck ckckckck ck ck ckck ck k ck ck ckck ck ck ckck ck ck ckck ck k ck ck kk 
4 Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
5 文件 名 : imx6ul.h 

6 Tr : 左 忠 凯 

7 版 本 J 

8 描述 : ES EET FIBOSESCIE, 

o 其 他 EE 

10). MESES : www.openedv.com 

ir BS : WIR v1.0 2019/1/3 左 忠 凯 创建 

QC ck KC ko kk koe Kk eK KC eR KK ke KK e KK R KC ke KK d KK R KK RR KORG RIO / 
Te el Were ow 

14 #include "MCIMX6Y2.h" 

15 finclude "fsl common.h" 

16 finclude "fsl iomuxc.h" 

107 

18 £endif 





文件 imx6ul.h 很 简单 ， 就 是 引用 了 一 些 头 文件 ， 以 后 我 们 就 可 以 在 其 他 文件 中 需要 引用 
imx6ul.h 就 可 以 了 。 








13.3.2 编写 led 驱动 代码 


新 建 bsp_led.h 和 bsp_led.c 两 个 文件 , 将 这 两 个 文件 存放 到 bsp/led H, 在 bsp_led.h 中 输入 
输入 如 下 内 容 : 





示例 代码 13.3.2.1 bsp_led.h 文件 代码 
fifndef X BSP LED H 
#define BSP LED H 











eeS "nest c Io 


Jf[ FOKCKCKCKCkCKCkCk kCkCk kCkCk kk kCKCkCk KCkCk kCkCK kk Ck kCkCk kCkck kCk Ck k kc k Ck kc k ck kck Ck kck ck kck ck ckckck ko ko 





文件 名 : bsp led.h 

fedt : 左 忠 凯 

版 本 g Ws 

描述 : LED IRAD xf. 
0 其 他 3 JE 





il 
2 
3 
4 
SOME (9) vabteyzlarexo essit (Ol n. Titels. ke SO ns eer ok 
6 
D 
8 
9 
il 
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RULES : www.openedv.com 

12 Hs : 初版 V1.0 2019/1/4 左 忠 凯 创建 

ds 大 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 类 火炎 火炎 火炎 大 火炎 大 大 火炎 类 大 火炎 火炎 火炎 大大 大大 类 大 类 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 类/ 
14 

15 4define LEDO O0 

16 


17 /* HUERPIH] */ 
le voici decl imirt (voLch p 
19 voici led swircch(iat led, init Status) p 
20 #endif 
bsp led.h 的 内 容 很 简单 ， 就 是 一 些 函数 声明 ， 在 bsp_led.c 中 输入 如 下 内 容 : 
示例 代码 13.3.2.2 bsp. led.c 文件 代码 
finclude "bsp led.h" 





J[ KCKCKCKCKCKCkCk kCkCk kCkCk kCkCk kCKCkCk kk kCkCK kCkCkCkCkCkck ck k ck k kk k kc k Ck kc k Ck k kc k kck k k kc k kckck ck kok 


BaoeyoeTtoic oOo zoneonokr a Ol o MON v ufo DENM Ee EPOD Eo E; V D S a Wo ou Ma es or 











il 

2 

3 

4 文件 名 : bsp: Leche 

D TEES : ABL 

6 版 本 : V1.0 

7 描述 : LED 驱动 文件 。 

8 其 他 2 JE 

9 论坛 : Wwww.openedv.com 

TORE : 初版 V1.0 2019/1/4 左 忠 凯 创建 

a 大 类 大 大 大 类 大 大 大火 大 大 大火 大 大大 类 大 类 大火 大 类 大 类 大 类 类 类 大 类 类 类 大 类 大 类 大 类 大 大 大 类 大 类 大 类 大 类 大 大 类 类 大 大 大 类 大 大 大 大 大 / 
12 

Boy 

14 * @description : 初始 化 LED 对 应 的 GPIO 

15 * Qparam ES 

16 * Qreturn NES 

Jy se 

18 void led init (void) 

Ef 

20 /* 1、 初 始 化 IO 复 用 */ 

21 IOMUXC SetPinMux(IOMUXC GPIO1 IO03 GPIOl 1003,0); 
25 

23 /* 2. . Ki GP1O1 1003 Ij 10 Jf */ 

24 IOMUXC SetPinConfig(IOMUXC GPIO1 IO03 GPIO1 I0O03,0X10B0); 
25 

26 /* 3、 初 始 化 GPIO, GPIO1 1003 设置 为 输出 */ 
27 GPIOT-»GDIR |= (1 << 3); 

28 

29 /* 4, WE GPIOl 1003 输出 低 电 平 ， 打 开 LEDO*/ 
30 GPIO1->DR &= ~(1 << 3); 

ST] 
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32 

3r o 

34 * Qdescription : LED 控制 函数 ， 控 制 LED 打开 还 是 关闭 
35 * (param - led : 要 控制 的 IED AI 285 

36 * Qparam - status : 0, XH] LEDO, 1 DF LEDO 

SUM STIS S JE 

Bo 

$9 woes lee en led, iom status) 

40 ( 

41 switch(led) 

42 { 

43 case LEDO: 

44 if(status == ON) 

45 GPIO1-»DR &= «(1««3);  /* 打开 LEDO */ 
46 else if(status == OFF) 

47 GPIO1-»DR |= (1««3); /* x&HM]LEDO */ 
48 break; 

49 ) 

50 ] 





bsp led.c 里 面 就 两 个 函数 led init 和 led switch, led init 函数 用 来 初始 化 LED 所 使 用 的 
IO, led switch 函数 是 控制 LED 灯 的 打开 和 关闭 ， 这 两 个 函数 都 很 简单 。 














13.3.3 编写 时 钟 驱 动 代码 


新 建 bsp_clk.h 和 bsp_clk.c 两 个 文件 , 将 这 两 个 文件 存放 到 bsp/clk H, 在 bsp. clkh 中 输入 
输入 如 下 内 容 : 





示例 代码 13.3.3.1 bsp_clk.h 文件 代码 

















Iifnder _ BSP CIE H 

2 #define BSP CLK H 

3 DKkokok KCKCk Ok koK KK kk odo K KK KK ok A KICK ok KC KCKCK KOC ok A KK KO ko koK KK KK 
Zt Copyeighe © zucznonclar Coo, bech 11999—209. ALL sextae: Teservech 
5 IOMA 5 bap Cl 

G MESE : 左 忠 凯 

7 版 本 S Wil) 

8 描述 : 系统 时 钟 驱动 头 文件 。 

9 其 他 iB 

ROSE : www.openedv.com 

3. f] als : 初版 V1.0 2019/1/4 左 忠 凯 创建 

TES KCKCKCKCkCKCk kCkCk k kk k kk Ck kCk Ck k kk k kc k k kk Ck k Ck Ck kCkCk k kk k kc k Ck kc k Ck kck ck kck ck ckck ck ckckck kk e kk f 
1L$ 

14 #include "imxóul.nh" 

115 


16 /* 函数 声明 */ 
17 void elk enable (void); 
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18 
19 £4endif 
bsp clk.h 很 简单 ， 在 bsp clk.c 中 输入 内 容 : 
示例 代码 13.3.3.2 bsp. clk.c 文件 代码 
include "bsp alk 





J[ KCKCKCKCk kk kk kk kk kk kk kk ck kk ckckckck ckck ckck ckck ck ck ckckckckckck ck ck ckck ck ck ckck ck ck ckck ck ck ck ck ck ck ck ck kc 
Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 se 

作者 : 左 忠 凯 

版 本 E Wübs 

描述 : 系统 时 钟 驱动 。 

其 他 3 JE 

Ve : www.openedv.com 


nis : 初版 V1.0 2019/1/4 左 忠 凯 创建 


KCKCKCKCkCkCkCk Ck k Ck k Ck k Ck k k Ck k Ck kCk kCk kCkCkCk kCkCkCk kCkCk Ck k kCk Ck k Ck k Ck k Ck k ck k ck k ckck kckckok kok ok kx k f 


COSME I YE CES I CG EU ISO TEILS 


«o 





/ * 

* (description : 使 能 工 .MX6U 所 有 外 设 时 钟 
* Qparam 2 3 
* Qreturn 3 JE 
z 

void Elk enable (void) 


{ 


[| 
SO 0 os 


CCM-»CCGRO OXFFFFEFFFF; 
CCM->CCGRI = OÜXFEEEEFEEE; 
CCM-2CCGR2 = ÜXFFFFFFEFF; 
CCM--CCGRS = OÜXEEEEEEEE; 
CCM=>CCGR4 = OXFFEFFFEFFE; 
CCM=>CCGR5 = OXFFFFFFFF; 
CCM-2CCGR6 - ÜXFFFFFFFFE; 


NONU YTE N OT 
s cy OE 








28 } 
bsp clk.c 只 有 一 个 clk_enable 函数 ， 用 来 使 能 所 有 的 外 设 时 钟 。 


13.3.4 编写 延 时 驱动 代码 


新 建 bsp_delay.h 和 bsp_delay.c 两 个 文件 , 将 这 两 个 文件 存放 到 bsp/delay F, 在 bsp. delay.h 
中 输入 输入 如 下 内 容 : 
示例 代码 13.3.4.1 bsp_delay.h 文件 代码 
#ifndef BSP DELAY H 
#define BSP DELAY H 


Jf[ FCKCKCKCKCKCKCkCk kk kCkCk kk KC KCkCk KOC KC kCkCK kk Ck KCkCk kCkCk kCk CK Ck kc k Ck kc k ck kc kc k kck ck kckckckckck kc ko 











Copyeiighit (9). zoneoneorkre Cok, Mede oe 2/0119) VILI oes eer ee 
文件 名 : bsp delay.h 


OU ESL RN ES 
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S : ABL 

7 版 本 g VEI 

8 描述 5 REBISLOCÓE. 





9 其 他 8 3E 
10 itx : www.openedv.com 
Tl os : 初版 V1.0 2019/1/4 左 忠 凯 创建 


11522 KCKCKCKCKCKCk kCkCk k kk k kk Ck kCk Ck k kk k kc k k kc k Ck kCkCk kCk Ck k kc k k kk Ck kc k ck kck ck kck ck ckck ck ckck ck kk e kx kx f 


LS ne nS DULL c Te 


15 /* RAH */ 


16 void delay(volatile unsigned int n); 





18 #endif 


在 bsp delay.c 中 输入 内 容 : 
T PIRA 13.3.42 bsp. delay.c XARA 


J[ FCKCKCKCKCKCKCkCK Kk Ck Ck kk Ck KCkCk kk kCkCk Ck k Ck Ck k Ck ck k k Ck k k Ck kkk k k Ck k k ck ck k ck ck k ck kck kkk kkk 





Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 a bsp Celay © 
作者 : 左 忠 凯 


版 本 g wAE 50 

描述 : SERIE, 

其 他 3 JÈ 

论坛 : www.openedv.com 


志 : 初版 V1.0 2019/1/4 左 忠 凯 创 建 


类 大火 类 类 大 火炎 类 大 火炎 大 大 炎炎 大 大 类 类 类 大 类 类 类 类 类 大 大 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 大 大 类 大 类 大 类 大 类 大 类 大 大 大 大 大 大 大 类/ 


1 #include "bsp delay.h" 





2 

I fs 

4  * Qdescription : 短 时 间 延 时 函数 

5  * @param - n : 要 延 时 循环 次 数 ( 空 操作 循环 次 数 ， 模 式 延 时 ) 
6  * Qreturn 3 XB 

7. *f 

8 void delay short(volatile unsigned int n) 
PEE 

10 while (n--)() 

11 ) 

102 

d$. o/e 

14 * Qdescription : 延 时 函数 ,在 396Mhz 的 主 频 下 
I5 延 时 时 间 大 约 为 Ims 

16 * Qparam - n : 要 延 时 的 ms 数 

17 * QGreturn 3 JE 

de 3 
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19 void delay(volatile unsigned int n) 
20 ( 
2m while (n--) 
92 { 
23 leew Glaesex (05x T c» g 
24 } 
25m} 
bsp delay.c 里 面 就 两 个 函数 ，delay_short 和 delay, 这 两 个 其 实 就 是 第 十 二 章 中 main.c 里 面 
的 函数 。 








13.3.5 修改 main.c 文件 


在 第 十 二 章 中 ，led 驱动 、 延 时 驱动 和 时 钟 驱动 相关 的 函数 全 部 都 号 到 了 main.c 中 ， 本 章 
我 们 在 前 几 节 已 经 将 这 些 驱 动 根据 功能 模块 放置 到 相应 的 地 方 , 所 以 main.c 里 面 的 内 容 就 得 修 
改 ， 将 main.c 里 面 的 内 容 改 为 如 下 所 示 代 码 : 

示例 代码 13.3.5.1 main.c 文件 代码 


/玉米 大火 火炎 类 类 大火 大火 火炎 类 大 大 类 类 类 类 类 大 大 类 类 大 大 大 类 大 大 大 类 大 大 大大 大 类 大 类 大 大 大 类 大 类 大 大 大 类 大 类 大 类 大 大 大 类 大 大 























Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 ne 




















作者 : ABL 
版 本 VIEO 

D : I.MX6U 开发 板 裸 机 实验 5 BSP 形式 的 LED 驱动 
其 他 : 本 实验 学 习 目 的 : 





1、 将 各 个 不 同 的 文件 进行 分 类 ， 学 习 如 何 整理 工程 、 就 和 学 习 STM32 一 样 创建 工程 
的 各 个 文件 夹 分 类 ， 实 现 工 程 文件 的 分 类 化 和 模块 化 ， 便 于 管理 。 
2、 深 入 学 习 Makefile， 学 习 Makefile 的 高 级 技巧 ， 学 习 编写 通用 Makefile。 
论坛 : www.openedv.com 


Ba : JI vi.o 2019/1/4 证 忠 凯 创建 


KCKCKCKCKCkCkCkCk k kk k kk Ck kk Ck kCkCk k kk k kCk Ck k Ck Ck kCk Ck k kk k kc k Ck kc k Ck kck ck kck ck ckck ck ckckck kk k kx f 











1 finclude "bsp clk.h" 
finclude "bsp delay.h" 
finclude "bsp led.h" 


* Qdescription : mian 函数 
* Qparam S JE 

* Qreturn s JE 

5 

10 int main(void) 

Tl 

12 clk enable(); /* 使 能 所 有 的 时 钟 */ 
IS led init(); /* 初始 化 lea = 
14 

站 5 while(!) 


2 
3 
4 
SE dos 
6 
7 
8 
9 
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16 { 

ilu /* $TJF LEDO */ 

iig led switch (LEDO,ON); 
19 delay (500); 

20 

21 /* 关闭 LEDO */ 

22 led switch (LEDO,OFF); 
2 delay (500); 

24 } 

25 

26 return 0; 

2 








在 main.c 中 我 们 仅仅 留 下 了 main 函数 , 至 此 , 本 例 程 跟 程序 相关 的 内 容 就 全 部 编写 好 了 。 
13.4 编译 下 载 验证 


13.4.1 编写 Makefile 和 链接 脚本 


在 工程 根 目录 下 新 建 Makefile 和 imx6ul.lds 这 两 个 文件 , 创建 完成 以 后 的 工程 如 图 13.4.1.1 
Br: 























: $ ls -a 
imx6ul.lds ledc bsp.code-workspace Makefile 





si 
图 13.41 最 终 的 工程 目录 
在 文件 Makefile 中 输入 如 下 所 示 内 容 : 
示例 代码 13.4.1.1 Makefile 文件 代码 






































1 -CROSS-COMPTHLEE 2o arm-linux-gnueabuhf- 

2 TARGET ?2 bsp 

3 

a EG := S$(CROSS COMPILE)gcc 

S iD :2 o (CROSS COMPILE) LG 

6 OBJCOPY := $(CROSS COMPILE)objcopy 
7 OBJDUMP := $ (CROSS COMPILE)objdump 
8 

9  INCDIRS := imx6ul \ 

10 bsp/clk V 

dil bsp/led WV 

12 bsp/delay 

13 

IME (D NNENS) 8e Project Y 

i5 bsp/clk N 

16 bsp/led WV 

dL bsp/delay 

18 

19 INCLUDE :- $(patsubst $, -I $, $(INCDIRS)) 
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20 

21 SETLES 一 
22 CPEILIS ser mee che. S (SRCDIRS) (laa (ane 
25 

24 SFILENDIR se È (mordir S SEITE) ) 

2 EDDA SINIT SG sex gone 8 (STIS) ) 

26 

DUNS EIS S S (patsuúubst =; ODI, S(SEILENDIR: D) 

28 COBJS =E (ls SO 55 1$ (CDCIEIISNDIURS 559) ) 
ZONES Bes (SOBy (COBISS) 

30 

31 VPATH a= (RED 

E 

BS PHONY Ere m 

34 

S5 (TARCE NF OIT: S (OBS) 

36 CQ m GUEST 全 人 

2:7) S ((OENCIOES/) -QO lo:mesy -65 (em eli 

38 $ (OBJDUMP) -D -m arm $ (TARGET) .elf > $ (TARGET) .dis 

E 

4 S(SOBUJS) & Goes & $$ 

41 (CC) -Waell -nostdiib =e =02 S (INCLUDE) =0 $8 $< 

42 

A E (COBJS) 8 ooj3/959 9 SoC 

44 $(CC) -Wall -nostdlib =e -02 (INCLUDE) -o $8 $« 

45 

46 clean: 


72: en EE SMA ed ES IUAERGBÜIUGHI SmSNUEAERGEBUIE Imo 6COBUS)NmSNSOBJUS) 

可 以 看 出 本 章 实验 的 Makefile 文件 要 比 前 面 的 实验 复杂 很 多 ， 因 为 “示例 代码 13.4.1.1” 中 
的 Makefile 代码 是 一 个 通用 Makefile， 我 们 以 后 所 有 的 裸 机 例 程 都 使 用 这 个 Makefile。 使 用 时 
候 只 要 将 所 需要 编译 的 源 文件 所 在 的 目录 添加 到 Makefile 中 即 可 ,我 们 接 下 来 详细 分 析 一 下 “ 示 
例 代 码 13.4.1.1” 中 的 Makefile 源码 : 

第 1~7 行 定 义 了 一 些 变量 ， 除 了 第 2 行 以 外 其 它 的 都 是 跟 编译 器 有 关 的 ， 如 果 使 用 其 它 编 
译 器 的 话 只 需要 修改 第 1 行 即 可 。 第 2 行 的 变量 TARGET. 目标 名 字 , 不 同 的 例 程 肯定 名 字 不 一 
一 样 。 

第 9 行 的 变量 INCDIRS 包含 整个 工程 的 .h 头 文件 目录 ， 文 件 中 的 所 有 头 文件 目录 都 要 添 
加 到 变量 INCDIRS 中 .比如 本 例 程 中 包含 .h 头 文件 的 目录 有 imx6ul.bsp/clk. bsp/delay fI bsp/led, 
所 以 就 需要 在 变量 INCDIRS 中 添加 这 些 目录 ， 即 : 

INCDIRS := imx6ul bsp/clk bsp/led bsp/delay 

仔细 观察 的 话 会 发 现 第 9~11 行 后 面 都 会 有 一 个 符号 “\”， 这 个 相当 于 “换行 符 ” 表示 本 
行 和 下 一 行 属于 同一 行 ， 一般 一 行 写 不 下 的 时 候 就 用 符号 “\” 来 换行 。 在 后 面 的 裸 机 例 程 中 我 
们 会 根据 实际 情况 来 在 变量 INCDIRS 中 添加 头 文件 目录 。 
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第 14 行 是 变量 SRCDIRS， 和 变量 INCDIRS 一 样 ， 只 是 SRCDIRS 包含 的 是 整个 工程 的 所 
有 .c 和 .S 文件 目录 。 比 如 本 例 程 包含 有 .c 和 .S 的 目录 有 bsp/clk、bsp/delay、bsp/led 和 project, 
BJ: 

SRCDIRS := project bsp/clk bsp/led bsp/delay 

同样 的 ， 后 面 的 裸 机 例 程 中 我 们 也 要 根据 实际 情况 在 变量 SRCDIRS 中 添加 相应 的 文件 目 




















录 。 














第 19 行 的 变量 INCLUDE 是 用 到 了 函数 patsubst， 通 过 函数 patsubst 给 变量 INCDIRS 添加 
一 个 “-I” Bh 

INCLUDE :- -I imx6ul -I bsp/clk -I bsp/led -I bsp/delay 

加 “-I” 的 目的 是 因为 Makefile 语法 要 求 指明 头 文件 目录 的 时 候 需要 加 上 “-IT”。 

第 21 行 变量 SFILES 保存 工程 中 所 有 的 .s 汇编 文件 (包含 绝对 路 径 )， 变 量 SRCDIRS 已 经 
存放 了 工程 中 所 有 的 .c 和 .S 文件 ， 所 以 我 们 只 需要 从 里 面 挑 出 所 有 的 .S 汇编 文件 即 可 ， 这 里 借 
助 了 函数 foreach 和 函数 wildcard， 最 终 SFILES 如 下 : 

SFILES := project/start.S 

第 22 行 变量 CFILES 和 变量 SFILES 一 样 ， 只 是 CFILES 保存 工程 中 所 有 的 .c 文件 (包含 绝 
对 路 径 )， 最 终 CFILES 如 下 : 

CFILES = project/main.c bsp/clk/bsp clk.c bsp/led/bsp led.c bsp/delay/bsp delay.c 

第 24 和 25 行 的 变量 SFILENDIR 和 CFILENDIR 包含 所 有 的 .$ 汇编 文件 和 .c 文件 , 相 比 变 
量 SFILES 和 CFILES, SFILENDIR 和 CFILNDIR 只 是 文件 名 ， 不 包含 文件 的 绝对 路 径 。 使 用 
函数 notdir 将 SFILES 和 CFILES 中 的 路 径 去 掉 即 可 ，SFILENDIR 和 CFILENDIR 如 下 : 

SFILENDIR = start.S 

CFILENDIR - main.c bsp clk.c bsp led.c bsp delay.c 

第 27 $128 行 的 变量 SOBJS 和 COBJS 是 .S 和 .c 文件 编译 以 后 对 应 的 .o 文件 目录 ， 默 认 所 
有 的 文件 编译 出 来 的 .o 文件 和 源 文件 在 同一 个 目录 中 ， 这 里 我 们 将 所 有 的 .o 文件 都 放 到 obj X 
件 夹 下 ，SOBJS 和 COBJS 内 容 如 下 : 

SOBJS = obj/start.o 

COBJS = obj/main.o obj/bsp_clk.o obj/bsp led.o obj/bsp delay.o 

第 29 行 变量 OBJS 是 变量 SOBJS 和 COBJS 的 集合 ， 如 下 : 

OBJS = obj/start.o obj/main.o obj/bsp clk.o obj/bsp led.o obj/bsp delay.o 

编译 完成 以 后 所 有 的 .o 文件 就 全 部 存放 到 了 obj 目录 下 ， 如 图 13.4.1.1 所 示 : 



































































































































delay.o bsp Led.o main.o start.o 


图 13.4.1.1. 编译 完成 后 的 obj 文件 夹 

第 31 行 的 VPATH 是 指定 搜索 目录 的 ， 这 里 指定 的 搜索 目录 就 是 变量 SRCDIRS 所 保存 的 
目录 ， 这 样 当 编译 的 时 候 所 需 的 .S 和 .c 文件 就 会 在 SRCDIRS 中 指定 的 目录 中 查找 。 

第 34 行 指定 了 一 个 伪 目 标 clean， 伪 目标 前 面 讲解 Makefile 的 时 候 已 经 讲解 过 了 。 

第 35~47 行 就 很 熟悉 了 ， 前 几 章 都 已 经 详细 的 讲解 过 了 。 

“示例 代码 13.4.1.1” 中 的 Makefile 文件 内 容重 点 工作 是 找到 要 编译 哪些 文件 ? 编译 的 .o 
文件 存放 到 哪里 ? 使 用 到 的 编译 命令 和 前 面 实验 使 用 的 一 样 ， 其 实 Makefile 的 重点 工作 就 是 解 
决 “ 从 哪里 来 到 哪里 去 的 ”问题 ， 也 就 是 找到 要 编译 的 源 文件 、 编 译 结果 存放 到 哪里 ? 真正 的 
编译 命令 很 简洁 。 

链接 脚本 imx6ul.lds 的 内 容 和 上 一 章 一 样 ， 可 以 直接 使 用 上 一 章 的 链接 脚本 文件 。 

























































































































































































LMX6U 嵌入 式 Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


13.4.2 编译 下 载 


使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 bsp.bin 文件 
下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

./imxdownload bsp.bin /dev/sdd // 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 ， 如 果 代 码 运行 正常 的 
话 LEDO 就 会 以 500ms 的 时 间 间 隔 亮 灭 ， 实 验 现 和 象 和 上 一 章 一 样 。 





























x 
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第 十 四 章 蜂 鸣 器 试验 





前 几 童 试验 中 的 驱动 LED 灯亮 灭 属 于 GPIO 的 输出 控制 , 本 章 再 巩固 一 下 IMX6U 的 GPIO 
输出 控制 ， 在 LMX6U-ALPHA 开发 板 上 有 一 个 有 源 蜂 鸣 器 ， 通 过 IO 输出 高 低 电 平 即 可 控制 蜂 
鸣 器 的 开关 ， 本 质 上 也 属于 GPIO 的 输出 控制 。 
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14.2 有 源 蜂 鸣 器 简介 


蜂 鸣 器 常用 于 计算 机 、 打 印 机 、 报 警 器 、 电 子 玩具 等 电子 产品 中 ， 常 用 的 蜂 鸣 器 有 两 种 ; 
有 源 蜂 鸣 器 和 无 源 蜂 鸣 器 ， 这 里 的 有 “ 源 ” 不 是 电源 ， 而 是 震荡 源 ， 有 源 蜂 鸣 器 内 部 带 有 震荡 
源 ， 所 以 有 源 蜂 鸣 器 只 要 通电 就 会 叫 。 无 源 蜂 鸣 器 内 部 不 带 震 荡 源 ， 直 接 用 直流 电 是 驱动 不 起 
来 的 , 需要 2K-5K 的 方 波 去 驱动 。LMX6U-ALPHA 开发 板 使 用 的 是 有 源 蜂 鸣 器 , 因此 只 要 给 其 
供电 就 会 工作 ，I.MX6U-ALPHA 开发 板 所 使 用 的 有 源 蜂 鸣 器 如 图 14.2.1 所 示 ; 















































































































































图 14.2.1 有 源 蜂 鸣 器 

有 源 蜂 鸣 器 只 要 通电 就 会 叫 ， 所 以 我 们 可 以 做 一 个 供电 电路 ， 这 个 供电 电路 可 以 由 一 个 IO 
来 控制 其 通 断 ， 一 般 使 用 三 极 管 来 搭建 这 个 电路 。 为 什么 我 们 不 能 像 控制 LED 灯 一 样 ， 直 接 将 
GPIO 接 到 蜂 鸣 器 的 负极 ， 通 过 IO 输出 高 低 来 控制 蜂 鸣 器 的 通 断 。 因 为 蜂 鸣 器 工作 的 电流 比 
LED 灯 要 大 ， 直 接 将 蜂 鸣 器 接 到 IMX6U 的 GPIO 上 有 可 能 会 烧毁 IO， 所 以 我 们 需要 通过 一 个 
三 极 管 来 间接 的 控制 蜂 鸣 器 的 通 断 , 相当 于 加 了 一 层 隔离 。 本 章 我 们 就 驱动 ILMX6U-ALPHA FF 
发 板 上 的 有 源 蜂 鸣 器 ， 使 其 周期 性 的 “ 滴 、 滴 、 滴 .…” 鸣 叫 。 


14.3 硬件 原理 分 析 
蜂 鸣 器 的 硬件 原理 图 如 图 14.3.1 所 示 : 
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30 L— LSNVS TAMPER] BEEP 


图 14.3.1 蜂 鸣 器 原理 图 
图 14.3.1 中 通过 一 个 PNP 型 的 三 极 管 8550 来 驱动 蜂 鸣 器 , 通过 SNVS_TAMPER1 这 个 IO 
来 控制 三 极 管 QI 的 导 通 , 当 SNVS TAMPERI 输出 低 电 平 的 时 候 Q1 导 通 , 相当 于 蜂 鸣 器 的 正 
极 连接 到 DCDC_3V3， 蜂 鸣 器 形成 一 个 通路 ， 因 此 蜂 鸣 器 会 鸣叫 。 同 理 ， 当 SNVS TAMPERI 
输出 高 电 平 的 时 候 Q2 不 导 通 ， 那 么 蜂 鸣 器 就 没有 形成 一 个 通路 ， 因 此 蜂 鸣 器 也 就 不 会 鸣叫 。 
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14.3 试验 程序 编写 
本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 6 beep. 

















新 建文 件 夹 “6_beep”， ee 的 所 有 内 容 拷贝 到 刚刚 新 建 的 “6 beep” 里 面 ， 
拷贝 完成 以 后 的 工程 如 图 13.3.1 所 示 : 


$ ls -a 























imx6ul.lds imxdownload load.imx Makefile 





图 13.3.1. 工程 文件 夹 

新 建 VSCode 工程 ， 工 程 创建 完成 以 后 在 bsp 文件 夹 下 新 建 名 为 “beep” 的 文件 夹 ， 蜂 鸣 
器 驱动 文件 都 放 到 “beep” 文 件 夹 里 面 。 

新 建 beep.h 文件 ， 保 存 到 bsp/beep 文件 夹 里 面 ， 在 beep.h 里 面 输入 如 下 内 容 : 

示例 代码 13.3.1 beep.h 文件 代码 



























































&ifndef BSP BEEP H 
&define BSP BEEP H 

















dinclude "imxó6ul.h" 


/* BN] */ 
void beep init (void); 
void beep switch(int status); 
fendif 
beep.h 很 简单 ， 就 是 函数 声明 。 新 建文 件 beep.c， 然 后 在 beep.c 里 面 输入 如 下 内 容 : 
示例 代码 13.3.2 beep.c 文件 代码 


KE 00 TOO Gs EA NN ES 






































melide "Seu OSEP Iai 


il 

2 
SEE 
4  * Qdescription : 初始 化 蜂 鸣 器 对 应 的 IO 

5 separam 8 XE 

6  * Qreturn 8 E 

gy o wj 

Sa volel besp imit (nent) 

St 

10 /* 1、 初 始 化 IO 复 用 ， 复 用 为 GPIO5 IO01 */ 
ial IOMUXC SetPinMux(IOMUXC SNVS SNVS TAMPERI GPIO5 I001,0); 








13 /* 2. . KR GP101 1003 Sj 10 TE — */ 
14 IOMUXC SetPinConfig(IOMUXC SNVS SNVS TAMPERI GPIO5 IO01,0X10B0); 





16 /* 3、 初 始 化 GPIO, GPIO5_I001 设置 为 输出 */ 
T GPIO5-»GDIR |= (1 << 1); 


19 /* 4, WE GPIOS5 IO01 输出 高 电 平 ， 关 闭 蜂 鸣 器 */ 
20 GPIO5-»DR |= (1 << 1); 
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2 

22 

2s ss 

24 * Qdescription : 蜂 鸣 器 控制 函数 ， 控 制 蜂 鸣 器 打开 还 是 关闭 
25 * @param - status : 0， 关 闭 蜂 鸣 器 ，1 打开 蜂 鸣 器 

26 * Qreturn E JE 

gu w 

28 void beep switch(int status) 

ZI 

30 if (status == ON) 

31 GPIO5-»DR &= «(1 << 1); /* 打开 蜂 鸣 器 */ 

92 else if(status == OFF) 

33 GPIO5-»DR |= (1 << 1); /* 关闭 蜂 鸣 器 */ 

} 





beep.c 文件 一 共有 两 个 函数 : beep_init 和 beep_switch， 其 中 beep init 用 来 初始 化 BEEP 所 
使 用 的 GPIO， 也 就 是 SNVS TAMPERI, 将 其 复 用 为 GPIOS IO01， 和 上 一 章 的 LED 灯 初 始 化 
函数 一 样 。beep_switch 函数 用 来 控制 BEEP 的 开关 ， 也 就 是 设置 GPIO5_IO01 的 高 低 电 平 ， 很 
简单 。 

最 后 在 main.c 函数 中 输入 如 下 所 示 内 容 : 
示例 代码 13.3.3 main.c 文件 代码 











finclude "bsp clk.h" 
finclude "bsp delay.h" 
finclude "bsp led.h" 
finclude "bsp beep.h" 


/ * 


* (description : main KÆ 


OO OY CN 


* Qparam 8. JE 
9  * Qreturn JE 

1O  */ 

aL hae meuna (o5 

12 { 

lS clk enable(); /* 使 能 所 有 的 时 钟 DA 
14 leed cima) /* 初始 化 lea = 
15 beep init(); /* 初始 化 beep af 


17 while(!) 

We qW 

19 /* 打开 IED0 和 蜂 鸣 器 */ 
20 led switch (LEDO,ON); 
2l besp switch (ON); 

22 delay (500); 
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24 /* 关闭 LEDO 和 蜂 鸣 器 */ 

25 led switch(LEDO,OFF); 

26 beep switch(OFF); 

2 delay(500); 

28 ] 

29 

30 return 0; 

Se) 





main.c 中 只 有 一 个 main 函数 ,main 函数 先 使 能 所 有 的 外 设 时 钟 ,然后 初始 化 LED 和 BEEP。 
RAE while(1) 循 环 中 周期 性 的 开关 LED 灯 和 蜂 鸣 器 ， 周 期 大 约 为 500ms，main.c 的 内 容 也 比 
较 简单 。 


14.4 编译 下 载 验 证 
14.4.1 编写 Makefile 和 链接 脚本 


Makefile 使 用 第 十 三 章 编写 的 通用 Makefile, 修改 变量 TARGET 为 beep, 在 变量 INCDIRS 
和 SRCDIRS 中 追加 “bsp/beep” 修改 完成 以 后 如 下 所 示 : 
示例 代码 13.4.1.1 Makefile 文件 代码 















































1 CROSS COMPILE ?- arm-linux-gnueabihf- 
2 TARGET ?= beep 

3 

4 /* REMEE... Sy 

5 

6. INCDIRS :25 imx6ul N 

7 bsp/clk \ 

8 bsp/led WV 

9 bsp/delay \ 
10 bsp/beep 

al 

12 SRCDIRS ses project X 
ilS) bsp/clk N 

14 bsp/led WV 

15 bsp/delay \ 
16 bsp/beep 

dE gi 

18 /* AAR EI... =y 

19 

20 clean: 

2i em ~ri È (TARGET) li S (TARGET -Cie $ (TARGHE) Jolm $ (COBJS) (OEY 


第 2 行 修改 目标 的 名 称 为 “beep ”。 

第 10 行 在 变量 INCDIRS 中 添加 蜂 鸣 器 驱动 头 文件 路 径 ， 也 就 是 文件 beep.h 的 路 径 。 

第 16 行 在 变量 SRCDIRS 中 添加 蜂 鸣 器 驱动 文件 路 劲 ， 也 就 是 文件 beep.c 的 路 径 。 
链接 脚本 就 使 用 第 十 三 章 试验 中 的 链接 脚本 文件 imx6ul.lds 即 可 。 
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14.4.2 编译 下 载 
使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 beep.bin X 























件 下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload // 给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

./imxdownload beep.bin /dev/sdd / 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 。 如 果 代 码 运行 正常 的 
话 LED 灯亮 的 时 候 蜂 鸣 器 鸣叫 ， 当 LED 灯 灭 的 时 候 蜂 鸣 器 不 鸣叫 ， 周 期 大 概 为 500ms。 通 过 
本 章 的 例 程 , 我 们 进一步 巩固 了 I.MX6U 的 IO 输出 控制 ， 下 一 章 我 们 学 习 如 何 实现 IMX6U 的 
IO 输入 控制 。 
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第 十 五 章 按键 输入 试验 





前 面 几 童 试验 都 是 讲解 如 何 使 用 IMX6U 的 GPIO 输出 控制 功能 ，I.MX6U 的 IO 不 仅 能 作 
为 输出 ， 而 且 也 可 以 作为 输入 。LMX6U-ALPHA 开发 板 上 有 一 个 按键 ， 按 键 连接 了 一 个 IO, 将 
这 个 IO 配置 为 输入 功能 ， 读 取 这 个 IO 的 值 即 可 获取 按键 的 状态 ( 按 下 或 松 开 )。 本 章 通过 这 个 
按键 来 控制 蜂 鸣 器 的 开关 ， 通 过 本 章 的 学 习 你 将 掌握 如 何 将 LMX6UL 的 IO 作为 输入 来 使 用 。 
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15.1 按键 输入 简介 
按键 就 两 个 状态 : 按 下 或 弹 起 ， 将 按键 连接 到 一 个 IO 上 ， 通 过 读 取 这 个 IO 的 值 就 知道 按 



























































键 是 按 下 的 还 是 弹 起 的 。 至 于 按键 按 下 的 时 候 是 高 电 平 还 是 低 电 平 要 根据 实际 电路 来 判断 。 前 
面 几 章 我 们 都 是 讲解 LIMX6U 的 GPIO 作为 输出 使 用 ， 当 GPIO 连接 按键 的 时 候 就 要 做 为 输入 
使 用 。 关 于 LMX6U 的 GPIO 已 经 在 第 八 章 详细 的 讲解 了 ， 本 章 我 们 的 主要 工作 就 是 配置 按键 
所 连接 的 IO 为 输入 功能 ， 然 后 读 取 这 个 IO 的 值 来 判断 按键 是 否 按 下 。 

LMX6U-ALPHA 开发 板 上 有 一 个 按键 KEY0， 本 章 我 们 将 会 编写 代码 通过 这 个 KEY0 按键 
来 控制 开发 板 上 的 蜂 鸣 器 ， 按 一 下 KEYO 蜂 鸣 器 打开 ， 再 按 一 下 蜂 鸣 器 就 关闭 。 


15.2. 硬件 原理 分 析 


本 试验 我 们 用 到 的 硬件 有 : 

1) LED X] LEDO. 

2) 蜂 鸣 器 。 

3) 1 个 按键 KEY0。 

按键 KEY0 的 原理 图 如 图 15.2.1 所 示 : 





































































































图 15.2.1 按键 原理 图 

从 图 15.2.1 可 以 看 出 ， 按 键 KEYO 是 连接 到 I.MX6U 的 UART1 CTS 这 个 IO 上 的 ，KEY0 
接 了 一 个 10K 的 上 拉 电 阻 ， 因 此 KEY0 没有 按 下 的 时 候 UART1_CTS 应 该 是 高 电 平 ， 当 KEY0 
按 下 以 后 UART1_CTS 就 是 低 电 平 。 

















15.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 7 key. 

本 试验 在 上 一 章 试验 例 程 的 基础 上 完成 ， 重 新 创建 VSCode 工程 ， 工 作 区 名 字 为 “key”， 
在 工程 目录 的 bsp 文件 夹 中 创建 名 为 “key” 和 “gpio” 两 个 文件 夹 。 按 键 相 关 的 驱动 文件 都 放 
到 “key” 文 件 夹 中 ， 本 章 试 验 我 们 对 GPIO 的 操作 编写 一 个 函数 集合 ， 也 就 是 编写 一 个 GPIO 
驱动 文件 ，GPIO 的 驱动 文件 放 到 “gpio” 文 件 夹 里 面 。 

新 建 bsp_gpio.c 和 bsp_gpio.h 这 两 个 文件 ， 将 这 两 个 文件 都 保存 到 刚刚 创建 的 bsp/gpio 文 
件 夹 里 面 ， 然 后 在 bsp_gpio.h 文件 夹 里 面 输 入 如 下 内 容 : 
示例 代码 15.3.1 bsp_gpio.h 文件 代码 
1 #ifndef BSP GPIO H 
2 #define BSP GPIO H 
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$define BSP KEY H 





maine Luce — "rimesso c Mad 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 


S /汪汪 业 大 火炎 类 大 火炎 类 大 类 类 类 大 类 类 类 大 类 类 大 大 类 类 类 炎炎 大 类 大 类 类 类 大 大大 大 大 大大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 





文件 名 8 bso Goro im 
作者 : IER 
9 版 本 3 Wi 
10 描述 : GPIO BRÉESCIESE CE, 
11 其 他 
12 wins : www.openedv.com 
1S EIR : 初版 V1.0 2019/1/4 左 忠 凯 创建 





14 KCKCKCKCKCk KC kk kk kCk Ck k Ck kCk k kc k kc k Ck Ck Ck Ck kCkCkCkCk Ck Ck Ck k kCk k Ck Ck k ck k ck Ck ck k ck ck ckck ckck kok kok X ke x k f 


16 /* 枚 举 类 型 和 结构 体 定 义 */ 
17 typedef enum _gpio pin direction 


Ten 

19 kGPIO DigitalInput = OU, J> GIN 
20 kGPIO DigitalOutput = 1U, /* 输出 */ 
2l p goio pin direction p 

22 


23 /* GPIO 配置 结构 体 */ 
24 typedef struct gpio pin config 


user 

26 gpio pin direction t direction; /* GPIO 方向 :输入 还 是 输出 i 
2 uint8 t outputLogic; /* 如 果 是 输出 的 话 ， 默 认输 出 电 平 */ 
25 ] goio pin contig tp 

29 

20 


31 /* HUERRIH] */ 
32 Vald ggio anaibE((GIPIO Type Hbase, int pin, goio pin Contig (t veoniig)) p 
35; lmt golo pinreec (GLITO Typs isse, im PLN) p 
S4 Valid Guo: pinwrite(GPLIO Type base, inte pin, 1nE value)? 
25 
36 #endif 

bsp gpio.h 中 定义 了 一 个 枚 举 类 型 gpio pin direction t 和 结构 体 gpio pin config t， 枚 举 类 
7] epio pin direction t 表示 GPIO 方向 ,输入 或 输出 。 结 构 体 gpio pin config t 是 GPIO 的 配置 
结构 体 ， 里 面 有 GPIO 的 方向 和 默认 输出 电 平 两 个 成 员 变量 。 在 bsp gpio.c 中 输入 如 下 所 示 内 


dae 


Ti: 


























示例 代码 15.3.2 bsp. gpio.c 文件 代码 
*include "bsp gpio.h" 
/汪汪 类 大 火炎 火炎 火炎 类 大 火炎 类 大 火炎 火炎 火炎 类 大 类 类 类 类 类 大 类 大 类 类 类 大 类 大 类 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 


Caovilioms © Zz00znaender Co Lae. 9358 2019 ll 10nNse Teervee. 
文件 名 s Sp Goroh 


I 
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DI : 左 忠 凯 

6 版 本 a VL 

7 描述 pro 

8 其 他 20 

9 论坛 : www.openedv.com 

10 Hs : 初版 V1.0 2019/1/4 左 忠 凯 创建 

| KCKCKCKCkCKCk kCkCk kCkCk k kk Ck kCk Ck k kk k kc k k kc k Ck k Ck Ck kCkCk k kc k k kk Ck kc k Ck kck ck kck ck ckck ck ckck ck kk e k kx f 
12 

I y= 

14 * Qdescription : GPIO 初始 化 。 

15 * Qparam - base  : 要 初始 化 的 GPIO 组 。 

16 * Qparam - pin : 要 初始 化 cero 在 组 内 的 编号 。 

17 * Q8param - config : GPIO 配置 结构 体 。 

18 * return s JE 

DO 2 


20 void exo init(GPIO Type base, int pin, geio pin Contig ib Veo ig) 
20 


22 if(config-»2direction = kGPIO DigitalInput) /* 输入 */ 
23 { 

24 base->GDIR &= ~( 1 << pin); 

25 } 

26 else /* SH */ 
2 ( 

28 base-»GDIR |= 1 << pin; 

29 goio pinwrite(base,pin, config-»outputLogic);/* 默认 输出 电 平 */ 
30 } 

St 

22 

Se As 


34 * Qdescription : 读 取 指定 GPIO 的 电 平 值 。 
35  * Qparam - base : ZH cero. 


36 * QGparam - pin  : 要 读 取 的 GPIO 脚 号 。 

37  * Qreturn 8 Jb 

DONE] 

39) ime Glo pilnreaci (CPTO Type base, imt pim) 
40 ( 

41 return (((base->DR) >> pin) & 0x1); 

42 ) 

43 

44 7/* 


[o 
UI 
* 


Gdescription : 指定 GPIO 输出 高 或 者 低 电 平 。 
46  * @param - base : 要 输出 的 的 GPIO 组 。 
47 * (param - pin : 要 输出 的 GPIO 脚 号 。 
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48  * eparam - value : 要 输出 的 电 平 ，1 输出 高 电 平 ， 0 输出 低 低 电 平 





论坛 :www.opendev.com 


51. void gopio pinwreite(GPIO Type base, i pin, imot selle 


49  * @return 8 JE 
S wy 

S2 

53 if (value == 0U) 

54 { 

55 base->DR &= ~(1 
56 ) 

5 else 

58 { 

59 base->DR |= (1U 
60 } 

61 ) 





U << pin); /* "idm */ 


<< pin); /* 输出 高 电 平 */ 


文件 bsp gpio.c 中 有 三 个 函数 : gpio init, gpio pinread 和 gpio pinwrite, PAX gpio init 用 














于 初始 化 指定 的 GPIO 引 脚 ， 最 终 配 置 的 是 GDIR 寄存 器 ， 此 函数 有 三 个 参数 ， 这 三 个 参数 的 


含义 如 下 : 














base: 要 初始 化 的 GPIO 所 属于 的 GPIO 组 ， 比 如 GPIO1 IO18 就 属于 GPIO1 组 。 

pin: 要 初始 化 GPIO 在 组 内 的 标号 ， 比 如 GPIO1 1018 在 组 内 的 编号 就 是 18。 

config: 要 初始 化 的 GPIO 配置 结构 体 ， 用 来 指定 GPIO 配置 为 输出 还 是 输入 。 

函数 gpio_pinread 是 读 取 指定 的 GPIO 值 , 也 就 是 读 取 DR 寄存 器 的 指定 位 ， 此 函数 有 两 个 
参数 和 一 个 返回 值 ， 参 数 含义 如 下 : 














base: 要 读 取 的 GPIO 所 属于 























的 GPIO 组 ， 比 如 GPIO1 IO18 就 





属于 GPIOI 组 。 








pin: 要 读 取 的 GPIO 在 组 内 的 标号 ， 比 如 GPIO1 1018 在 组 内 的 编号 就 是 18。 





返回 值 : 读 取 到 的 GPIO 值 ， 


为 0 或 者 1。 











函数 gpio_pinwrite 是 控制 指定 的 GPIO 引 脚 输入 高 电 平 (1) 或 者 低 电 平 (0)， 就 是 设置 DR 寄 
存 器 的 指定 位 ， 此 函数 有 三 个 参数 ， 参 数 含 义 如 下 : 





base: 要 设置 的 GPIO 所 属于 


的 GPIO 组 ， 比 如 GPIO1 IO18 就 





属于 GPIOI 组 。 


pin: 要 设置 的 GPIO 在 组 内 的 标号 ， 比 如 GPIO1 IO18 在 组 内 的 编号 就 是 18。 
value: 要 设置 的 值 ，1( 高 电 平 ) 或 者 0( 低 电 平 )。 
我 们 以 后 就 可 以 使 用 函数 gpio_init 设置 指定 GPIO 为 输入 还 是 输出 , 使 用 函数 gpio_pinread 
和 gpio_pinwrite 来 读 写 指定 的 GPIO， 文 件 bsp_gpio.c 文件 就 讲解 到 这 里 。 
接 下 来 编写 按键 驱动 文件 ， 新 建 bsp_key.c 和 bsp key.h 这 两 个 文件 ， 将 这 两 个 文件 都 保存 
， 然 后 在 bsp_key.h 文件 夹 里 面 输入 如 下 内 容 : 
示例 代码 15.3.3 bsp_key.h 文件 代码 















































到 刚刚 创建 的 bsp/key 文件 夹 里 面 











1 4ifndef BSP KEY H 

2 4define BSP KEY M 

3 ime lude "imxóul.h" 

4 

5 Copyright © zuozhongkai 
6 文件 名 se 

7 E : 左 忠 凯 

8 版 本 UO 























(or Hech JL999—201.9)5 JUL 
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9 描述 : 按键 驱动 头 文件 。 

10 其 他 SE 

II KE : www.openedv.com 

l2] ds : 初版 V1.0 2019/1/4 左 忠 凯 创建 

ds KCKCKCKCkCKCk kCkCk k kc k k kk Ck kCkCk k kk k kc k k kc k Ck k Ck Ck kCkCk k kc k k kk Ck kc k ck kck ck kck ck ckck ck ckckck kk kk f 
14 

15 /* 定义 按键 值 */ 

16 enum keyvalue( 

157 KEY NONE  - 0, 

18 KEYO VALUE, 

MYE 

20 

21 /* Riera] =/ 

22 void key init (void); 

25, int key gyeutwelwe(weoie 

24 

25 tendif 





bsp key.h 文件 中 定义 了 一 个 枚 举 类 型 : keyvalue， 此 枚 举 类 型 表示 按键 值 ， 因 为 LMX6U- 








ALPHA 开发 板 上 只 有 一 个 按键 ， 因 此 枚 举 类 型 里 面 只 到 KEYO VALUE. 1E bsp key.c 中 输入 
如 下 所 示 内 容 : 


CO SH Cn 


N N SBS FEEPE PP FEF Fp CO 
v ES OP oOo OD ONS 








示例 代码 15.3.4 bsp_key.c 文件 代码 
#include "bsp key.h" 
#include "bsp gpio.h" 
#include "bsp delay.h" 
/汪汪 业 大 火炎 火炎 火炎 火炎 火炎 类 大 类 类 类 大 炎炎 类 大 类 类 类 类 大大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 
Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 a bp key C 
作者 : 左 忠 凯 
版 本 a WIESO 
描述 : 按键 驱动 文件 。 
其 他 ES 
论坛 : www.openedv.com 


日 志 : 初版 V1.0 2019/1/4 左 忠 凯 创 建 


KCKCKCKCKCKCkCkCkck k kk kCk Ck Ck kCk Ck kk k k kk k kc k Ck k Ck Ck kCk k k kc k k kk k kc k ck kck ck kck ck ckck ck ckckck kk kk f 


/* 
* (description : 初始 化 按键 
* Qparam S JE 
* Qreturn 8 JE 
s 
void key init(void) 
( 
gopio pin contig © key Contig 
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25 

24 /* 1. Wj$845 io SH, SH7JGPIOL 1018 */ 

25 IOMUXC SetPinMux(IOMUXC UART1 CTS B GPIO1 IO18, 0); 
26 

2 /* 2. . MÆ UARTI CTS B 的 I0 属 性 

28 *bit 16:0 HYS 关闭 

29 "bit [15:14]: 11 SAU 22K.EdY 

30 *bit [13]: 1 pull 动能 

S *bit [12]: 1 pull/keeper 使 能 

32 *bit [11]: 0 关闭 开路 输出 

35 *bit [7:6]: 10 速度 100Mhz 

34 *bit [5:3]: 000 Barth 

35 *bit [0]: O 低 转换 率 

36 i 

37 IOMUXC SetPinConfig(IOMUXC UART1 CTS B GPIO1 IO18, OxF080); 
38 

39 /* 3、 初 始 化 GPIO GPIO1 IO18 设置 为 输入 */ 

40 key config.direction = kGPIO DigitalInput; 

41 gpio init(GPIO1,18, &key config); 

42 

43 } 

44 

A y7 

46 * @description : 获取 按键 值 

47 * Qparam 8 JE 

48 * @return : 0 没有 按键 按 下 ， 其 他 值 :对 应 的 按键 值 

49 */ 

50 int key getvalue (void) 

XE 

52 int ret = 0; 

ES static unsigned char release = 1;  /* fRSERAJT */ 

54 

55 if((release--i)&&(gpio pinread(GPIO1, 18) == 0)) /* KEYO ER */ 
56 { 

57 delay (10); /* ERAP  — */ 

58 release 2 0; /* 标记 按键 按 下 */ 

59 if(gpio pinread(GPIO1, 18) == 0) 

60 ret — KEYO VALUE; 

61 } 

62 else if(gpio pinread(GPIO1, 18) == 1) /* KEYO 未 按 下 */ 
(3 { 

64 ret = 0; 

65 release = 1; /* 标记 按键 释放 */ 
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66 ) 

67 

68 return ret; 

69 I 











bsp key.c 中 一 共有 两 个 函数 : key. init 和 key. getvalue, key init 是 按键 初始 化 函数 ， 用 来 
初始 化 按键 所 使 用 的 UARTI CTS 这 个 IO. PER key init 先 设置 UARTI CTS 复 用 为 
GPIO1 IO18， 然 后 配置 UART1_CTS 这 个 IO 为 速度 为 100MHz， 默 认 22K 上 拉 。 最 后 调用 函 
数 gpio_init 来 设置 GPIO1 IO18 为 输入 功能 。 

函数 key getvalue 用 于 获取 按键 值 ， 此 函数 没有 参数 ， 只 有 一 个 返回 值 ， 返 回 值 表 示 按 键 
值 ， 返 回 值 为 0 的 话 就 表示 没有 按键 按 下 ， 如 果 返 回 其 他 值 的 话 就 表示 对 应 的 按键 按 下 了 。 获 
取 按 键 值 其 实 就 是 不 断 的 读 取 GPIO1_IO18 的 值 ， 如 果 按 键 按 下 的 话 相应 的 IO 被 拉 低 ， 那 么 
GPIOI IOI8 值 就 为 0， 如果 按 键 未 按 下 的 话 GPIO1 1018 的 值 就 为 1。 此 函数 中 静态 局 部 变量 
release 表示 按键 是 否 释放 。 

“示例 代码 15.3.4” PHI 57 行 是 按键 消 抖 延 时 函数 ， 延 时 时 间 大 约 为 10ms， 用 于 消除 按 
键 抖动 。 理 想 型 的 按键 电压 变化 过 程 如 图 15.3.1 所 示 : 

按键 按 下 































































































图 15.3.1 理想 的 按键 电压 变化 过 程 
在 图 15.3.1 中 ， 按 键 没 有 按 下 的 时 候 按键 值 为 1， 当 按键 在 tl 时 刻 按键 被 按 下 以 后 按键 值 
就 变 为 0， 这 是 最 理想 的 状态 。 但 是 实际 的 按键 是 机 械 结 构 ， 加 上 刚 按 下 去 的 一 瞬间 人 手 可 能 
也 有 抖动 ， 实 际 的 按键 电压 变化 过 程 如 图 15.3.2 所 示 : 
BREST 稳定 






























































图 15.3.2 实际 的 按键 电压 变化 过 程 
在 图 15.3.2 中 t1 时 刻 按 键 被 按 下 ， 但 是 由 于 抖动 的 原因 ， 直 到 ( 时 刻 才 稳 定 下 来 ，tl 到 
2 这 段 时 间 就 是 抖动 。 一 般 这 段 时 间 就 是 十 几 ms 左右 ， 从 图 15.3.2 中 可 以 看 出 在 拌 动 期 间 会 
有 多 次 触发 ， 如 果 不 消 除 这 段 抖动 的 话 软 件 就 会 误 判 ， 本 来 按键 就 按 下 了 一 次 ， 结 果 软 件 读 取 
IO 值 发 现 电 平 多 次 跳 变 以 为 按 下 了 多 次 。 所 以 我 们 需要 跳 过 这 段 抖动 时 间 再 去 读 取 按 键 的 IO 
值 ， 也 就 是 至 少 要 在 t2 时 刻 以 后 再 去 读 IO 值 。 在 “示例 代码 15.3.4” 中 的 57 行 是 延 时 了 大 约 
10ms 后 再 去 读 取 GPIO1 IO18 的 IO 值 ， 如 果 此 时 按键 的 值 依 旧 是 0， 那 么 就 表示 这 是 一 次 有 
效 的 按键 触发 。 
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按键 驱动 就 讲解 到 这 里 ， 最 后 就 是 main.c 文件 的 内 容 了 ， 在 main.c 中 输入 如 下 代码 : 
示例 代码 15.3.5 main.c 文件 代码 


/玉米 业 炎 火炎 类 火炎 类 大 类 大 炎炎 类 类 炎炎 类 大 类 大 大 大 类 大 大 大 类 大 大 类 类 大 大 大大 大 大 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大大 大 类 大 大 





Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 


文件 名 8 mian.c 
作者 : 左 忠 凯 
版 本 RE 
描述 : I.MX6U 开发 板 裸 机 实验 7 按键 输入 实验 
其 他 : 本 实验 主要 学 习 如 何 配置 .MX6U 的 GPIO 作为 输入 来 使 用 ， 通 过 
开发 板 上 的 按键 控制 蜂 鸣 器 的 开关 。 
论坛 : www.openedv.com 
is : 初版 V1.0 2019/1/4 左 忠 凯 创建 


KOKCKCKCKCkCkCkCk k kk k kc k Ck kc kCk k kk k kc k k kc k Ck k Ck Ck kCkCk k kc k k kc k Ck kc k Ck kck ck kck ck ckck ck ckckck kk e k kx f 


1 finclude "bsp clk.h" 


2 #include "bsp delay.h" 

3 include "bsp led.h" 

4 #include "bsp beep.h" 

5 4include "bsp key.h" 

6 

3L. gs 

8 X * Qdescription : main 函数 

9 * (param e Jb 

10 * Qreturn 3 JE 

ibd cx 

12 int main(void) 

T3 f 

14 int i2 0; 

Jis; int keyvalue = 0; 

16 tWasigaed! Char led etate = ON 

E) unsigned char besp state = OFF; 

18 

19 clk enable(); /* 使 能 所 有 的 时 钟 */ 
20 led init()? /* 初始 化 led wy 
21 beep init(); /* 初始 化 beep */ 
2 key init(); /* 初始 化 key 
2 

24 while(!) 

25 { 

26 keyvalue = key getvalue(); 

27 if(keyvalue) 

28 { 

289) switch (keyvalue) 

20 { 
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E case KEYO VALUE: 











32 besp state = !beep state; 
99 beep switch(beep state); 
34 break; 
85 } 
36 } 
EN ah 
38 if (i==50) 
39 { 
40 aL Eb E 
41 led stata = lled state, 
42 lel switch (LEDO, lee! suse); 
43 } 
44 delay (10); 
45 } 
46 return 0; 
am 
main.c 函数 先 初始 化 led 灯 、 蜂 鸣 器 和 按键 ， 然 后 在 while(1) 循 环 中 不 断 的 调用 函数 
key getvalue 来 读 取 按 键 值 ， 如 果 KEY0 按 下 的 话 就 打开 /关闭 蜂 鸣 器 。LED0 作为 系统 提示 指 
示 灯 闪烁 ， 闪 烁 周期 大 约 为 500ms。 本 章 例 程 的 软件 编写 就 到 这 里 结束 了 ， 接 下 来 就 是 编译 下 
载 验 证 了 。 


15.4 编译 下 载 验 证 
15.4.1 编写 Makefile 和 链接 脚本 


Makefile 使 用 第 十 三 章 编写 的 通用 Makefile, 修改 变量 TARGET 为 beep, 在 变量 INCDIRS 
和 SRCDIRS 中 追加 “bsp/beep” 修改 完成 以 后 如 下 所 示 : 
示例 代码 15.4.1.1 Makefile 文件 代码 
















































































T CROSS COMETS 2o arm-linux-gnueabuhf- 
2 TARGET ?= key 

E 

4  /* 省 略 掉 其 它 代码 ...... */ 

5 

GNCDIRS ga Som Ñ 

qj bsp/clk \ 

8 bsp/led \ 

9 bsp/delay \ 
10 bsp/beep V 
Tl bsp/gpio NN 
12 bsp/key 

1S; 

14 SRCDIRS se jgqexeyect AN 
1.5 bsp/clk y 
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16 bsp/led WV 

ey bsp/delay \ 

18 bsp/beep V 

19 bsp/gpio 

20 bsp/key 

zl 

22 /* EAEI. =. */ 

209) 

24 clean: 


25 rm -rf S(TARGET).elf S(TARGET).dis S(TARGET).bin S$(COBJS) S$(SOBJS) 
第 2 行 修改 变量 TARGET X "key", 也 就 是 目标 名 称 为 “key”。 
第 11、12 行 在 变量 INCDIRS 中 添加 GPIO 和 按键 驱动 头 文件 (.b 路 径 。 
第 19、20 行 在 变量 SRCDIRS 中 添加 GPIO 和 按键 驱动 文件 (.c) 路 径 。 

链接 脚本 就 使 用 第 十 三 章 试验 中 的 链接 脚本 文件 imx6ul.lds 即 可 。 


























15.4.2 编译 下 载 


使 用 Make 命令 编译 代码 ,编译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 key.bin 文件 
下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

Jimxdownload key.bin /dev/sdd // 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 。 如 果 代 码 运行 正常 的 
话 LED0 会 以 大 约 500ms 周期 闪烁 ， 按 下 开发 板 上 的 KEYO 按键 ， 蜂 鸣 器 打开 ， 再 按 下 KEY0 
按键 ， 蜂 鸣 器 关闭 。 
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第 十 六 章 主 频 和 时 钟 配置 实验 


在 前 几 章 实验 中 我 们 都 没有 涉及 到 ILMX6U 的 时 钟 和 主 频 配置 操作 , 全 部 使 用 的 默认 配置 























默认 配置 下 I.MX6U 工作 频率 为 396MHz。 但 是 LMX6U 系列 标准 的 工作 频率 为 528MHz,， 有 i 
型 号 甚至 可 以 工作 到 696MHz. 本 章 我 们 就 学 习 IMX6U 的 时 钟 系统 , 学 习 如 何 配置 LIMX6U 的 
系统 时 钟 和 其 他 的 外 设 时 钟 ， 使 其 工作 频率 为 528MHz， 其 他 的 外 设 时 钟 源 都 工作 在 NXP 推荐 
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16.1 LMX6U 时 钟 系统 详解 


LMX6U 的 系统 主 频 为 528MHz， 有 些 型 号 可 以 跑 到 696MHz， 但 是 默认 情况 下 内 部 boot 
rom 会 将 ILMX6U 的 主 频 设置 为 396MHz, 这 个 我 们 在 9.2 小 节 已 经 讲 过 了 。 我 们 在 使 用 LMX6U 
的 时 候 肯定 是 要 发 挥 它 的 最 大 性 能 ， 那 么 主 频 肯 定 要 设置 到 528MHz( 其 它 型 号 可 以 设置 更 高 ， 
比如 696MHz)， 其 它 的 外 设 时 钟 也 要 设置 到 NXP 推荐 的 值 。LMX6U 的 系统 时 钟 在 
《I.MX6ULL/I.MX6UL 参考 手册 》 的 第 10 Æ “Chapter 10 Clock and Power Management” 和 第 
18 Æ “Chapter 18 Clock Controller Module (CCM)” 这 两 章 有 详细 的 讲解 。 









































16.1.1 系统 时 钟 来 源 
打开 IMX6U-ALPHA 开发 板 原理 图 ， 开 发 板 时 钟 原 理 图 如 图 16.1.1.1 所 示 : 


Xmig TXTAD 
一 


C2| 118pF 
| li u| RTC. XTALI 


GND | i" Ul 


3 pL. c RTC XTALO 
32.768KHz 


1| GND HOT 
| HOT GND 


















GND'|| 











图 16.1.1.1 开发 板 时 钟 原理 图 

从 图 16.1.1.1 可 以 看 出 LIMX6U-ALPHA 开发 板 的 系统 时 钟 来 源 于 两 部 分 : 32.768KHz 和 
24MHz 的 晶振 ， 其 中 32.768KHz 晶振 是 LMX6U 的 RTC 时 钟 源 ，24MHz 晶振 是 LMX6U PE 
和 其 它 外 设 的 时 钟 源 ， 也 是 我 们 重点 要 分 析 的 。 

















16.1.27 路 PLL 时 钟 源 


LMX6U 的 外 设 有 很 多 ， 不 同 的 外 设 时 钟 源 不 同 ，NXP 将 这 些 外 设 的 时 钟 源 进行 了 分 组 ， 
一 个 有 7 组 , 这 7 组 时 钟 源 都 是 从 24MHz 晶振 PLL 而 来 的 , 因此 也 叫做 7 组 PLL, 3x 7 ZH PLL 
结构 如 图 16.1.1.2 所 示 : 
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m armpll bypass sel[1:0] 
OSC24M © armpll bypass 





armpll enable 


ARM PLL ES H ) ref armpll ck _ p 
CLK1 (In) | J- 
I 528píd3 "cl 


P855  5o8pfd3 enable 
CLK2 (In) n 


| esaeptaa. cl ee 


528pfd2 bypass  5?28pfd3 enable 


* ) ref 528pfd2 clk 

















































































































*—1528PFD2 " T 
2 
main «d 528pfd3 enable 
$ f 528pfd1_clk 
= ) ref 528pfd1 s 
$—|528PFD1 
528pfdO ied 528pfd0 enable 
f 52 lk 
* ) ref 528pfdO0 c »- 
528pll bypass |sel[1:0] $—[528PFD0 | — 
L Q | 580pll enable 
528 PLL ) ref 528pll clk » 
pem 
480pfd3_bypass 480pfd3_enable 
j ) ref 480pfd3 clk p 
480PFD3 ~~ 
kicia m 480pfd2_enable 
l j ) ref 480pfd2 clk, 





| | 一 


480pfd1_enabl 
480pfd1_byHass PAR 
ref 480pfd1 clk »- 





] 
i 
: 


480pfd0. enable 











ref 480pfdO clk p 


i 




























480pll. bypass sel[1:0] ii — jo 
n (8) 480pli bypass ^ 480pll enable 
USB1 PLL ) ref 480pll ck |. 











@ | usb2 enable 


P 
USB2 PLL 


enetpll bypass| sel[1:0] 








in 
























































TE: enetpll enable | emiz 
4H Ee 
D 100 MH 
Its [—*-| ENETPLL ref enetpll cl(500 MHz), | Div enet oM 
| 一 » fi 
25/50/100/125 MH 
vidplL bypdss| Sel[1:0] [FoU anos ME 
(€ e vidpll enable 
ERN 
P 一 个 VIDEO PLL ref vidpll clk Div1/2/4/816 
M | 一 ) > EL ————» 
—" me (g)  8udplibypass audpll enable 
4H [7*7 AUDIO PLL x re audpllcik ||  Divi/2/4 
| = 














16.1.2.1 初级 PLLs 时 钟 源 生成 图 
16.1.2.1 展示 了 7 个 PLL 的 关系 ， 我 们 依次 来 看 一 下 这 7 个 PLL 都 是 什么 做 什么 的 : 
(D. ARM PLL (PLL1)， 此 路 PLL 是 供 ARM 内 核 使 用 的 ， ARM 内 核 时 钟 就 是 由 此 PLL 
生成 的 ， 此 PLL 通过 编程 的 方式 最 高 可 倍 频 到 1.3GHz。 
@、528 PLLOPLL2)， 此 路 PLL 也 叫做 System PLL， 此 路 PLL 是 固定 的 22 倍 频 ， 不 可 编 
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Buo KE, JE PLL 时 钟 =24MHz * 22 = 528MHz， 这 也 是 为 什么 此 PLL 叫做 528. PLL 的 
因 。 此 PLL 分 出 了 4 路 PFD， 分 别 为 : PLL2 PFD0~PLL2 PFD, 这 4 路 PFD 41528 PLL 共 
同 作 为 其 它 很 多 外 设 的 根 时 钟 源 。 通 常 528 PLL 和 这 4 路 PFD 是 IMX6U 内 部 系统 总 线 的 时 
钟 源 ， 比 如 内 处 理 逻 辑 单 元 、DDR 接口 、NAND/NOR 接口 等 等 。 











cB 
3m ui 




















(3. USBI PLL(PLL3), jki% PLL 主要 用 于 USBPHY, Jt PLL 也 有 四 路 PFD, X: 
PLL3 PFDO-PLL3 PFD3,USBI PLL 是 固定 的 20 倍 频 , 因 此 USB1_PLL=24MHz *20-480MHz. 
USBI PLL 虽然 主要 用 于 USB1PHY, 但 是 其 和 四 路 PFD 同样 也 可 以 作为 其 他 外 设 的 根 时 钟 源 。 

@@、USB2 PLLOPLL7， 没 有 写 错 ! 就 是 PLL7， 虽 然 序号 标 为 4， 但 是 实际 是 PLL7)， 看 名 
字 就 知道 此 路 PLL 是 给 USB2PHY 使 用 的 .同样 的 , 此 路 PLL 固定 为 20 倍 频 , 因 此 也 是 480MHz。 

©, ENET PLL(PLL6), 此 路 PLL 固定 为 20+5/6 倍 频 ， 因 此 ENET. PLL-24MHz * (20+5/6) 
= 500MHz。 此 路 PLL 用 于 生成 网 络 所 需 的 时 钟 ,可 以 在 此 PLL 的 基础 上 生成 25/50/100/125MHz 
的 网 络 时 钟 。 

@@、VIDEO_PLL(PLL5), 此 路 PLL 用 于 显示 相关 的 外 设 ， 比 如 LCD， 此 路 PLL 的 倍 频 可 以 
调整 ，PLL 的 输出 范围 在 650MHz~1300MHz。 此 路 PLL 在 最 终 输出 的 时 候 还 可 以 进行 分 频 ， 
可 选 1/2/4/8 分 频 。 

GD、AUDIO_PLLCOLL4), 此 路 PLL 用 于 音频 相关 的 外 设 ， 此 路 PLL 的 倍 频 可 以 调整 ，PLL 
的 输出 范围 同样 也 是 650MHz~1300MHz， 此 路 PLL 在 最 终 输 出 的 时 候 也 可 以 进行 分 频 ， 可 选 
1/2/4 分 频 。 























































































































16.1.3 时 钟 树 简介 


在 上 一 小 节 讲解 了 7 路 PLL, LMX6U 的 所 有 外 设 时 钟 源 都 是 从 这 7 路 PLL 和 有 些 PLL 的 
PFD 而 来 的 ， 这 些 外 设 究竟 是 如 何 选 择 PLL 或 者 PFD 的 ?这 个 就 要 借助 《TIMX6ULL 参考 手 
册 》 里 面 的 时 钟 树 了 , 在 “Chapter 18 Clock Controller Module (CCMD ”的 18.3 小 节 给 出 了 IMX6U 
详细 的 时 钟 树 图 ， 如 图 16.1.3.1 所 示 : 
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CLOCK SWITCHER， CLOCK ROOT GENERATOR eine 


| CACRR[ARM PODF] 


ARM CLK ROOTI 
PLL1 clock source goes to ARM Domain and returns to CCM 172] = = i ARM 
ARM domain divider 


— CBCDRIPERIPH2 CLK SEL] ! 
CBCDRI[FABRIC_MMDC_POD 
MMDC_CLK Foor arm 


FABRIC_CLK_ROOT, Wee 
1 
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图 16.1.3.1 LMX6U 时 钟 树 
在 图 16.1.3.1 中 一 共有 三 部 分 : CLOCK SWITCHER 、CLOCK ROOT GENERATOR 和 
SYSTEM CLOCKS 。 其 中 左边 的 CLOCK SWITCHER 就 是 我 们 上 一 小 节 讲 解 的 那 7 路 PLL 和 
8 路 PFD, 右边 的 SYSTEM CLOCKS 就 是 芯片 外 设 ， 中 间 的 CLOCK ROOT GENERATOR 是 最 
复杂 的 ! 这 一 部 分 就 像 * 月 老 一样， 给 左边 的 CLOCK SWITCHER 和 右边 的 SYSTEM CLOCKS 
































进行 牵线 搭桥 。 外 设 时 钟 源 是 有 多 路 可 以 选择 的 ，CLOCK ROOT GENERATOR 就 负责 从 7 路 
PLL 和 8 路 PFD 中 选择 合适 的 时 钟 源 给 外 设 使 用 。 具 体操 作 肯 定 是 设置 相应 的 寄存 器 , 我们 以 
ESAI 这 个 外 设 为 例 ，ESAI 的 时 钟 图 如 图 16.1.3.2 所 示 : 






























1 
ESAI CLK ROOT! 
ESAI 


CS1CDR[ESAI CLK PODF] I 


图 16.1.3.2 ESAI 时 钟 
在 图 16.1.3.2 中 我 们 分 为 了 3 部 分 ， 这 三 部 分 如 下 : 

QD、 此 部 分 是 时 钟 源 选择 器 ，ESAI 有 4 个 可 选 的 时 钟 源 : PLL4、PLL5、PLL3_PFD2 和 
pll3 sw ck。 具体 选择 哪 一 路 作为 ESAI 的 时 钟 源 是 由 寄存 器 CCM->CSCMR2 的 
ESAI CLK SEL 位 来 决定 的 ， 用 户 可 以 自由 配置 ， 配 置 如 图 16.1.3.3 所 示 : 

20-19 Selector for the ESAI clock 


ESAI CLK SEL 
00 derive clock from PLL4 divided clock 


01 derive clock from PLL3 PFD2 clock 
10 derive clock from PLLS clock 
11 derive clock from pll3 sw clk 












































图 16.1.3.3 寄存 器 CSCMR2 ff] ESAI CLK SEL 位 

包 、 此 部 分 是 ESAI 时 钟 的 前 级 分 频 , 分 频 值 由 寄存 器 CCM, CSICDR 的 ESAL CLK. PRED 
来 确定 的 ， 可 设置 1-8 分 频 ， 假 如 现在 PLL4=650MHz， 我 们 选择 PLLA 作为 ESAI 时 钟 ， 前 级 
分 频 选 择 2 分 频 ， 那 么 此 时 的 时 钟 就 是 650/2=325MHz。 

曙 、 此 部 分 又 是 一 个 分 频 器 ， 对 外 中 输出 的 时 钟 ; 分 频 ， 分 频 值 由 寄存 器 
CCM CSICDR 的 ESAI CLK PODF 来 决定 ， 可 设置 1~8 分 频 。 假 如 我 们 设置 为 8 分 频 的 话 ， 
经 过 此 分 频 器 以 后 的 时 钟 就 是 325/8=40.625MHz。 因 此 最 终 进 入 到 ESAI 外 设 的 时 钟 就 是 
40.625MHz. 

上 面 我 们 以 外 设 ESAI 为 例 讲 解 了 如 何 根据 图 16.1.3.1 来 设置 外 设 的 时 钟 频率 ， 其 他 的 外 
设 基本 类 似 的 ， 大 家 可 以 自行 分 析 一 下 其 他 的 外 设 。 关 于 外 设 时 钟 配置 相关 内 容 全 部 都 在 

《I.MX6ULL 参考 手册 》 的 第 18 章 。 
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16.1.4. 内 核 时 钟 设置 


LMX6U 的 时 钟 系统 前 面 几 节 已 经 分 析 的 差不多 了 ， 现 在 就 可 以 开始 设置 相应 的 时 钟 频 率 
了 。 先 从 主 频 开始 , 我 们 将 ILMX6U 的 主 频 设置 为 528MHz, 根据 图 16.1.3.2 的 时 钟 树 可 以 看 到 
ARM 内 核 时 钟 如 图 16.1.4.1 所 示 : 



































@ 1 
-一 一 一 -一 I A 7 和 9 anu 
图 16.1.4.1 ARM 内 核 时 钟 树 


" CACRR[ARM_PODF] 
Q 








在 图 16.1.4.1 中 各 部 分 如 下 : 
Q@、 内 核 时 钟 源 来 自 于 PLL1， 假 如 此 时 PLL1 为 996MHz。 
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@、 通 过 寄存 器 CCM_CACRR 的 ARM_PODF 位 对 PLLI 进行 分 频 , 可 选择 1/2/4/8 分 频 ， 
假如 我 们 选择 2 分 频 ， 那 么 经 过 分 频 以 后 的 时 钟 频率 是 996/2=498MHz。 

()、 大 家 不 要 被 此 处 的 2 分 频 给 骗 了 ， 此 处 没有 进行 2 分 频 (我 就 被 这 个 2 分 频 骗 了 好 久 ， 
主 频 一 直 配 置 不 正确 ! )。 

D, ATEOS 2 分 频 以 后 的 498MHz 就 是 ARM 的 内 核 时 钟 ， 也 就 是 IMX6U 的 主 频 。 











经 过 上 面 几 步 的 分 析 可 知 ， 假 如 我 们 要 设置 内 核 主 频 为 528MHz， 那 么 PLL1 可 以 设置 为 
1056MHz, 寄存 器 CCM CACRR 的 ARM PODF 位 设置 为 2 分 频 即 可 。 同 理 ， 如 果 要 将 主 频 设 
置 为 696MHz, Ji, PLLI 就 可 以 设置 为 696MHz, CCM CACRR 的 ARM PODF 设置 为 1 分 
频 即 可 。 现 在 问题 很 清晰 了 ， 寄 存 器 CCM CACCR 的 ARM PODF 位 很 好 设置 ，PLL1 的 频率 
可 以 通过 寄存 器 CCM ANALOG PLL ARMn 来 设置 。 接 下 来 详细 的 看 一 下 CCM_CACRR 和 
CCM _ ANALOG PLL ARMn 这 两 个 寄存 器 ，CCM_CACRR 寄存 器 结构 如 图 16.1.4.2 所 示 : 


Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16|15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


R 0 ARM_ 
W PODF 


Rst0.0.00000000000000j0000000000000000 


[Fed | pe ooo 


31-3 This read-only field is reserved and always has the value 0. 
Reserved 


ARM PODF |Divider for ARM clock root. 

























































NOTE: If arm freq shift divider is set to '1' then any new write to arm podf will be held until 
arm clk switch req signal is asserted. 


NOTE: arm podf should be >= 3 if fuse bit CPU SPEED LIMIT is set. 


O00 divide by 1 
001 divide by 2 
010 divide by 3 
011 divide by 4 
100 divide by 5 
101 divide by 6 
110 divide by 7 
111 divide by 8 








16.1.4.2 寄存 器 CCM CACRR 
寄存 器 CCM CACRR 只 有 ARM PODF 位 ， 可 以 设置 为 0~7， 分别 对 应 1-8 分 频 。 如 果 要 
设置 为 2 分 频 的 话 CCM_CACCR 就 要 设置 为 1。 再 来 看 一 下 寄存 器 CCM ANALOG PLL ARMn, 
此 寄存 器 结构 如 图 16.1.4.3 所 示 : 
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18 17 16 


E 
e 


Bit 31 30 29 28 27 26 25 24 | 23 22 21 20 





PLL SEL 

















Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 
Bit 15 14 13 12 6 4 3 2 1 0 
zZ 
i BYPASS d Š 
- [rs] a 
CLK. SRC E: m DIV SELECT 
w 出 z 
o 
n. 
Reset 0 0 1 1 1 1 0 0 0 1 1 





CCM ANALOG PLL ARWMn field descriptions 


Rar Bes 














31 1 - PLL is currently locked. 
COE 0 - PLL is not currently locked. 
30-20 Always set to zero (0). 

19 Reserved 

PLL_SEL 
18-17 This field is reserved. 
- Reserved 
16 Bypass the PLL. 
BYPASS 
15-14 
BYPASS_CLK_ |Determines the bypass source. 
SRC 


NOTE: Changing the Bypass clock source also changes the PLL reference clock source. 


0x0 REF_CLK_24M — Select the 24MHz oscillator as source. 
0x1 CLK1 — Select the CLK1_N / CLK1_P as source. 

Ox2 Reserved — 

Ox3 Reserved — 





13 Enable the clock output. 
ENABLE 
12 Powers down the PLL. 
POWERDOWN 
11-7 This field is reserved. 
- Reserved. 














DIV SELECT  |This field controls the PLL loop divider. Valid range for divider value: 54-108. Fout = Fin * div select/2.0. 





16.1.4.3 寄存 器 CCM ANALOG PLL ARMn 

在 寄存 器 CCM. ANALOG PLL ARMn 中 重要 的 位 如 下 : 

ENABLE: 时 钟 输出 使 能 位 , 此 位 设置 为 1 使 能 PLLI 输出 ,如 果 设 置 为 0 的 话 就 关闭 PLLI 
输出 。 

DIV SELECT: 此 位 设置 PLL1 的 输出 频率 ， 可 设置 范围 为 : 54-108, PLLI CLK = Fin * 
div_seclec/2.0，Fin=24MHz。 如 果 PLLI 要 输出 1056MHz 的 话 ，div_select 就 要 设置 为 88。 
在 修改 PLL1 时 钟 频率 的 时 候 我 们 需要 先 将 内 核 时 钟 源 改 为 其 他 的 时 钟 源 , PLL1 可 选择 的 
时 钟 源 如 图 16.1.4.4 所 示 : 











397 


LMX6U AR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 







24MHz PLL1 pll1 main clk 
OSC plt_sw_ck (1) 


GLITCHLESS MUX 








step_clk 


osc clk 


PFD2: 400M 


secondary clk 






PFD3: 200M 





PFDO: 352M 








PFD1: 594M 


pll2 main clk 






BEI 
(528M) 






图 16.1.4.4 PLLI 时 钟 开关 
QD. plll sw clIk 也 就 是 PLL1 的 最 终 输出 频率 。 
@@、 此 处 是 一 个 选择 器 ， 选 择 plll sw_clk 的 时 钟 源 ， 由 寄存 器 CCM CCSR 的 

















PLLI SW CLK SEL 位 决定 plll sw clk 是 选择 plll main clk 还 是 step_clk。 正 常情 况 下 应 该 
选择 pl] main clk， 但 是 如 果 要 对 plll main clk(PLLD 的 频率 进行 调整 的 话 ， 比 如 我 们 要 设置 





PLL1=1056MHz， 此 时 就 要 先 将 plll_sw_clk 切换 到 step_clk E. 7T plll_main clk 调整 完成 以 
在 切换 回来 。 

















pes 
H 





@)、 此 处 也 是 一 个 选择 器 , 选择 step clk 的 时 钟 源 , 由 寄存 器 CCM CCSR 的 STEP. SEL 位 
来 决定 step clk 是 选择 osc clk 还 是 secondary _clk。 一 般 选 择 osc_clk， 也 就 是 24MHz 的 晶振 。 








这 里 我 们 就 用 到 了 一 个 寄存 器 CCM_CCSR， 此 寄存 器 结构 如 图 16.1.4.5 所 示 : 
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m 
o 





-l 
W 
N 
n. 
LLI 
E 
o 


PLL1 SW CLK SEL 


PLL3 SW CLK SEL 





o| SECONDARY CLK SEL |o 


CCM CCSR field descriptions 


| "ea |  Bespion | 




















31-9 This read-only field is reserved and always has the value 0. 
Reserved 
8 Selects the option to be chosen for the step frequency when shifting ARM frequency. This will control the 
STEP SEL step clk. 
NOTE: This mux is allowed to be changed only if its output is not used, i.e. ARM uses the output of pll1, 
and step clk is not used. 
O derive clock from osc_clk (24M) - source for lp apm. 
1 derive clock from secondary clk 
7-4 This read-only field is reserved and always has the value 0. 
Reserved 
3 Select source to generate secondary. clk 
SECONDARY . 
CLK SEL 0 PLL2 PFD2 (400 M) 
1 PLL2 (528 M) 
2 Selects source to generate pll1 sw clk. 
PLL1 SW CLK 
SEL 0 plli main clk 
1 step clk 
1 This field is reserved. 
- Reserved 
0 Selects source to generate pll3 sw clk. This bit should only be used for testing purposes. 
PLL3 SW CLK . 
SEL O pll3 main clk 
1 pll3 bypass clock 








16.1.4.5 寄存 器 CCM CCSR 结构 图 

寄存 器 CCM CCSR 我 们 只 用 到 了 STEP SEL. PLLI SW CLK SEL 这 两 个 位 ， 一 个 是 用 
来 选择 step_clk 时 钟 源 的 ， 一 个 是 用 来 选择 plll_sw_clk 时 钟 源 的 。 

到 这 里 ， 修 改 ILMX6U 主 频 的 步 又 就 很 清晰 了 ， 修 改 步骤 如 下 : 

(D. 设置 寄存 器 CCSR 的 STEP SEL 位 ， 设 置 step_clk 的 时 钟 源 为 24M 的 晶振 。 

©, HAAS CCSR 的 PLLI SW CLK SEL 位 ， 设 置 plll sw clk 的 时 钟 源 为 
step_clk=24MHz， 通 过 这 一 步 我 们 就 将 IMX6U 的 主 频 先 设置 为 24MHz， 直 接 来 自 于 外 部 的 
24M 晶振 。 

@、 设 置 寄存 器 CCM ANALOG PLL ARMn， 将 plll main clk(PLL1) 设 置 为 1056MHz. 

四 、 设 置 寄存 器 CCSR 的 PLLI SW CLK SEL 位 ， 重 新 将 plll_sw_clk 的 时 钟 源 切换 回 
plll_main_clk， 切 换 回来 以 后 的 plll_sw_clk 就 等 于 1056MHz。 

@@、 最 后 设置 寄存 器 CCM_CACRR 的 ARM PODF 为 2 分 频 ，I.MX6U 的 内 核 主 频 就 为 
1056/22528MHz. 














16.1.5 PFD 时 钟 设置 
设置 好 主 频 以 后 我 们 还 需要 设置 好 其 他 的 PLL 和 PFD 时 钟 ，PLL1 上 一 小 节 已 经 设置 了 ， 
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PLL2、PLL3 和 PLL7 固定 为 528MHz. 480MHz 和 480MHz，PLL4~PLL6 都 是 针对 特殊 外 设 
的 ， 用 到 的 时 候 再 设置 。 因 此 ， 接 下 来 重点 就 是 设置 PLL2 和 PLL3 的 各 自 4 路 PFD，NXP 推 





荐 的 这 8 路 PFD 频率 如 表 16.1.5.1 所 示 : 





论坛 :www.opendev.com 















































PLL2 PFDO 352MHz 

PLL2 PFDI 594MHz 

PLL2 PFD2 400MHz( 实 际 为 396MHz) 
PLL2 PFD3 297MHz 

PLL3 PFDO 720MHz 

PLL3 PFDI 540MHz 

PLL3 PFD2 508.2MHz 

PLL3 PFD3 454.7MHz 











图 16.1.5.1 所 示 : 





K 16.1.5.1 NXP 推荐 的 PFD 频率 
先 设置 PLL2 的 4 路 PFD 频率 ， 用 到 寄存 器 是 CCM_ANALOG PFD 528n， 寄 存 器 结构 如 



































Bit 831 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
山 山 
d 
u a uw a 
< < < < 
- | a PFD3_FRAC X | PFD2_FRAC 
9 a Oo a 
eo m a iL 
= B LE 
w| œ a 
Reset 0 0 0 1 0 0 0 0 0 0 0 1 ] 0 0 0 
Bit 15 14 13 12 11 10 9 8 7 6 4 3 2 1 0 
山 山 
| 
w |a Ejla 
R| < 区 < | < 
|o 9| 
x b PFD1 FRAC d | PFDO FRAC 
Q 9 S a 
- u o LL 
a a- a n 
L LL 
w| & a 
Reset 0 0 0 1 0 0 0 0 0 0 0 1 1 0 1 1 


图 16.1.5.1 寄存 器 CCM. ANALOG PFD 528n 结构 
从 图 16.1.51 可 以 看 出 ， 寄 存 器 CCM ANALOG PFD 528n 其 实 分 为 四 组 ， 分 别 对 应 
PFD0~PFD3， 每 组 8 个 bit， 我 们 就 以 PFD0 为 例 ， 看 一 下 如 何 设置 PLL2_PFD0 的 频率 。PFD0 





对 应 的 寄存 器 位 如 下 : 














PFD0_FRAC: PLL2 PFDO 的 分 频数 ，PLL2_PFD0 的 计算 公式 为 528*18/PFD0 FRAC, Jk 
为 可 设置 的 范围 为 12~35 。 如 果 PLL2 PFDO 的 频率 要 设置 为 352MHz 的 话 











PFD0 FRAC-528*18/352-27. 





PFD0 STABLE: 此 位 为 只 读 位 ， 可 以 通过 读 取 此 位 判断 PLL2_PFD0 是 否 稳定 。 
PFD0_CLKGATE: PLL2_PFD0 输出 使 能 位 ,为 1 的 时 候 关 闭 PLL2 PFDO 的 输出 , 为 0 的 


时 候 使 能 输出 。 








如 果 我 们 要 设置 PLL2 PFDO 的 频率 为 352MHz 的 话 就 需要 设置 PFDO FRAC 为 27, 


PFD0 CLKGATE 为 0. PLL2 PFDI-PLL2 PFD3 设置 类 似 ， 频 率 计算 公式 都 是 


528*18/PFDX FRAC(X-1-3) ， 








因 此 PLL2 PFDI-594MHz 的 话 PFDI FRAC-16 ; 





PLL2 PFD2-400MHz 的 话 PFD2 FRAC 不 能 整除 , 因此 取 最 近 的 整数 值 , 即 PFD2 FRAC-24, 
这 样 PLL2 PFD2 实际 为 396MHz; PLL2 PFD3-297MHz 的 话 ，PFD3 FRAC-32. 
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接 下 来 设置 PLL3 PFDO-PLL3 PFD3 ix 4 路 PFD 的 频率 ， 使 用 到 的 寄存 器 是 
CCM ANALOG PFD 480n， 此 寄存 器 结构 如 图 16.1.5.2 所 示 : 




































Bt 831 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
u 山 
ug ug 
< < < < 
当 | uel PFD3 FRAC X | PFD2 FRAC 
9 a Oo a 
e LL el uL 
P mm S 
w| œ & 
Reset 0 0 0 1 0 0 0 0 0 0 0 1 1 0 0 0 
Bit 15 14 13 12 11 10 9 8 7 6 4 3 2 1 0 
山 山 
-l 
w |a Ejla 
RI < < < < 
go 25 
m zi PFD1 FRAC = | PFDO FRAC 
9 Q 9 S 一 
- u o L 
a a- a n 
Lu. LL. 
w| & a 
Reset 0 0 0 1 0 0 0 0 0 0 0 1 1 0 1 1 


图 16.1.5.2 寄存 器 CCM ANALOG PFD 480n 结构 
从 图 16.1.5.2 可 以 看 出 ， 寄 存 器 CCM. ANALOG PFD 480n 和 CCM ANALOG PFD 528n 
的 结构 是 一 模 一 样 的 ， 只 是 一 个 是 PLL2 的 , 一 个 是 PLL3 的 。 寄 存 器 位 的 含义 也 是 一 样 的 ， 只 
是 频率 计算 公式 不 同 ， 比 如 PLL3 PFDX=480*18/PFDX FRAC(X-0-3) . 如 R 
PLL3 PFD0-720MHz 的 话 , PFDO FRAC-12; 如 果 PLL3 PFD1-540MHz 的 话 , PFD1 FRAC-16; 
如 果 PLL3 PFD2-508.2MHz 的 话 ，PFD2 FRAC-17; 如 果 PLL3 PFD3-454.7MHz 的 话 ， 
PFD3 FRAC-19. 





16.1.6 AHB, IPG 和 PERCLK 根 时 钟 设置 





7 路 PLL 和 8 路 PFD 设置 完成 以 后 最 后 还 需要 设置 AHB_CLK_ ROOT fll IPG CLK. ROOT 
的 时 钟 ，I.MX6U 外 设 根 时 钟 可 设置 范围 如 图 16.1.6.1 所 示 : 












































ARM_CLK_ROOT 12 528 
MMDC_CLK_ROOT 24 396 
FABRIC_CLK_ROOT 

AXI_CLK_ROOT 12 264 
AHB_CLK_ROOT 6 132 
PERCLK_CLK_ROOT 3 66 
IPG_CLK_ROOT 3 66 
USDHCn_CLK_ROOT 12 198 
ACLK_EIM_SLOW_CLK_ROOT 6 132 
SPDIFO_CLK_ROOT 1.5 66.6 
SAIn CLK ROOT 3 66.6 
LCDIF_CLK_ROOT 6 150 
SIM_CLK_ROOT 12 264 
QSPI_CLK_ROOT 12 396 
ENFC_CLK_ROOT 12 198 
CAN_CLK_ROOT 1.5 - |Bo 
ECSPI CLK ROOT 3 60 
UART_CLK_ROOT 4 |80 
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图 16.1.6.1 外 设 根 时 钟 可 设置 范围 




















图 16.1.6.1 给 出 了 大 多 数 外 设 的 根 时 钟 设 置 范围 ,AHB_CLK ROOT 最 高 可 以 设置 132MHz， 
IPG CLK ROOT 和 PERCLK_CLK_ROOT 最 高 可 以 设置 66MHz。 那 我 们 就 将 AHB_CLK_ROOT、 
IPG CLK ROOT 和 PERCLK CLK ROTO 分 别 设 置 为 132MHz 、66MHz 、 66MHz 。 
AHB CLK ROOT 和 IPG_CLK ROOT 的 涉及 如 图 16.1.6.2 所 示 : 














PLL3_sw_clk 


OSC CLK 


burn in bist 


OSC CLK 
PLL2 bypass clk 3 bit divider 
default=1 
GLITCHLESS MUX 
is 2) 

PLL2 (0) 
PFD2 3 bit divider © 
元 default=4 AHB_CLK_ROOT 


periph_clk 


3 bit divider |(4) — 
default-2 TUE 


PLL bypass en? (from jtag) 


图 16.1.6.2 总 线 时 钟 图 

图 16.1.6.2 就 是 AHB_CLK ROOT ANI IPG CLK ROOT 的 时 钟 图 ， 图 中 分 为 了 3 部 分 。 

GD、 此 选择 器 用 来 选择 pre_periph_clk 的 时 钟 源 , 可 以 选择 PLL2、PLL2 PFD2、PLL2_PFD0 
和 PLL2 PFD2/2。 寄 存 器 CCM CBCMR 的 PRE PERIPH CLK SEL 位 决定 选择 哪 一 个 ， 默 认 
选择 PLL2 PFD2， 因 此 pre periph cIk-PLL2 PFD2-396MHz. 

包 、 此 选择 器 用 来 选择 periph clk 的 时 钟 源 , 由 寄存 器 CCM_CBCDR 的 PERIPH CLK. SEL 
位 与 PLL bypass en2 组 成 的 或 来 选择 。 当 CCM_CBCDR 的 PERIPH CLK SEL 位 为 0 的 时 候 
periph clk-pr periph cIk-396MHz. 

(3), ifi: CBCDR 的 AHB PODF 位 来 设置 AHB_CLK ROOT 的 分 频 值 ， 可 以 设置 1-8 分 
频 ， 如 果 想 要 AHB_CLK_ROOT=132MHz 的 话 就 应 该 设置 为 3 分 频 : 396/3=132MHz。 图 16.1.2 
中 虽然 写 的 是 默认 4 分 频 ， 但 是 LMX6U 的 内 部 boot rom 将 其 改 为 了 3 分 频 ! 

四 .通过 CBCDR 的 IPG. PODF 位 来 设置 PG_CLK ROOT 的 分 频 值 , 可 以 设置 1-4 分 频 ， 
IPG_CLK ROOT 时 钟 源 是 AHB_CLK ROOT， 要 想 IPG_CLK_ ROOT-66MHz 的 话 就 应 该 设置 
2 分 频 : 132/2=66MHz。 

最 后 要 设置 的 就 是 PERCLK_CLK ROOT 时 钟 频 率 ， 其 时 钟 结构 图 如 图 16.1.6.3 所 示 : 

l 
















































OSC i 
PERCLK CLK ROOT, [EPIT 
12C 
CSCMR1[PERCLK_PODF] 
ADC 
WDOG 


CBCDRIIPG_PODF] IPG ELK ROUT, 
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16.1.6.3 PERCLK CLK ROOT 时 钟 结构 

从 16.1.6.3 可 以 看 出 ，PERCLK CLK ROOT 来 源 有 两 种 : OSC(24MHz) 和 
IPG CLK ROOT， 由 寄存 器 CCM CSCMRI 的 PERCLK CLK SEL 位 来 决定 ， 如 果 为 0 的 话 
PERCLK CLK ROOT 的 时 钟 源 就 是 IPG CLK ROOT-66MHz 。 可 以 通过 寄存 器 
CCM CSCMRI 的 PERCLK. PODF 位 来 设置 分 频 , 如 果 要 设置 PERCLK_CLK_ROOT 为 66MHz 
的 话 就 要 设置 为 1 分 频 。 
在 上 面 的 设置 中 用 到 了 三 个 寄存 器 : CCM_CBCDR、CCM CBCMR 和 CCM CSCMRI, 我 
们 依次 来 看 一 下 这 些 寄存 器 ， CCM CBCDR 寄存 器 结构 如 图 16.1.6.4 所 示 : 
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图 16.1.6.4 寄存 器 CCM CBCDR 结构 

寄存 器 CCM_CBCDR 各 个 位 的 含义 如 下 : 

PERIPH_CLK2_PODF: periph2 时 钟 分 频 ， 可 设置 0~7， 分 别 对 应 1~8 分 频 。 

PERIPH2 CLK SEL: 选择 peripheral2 的 主 时 钟 ， 如 果 为 0 的 话 选择 PLL2， 如 果 为 1 的 
话 选 择 periph2_clk2_clk。 修 改 此 位 会 引起 一 次 与 MMDC 的 握手 ， 所 以 修改 完成 以 后 要 等 待 握 
手 完成 ， 握 手 完成 信号 由 寄存 器 CCM_CDHIPR 中 指定 位 表示 。 

PERIPH CLK SEL: peripheral 主 时 钟 选择 ， 如 果 为 0 的 话 选择 PLL2， 如 果 为 1 的 话 选 
择 periph_clk2_clock。 修改 此 位 会 引起 一 次 与 MMDC 的 握手 ， 所 以 修改 完成 以 后 要 等 待 握手 完 
成 ， 握 手 完成 信号 由 寄存 器 CCM_CDHIPR 中 指定 位 表示 。 

AXI PODF: axi 时 钟 分 频 ， 可 设置 0~7， 分 别 对 应 1~8 分 频 。 

AHB PODF: ahb 时 钟 分 频 ， 可 设置 0~7， 分 别 对 应 1-8 分 频 。 修 改 此 位 会 引起 一 次 与 
MMDC 的 握手 ， 所 以 修改 完成 以 后 要 等 待 握 手 完成 ， 握 手 完 成 信号 由 寄存 器 CCM_CDHIPR 中 
指定 位 表示 。 

IPG_PODF: ipg 时 钟 分 频 ， 可 设置 0~3， 分 别 对 应 1~4 分 频 。 

AXI ALT CLK SEL: axi alt 时 钟 选择 ， 为 0 的 话 选择 PLL2 PFD2， 如 果 为 1 的 话 选择 
PLL2 PFDI. 

AXI CLK_SEL: axi 时 钟 源 选 择 ， 为 0 的 话 选择 periph_clk， 为 1 的 话 选 择 axi_alt 时 钟 。 

FABRIC MMDC _PODF: fabric/mmdc 时 钟 分 频 设 置 ， 可 设置 0~7， 分 别 对 应 1-8 分 频 。 

PERIPH2 CLK2 PODF: periph2 cIk2 的 时 钟 分 频 ， 可 设置 0~7， 分 别 对 应 1~8 分 频 。 

接 下 来 看 一 下 寄存 器 CCM_CBCMR， 寄 存 器 结构 如 图 16.1.6.5 所 示 : 
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PERIPH . 


CLK2 SEL 





Reset 
16.1.6.5 寄存 器 CCM CBCMR 结构 

寄存 器 CCM CBCMR 各 个 位 的 含义 如 下 : 
LCDIF1 PODF: lcdifl 的 时 钟 分 频 ， 可 设置 0~7， 分 别 对 应 1-8 分 频 。 

PRE PERIPH2 CLK SEL: pre periph2 时 钟 源 选择 , 00 选择 PLL2, 01 选择 PLL2_PFD2, 
10 选择 PLL2 PFD0，11 选择 PLL4。 

PERIPH2_CLK2_SEL: periph2_clk2 时 钟 源 选 择 为 0 的 时 候选 择 pll3_sw_clk, 为 1 的 时 候 
选择 OSC. 
PRE PERIPH CLK SEL: pre periph 时 钟 源 选择 ，00 选择 PLL2，01 选择 PLL2_PFD2, 10% 
择 PLL2 PFD0，11 选择 PLL2 PFD2/2. 

PERIPH_CLK2_SEL: peripheral_clk2 时 钟 源 选择 , 00 选择 pll3 sw clk, 01 选择 osc_clk， 
10 选择 pll2_bypass_clk。 

最 后 看 一 下 寄存 器 CCM_CSCMR1， 寄 存 器 结构 如 图 16.1.6.6 所 示 : 
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16.1.6.6 寄存 器 CCM. CSCMRI 结构 
此 寄存 器 主要 用 于 外 设 时 钟 源 的 选择 ， 比 如 QSPI1、ACLK、GPMI、BCH 等 外 设 ， 我 们 重 
点 看 一 下 下 面 另 个 未 : 
PERCLK CK SEL: perclk 时 钟 源 选择 ， 为 0 的 话 选择 ipg clk， 为 1 的 话 选择 osc clk。 
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PERCLK PODF: perc 





(D. mmdc podf 
(2. periph clk sel 
(S. periph2 clk sel 
(à. arm podf 

©, ahb podf 








Ik 的 时 钟 分 频 ， 可 设置 0~7， 分 别 对 应 1-8 分 频 。 


在 修改 如 下 时 钟 选择 器 或 者 分 频 器 的 时 候 会 引起 与 MMDC 的 握手 发 生 : 











发 生 握手 信号 以 后 需要 等 待 握 手 完成 , 寄存 器 CCM_CDHIPR 中 保存 着 握手 信号 是 否 完成 ， 
如 果 相 应 的 位 为 1 的 话 就 表示 握手 没有 完成 ， 如 果 为 0 的 话 就 表示 握手 完成 ， 很 简单 ， 这 里 就 
不 详细 的 列举 寄存 器 CCM_CDHIPR 中 的 各 个 位 了 。 






























































男 外 在 修改 arm_podf 和 ahb_podf 的 时 候 需 要 先 关 闭 其 时 钟 输出 , 等 修改 完成 以 后 再 打开 ， 








否则 的 话 可 能 会 出 现在 修改 完成 以 后 没有 时 钟 输出 的 问题 。 本 教程 需要 修改 寄存 器 
CCM CBCDR 的 AHB PODF 位 来 设置 AHB ROOT CLK 的 时 钟 , 所 以 在 修改 之 前 必须 先 关 闭 


AHB ROOT CLK 的 输出 。 

















晶 是 笔者 没有 找到 相应 的 寄存 器 ， 没 法 目前 没 法 关闭 ， 那 也 就 没 法 


设置 AHB PODF 了 。 不 过 AHB PODF 内 部 boot rom 设置 为 了 3 分 频 ， 如 果 pre periph clk 的 
时 钟 源 选择 PLL2 PFD2 的 话 ，AHB ROOT CLK 也 是 396MHz/3=132MHz。 




















至 此 ，I.MX6U 的 时 钟 系统 就 讲解 完了 ，I.MX6U 的 时 钟 系统 还 是 很 复杂 的 ， 大 家 要 结合 
《LMX6ULL 参考 手册 》 中 时 钟 相关 的 结构 图 来 学 习 。 本 章 我 们 也 只 是 讲解 了 如 何 进行 主 频 、 


PLL, PFD 和 一 些 总 线 时 钟 的 设置 ， 关 于 具体 的 外 设 时 钟 设置 我 们 在 学 习 到 的 时 候 在 详细 的 讲 


解 。 
16.2 硬件 原理 分 析 

















时 钟 原理 图 分 析 参 考 16.1.1 小 节 。 





16.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 8_clk。 
本 试验 在 上 一 章 试验 “7 key” 的 基础 上 完成 ， 因 为 本 试验 是 配置 LMX6U 的 系统 时 钟 ， 
此 我 们 直接 在 文件 “bsp_clkc” 上 做 修改 ， 修 改 bsp_clk.c 的 内 容 如 下 : 
































示例 代码 16.3.1 bsp. clk.c 文件 代码 


下 

2 

3 J[KKCKCKCKCKCkCk KCkCk kk kCKCKCkCKCkCk KCKCk CC KC KC Ck KCkCk KC k kCkCkCkCkCk Ck kCk ck k kc k k kc k kck ck ck kck kc kck k 
4 Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
5 3a e bep elke 

6 fr& : ABIL 

7 ”版 本 O 

8 ”描述 : 系统 时 钟 驱动 。 

9 ”其 他 SE 

TON I : www.openedv.com 

"ES : 初版 V1.0 2019/1/3 左 忠 凯 创建 

1,2 

13 M2 2019/1/3 左 忠 凯 修 改 

14 添加 了 函数 imx6u_clkinit () ， 完 成 I.MX6U 的 系统 时 钟 初始 化 
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195i Kkckckckckckck kk ck kk kk kk kc kk kk kk kk kk kk kk kck kck kck ckck ckck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck kck kk f 











16 

ILE ape 

18  * Qdescription : 使 能 I.Mx6U 所 有 外 设 时 钟 

1b) * (üiparam 2 3E 

20  * Greturn s JE 

ll 

22 void elk enable (void) 

Ze qi 

24 CCM-»-CCGROÓ = OXFFFFFFFFE; 

25 CCM->CCGR1 = OXFFFFFFFF; 

26 CCM->CCGR2 = OXFFFFFFFF; 

2. CCM-»-CCGR3 = OXFFFFFFFFE; 

28 CCM-»CCGRA S OXFFFFFFFF; 

29 CCM->CCGR5 = OXFFFFFFFF; 

30 CCM=>CCGR6 = OXFFFFFFFF; 

31 ]) 

32 

SES ue 

34  * Qdescription : 初始 化 系统 时 钟 528Mhz, WARE PLL2 和 PLL3 各 个 

25 PFD 时 钟 ,所 有 的 时 钟 频率 均 按 照 I.MX6U 官方 手册 推荐 的 值 . 
36  * Qparam 9 JE 

EN * Qreturn JE 

38 e 

39 void imx6u clkinit (void) 

40 ( 

41 unsigned int reg = 0; 

42 /* 1. WE ARM 内 核 时 钟 为 528MHz */ 

43 /* 1.1、 判 断 当 使 用 哪个 时 钟 源 启动 的 ， 正 常情 况 下 是 由 p111 sw_clk 驱动 的 ， 而 
44 * plll sw clk 有 两 个 来 源 : pl11 main clk 和 tep clk, WR 

45 * 让 内 核 跑 到 528M， 那 必须 选择 p111 main clk 作为 p111 的 时 钟 源 。 
46 B 如 果 我 们 要 修改 p111 main clk 时 钟 的 话 就 必须 先 将 p111 sw clk 从 
47 d plll main clk 切换 到 step_clk, 当 修 改 完 以 后 再 将 p111 sw clk 切换 
48 * [Hl pll1 main cl. step clk €T 24MHz. 

49 eu 

50 

51 if((((CCM-»CCSR) »» 2) & 0x1 ) 2-2 0)  /*  plll main clk? */ 
52 { 

53 CCM->CCSR &= ~(1 << 8); /* 配置 step clk 时 钟 源 为 24MH OSC */ 
54 CCM->CCSR |= (1 << 2); /* 配置 p111 sw clk 时 钟 源 为 step clk */ 
55 } 

56 

57 /* 1.2. WE plll main clk 为 1056MHz, 也 就 是 528x2=1056MHZ 
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58 * ”因为 p111 sw_clk 进 ARM 内 核 的 时 候 会 被 二 分 频 ! 

59 E 配置 CCM ANLOG-»2PLL ARM 寄存 器 

60 * bitl13: 1 使 能 时 钟 输出 

61 大 bit[6:0]: 88, HAN: Fout - Fin * diy select / 2505 
62 3 1056-24*div select/2.0, fjHi: div select-88. 

63 E 

64 CCM ANALOG->PLL ARM = (1 << 13) | ((88 << 0) & 0X7F); 


























65 CCM-»CCSR &= «(1 << 2);/* 将 pll sw clk 时钟 切换 回 p111 main clk */ 
66 CCM-»CACRR = 1; /* ARM 内 核 时 钟 为 bl111 sw clk/2-1056/2-528Mhz */ 
67 

68 J DE ANSYS PT) Se EEDE 

69 reg — CCM ANALOG-»PFD 528; 

70 reg &= «(0X3F3F3F3F); /* 清除 原来 的 设置 n 

71 reg J5 32««24c /* PLL2 PFD3-528*18/32-297Mhz  */ 

7 reg |» 24««16; /* PLL2 PFD2-528*18/24-396Mhz  */ 

FES reg |2 16««8; /* PLL2 PFD1-528*18/16-594Mhz  */ 

74 zeg [> 27220} /* PLL2 PFD0-528*18/27-352Mhz  */ 

75 CCM ANALOG-»PFD 528z2reg; /* 设置 PLL2 PFD0-3 e 

76 

vii /* 3. WE PLL3(USB1)4 T PFD */ 

78 Ic cU /* dB 8f 

79 reg = CCM ANALOG-»PFD 480; 

80 reg &= «(0X3F3F3F3F); /* 清除 原来 的 设置 x 
81 reg |= 19««24; /* PLL3 PFD3-480*18/19-454.74Mhz */ 
82 reg | 7ecio: /* PLL3 PFD2-480*18/17-508.24Mhz */ 
83 reg |= 16««8; /* PLL3 PFD1-480*18/16-540Mhz */ 
84 reg je 12€«0; /* PLL3 PFD0-480*18/12-720Mhz */ 
85 CCM ANALOG-»PFD 4802reg; /* 设置 PLL3 PFD0-3 E 
86 

87 /* 4、 设 置 AHB 时 钟 最 小 6Mhz， 最 大 132Mhz */ 

88 CCM->CBCMR &= ~(3 << 18); /* 清除 设置 */ 

89 CCM-»CBCMR |= (1 << 18); (* pre periph clk=PLLA PFD2=396MHZ =/ 
90 COM->CBCDR &= dE << 25); /~ periph Clk pre periph clk=39CMHz */ 
91 while(CCM-»CDHIPR & (1 << 5));/* 等 待 握手 完成 */ 

92 

93 /* 修改 AHB_PODF 位 的 时 候 需 要 先 禁止 AHB_CLK_ROOT 的 输出 ， 但 是 

94 * 我 没有 找到 关闭 AHB_CLK ROOT 输出 的 的 寄存 器 ， 所 以 就 没 法 设置 。 

95 * 下 面 设置 AHB PODF 的 代码 仅 供 学 习 参 考 不 能 直接 拿 来 使 用 ! ! 

96 * 内 部 boot rom 将 AHB PODF 设置 为 了 3 分 频 ， 即 使 我 们 不 设置 AHB_PODFE， 

97 * AHB ROOT CLK 也 依旧 等 于 396/3=132Mhz。 

98 */ 

99 #if 0 

100 /* 要 先 关 闭 AHB ROOT CILK 输出 ， 否 则 时 钟 设置 会 出 错 */ 
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101 CCM-»CBCDR &= «(7 << 10);/* CBCDR 的 AHB PODE 清 零 */ 

102 CCM-»CBCDR |= 2 << 10; /* AHB PODF 3 分 频 AHB CLK ROOT-132MHz */ 
103 while(CCM-»CDHIPR & (1 << 1));/* 等 待 握手 完成 */ 

104 £endif 

105 

106 /* 5. WE IPG CLK ROOT 最 小 3Mhz， 最 大 66Mhz */ 

107 CCM-»CBCDR &= «(3 << 8); /* CBCDR 的 IPG PODF JS */ 

108 CCM-»CBCDR |= 1 << 8; /* IPG PODF 2 分 频 ，IPG_CLK ROOT-66MHz */ 
109 

110 /* 6. XE PERCLK CLK ROOT 时 钟 */ 

ETE CCM-»CSCMR1 &= «(1 << 6);  /* PERCLK CLK ROOT 时 钟 源 为 IPG */ 

12 CCM-»CSCMR1 &= «(7 << 0);  /* PERCLK PODF 位 清 零 ， 即 1 分 频 */ 

113 ) 





文件 bsp_clk.c 中 一 共有 两 个 函数 : clk enable 和 imx6u clkinit， 其 中 国 数 clk enable Bi TRI 
已 经 讲 过 了 ， 就 是 使 能 LMX6U 的 所 有 外 设 时 钟 。 函 数 imx6u clkinit 才 是 本 章 的 重点 ， 
imx6u clkinit 先 设置 系统 主 频 为 528MHz， 然 后 根据 我 们 上 一 小 节 分 析 的 ILMX6U 时 钟 系统 来 
设置 8 路 PFD， 最 后 设置 AHB、IPG 和 PERCLK 的 时 钟 频率 。 



































在 bsp_clk.h 文件 中 添加 函数 imx6u_clkinit 的 声明 ， 最 后 修改 main.c 文件 ， 在 main 函数 里 
面 调用 imx6u_clkinit 来 初始 化 时 钟 ， 如 下 所 示 : 


示例 代码 16.3.2 main 函数 


1 int main(void) 

A N 

E int i - 0; 

4 int keyvalue = 0; 

5 Wusebepaex! ehar led etate = Omm 

6 unsigned char beep state OFF; 

7j 

8 imx6u clkinit(); /* 初始 化 系统 时 钟 ir 
9 clk enable(); /* 使 能 所 有 的 时 钟 a 
10 leed init() e /* 初始 化 led “y 
Lai beep init(); /* 初始 化 beep S 
15 key init(); /* 初始 化 key mf 


13 
14 /* 省 略 掉 其 它 代 码 */ 
15 ) 


上 述 代码 的 第 8 行 就 是 时 钟 初始 化 函数 ， 时 钟 初 始 化 函数 最 好 放 到 最 开始 的 地 方 调用 。 


16.4 编译 下 载 验证 
16.4.1 编写 Makefile 和 链接 脚本 


因为 本 章 是 在 试验 “7_ key” 上 修改 的 ， 而 且 本 章 试验 没有 添加 任何 新 的 文件 ， 因 此 只 需 
要 修改 Makefile 的 变量 TARGET 为 “clk” 即 可 ， 如 下 所 示 : 





TARGET ?= clk 
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链接 脚本 保持 不 变 。 


16.4.2 编译 下 载 


使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 clk.bin 文件 
下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload // 给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

Jimxdownload clk.bin /dev/sdd / 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 。 本 试验 效果 其 实 和 试 
验 “7 _ key” 一 样 ， 但 是 LED 灯 的 闪烁 频率 相 比试 验 “7 _ key” 要 快 一 点 。 因 为 试验 “7_ key” 的 
主 频 是 396MHz, 而 本 试验 的 主 频 被 配置 成 了 528MHz， 因 此 代码 执行 速度 会 变 快 ， 所 以 延 时 函 
数 的 运行 就 会 加 快 。 
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第 十 七 章 GPIO 中 断 试 验 


中 断 系 统 是 一 个 处 理 器 重要 的 组 成 部 分 ,中断 系统 极 大 的 提高 了 CPU 的 执行 效率 , 在 学 习 
STM32 的 时 候 就 经 常用 到 中 断 。 本 章 就 通过 与 STM32 的 对 比 来 学 习 一 下 Cortex-A7(I.MX6U) 
中 断 系 统 和 Cortex-M(STM32) 中 断 系统 的 异同 ， 同 时 ， 本 章 会 将 ILMX6U 的 一 个 IO 作为 输入 中 
断 ， 借 此 来 讲解 如 何 对 IMX6U 的 中 断 系统 进行 编程 。 
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17.1 Cortex-A7 中 断 系 统 详 解 


17.1.1 STM32 中 断 系 统 回 顾 


STM32 的 中 断 系 统 主要 有 一 下 几 个 关键 点 : 





(D、 中 断 向 量 表 。 





©, NVIC(PA EE [3] EP Brian] d) o 








©, FEER. 
QD. FERS ERR 


1、 中 断 向 量 表 














中 断 向 量 表 是 一 个 表 ， 这 个 表 上 








面 存 放 的 是 中 断 向 量 





断 服 务 程 序 的 首 地 址 成 为 中 断 向 量 ， 
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。 中 断 服务 程序 的 入 口 地址 或 存放 中 








因此 中 断 向 量 表 是 一 系列 中 断 服务 程序 入 口 地 址 组 成 的 表 。 








这 些 中 断 服 务 程序 (函数 ) 在 中 断 向 量 表 中 的 位 置 是 由 半导体 三 商定 好 的 ， 当 某 个 中 断 被 触发 以 











后 就 会 自动 跳 转 到 中 断 向 量 表 中 对 应 的 中 断 服 务 程序 (函数 ) 入 口 地 址 处 。 中 断 向 量 表 在 整个 程 


序 的 最 前 面 ， 比 如 STM32F103 的 中 


断 向 量 表 如 下 所 示 : 











示例 代码 17.1.1.1 STM32F103 + Bp] 























1 Weeters DED initial 5p p tOo eor Stack 

2 DCD Reset Handler esee 

8 DCD NMI Handler ; NMI Handler 

4 DCD HardFault Handler p harc Faule kancler 
5 DCD MemManage Handler ; MPU Fault Handler 

6 DCD BusFault Handler ; Bus Fault Handler 

3) DCD UsageFault Handler ; Usage Fault Handler 
8 DCD 0 P Reserved 

9 DCD 0 ; Reserved 

10 DCD 0 ; Reserved 

Jt DCD 0 ; Reserved 

12 DCD SVC Handler ; SVCall Handler 

385) DCD DebugMon Handler ; Debug Monitor Handler 
14 DCD 0 ? Reserven 

JU; DCD PendSV Handler ; PendSV Handler 

16 DCD SysTick Handler ; SysTick Handler 

AUT 

18 ; External Interrupts 

ERO DCD WWDG IROHandler ; Window Watchdog 

20 DCD PVD IROHandler ; PVD through EXTI Line detect 
2a DCD TAMPER IRQHandler ; Tamper 

22 DCD RTC IRQHandler p RIIG 

25 DCD FLASH IROHandler ; Flash 

24 

25 /* 省 略 掉 其 它 代 码 */ 

26 


2 DED DMA2 Channel4 5 IRQHandler ; DMA2 Channel4 & 15 
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Z5 VseeoeS Enel 

















“示例 代码 17.1.1.1” 就 是 STM32F103 的 中 断 向 量 表 ， 中 断 向 量 表 都 是 链接 到 代码 的 最 
前 面 ， 比 如 一 般 ARM 处 理 器 都 是 从 地 址 0X00000000 开始 执行 指令 的 ， 那 么 中 断 向 量 表 就 是 
从 0X00000000 开始 存放 的 。“ 示 例 代 码 17.1.1.1” 中 第 1 行 的 “ initial sp” 就 是 第 一 条 中 断 
向 量 ， 存 放 的 是 栈 顶 指针 ， 接 下 来 是 第 2 行 复位 中 断 复 位 函数 Reset Handler 的 入 口 地 址 ， 依 
次 类 推 ， 直 到 第 27 行 的 最 后 一 个 中 断 服 务 函 数 DMA2_Channel4 5 IRQHandler 的 入 口 地 址 ， 
这 样 STM32F103 的 中 断 向 量 表 就 建 好 了 。 

我 们 说 ARM 处 理 器 都 是 从 地 址 0X00000000 开始 运行 的 ， 但 是 我 们 学 习 STM32 的 时 候 
代码 是 下 载 到 0X8000000 开始 的 存储 区 域 中 。 因 此 中 断 向 量 表 是 存放 到 0X 8000000 地 址 处 
的 ， 而 不 是 0X00000000， 这 样 不 是 就 出 错 了 吗 ? 为 了 解决 这 个 问题 ，Cortex-M 架构 引入 了 一 
个 新 的 概念 一 一 中 断 向 量 表 偏 移 ， 通 过 中 断 向 量 表 偏 移 就 可 以 将 中 断 向 量 表 存 放 到 任意 地 址 
处 ， 中 断 疝 量 表 偏 移 配置 在 函数 SystemInit 中 完成 ， 通 过 向 SCB_VTOR 寄存 器 写 入 新 的 中 断 
向 量 表 首 地 址 即 可 ， 代 码 如 下 所 示 : 

示例 代码 17.1.1.2 STM32F103 中 断 向 量 表 偏 移 




















































































































































































































1 void SystemInit (void) 

A 

3 RCC->CR |= (uint32 t)0x00000001; 

4 

5 /* 省 略 其 它 代 码 */ 

6 

7 #ifdef VECT TAB SRAM 

8 SCB-»2VTOR = SRAM BASE | VECT TAB OFFSET; 
9 #else 

10 SCB-»2VTOR - FLASH BASE | VECT TAB OFFSET; 
11 fendif 

12.3 

















第 8 行 和 第 10 行 就 是 设置 中 断 向 量 表 偏 移 ， 第 8 行 是 将 中 断 向 量 表 设 置 到 RAM 中 ， 第 
10 行 是 将 中 断 向 量 表 设置 到 ROM 中 ， 基 本 都 是 将 中 断 向 量 表 设 置 到 ROM 中 ， 也 就 是 地 址 
0X8000000 处 。 第 10 行 用 到 了 FALSH BASE 和 VECT TAB _OFFSET， 这 两 个 都 是 宏 ， 定 义 
如 下 所 示 : 
#define FLASH BASE ((uint32 t)0x08000000) 
Zdefine VECT TAB OFFSET 0x0 

因此 第 10 行 的 代码 就 是 : SCB->VTOR=0X080000000， 中 断 向 量 表 偏 移 设置 完成 。 通 过 上 
面 的 讲解 我 们 了 解 了 两 个 跟 STM32 中 断 有 关 的 概念 : 中 断 向 量 表 和 中 断 向 量 表 偏 移 , 那么 这 个 
ER LMX6U 有 什么 关系 呢 ? 因为 IMX6U 所 使 用 的 Cortex-A7 内 核 也 有 中 断 和 癌 量 表 和 中 断 向 量 
表 偏 移 ， 而 且 其 含义 和 STM32 是 一 模 一 样 的 ! 只 是 用 到 的 寄存 器 不 通 而 已 ， 概 念 完全 相同 ! 

2. NVIC(PI BR [8] E rF Bree] 38) 

中 断 系 统 得 有 个 管理 机 构 ， 对 于 STM32 这 种 Cortex-M 内 核 的 单片机 来 说 这 个 管理 机 构 叫 
做 NVIC， 全 称 叫 做 Nested Vectored Interrupt Controller。 关 于 NVIC 本 教程 不 作 详 细 的 讲解 ， 既 
然 Cortex-M 内 核 有 个 中 断 系统 的 管理 机 构 一 NVIC， 那 么 LMX6U 所 使 用 的 Cortex-A7 内 核 是 
不 是 也 有 个 中 断 系统 管理 机 构 ? 答案 是 肯定 的 ， 不 过 Cortex-A 内 核 的 中 断 管理 机 构 不 叫做 
NVIC， 而 是 叫做 GIC， 全 称 是 general interrupt controller， 后 面 我 们 会 详细 的 讲解 Cortex-A 内 
核 的 GIC。 
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3、 中 断 使 能 

















要 使 用 某 个 外 设 的 中 断 ， 肯 定 要 先 使 能 这 个 外 设 的 中 断 ， 以 STM32F103 的 PE2 这 个 IO 为 
例 ， 假 如 我 们 要 使 用 PE2 的 输入 中 断 肯 定 要 使 用 如 下 代码 来 使 能 对 应 的 中 断 : 

NVIC InitStructure.NVIC IRQChannel = EXTI2 IRQn; 

NVIC InitStructure.NVIC IRQChannelPreemptionPriority = 0x02; /抢占 优先 级 2， 

NVIC InitStructure.NVIC IRQChannelSubPriority = 0x02; / 子 优先 级 2 

NVIC InitStructure.NVIC IRQChannelCmd = ENABLE; /使 能 外 部 中 断 通 道 

NVIC Init(&NVIC InitStructure); 

上 述 代 码 就 是 使 能 PE2 对 饮 过 的 EXTI2 中 断 ， 同 理 ， 如 果 要 使 用 LMX6U 的 某 个 中 断 的 话 
也 需要 使 能 其 对 应 的 中 断 。 

4、 中 断 服务 函数 

我 们 使 用 中 断 的 目的 就 是 为 了 使 用 中 断 服 务 函 数 ， 当 中 断 发 生 以 后 中 断 服 务 函 数 就 会 被 调 
用 ， 我 们 要 处 理 的 工作 就 可 以 放 到 中 断 服务 函数 中 去 完成 。 同 样 以 STM32F103 的 PE2 为 例 ， 
其 中 断 服 务 函数 如 下 所 示 : 

F* 外 部 中 断 2 服务 程序 */ 

void EXTI2 IRQHandler(void) 

i 





















































[* 中 断 处 理 代 码 */ 

j 

当 PE2 引 脚 的 中 断 触 发 以 后 就 会 调用 其 对 应 的 中 断 处 理 函 数 EXTI2_IRQHandler， 我 们 可 
以 在 函数 EXTI2_IRQHandler 中 添加 中 断 处 理 代码 。 同 理 ,， LMX6U 也 有 中 断 服务 函数 ， 当 某 个 
外 设 中 断 发 生 以 后 就 会 调用 其 对 应 的 中 断 服务 函数 。 

通过 对 STM32 中 断 系 统 的 回顾 ， 我 们 知道 了 Cortex-M 内 核 的 中 断 处 理 过 程 ， 那么 Cortex- 
A 内 核 的 中 断 处 理 过 程 是 否 是 一 样 的 ， 有 什么 异同 呢 ?” 接 下 来 我 们 带 着 这 样 的 疑问 来 学 习 
Cortex-A7 内 核 的 中 断 系 统 。 


























17.1.2 Cortex-A7 中 断 系 统 简介 


ER STM32 一 样 ，Cortex-A7 也 有 中 断 向 量 表 ， 中 断 向 量 表 也 是 在 代码 的 最 前 面 。Cortex- 
A7 内 核 有 8 个 异常 中 断 ， 这 8 个 异常 中 断 的 中 断 向 量 表 如 表 17.1.2.1 所 示 : 


[nn 断 类 型 
















































































0X00 复位 中 断 (Rest) 特权 模式 (SVC) 

0X04 未 定义 指令 中 断 (Undefined Instruction) 未 定义 指令 中 止 模式 (Undef) 
0X08 软 中 断 (Software Interrupt, SWI) 特权 模式 (SVC) 

0X0C 间 令 预 取 中 止 中 断 (Prefetch Abort) 中 止 模式 

0X10 数据 访问 中 止 中 断 (Data Abort) 中 止 模式 

0X14 未 使 用 (Not Used) 未 使 用 

0X18 IRQ 中 断 GRQ Interrupt) 外 部 中 断 模式 TRQ) 

0XIC FIQ 中 断 (EIQ Interrupt) 快速 中 断 模式 (FIQ) 

















K 17.1.2.1 Cortex-A7 中 断 向 量 
中 断 向 量 表 里 面 都 是 中 断 服务 函数 的 入 口 地 址 ， 因 此 一 款 芯片 有 什么 中 断 都 是 可 以 从 中 断 
向 量 表 看 出 来 的 。 从 表 17.1.2.1 中 可 以 看 出 ，Cortex-A7 一 共有 8 个 中 断 ， 而 且 还 有 一 个 中 断 向 
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量 未 使 用 ， 实 际 只 有 7 个 中 断 。 和 “示例 代码 17.1.1.1” 中 的 STM32F103 中 断 向 量 表 比 起 来 少 
了 很 多 ! 难道 一 个 能 跑 Linux 的 芯片 只 有 这 7 个 中 断 ? 明显 不 可 能 的 ! 那 类 似 STM32 中 的 
EXTI9 5_IRQHandler、TIM2_IRQHandler 这 样 的 中 断 向 量 在 哪里 ? DPC、SPI、 定 时 器 等 等 的 中 























断 怎么 处 理 呢 ? 这 个 就 是 Cortex-A 和 Cotex-M 在 中 断 向 量 表 这 一 块 的 区 别 ， 对 于 Cortex-M 内 
核 来 说 , 中 断 向 量 表 列 举 出 了 一 款 芯 片 所 有 的 中 断 向 量 , 包括 芯片 外 设 的 所 有 中 断 。 对 于 Cotex- 
A 内 核 来 说 并 没有 这 么 做 ， 在 表 17.1.2.1 中 有 个 IRQ 中 断 ， Cortex-A EZ CPU 的 所 有 外 部 中 
断 都 属于 这 个 IQR 中 断 ， 当 任意 一 个 外 部 中 断 发 生 的 时 候 都 会 触发 RO 中断。 在 IRQ 中 断 服 
务 函 数 里 面 就 可 以 读 取 指 定 的 寄存 器 来 判断 发 生 的 具体 是 什么 中 断 ， 进 而 根据 具体 的 中 断 做 出 
相应 的 处 理 。 这 些 外 部 中 断 和 IQR 中 断 的 关系 如 图 17.1.2.1 所 示 : 


SoftwareO IRQn 
Softwarel IRQn 


LegacyIRQ IRQn 
IOMUXC IRQn IRQ BT 
DAP IRQn 
SDMA IRQn 


PMU IRQZ IRQn 


图 17.1.2.1 外 部 中 断 和 RO 中 断 关 系 
在 图 17.1.2.1 中 ， 左 侧 的 Softwareü IROn-PMU IRQ2 IRQ 这 些 都 是 LMX6U 的 中 断 ， 他 
们 都 属于 IRQ 中 断 。 当 图 17.1.2.1 左 侧 这 些 中 断 中 任意 一 个 发 生 的 时 候 RO 中 断 都 会 被 触发 ， 
所 以 我 们 需要 在 IRQ 中 断 服务 函 数 中 判断 究竟 是 左 侧 的 哪个 中 断 发 生 了 ,然后 再 做 出 具体 的 处 
理 。 
































































































































在 表 17.1.2.1 中 一 共有 7 个 中 断 ， 简 单 介 绍 一 下 这 7 个 中 断 : 
Q)、 复 位 中 断 (Rest), CPU 复位 以 后 就 会 进入 复位 中 断 , 我 们 可 以 在 复位 中 断 服务 函数 
做 一 些 初始 化 工作 ， 比 如 初始 化 SP 指针 、DDR 等 等 。 

人 @、 未 定义 指令 中 断 (Undefined Instruction)， 如 果 指 令 不 能 识别 的 话 就 会 产生 此 中 断 。 

©., f*rBlBr(Software Interrupt, SWI), H SWI 指令 引起 的 中 断 ，Linux 的 系统 调用 会 用 SWI 
指令 来 引起 软 中 断 ， 通 过 软 中 断 来 陷入 到 内 核 空 间 。 

则 、 指 令 预 取 中 止 中 断 (Prefetch Abort)， 预 取 指 令 的 出 错 的 时 候 会 产生 此 中 断 。 

@@、 数 据 访问 中 止 中 断 (Data Abort)， 访 问 数据 出 错 的 时 候 会 产生 此 中 断 。 

©, IRQ 中 断 (IRQ Interrupt)， 外 部 中 断 ， 前 面 已 经 说 了 ， 访 片 内 部 的 外 设 中 断 都 会 引起 此 
中 断 的 发 生 。 

C. FIQ rPIBr(FIQ Iterrupb， 人 快速 中 新， 如 果 需 要 快速 处 理 中 断 的 话 就 可 以 使 用 此 中 。 
在 上 面 的 7 个 中 断 中 ， 我 们 常用 的 就 是 复位 中 断 和 IRQ. 中 断 ， 所 以 我 们 需要 编写 这 两 个 中 
断 的 中 断 服务 函数 , 稍 后 我 们 会 讲解 如 何 编写 对 应 的 中 断 服务 函数 。 首先 我 们 要 根据 表 17.1.2.1 
的 内 容 来 创建 中 断 向 量 表 ， 中 断 向 量 表 处 于 程序 最 开始 的 地 方 ， 比 如 我 们 前 面 例 程 的 start.S 文 
牛 最 前 面 ， 中 断 向 量 表 如 下 ; 
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示例 代码 17.1.1.1 Cortex-A 向 量 表 模 板 


1 .global start /* 全 局 标号 2 
2 

35 Bract 

4 ldr pc, =Reset_Handler /* 复位 中 断 "p 
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5 ldr pc, 2Undefined Handler  /* 未 定义 指令 中 断 n 

6 lar pc, zSVC Handler /* SVC (Supervisor) 中断 e y 

7 ldr pc, 2PrefAbort Handler  /* 预 取 终 止 中 断 A 

8 ldr pc, -DataAbort Handler  /* 数据 终止 中 断 21 

9 ldr pc, zNotUsed Handler /* 未 使 用 中 断 da 
10 lar pc, -IRQ Handler /* IRQ FET e 
Tal ldr pc, -FIQ Handler /* FIQ (快速 中 断 ) 未 定义 中 断 */ 
12 


13 /* Sr */ 

ii Reset Mancdler: 

15 /* 复位 中 断 具 体 处 理 过 程 */ 
16 

Te */ 


18 Undefined Handler: 


IS) ldr r0, -Undefined Handler 
20 lox ae) 
2l 


22 /* svc 中 断 */ 
23 SVC hemellers 


24 ldr r0, -SVC Handler 
28 los r0 
26 


27 /* 预 取 终止 中 断 */ 
26 PrertAbort Hanclere 


29 ldr r0, zPrefAbort Handler 
30 lox z0 
ETE 


32 /* 数据 终止 中 断 */ 
33 DataAbort Handler: 


34 ldr r0, -DataAbort Handler 
35 bbx ro 
36 


S LUE sai sd A 


38 NotUsed Handler: 





29 

40 ldr r0, zNotUsed Handler 
41 los r0 

42 

43 /* IRO 中 有 断 ! 重点 ! ! ! ! ! */ 


44 IRQ Handler: 

45 /* 复位 中 断 有 具体 处 理 过 程 */ 
46 

47 /* BIO Ra */ 
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ae PIO Hancilers 
49 lede z0, IQ handler 
50 bx rO 

第 4 到 11 行 是 中 断 向 量 表 ， 当 指定 的 中 断 发 生 以 后 就 会 调用 对 应 的 中 断 复 位 函数 ， 比 如 
复位 中 断 发 生 以 后 就 会 执行 第 4 行 代码 ， 也 就 是 调用 函数 Reset Handler, PŽ Reset Handler 
就 是 复位 中 断 的 中 断 复位 函数 ， 其 它 的 中 断 同 理 。 
第 14 到 50 行 就 是 对 应 的 中 断 服 务 函 数 ， 中 断 服务 函数 都 是 用 汇编 编写 的 ， 我 们 实际 需要 
编写 的 只 有 复位 中 断 服务 函数 Reset Handler 和 IRQ FEARS KZ IRQ Handler, 其 它 的 中 断 本 
教程 没有 用 到 ， 所 以 都 是 死 循 环 。 在 编写 复位 中 断 复位 函数 和 IRO 中 断 服务 函数 之 前 我 们 还 需 
要 了 解 一 些 其 它 的 知识 ， 否 则 的 话 就 没 法 编写 。 


















































17.1.3 GIC 控制 器 简介 


1. GIC 控制 器 总 览 

STM32(Cortex-M) 的 中 断 控制 器 叫做 NVIC，LMX6U(Cortex-A) 的 中 断 控 制 器 叫做 GIC, 
XT GIC 的 详细 内 容 请 参考 开发 板 光 盘 中 的 文档 《ARM Generic Interrupt Controller(ARM GIC 
控制 器 )V2.0.pdf》。 

GIC 是 ARM 公司 给 Cortex-A/R 内 核 提 供 的 一 个 中 断 控制 器 ， 类 似 Cortex-M 内 核 中 的 
NVIC。 目 前 GIC 有 4 个 版 本 :V1~V4，V1 是 最 老 的 版 本 ， 已 经 被 废弃 了 。V2~V4 目前 正在 大 
量 的 使 用 。GIC V2 是 给 ARMV7-A 架构 使 用 的 ， 比 如 Cortex-A7、Cortex-A9、Cortex-A15 等 ， 
V3 和 V4 是 给 ARMv8-A/R 架构 使 用 的 ， 也 就 是 64 位 芯片 使 用 的 。LMX6U 是 Cortex-A 内 核 
的 ， 因 此 我 们 主要 讲解 GIC V2. GIC V2 最 多 支持 8 个 核 。ARM 会 根据 GIC 版 本 的 不 同 研发 
出 不 同 的 全 核 ， 那 些 半 导体 厂商 直接 购买 对 应 的 IP 核 即 可 ， 比 如 ARM 针对 GIC V2 就 开发 出 
了 GIC400 这 个 中 断 控 制 器 IP 核 。 当 GIC 接收 到 外 部 中 断 信 号 以 后 就 会 报 给 ARM 内 核 ， 但 是 
ARM 内 核 只 提供 了 四 个 信号 给 GIC 来 汇报 中 断 情况 : VFIQ. VIRQ. FIQ 和 IRQ， 他 们 之 间 的 
关系 如 图 17.1.3.1 所 示 : 
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图 17.1.3.1 中 断 示意 图 

在 图 17.1.3.1 P, GIC 接收 众多 的 外 部 中 断 ， 然 后 对 齐 进行 处 理 ， 最 终 就 只 通过 四 个 信号 
报 给 ARM 内 核 ， 这 四 个 信号 的 含义 如 下 : 

VFIQ: 虚 拟 快速 FIQ. 

VIRQ: 虚 拟 快速 IRQ. 

FIQ: 快 速 中 断 IRQ。 

IRQ: 外 部 中 断 IRQ. 

VFIQ 和 VIRQ 是 针对 虚拟 化 的 ， 我 们 讨论 虚拟 化 ， 剩 下 的 就 是 FIQ 和 IR 了， 我们 前 面 
都 讲 了 很 多 次 了 。 本 教程 我 们 只 使 用 IRQ， 所 以 相当 于 GIC 最 终 向 ARM PALOS E45 — 7 IRQ 
Hg. HA GIC 是 如 何 完成 这 个 工作 的 呢 ? GICV2 的 逻辑 图 如 图 17.1.3.2 所 示 : 
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图 17.1.3.2 GICV2 总 体 框 图 

图 17.1.3.1 中 左 侧 部 分 就 是 中 断 源 ， 中 间 部 分 就 是 GIC 控制 器 ， 最 右 侧 就 是 中 断 控制 器 向 
处 理 器 内 核发 送 中 断 信息 。 我们 重点 要 看 的 肯定 是 中 间 的 GIC 部 分 ，GIC 将 众多 的 中 断 源 分 为 
分 为 三 类 : 

(D、SPI(Shared Peripheral Interrupb), 共 享 中 断 ， 顾 名 思 义 ， 所 有 Core 共享 的 中 断 ， 这 个 是 最 
常见 的 ， 那 些 外 部 中 断 都 属于 SPI 中 断 ( 注 意 ! 不 是 SPI 总 线 那 个 中 断 ) 。 比 如 按键 中 断 、 串 口 
中 断 等 等 ， 这 些 中 断 所 有 的 Core 都 可 以 处 理 ， 不 限定 特定 Core. 

®©, PPI(Private Peripheral Interrupt), AA FI, RAIT GIC 是 支持 多 核 的 ， 每 个 核 肯 定 
有 自己 独 有 的 中 断 。 这 些 独 有 的 中 断 肯定 是 要 指定 的 核心 处 理 , 因此 这 些 中 断 就 叫做 私有 中 断 。 

(3. SGl(Software-generated Interrupt)， 软 件 中 断 ， 由 软件 触发 引起 的 中 断 ， 通 过 向 寄存 器 
GICD_SGIR 写 入 数据 来 触发 ， 系 统 会 使 用 SGI 中 断 来 完成 多 核 之 间 的 通信 。 

2、 中 断 ID 

中 断 源 有 很 多 ， 为 了 区 分 这 些 不 同 的 中 断 源 肯定 要 给 他 们 分 配 一 个 唯一 中， 这 些 ID 就 是 
中 断 ID 。 每 一 个 CPU 最 多 支持 1020 个 中 断 ID， 中 断 ID 号 为 ID0~ID1019。 这 1020 ^^ ID 8, 
含 了 PPI、SPI 和 SGI， 那 么 这 三 类 中 断 是 如 何 分 配 这 1020 个 中 断 ID 的 呢 ? 这 1020 个 ID 分 
配 如 下 : 

ID0~ID15: 3X 16 个 ID 分 配给 SGI 

ID16~ID31: 这 16 个 ID 分 配给 PPI。 
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ID32~ID1019: 这 988 个 ID 分 配给 SPI， 像 GPIO 中 断 、 串 口中 断 等 这 些 外 部 中 断 ， 至 于 具体 


























到 某 个 ID 对 应 哪个 中 断 那 就 由 半导体 厂商 根据 实际 情况 去 定义 了 。 比 如 LMX6U 的 总 共 使 用 
了 128 个 中 断 ID， 加 上 前 面 属于 PPI 和 SGI 的 32 个 ID，LMX6U 的 中 断 源 共 有 128+32=160 
个 , 这 128 个 中 断 ID 对 应 的 中 断 在 《LMX6ULL 参考 手册 》 的 “3.2 Cortex A7 interrupts ”小 节 ， 

中 断 源 如 表 17.1.3.1 所 示 : 





IRO ) [22]; S] REA 
IKUY 1L E 做 了 


32 boot 用 于 在 启动 异常 的 时 候 通知 内 核 。 


















































0 
1 33 ca7 platform DAP 中 断 ， 调 试 端口 访问 请 求 中 断 。 
2 34 sdma SDMA 中 断 。 
3 35 tsc TSC( 触 摸 ) 中 断 。 
snvs lp wrapper SNVS 中 断 。 
snvs hp wrapper 
124 156 无 保留 
125 157 无 保留 
126 158 无 保留 
127 159 pmu PMU "Hr 

















表 17.1.3.1 LMX6U 中 断 源 
限于 篇 幅 原 因 ， 表 17.1.3.1 中 并 没有 给 出 LMX6U 完整 的 中 断 源 ， 完 整 的 中 断 源 自行 查阅 
《I.MX6ULL 参考 手册 》 的 3.2 小 节 。 打 开 裸 机 例 程 “9_int”， 我 们 前 面 移植 了 NXP 官方 SDK 
中 的 文件 MCIMX6Y2C.h， 在 此 文件 中 定义 了 一 个 枚 举 类 型 IRQn_Type， 此 枚 举 类 型 就 枚 举 出 
了 LMX6U 的 所 有 中 断 ， 代 码 如 下 所 示 : 
示例 代码 17.1.3.1 中 断 向 量 





























1 #define NUMBER OF INT VECTORS 160 /* 中 断 源 160 个 ，SGI+PPI+SPI*/ 
2 

3 typedef enum IROn ( 

4 /* Auxiliary constants */ 

5 NotAvail IROn E cub 
6 

7 Ae oOre u4nterrupts */ 

8 Software0 IROn = 0, 

9 Softwarel IROn = 1, 

10 Software2 IROn -2, 

dal Software3 IROn = 3, 

T2 Software4 IROn = 4, 

13 Software5 IROn 25, 

14 Software6 IROn = 6, 

dl; Software'7 IROn E 

16 Software8 IROn = 8, 

157) Software9 IROn = 9, 

18 SoftwarelO0 TROM = 10, 
19 Softwarell IROn z 11, 
20 Softwarel2 IROn = 12, 
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2H Softwarel3 IROn = 19; 
22 Softwarel4 IROn = 14, 
25 Softwarel5 IROn zu 
24 VirtualMaintenance IROn = 25, 
25 HypervisorTimer TRON = 26, 
26 VirtualTimer TRON z27, 
2 LegacyFastInt IROn = 28, 
28 SecurePhyTimer IROn = 29, 
29 NonSecurePhyTimer IROn = 30, 
30 LegacyIRQ IROn = 31, 
el 
32 /* Device specific interrupts */ 
3S IOMUXC IROn = 32, 
34 DAP IROn = 33, 
35 SDMA IROn - 34, 
36 TSC IROn = 35, 
3 SNVS IROn = 36, 
dsl ENET2 1588 IROn = ds 
152 Reservedl154 IROn = 154, 
JUS) Eleisiem e ct MEINE Om - 155, 
154 Reservedl156 TRON = 156, 
15/5 Reserved157 IROn zl; 
156 Reserved158 TROM = 158, 
157 PMU IRQ2 IROn = 159 
158) IROn Type; 

3. GIC 逻辑 分 块 


GIC 架构 分 为 了 两 个 逻辑 块 :Distributor 和 CPU Interface, 也 就 是 分 发 器 端 和 CPU 接口 端 。 
这 两 个 逻辑 块 的 含义 如 下 : 

Distributor( 分 发 器 端 ): 从 图 17.1.3.2 可 以 看 出 ， 此 逻辑 块 负责 处 理 各 个 中 断 事件 的 分 发 问 
题 ， 也 就 是 中 断 事件 应 该 发 送 到 哪个 CPU Interface 上 去 。 分 发 器 收集 所 有 的 中 断 源 ， 可 以 控制 
每 个 中 断 的 优先 级 ,， 它 总 是 将 优先 级 最 高 的 中 断 事件 发 送 到 CPU 接口 端 。 分 发 器 端 要 做 的 主要 
工作 如 下 : 

QD、 全 局 中 断 使 能 控 仙 

名、 控制 每 一 个 中 断 的 使 能 或 者 关闭 。 
设置 每 个 中 断 的 优先 级 。 
设置 每 个 中 断 的 目标 处 理 器 列表 。 
设置 每 个 外 部 中 断 的 触发 模式 : 电 平 触发 或 边沿 触发 。 
设置 每 个 中 断 属于 组 0 还 是 组 1。 

CPU Interface(CPU 接口 端 ): CPU 接口 端 听 名 字 就 知道 是 和 CPU Core 相连 接 的 ， 因 此 在 
图 17.1.3.2 中 每 个 CPU Core 都 可 以 在 GIC 中 找到 一 个 与 之 对 应 的 CPU Interface。CPU 接口 端 
就 是 分 发 器 和 CPU Core 之 间 的 桥梁 ，CPU 接口 端 主要 工作 如 下 : 

(DD、 使 能 或 者 关闭 发 送 到 CPU Core 的 中 断 请 求 信 和 号。 
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人 @、 应 答 中 断 。 

@、 通 知 中 断 处 理 完 成 。 

(@、 设 置 优 先 级 掩 码 ， 通 过 掩 码 来 设置 哪些 中 断 不 需要 上 报 给 CPU Core. 

©, ENH HRI. 

人 @@、 当 多 个 中 断 到 来 的 时 候 ， 选 择优 先 级 最 高 的 中 断 通知 给 CPU Core. 

例 程 “9 int” 中 的 文件 core ca7.h 定义 了 GIC 结构 体 ， 此 结构 体 里 面 的 寄存 器 分 为 了 分 
发 器 端 和 CPU 接口 端 ， 寄 存 器 定义 如 下 所 示 : 

示例 代码 17.1.3.2 GIC 控制 器 结构 体 











Pass 
* GIC 寄存 器 描述 结构 体 ， 
* GIC 分 为 分 发 器 端 和 CPU 接口 端 
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1 typedef struct 

2 1 

3 /* 分 发 器 端 寄存 器 */ 

4 uint32 t RESERVEDO[1024]; 

5 — HOM jubes S2 DI Botteec QOx1000 (EM) wf 

6 M uint 1E D TYPER; js (Quee B TUSCIA. WR y uw 

7 TD [** Quses OxIO08. (RR 

8 uint32 t RESERVEDI1 [29]; 

9 HON jubeo E ID) IWOEXOUER[DIG]g /' Oset QO1090 — OEC (Em) */ 
10 uint32 t RESERVED2[16]; 

11 TOM uint32 t D ISENABLER[16];/* Offset: Ox1100 = Ox13C (R/W) */ 
12 uint32 t RESERVED3 [16]; 

159 HON uini Tc ID) JHOINSUBISULIURN DIL] 2/7 QGuexereus OL190 — OxdUEC (Em) */ 
14 uint32 t RESERVEDA[16]; 

15 TOM webmESZ 1 D) XSEmNDE[SCI]Ss 5 Oxxsews 051200 — 0523€ Qm/W) 
16 uint32 t RESERVED5 [16]; 

17 ON weumzS2 DT PMOL ^s Oneets 0x1290 — Os2EC (R/W € 
18 uint32 t RESERVED6[16]; 

19  JMORE DT TI OEE Dl 0 — (S3) (Qu 97 
20 uint32 t RESERVED? [16]; 

21 IOM uint32 t D ICACTIVER[16];/* Offset: 0x1380 = Ox3BC (R/W) */ 
22 uint32 t RESERVEDS [16]; 

25. TOM wobaS i [D IJPEUNONOLEXEJDS321]2/* Oxiseus QOxi400 — ObxbmC (m/m) */ 
24 uint32 t RESERVED9[128]; 

25  JXONRA woes iE TD IDTNSNGNPS[US:2]]g/* Offset Ox1900 — OIC (QD */ 
26 uint32 t RESERVED10[128]; 

23] XO) wobaS2 1: D ICEGRISZI? [^ QGuxseus OxdCO0 — ORCUC (QR/M) */ 
28 Med2 MEEMEEIEIS BUESVIBUID STATS DT 

29) 3A Wines? i D IEJUSEDS [= (Quetexea UEdUbUU (Eu J = 

3p IM mints? © D SPISRI SI? /* Offset: 0x1D04 - OxD3C (R/ ) */ 
31 uint32 t RESERVED12[112]; 
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32 (OM net DIR [^s QOuseees xxl ( JN E 
33 Uime S2 1c RISERVDIDLS| |? 

34; TOM S E D) OCENO oC IRIGI Otisci: OIF — OFIC QmR/AM) */ 
S5 — TOM winte e D SPENDSCIRILG?/ = Orteses Ovx? = Os? (R/W) "7 
36 uint32 t RESERVED14[40]; 

5 IM uints2 © D PIEDRA? SEE 
SS IM uimes2 È D PIDRO? SEE 
IE [S MONEE Se Oiid (R J) =/ 
140 IM winEs2 EE D PIDRY? J OEE (0 (Qe) e 
a IM bones. E D PIDRO; [s Queer sd R ) 4 
42 IM wint 15 D TJDIDIEUL S fa Quies Osee (R ) =/ 
43 . HH wim t D PIDRZ? SEE (BY ) =/ 
IE MORRESSE (Ia (e/o 97 
da TIM urnts2 wc D CIDRO; (^5 OrrgerS sS (Qe/ ) 97 
45 — JU uime E D (CIDIEULS [a (Queirscewes Olara (QE D 97 
27 — | IM uint t D CIPR; EEC <=/ 
43 IM mints qc D CIDR ROR ee Ürdsme Qu) 7 
49 

50  /* CPU 接口 端 寄存 器 */ 

51o TOM uin e C C CTR; (4^5 Orres (Ue! (RANT S 
52 IOM minta i (C BMRA 5s (Queftexenes (02 (eA 57 
35 HOME wianrS2 iz (C BER, Ortfsete 0322000 (QUAM) = 
34 JM mt 1 € INR [** Qussewes Ox200€ R ) wf 
55 OM ni t (C BOIR? (^5 Oroes eA. ( AND) ey 
56 IM uint32 t C RPR; /* Offset: Ox2014 (R/ ) */ 
21 IM bones. E C HPPIR; (^s Offset: 032012 (eU = 
58 TOM uint32 t C ABPR; /* Offset: Ox201C (R/W) */ 
59 UM wutenc$2 i (C ALIAR? (^5 Orre (ESAE. (Eu ) m 
60 OM uint32 t C AEOIR; /* Offset: 0x2024 ( /W) */ 
6l IM uint- E (C AHPPIR; (^5 OrreerS 2029 R ) E 
62 uint32 t RESERVED15[41]; 

63 IOM uint32 t C APRO; /* Offset: Ox20D0 (R/W) */ 
64 guine 97 E RIESERVIDLISG| |? 

65 IOM uint32 t C NSAPRO; /* Offset: Ox20E0 (R/W) */ 
66 uint32 t RESERVED17[6]; 

G0 AW uint- C C TIDR; 人 
68 uint32 t RESERVED18[960]; 

5 /'s Quexexews 059000 ( m) */ 


qO p GIC ees 

“示例 代码 17.1.3.2” 中 的 结构 体 GIC. Type 就 是 GIC 控制 器 ， 列 举 除 了 GIC 控制 器 的 所 
有 寄存 器 ， 可 以 通过 结构 体 GIC. Type 来 访问 GIC 的 所 有 寄存 器 。 
第 5 行 是 GIC 的 分 发 器 端 相 关 寄存 器 ， 其 相对 于 GIC 基地 址 偏 移 为 0X1000， 因 此 我 们 获取 到 
GIC 基地 址 以 后 只 需要 加 上 0X1000 即 可 访问 GIC 分 发 器 端 寄存 器 。 
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第 51 行 是 GIC 的 CPU 接口 端 相 关 寄 存 器 ， 其 相对 于 GIC 基地 址 的 偏 移 为 0X2000， 同 样 的 ， 
获取 到 GIC 基地 址 以 后 只 需要 加 上 0X2000 即 可 访问 GIC 的 CPU 接口 段 寄 存 器 。 

那么 问题 来 了 ? GIC 控制 器 的 寄存 器 基地 址 在 哪里 呢 ? 这 个 就 需要 用 到 Cortex-A 的 CP15 协 处 
理 器 了 ， 下 一 小 节 就 讲解 CP15 协 处 理 器 。 
































17.1.4 CP1S 协 处 理 器 


关于 CP15 协 处 理 器 和 其 相关 寄存 器 的 详细 内 容 请 参考 下 面 两 份 文档 : 

(ARM ArchitectureReference Manual ARMv7-A and ARMv7-R edition.pdf》 第 1469 页 “B3.17 
Oranization of the CP15 registers in a VMSA implementation ”。 

(Cortex-A7 Technical ReferenceManua.pdf) 58 55 页 “Capter 4 System Control". 

CP15 协 处 理 器 一 般 用 于 存储 系统 管理 ， 但 是 在 中 断 中 也 会 使 用 到 ，CP15 协 处 理 器 一 共有 
16 个 32 位 寄存 器 。CP15 协 处 理 器 的 访问 通过 如 下 另 个 指令 完成 

MRC: 将 CP15 协 处 理 器 中 的 寄存 器 数据 读 到 ARM 寄存 器 中 。 

MCR: 将 ARM 寄存 器 的 数据 写 入 到 CP15 协 处 理 器 寄存 器 中 。 

MRC 就 是 读 CP15 寄存 器 ，MCR 就 是 写 CP15 寄存 器 ，MCR 指令 格式 如 下 : 

MCR {cond} p15, <opc1>, «Rt», <CRn>, <CRm>, <opc2> 

cond: 指 令 执行 的 条 件 码 ， 如 果 忽略 的 话 就 表示 无 条 件 执行 。 

opcl: 协 处 理 器 要 执行 的 操作 码 。 

Rt: ARM 源 寄存 器 ， 要 写 入 到 CP15 寄存 器 的 数据 就 保存 在 此 寄存 器 中 。 

CRn: CP15 协 处 理 器 的 目标 寄存 器 。 

CRm: 协 处 理 器 中 附加 的 目标 寄存 器 或 者 源 操 作 数 寄存 器 ， 如 果 不 需 要 附加 信息 就 将 
CRm 设置 为 C0， 否 则 结果 不 可 预测 。 

opc2: 可 选 的 协 处 理 器 特定 操作 码 ， 当 不 需要 的 时 候 要 设置 为 0。 

MRC 的 指令 格式 和 MCR 一 样 ， 只 不 过 在 MRC 指令 中 Rt 就 是 目标 寄存 器 ， 也 就 是 从 
CP15 指定 寄存 器 读 出 来 的 数据 会 保存 在 Rt 中 。 而 CRn 就 是 源 寄 存 器 ， 也 就 是 要 读 取 的 写 处 
理 器 寄存 器 。 

假如 我 们 要 将 CP15 中 CO 寄存 器 的 值 读 取 到 R0 寄存 器 中 ， 那 么 就 可 以 使 用 如 下 命令 : 

MRC p15, 0, r0, c0, c0, 0 

CP15 协 处 理 器 有 16 个 32 位 寄存 器 ，c0~c15， 本 章 来 看 一 下 c0. cl. c12 和 c15 这 四 个 寄 
存 器 ， 因 为 我 们 本 章 实验 要 用 到 这 四 个 寄存 器 ， 其 他 的 寄存 器 大 家 参考 上 面 的 两 个 文档 即 可 。 

l. c0 寄存 器 


CP15 协 处 理 器 有 16 个 32 位 寄存 器 ，c0~c15， 在 使 用 MRC 或 者 MCR 指令 访问 这 16 个 
寄存 器 的 时 候 ， 指 令 中 的 CRn、opcl1、CRm 和 opc2 通过 不 同 的 搭配 ， 其 得 到 的 寄存 器 含义 是 
不 同 的 。 比 如 co 在 不 同 的 搭配 情况 下 含义 如 图 17.1.4.1 所 示 : 
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CRn | opc! |  CRm | opc2 
co -4—0—34 ! 0 MIDR, Main ID Register 

i | 上 一 一 1 CTR, Cache Type Register 
l : I2 TCMTR, TCM Type Register, details IMPLEMENTATION DEFINED 
| l I——3 TLBTR, TLB Type Register, details IMPLEMENTATION DEFINED 
l : | 4,7 Aliases of MIDR 
1 1 1— —5 MPIDR, Multiprocessor Affinity Register 
i | I —6 REVIDR, Revision ID Register 
! : 全 上行 ID PFRO, Processor Feature Register 0 * 
! l 小 二 一 和 ID_PFR1, Processor Feature Register 1 * 
| 上 小 一 一 2 ID_DFR0, Debug Feature Register 0 * 
i i 小 一 一 ? ID_AFRO, Auxiliary Feature Register O * 
i | -— ID MMFRO, Memory Model Feature Register O * 
| i -一 一 一 和 ID MMFR1, Memory Model Feature Register 1 * 
I[——3 ID MMFR2, Memory Model Feature Register 2 * 
! 1 ID_MMFR3, Memory Model Feature Register 3 * 
[ 1 c2— 0 ID_ISARO, ISA Feature Register 0 * 
i i i1 ID_ISAR1, ISA Feature Register 1 * 
i : 上 一 一 2 ID_ISAR2, ISA Feature Register 2 * 
l l I3 ID_ISAR3, ISA Feature Register 3 * 
l : 小 一 一 4 ID_ISAR4, ISA Feature Register 4 * 
i | i 一 一 千 ID ISARS, ISA Feature Register 5 * 
: l i -一 一 (6,7 Read-As-Zero 
Sc} 10:7} Read-As-Zero 
! 1 i " 0 CCSIDR, Cache Size ID Registers 
1 1 1 一 一 一 | CLIDR, Cache Level ID Register 
| | I—4$ AIDR, Auxiliary ID Register IMPLEMENTATION DEFINED 
1——2—1———60—34————9 CSSELR, Cache Size Selection Register 
1——4—41— —60——1— —0 VPIDR, Virtualization Processor ID Register + 
! l 1 一 一 VMPIDR, Virtualization Multiprocessor ID Register + 


Em] Read-only [a |Read/Write [— ]write-only * CPUID registers 


? Optional register. If not implemented, the encoding is an alias of the MIDR. 
+ Implemented only as part of the Virtualization Extensions. 


图 17.1.4.1 c0 寄存 器 不 同 搭配 含义 
在 图 17.1.4.1 中 当 MRC/MCR 指令 中 的 CRn=c0，opcl=0，CRm=c0，opc2=0 的 时 候 就 表示 
此 时 的 c0 就 是 MIDR 寄存 器 ， 也 就 是 主 ID 寄存 器 ， 这 个 也 是 c0 的 基本 作用 。 对 于 Cortex-A7 
内 核 来 说 ，c0 作为 MDIR 寄存 器 的 时 候 其 含义 如 图 17.1.4.2 Brzn: 








'31 24:23 20:19 16:15 413 0: 


图 17.1.4.2 c0 作为 MIDR 寄存 器 结构 图 

在 图 17.1.4.2 中 各 位 所 代表 的 含义 如 下 : 

bit31:24: 厂商 编号 ，0X41，ARM。 

bit23:20: 内 核 架 构 的 主 版 本 号 ，ARM 内 核 版 本 一 般 使 用 mpn 来 表示 ， 比 如 r0p1, HP ro 
后 面 的 0 就 是 内 核 架构 主 版 本 号 。 

bit19:16: 架构 代码 ，0XF，ARMv7 架构 。 

bit15:4: 内 核 版 本 号 ，0XC07，Cortex-A7 MPCore 内 核 。 

bit3:0: 内 核 架 构 的 次 版 本 号 ，mpn 中 的 pn， 比如 rOpl 中 pl 后 面 的 1 就 是 次 版 本 号 。 

2. cl 寄存 器 

cl 寄存 器 同样 通过 不 同 的 配置 ， 其 代表 的 含义 也 不 同 ， 如 图 17.1.4.3 所 示 : 
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CRn | opci CRm | opc2 
c1- SCTLR, System Control Register 





ACTLR, Auxiliary Control Register, IMPLEMENTATION DEFINED 
CPACR, Coprocessor Access Control Register 

SCR, Secure Configuration Register t 

SDER, Secure Debug Enable Register t 

NSACR, Non-Secure Access Control Register 十 

HSCTLR, Hyp System Control Register 

HACTLR, Hyp Auxiliary Control Register, IMPLEMENTATION DEFINED + 
HCR, Hyp Configuration Register + 

HDCR, Hyp Debug Configuration Register + 

HCPTR, Hyp Coprocessor Trap Register + 

HSTR, Hyp System Trap Register 1 

HACR, Hyp Auxiliary Configuration Register, IMPLEMENTATION DEFINED + 


[zx] Read-only [d Read/Write m) Write-only 


t Implemented only as part of the Security Extensions 
Implemented only as part of the Virtualization Extensions 


图 17.1.4.3 cl 寄存 器 不 同 搭配 含义 

在 图 17.1.4.3 中 当 MRC/MCR 指令 中 的 CRn=c1，opcl=0，CRm=c0，opc2=0 的 时 候 就 表示 
此 时 的 cl 就 是 SCTLR 寄存 器 ， 也 就 是 系统 控制 寄存 器 ， 这 个 是 cl 的 基本 作用 。SCTLR 寄存 
器 主要 是 完成 控制 功能 的 ， 比 如 使 能 或 者 禁止 MMU. I/D Cache 等 ，cl 作为 SCTLR 寄存 器 的 时 
候 其 含义 如 图 17.1.4.4 所 示 : 

| 30 31 29 28 27 26 25 124 21! 20 19 18 14 13 12 | 11 1019 3012 ! 1 





























图 17.1.4.4 cl 作为 SCTLR 寄存 器 结构 图 














SCTLR 的 位 比较 多 ， 我 们 就 只 看 本 章 会 用 到 的 几 个 位 : 

bit13: V， 中 断 向 量 表 基 地 址 选择 位 ， 为 0 的 话 中 断 向 量 表 基 地 址 为 0X00000000， 软 件 可 
以 使 用 VBAR 来 重 映射 此 基地 址 ， 也 就 是 中 断 向 量 表 重 定位 。 为 1 的 话 中 断 向 量 表 基 地 址 为 
0XFFFF0000， 此 基地 址 不 能 被 重 映射 。 

bit12: I, I Cache 使 能 位 ， 为 0 的 话 关 闭 I Cache, 73 1 的 话 使 能 I Cache. 

bitll: Z， 分 支 预测 使 能 位 ， 如 果 开 启 MMU 的 话 ， 此 为 也 会 使 能 。 

bit10: SW, SWP 和 SWPB 使 能 位 ， 当 为 0 的 话 关闭 SWP 和 SWPB 指令 ， 当 为 1 的 时 候 
就 使 能 SWP 和 SWPB 指令 。 

bit9:3: 未 使 用 ， 保 留 。 

bit2: C, D Cache 和 缓存 一 致 性 使 能 位 ， 为 0 的 时 候 禁止 D Cache 和 缓存 一 致 性 ， 为 1 时 












































bitl: A， 内 存 对 齐 检查 使 能 位 ,为 0 的 时 候 关 闭 内 存 对 齐 检查 ， 为 1 的 时 候 使 能 内 存 对 齐 














bit: M, MMU 使 能 位 ， 为 0 的 时 候 禁 止 MMU， 为 1 的 时 候 使 能 MMU。 
如 果 要 读 写 SCTLR 的 话 ， 就 可 以 使 用 如 下 命令 : 

MRC p15, 0, <Rt>, cl, c0, 0. ; 读 取 SCTLR 寄存 器 ， 数 据 保存 到 Rt 中 。 
MCR p15, 0, «Rt», cl,c0,0 ;将 Rt 中 的 数据 写 到 SCTLR(c1) 寄 存 器 中 。 

2. cl2 寄存 器 

c12 寄存 器 通过 不 同 的 配置 ， 其 代表 的 含义 也 不 同 ， 如 图 17.1.4.4 所 示 : 
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CRn | T i : opc2 
c12 i — VBAR, Vector Base Address Register + 
l " L3 MVBAR, Monitor Vector Base Address Register t 
| a— 1 ISR, Interrupt Status Register T 
l — g HVBAR, Hyp Vector Base Address Register 


[ |] Read-only [ud Read/Write O| Write-only 


t Implemented only as part of the Security Extensions 
Implemented only as part of the Virtualization Extensions 


图 17.1.4.4 c12 寄存 器 不 同 搭配 含义 

在 图 17.1.4.4 中 当 MRC/MCR 指令 中 的 CRn=c12，opcl=0，CRm=c0，opc2=0 的 时 候 就 表 
示 此 时 c12 为 VBAR 寄存 器 ， 也 就 是 向 量 表 基 地 址 寄存 器 。 设 置 中 断 向 量 表 偏 移 的 时 候 就 需要 
将 新 的 中 断 向 量 表 基地 址 写 入 VBAR 中 ， 比 如 在 前 面 的 例 程 中 ， 代 码 链接 的 起 始 地 址 为 
0X87800000， 而 中 断 向 量 表 肯 定 要 放 到 最 前 面 ， 也 就 是 0X87800000 这 个 地 址 处 。 所 以 就 需要 
设置 VBAR 为 0X87800000， 设 置 命令 如 下 : 





























ldrr0, =0X87800000 ; T0=0X87800000 
MCR p15, 0, r0, c12, c0, 0 :将 r0 里 面 的 数据 写 入 到 c12 中 ， 即 c12-0X87800000 
3. c15 寄存 器 


c15 寄存 器 也 可 以 通过 不 同 的 配置 得 到 不 同 的 含义 ， 参 考 文档 《Cortex-A7 Technical 
ReferenceManua.pdf》 第 68 页 “4.2.16 c15 registers”， 其 配置 如 图 17.1.4.5 所 示 : 











CRn Op1 CRm Op2 Name Reset Description 





cl5 3a c0 0 CDBGDRO UNK Data Register 0, see Direct access to internal memory on page 6-9 





1 CDBGDRI UNK Data Register 1, see Direct access to internal memory on page 6-9 


2 CDBGDR2 UNK Data Register 2, see Direct access to internal memory on page 6-9 





c2 0 CDBGDCT UNK Data Cache Tag Read Operation Register, see Direct access to internal 
memory on page 6-9 


1 CDBGICT UNK Instruction Cache Tag Read Operation Register, see Direct access to 
internal memory on page 6-9 


c4 0 CDBGDCD  UNK Data Cache Data Read Operation Register, see Direct access to internal 
memory on page 6-9 


1 CDBGICD UNK Instruction Cache Data Read Operation Register, see Direct access to 
internal memory on page 6-9 


2 CDBGTD UNK TLB Data Read Operation Register, see Direct access to internal memory 
on page 6-9 
4 c0 0 CBAR -b Configuration Base Address Register on page 4-83 


图 17.1.4.5 c15 寄存 器 不 同 搭配 含义 

在 图 17.1.4.5 中 ， 我 们 需要 c15 作为 CBAR 寄存 器 ， 因 为 GIC 的 基地 址 就 保存 在 CBAR 
我 们 可 以 通过 如 下 命令 获取 到 GIC 基地 址 : 
MRC p15, 4, r1, c15, c0, 0 ; 获取 GIC 基础 地 址 ， 基 地 址 保存 在 rl 中 。 
获取 到 GIC 基地 址 以 后 就 可 以 设置 GIC 相关 寄存 器 了 ， 比 如 我 们 可 以 读 取 当前 中 断 ID, 
当前 中 断 ID 保存 在 GICC_IAR 中 ， 寄 存 器 GICC IAR 属于 CPU 接口 端 寄存 器 ， 寄 存 器 地 址 
相对 于 CPU 接口 端 起 始 地 址 的 偏 移 为 0XC， 因 此 获取 当前 中 断 ID 的 代码 如 下 : 

MRC p15,4,r1, c15, c0, 0 ;3XH GIC 基地 址 

ADD rl, r1, #0X2000 ;GIC 基地 址 加 0X2000 得 到 CPU 接口 端 寄存 器 起 始 地址 
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LDR r0, [r1, #0XC] ; 读 取 CPU 接口 端 起 始 地 址 +0XC 处 的 寄存 器 值 , 也 就 是 寄存 器 
;GIC. IAR 的 值 


关于 CP15 协 处 理 器 就 讲解 到 这 里 ， 简 单 总 结 一 下 ， 通 过 cO 寄存 器 可 以 获取 到 处 理 器 内 
核 信 息 ; 通过 cl 寄存 器 可 以 使 能 或 禁止 MMU, ID Cache 等 ; 通过 c12 寄存 器 可 以 设置 中 断 
向 量 偏 移 ， 通 过 cl5 寄存 器 可 以 获取 GIC 基地 址 。 关 于 CP15 的 其 他 寄存 器 ， 大 家 自行 查阅 本 
节 前 面 列 举 的 2 份 ARM 官方 资料 。 





















































17.1.5 中 断 使 能 


中 断 使 能 包括 两 部 分 ， 一 个 是 IRQ 或 者 FIQ 总 中 断 使 能 ， 另 一 个 就 是 ID0~ID1019 这 1020 
个 中 断 源 的 使 能 。 

1、IRQ 和 FIQ 总 中 断 使 能 

IRQ 和 FIQ 分 别 是 外 部 中 断 和 快速 中 断 的 总 开关 ， 就 类 似 家 里 买 的 进 户 总 电 间 ， 然 后 
ID0~ID1019 这 1020 个 中 断 源 就 类 似 家 里 面 的 各 个 电器 开关 。 要 想 开 电视 ， 那 肯定 要 保证 进 户 
总 电疗 是 打开 的 ， 因 此 要 想 使 用 LMX6U 上 的 外 设 中 断 就 必须 先 打 开 IRQ 中 断 (本 教程 不 使 用 
FIQ)。 在 “6.3.2 程序 状态 寄存 器 ”小 节 已 经 讲 过 了 ， 寄 存 器 CPSR 的 三 1 禁止 IRQ， 当 天 0 使 
能 IRQ; F=1 禁止 FIQ，F=0 使 能 FIQ。 我 们 还 有 更 简单 的 指令 来 完成 民 Q 或 者 FIQ 的 使 能 和 
禁止 ， 图 表 17.1.5.1 所 示 : 







































































cpsid i 禁止 IRQ 中 断 。 
cpsie 1 使 能 IRQ PE. 
cpsid f 禁止 FIQ 中 断 。 
cpsie f 使 能 FIQ 中 断 。 








K 17.1.51 开关 中 断 指 令 

2、ID0~ID1019 中 断 使 能 和 禁止 

GIC 寄存 器 GICD ISENABLERn 和 GICD ICENABLERn 用 来 完成 外 部 中 断 的 使 能 和 禁 
止 ， 对 于 Cortex-A7 内 核 来 说 中 断 ID 只 使 用 了 512 个 。 一 个 bit 控制 一 个 中 断 ID 的 使 能 ， 那 么 
就 需要 512/32=16 个 GICD ISENABLER 寄存 器 来 完成 中 断 的 使 能 。 同 理 ， 也 需要 16 个 
GICD ICENABLER 寄存 器 来 完成 中 断 的 禁止 。 其 中 GICD ISENABLERO 的 bit[15:0] 对 应 
ID15~0 的 SGI 中 断 ，GICD ISENABLERO 的 bit[31:16] 对 应 ID31-16 的 PPI 中 断 。 剩 下 的 
GICD ISENABLERI-GICD ISENABLERIS 就 是 控制 SPI 中 断 的 。 























17.1.6 中 断 优先 级 设置 


1、 优 先 级 数 配置 

学 过 STM32 都 知道 Cortex-M 的 中 断 优先 级 分 为 抢占 优先 级 和 子 优先 级 ， 两 者 是 可 以 配置 
的 。 同 样 的 Cortex-A7 的 中 断 优先 级 也 可 以 分 为 抢占 优先 级 和 子 优先 级 ， 两 者 同样 是 可 以 配置 
的 。Cortex-A7 最 多 可 以 支持 256 个 优先 级 ， 数 字 越 小 ,优先 级 越 高 ! 半导体 厂商 自行 决定 选择 
多 少 个 优先 级 。I.MX6U 选择 了 32 个 优先 级 。 在 使 用 中 断 的 时 候 需 要 初始 化 GICC_PMR 寄存 
器 ， 此 寄存 器 用 来 决定 使 用 几 级 优先 级 ， 寄 存 器 结构 如 图 17.1.6.1 所 示 ; 


31 8:7 0: 
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图 17.1.6.1 GICC_PMR 寄存 器 
GICC PMR 寄存 器 只 有 低 8 位 有 效 ， 这 8 位 最 多 可 以 设置 256 个 优先 级 ， 其 他 优先 级 数 设 
置 如 表 17.1.6.1 HZR: 











11111111 256 个 优先 级 。 























11111110 128 个 优先 级 。 
11111100 64 个 优先 级 。 
11111000 32 个 优先 级 
11110000 16 个 优先 级 。 





表 17.1.6.1 优先 级 数 设置 

LMX6U 支持 32 个 优先 级 ， 所 以 GICC_PMR 要 设置 为 0b11111000。 

2、 抢 占 优先 级 和 子 优先 级 位 数 设置 

抢占 优先 级 和 子 优先 级 各 占 多 少 位 是 由 寄存 器 GICC_BPR 来 决定 的 , GICC. BPR 寄存 器 结 
构 如 图 17.1.6.2 所 示 : 

31 312 0 
图 17.1.6.2 GICC. BPR 寄存 器 结构 图 

寄存 器 GICC_BPR 只 有 低 3 位 有 效 ,其 值 不 同 ,抢占 优先 级 和 子 优先 级 占用 的 位 数 也 不 同 ， 

配置 如 表 17.1.6.2 所 示 : 




















[7:1] | [0] 7 级 抢占 优先 级 ，1 级 子 优先 级 。 





















































0 

1 [7:2] [1:0] 6 级 抢占 优先 级 ，2 级 子 优先 级 。 
2 [7:3] [2:0] 5 级 抢占 优先 级 ，3 级 子 优先 级 。 
3 [7:4] [3:0] 4 级 抢占 优先 级 ，4 级 子 优 先 级 。 
4 [7:5] [4:0] 3 级 抢占 优先 级 ，5 级 子 优先 级 。 
5 [7:6] [5:0] 2 级 抢占 优先 级 ，6 级 子 优 先 级 。 
6 [7:7] [6:0] 1 级 抢占 优先 级 ，7 级 子 优先 级 。 
7 无 [7:0] 0 级 抢占 优先 级 ，8 级 子 优先 级 。 

K 17.1.6.2 GICC BPR 配置 表 
为 了 简单 起 见 ， 一 般 将 所 有 的 中 断 优 先 级 位 都 配置 为 抢占 优先 级 ， 比 如 ILMX6U 的 优先 级 








位 数 为 5(32 个 优先 级 ), 所 以 可 以 设置 Binary point 为 2, 表示 5 个 优先 级 位 全 部 为 抢占 优先 级 。 
3、 优 先 级 设置 
前 面 已 经 设置 好 了 I.MX6U 一 共有 32 个 抢占 优先 级 ,数字 越 小 优先 级 越 高 。 具 体 要 使 用 某 

个 中 断 的 时 候 就 可 以 设置 其 优先 级 为 0~31。 某 个 中 断 ID 的 中 断 优先 级 设置 由 寄存 器 

D IPRIORITYR 来 完成 ， 前 面 说 了 Cortex-A7 使 用 了 512 个 中 断 ID， 每 个 中 断 ID 配 有 一 个 优 

先 级 寄存 器 ， 所 以 一 共有 512 个 D IPRIORITYR 寄存 器 。 如 果 优 先 级 个 数 为 32 的 话 ， 使 用 寄 

存 器 D_IPRIORITYR 的 bit7:4 来 设置 优先 级 ， 也 就 是 说 实际 的 优先 级 要 左 移 3 位 。 比 如 要 设置 

ID40 中 断 的 优先 级 为 5， 示 例 代码 如 下 : 

GICD IPRIORITYR[40] = 5 << 3; 

有 关 优 先 级 设置 的 内 容 就 讲解 到 这 里 ， 优 先 级 设置 主要 有 三 部 分 : 

(D、 设 置 寄存 器 GICC_PMR， 配 置 优先 级 个 数 ， 比 如 I.MX6U XIF 32 级 优先 级 。 
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@、 设 置 抢 占 优 先 级 和 子 优先 级 位 数 ， 一 般 为 了 简单 起 见 ， 会 将 所 有 的 位 数 都 设置 为 抢占 
优先 级 。 

(3)、 设 置 指定 中 断 ID 的 优先 级 ， 也 就 是 设置 外 设 优先 级 。 








17.2 硬件 原理 分 析 
本 试验 用 到 的 硬件 资源 和 第 十 五 章 的 硬件 资源 一 模 一 样 。 
17.3 试验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光 盘 -> 1、 裸 机 例 程 -> 9_int。 
本 章 试验 的 功能 和 第 十 五 章 一 样 ， 只 是 按键 采用 中 断 的 方式 处 理 。 当 按 下 按键 KEY0 以 后 
就 打开 蜂 鸣 器 ， 再 次 按 下 按键 KEY0 就 关闭 蜂 鸣 器 。 在 第 十 六 章 的 试验 上 完成 本 章 试验 。 



































17.3.1 移植 SDK 包 中 断 相关 文件 

将 SDK 包 中 的 文件 core ca7.h 拷贝 到 本 章 试 验 工 程 中 的 “imx6ul” 文 件 夹 中 ， 参 考试 验 
“9 int” 中 core ca7.h 进行 修改 。 主 要 留 下 和 GIC 相关 的 内 容 ， 我 们 重点 是 需要 core ca7.h 中 
的 10 个 API 函数 ， 这 10 个 函数 如 表 17.3.1.1 所 示 : 








GIC Init 初始 化 GIC. 


























GIC EnableIRQ 使 能 指定 的 外 设 中 断 。 
GIC DisableIRQ 关闭 指定 的 外 设 中 断 。 
GIC AcknowledgeIRQ 返回 中 断 号 。 
GIC_DeactivateIRQ 无 效 化 指定 中 上 断 。 





GIC GetRunningPriority | 获取 当前 正在 运行 的 中 断 优 先 级 。 
GIC SetPriorityGrouping | 设置 抢占 优先 级 位 数 。 
GIC GetPriorityGrouping | 获取 抢占 优先 级 位 数 。 
GIC SetPriority 设置 指定 中 断 的 优先 级 。 
GIC GetPriority 获取 指定 中 断 的 优先 级 。 
表 17.3.1.1 GIC 相关 API 操作 函数 
移植 好 core_ca7.h 以 后 ， 修 改 文件 imx6ul.h， 在 里 面 加 上 如 下 一 行 代码 : 


#include "core ca7.h" 












































17.3.2. 重新 编写 start.S 文件 


重新 在 start. S. 中 输入 如 下 内 容 : 
示例 代码 17.3.2.1 statt.S 文件 代码 


/大 大 大 大 炎炎 大 大 炎炎 大火 炎 炎炎 火炎 炎炎 大 火炎 大大 炎炎 大 大 炎炎 大 大大 大 大 大 大 炎炎 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 





Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 BE Se 





作者 a ABL 

版 本 0 

描述 : I.MX6U-ALPHA/I.MX6ULL 开发 板 启动 文件 ， 完 成 C 环境 初始 化 ， 
c 环境 初始 化 完成 以 后 跳 转 到 c 代码 。 

其 他 2 无 
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论坛 : www.openedv.com 
ES : 初版 V1.0 2019/1/3 左 忠 凯 修改 
v2.0 2019/1/4 左 忠 凯 修改 
添加 中 断 相关 定义 


类 大火 类 火炎 类 类 类 大 类 类 大 大 类 类 大 大 炎炎 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大火 大 大 大 类 大 大 大 类 大 类 大 类 大 大 大 大 大 大 大 类 大 大 大 / 


.global start /* 全 局 标号 */ 


1 
2 
ES 

4  * 描述 : — start 函数 ， 首 先是 中 断 向 量 表 的 创建 
5 #/ 
6 
7 
8 


Nj 

ldr pc, -Reset Handler /* 复位 中 断 nu 

ldr pc, -Undefined Handler  /* E XdHB- $n ud 
9 ldr pc, -SVC Handler /* SVC (Supervisor) P Wr*/ 
10 ldr pc, =PrefAbort_Handler  /* 预 取 终 止 中 断 a 
dal ldr pc, -DataAbort Handler  /* 数据 终止 中 断 5 
12 ldr pc, =NotUsed Handler /* 未 使 用 中 断 A 
l3 ldr pc, -IRQ Handler /* IRQ 中 断 ^x 
14 ldr pc, =FIQ Handler /* FIQ (快速 中 断 ) wy 


15 

16 /* 复位 中 断 */ 

1 Reser Hanclerss 

18 

19 cpsid i /* XB */ 
20 

EI /* X] I, DCache 和 MMU 

22 * 采取 读 - 改 -= 写 的 方式 。 


23 */ 

24 mrc pl5, 0, r0, cl, c0, 0 /* Beels el RO */ 
25 bic r0, r0, 4$(0x1 «« 12) /* iBl&cilyríf, XH]I Cache */ 
26 bic r0, r0, 4$(0x1 «« 2) /* iBl&cilyci, XHID Cache */ 
Du bic t0 O, $022 /* 清除 C1 的 六 位 ， 关 闭 对 齐 检查  */ 
28 bic r0, r0, 4$(0x1 «« 11) /* iül&cilyz4v, XBIAXDM  */ 
29 bic TOs "P0; Ox /* 清除 C1 的 M 位， 关闭 MMU */ 





30 mcr plö, 0, r0, ci, cO, 0 /* X ro PME SAAC CLE */ 
31 


32 
33 dif 0 

34 /* 汇编 版 本 设置 中 断 向 量 表 侦 移 / 
35 ldr r0, 20X87800000 

36 

37 dsb 
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38 isb 

39 wacse 9X9. (0. s. eu. e. 0 

40 dsb 

41 isb 

42 endif 

43 

44 /* 设置 各 个 模式 下 的 栈 指针 ， 

45 * 注意 : IMX6UL 的 堆栈 是 向 下 增长 的 ! 

46 * 扒 栈 指针 地 址 一 定 要 是 4 字 节 地 址 对 齐 的 ! ! ! 

47 * DDR 范围 :0X80000000~0X9FFFFFFF 或 者 0X8FFFFFFF 

48 s 

49 /* 进入 IRQ 模式 */ 

50 mesi se, peu 

Bl bie 1e, x0, mali /* Xt ro 的 低 5 位 清 零 ， 也 就 是 cpsr 的 MO~M4 */ 
orr z0, z0, POZ /* r0 或 上 0x12, RIE IRQ 模式 */ 
58 msr cpsr, r0 /* 将 r0 的 数据 写 入 到 cpsr 中 */ 
54 ldr sp, 20x80600000 /* IRQ 模式 栈 首 地 址 为 0X80600000, 大 小 为 2MB */ 
55 

56 /* 进入 SYS 模式 */ 

517] mes sc, epe 

58 bic r0, r0, 4Ox1f /* 将 r0 的 低 5 位 清 零 ， 也 就 是 cpsr 的 MO~M4 */ 
59 orr rO, rO, WORlE /* ro 或 上 0x13, 表 示 使 用 SYS 模式 A 
60 msr cpsr, r0 /* 将 r0 的 数据 写 入 到 cpsr 中 */ 
61 ldr sp, 20x80400000 /* SYS 模式 栈 首 地 址 为 0X80400000, 大 小 为 2MB */ 
62 

63 /* 进入 SVC 模式 */ 

64 ne 0 

65 bic r0, r0, HOxlf /* 将 r0 的 低 5 位 清 零 ， 也 就 是 cpsr 的 MO~M4 — */ 
66 orz rO, z0, Pols /* r0 RE 0x13, 表 示 使 用 svc 模式 
67 msr cpsr, r0 /* 将 r0 的 数据 写 入 到 cpsr 中 */ 
68 ldr sp, 20x80200000 /* SVC 模式 栈 首 地 址 为 0X80200000, 大 小 为 2MB */ 
69 

70 cpsie i /* 打开 全 局 中 断 */ 

qal 

T2 a £o 

73 /* 使 能 IRo 中 断 */ 

74 mrs r0, cpsr /* 读 取 cpsr 寄存 器 值 到 <0 中 wy 
75 bic r0, r0, 40x80 /* 将 r0 寄存 器 中 bit7 清 零 ， 也 就 是 CPSR 中 

76 * 的 工 位 清 零 ， 表 示人 允许 IRO 中 断 

vii */ 

78 msr cpsr, r0 /* 将 r0 重新 写 入 到 cpsr 中 */ 
79 £endif 

80 
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81 b main /* 跳 转 到 main 函数 */ 
82 

2507 WR 

84 Undefined Handler: 

85 ldr r0, -Undefined Handler 

86 bx r0 

87 

88 /* SVC 中 断 */ 

89 SVC Handler: 

90 ldr r0, SVC Handler 

el les se) 

92 

93 /* 预 取 终 止 中 断 */ 

9 PrefAbort handlers 

95 lehe r0, SPrerAbOrt kencier 

96 bx r0 

9n 

98 /* 数据 终止 中 断 */ 

Donecenlor ee 

100 ldr r0, -DataAbort Handler 

101 los 20 

LOZ 

103 /* RERE */ 

TOZ NorUsec Handlers 

105 

106 ldr r0, zNotUsed Handler 

IRON bx r0 

108 

109 /* IRQ'HWE! EHI 1113 / 

1110) TRO LS 

113 push {1r} /* 保存 1r 地 址 */ 

(itg push (r0-r3, r12) /* EF r0-r3, r12 寄存 器 */ 

3531585] 

IAA ames) zc). (joue /* 读 取 spsr 寄存 器 a 

115 push {r0} /* 保存 spsr 寄存 器 */ 

116 

117 mrc p15, 4, rl, c15, c0, O /* 将 cP15 的 Cc0 内 的 值 到 R1 寄存 器 中 

118 * 参考 文档 ARM Cortex-A(armV7) 编程 手册 V4.0.pdf P49 
TLS) * Cortex-A7 Technical ReferenceManua.pdf P68 P138 
120 A 

121 add rl, rl, $0x2000 /* cic 基地 址 加 0X2000， 得 到 cpu 接口 端 基地 址 */ 
122 ldr r0, [rl, #0XC]  /* CPU 接口 端 基地 址 加 0X0C 就 是 GICC IAR 寄存 器 ， 
123 * GICC IAR 保存 着 当前 发 生 中 断 的 中 断 号 ， 我 们 要 根据 





431 


e31E m B 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 
































原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
124 * 这 个 中 断 号 来 绝对 调用 哪个 中 断 服 务 函 数 

125 i 

126 push (r0, rl) /* IF r0, r1 */ 
10207. 

128 cps #0x13 /* 进入 SVC 模式 ， 人 允许 其 他 中 断 再 次 进去 i 
121) 

130 push (lr) /* 保存 SVC 模式 的 lr 寄存 器 */ 
Td ldr r2, zsystem irqghandler /* 加 载 c 语言 中 断 处 理 函数 到 v2 寄存 器 中 */ 
132 bis r2 /* 运行 C 语言 中 断 处 理 函数 ， 带 有 一 个 参数 */ 
29 

134 pop {1r} /* 执行 完 c 语言 中 断 服务 函数 ，1r 出 栈 */ 
135 cps #0x12 /* 进入 IRQ 模式 = 
136 poo (0, sy 

137 str ro, [rl, 40x10] /* HETAT EN., 5 EOIR */ 
MESES 

139 pop (r0) 

140 mer SOSE oc Mira) /* WA spsr wh 
141 

142 pop (0-3, 12 /* r0-r3,r12 出 栈 */ 
143 pop {lr} /* lr HM i 
144 suos pe, lx, /* 将 1r-4 赋 给 pc */ 
145 


146 /* FIQ 中 断 */ 
1417 PIO Hancilers 


148 
149 ldr r0, -FIQ Handler 
T 50 bx r0 





第 6 到 14 行 是 中 断 向 量 表 ，17.1.2 小 节 已 经 讲解 过 了 。 
第 17 到 81 行 是 复位 中 断 服务 函数 Reset Handler, 第 19 行 先 调用 指令 “cpsid i” 关 闭 IRQ, 
第 24 到 30 行 是 关闭 ID Cache、MMU、 对 齐 检 测 和 分 支 预测 。 第 33 行 到 42 行 是 汇编 版 本 的 
中 断 向 量 表 重 映射 。 第 50 到 68 行 是 设置 不 同 模式 下 的 sp 指针 ， 分 别 设 置 IRQ 模式 、SYS 模 
式 和 SVC 模式 的 栈 指针 ， 每 种 模式 的 栈 大 小 都 是 2MB 。 第 70 行 调用 指令 “cpsie i” 重 新 打开 
IRQ 中 断 ， 第 72 到 79 行 是 操作 CPSR 寄存 器 来 打开 IRQ 中 断 。 当 初始 化 工作 都 完成 以 后 就 可 
以 进入 到 main 函数 了 ， 第 81 行 就 是 跳 转 到 main 函数 。 

第 110 到 144 行 是 中 断 服 务 函数 耻 Q_Handler， 这 个 是 本 章 的 重点 ， 因 为 所 有 的 外 部 中 断 
最 终 都 会 触发 RQ 中 断 ， 所 以 IRQ 中 断 服 务 函 数 主 要 的 工作 就 是 区 分 去 当前 发 生 的 什么 中 断 
(中 断 ID)? 然后 针对 不 同 的 外 部 中 断 做 出 不 同 的 处 理 。 第 111 到 115 行 是 保存 现场 ， 第 117 到 
122 行 是 获取 当前 中 断 号 ， 中 断 号 被 保存 到 了 r0 寄存 器 中 。 第 131 和 132 行 才 是 中 断 处 理 的 重 
点 ， 这 两 行 相 当 于 调用 了 函数 system irqhandler， 函 数 system irqhandler 是 一 个 C 语言 函数 ， 
此 函数 有 一 个 参数 ， 这 个 参数 中 断 号 ， 所 以 我 们 需要 传递 一 个 参数 。 汇 编 中 调用 C 函数 如 何 实 
现 参 数 传递 呢 ? 根 据 ATPCS(ARM-Thumb Procedure Call Standard) 定 义 的 函数 参数 传递 规则 , 在 
汇编 调用 C 函数 的 时 候 建 议 形 参 不 要 超过 4 个 ， 形 参 可 以 由 r0~r3 这 四 个 寄存 器 来 传道， 如果 
形 参 大 于 4 个 , 那么 大 于 4 个 的 部 分 要 使 用 堆栈 进行 传递 。 所 以 给 r0 寄存 器 写 入 中 断 号 就 可 以 
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了 函数 system_irqhandler 的 参数 传递 ,在 136 行 已 经 向 r0 寄存 器 写 入 了 中 断 号 了 。 中 断 的 真正 
处 理 过 程 其 实 是 在 函数 system. irqhandler 中 完成 ， 稍 后 需要 编写 函数 stem_irqhandler。 

第 151 行 向 GICC_EOIR 寄存 器 写 入 刚刚 处 理 完 成 的 中 断 号 ， 当 一 个 中 断 处 理 完 成 以 后 必 
须 向 GICC_EOIR 寄存 器 写 入 其 中 断 号 表示 中 断 处 理 完成 。 

第 153 到 157 行 就 是 恢复 现场 。 

第 158 行 中 断 处 理 完 成 以 后 就 要 重新 返回 到 曾经 被 中 断 打 断 的 地 方 运行 ， 这 里 为 什么 要 将 
lr-4 然后 赋 给 pc BE? 而 不 是 直接 将 Ir 赋值 给 pe? ARM 的 指令 是 三 级 流水 线 : 取 指 、 译 指 、 执 
ÍT, pc 指向 的 是 正在 取 值 的 地 址 ， 这 就 是 很 多 书 上 说 的 pc= 当 前 执行 指令 地 址 +8。 比 如 下 面 代 
码 示例 : 

0X2000 MOV R1, RO ;执行 

0X2004 MOV R2, R3 ; 译 指 

0X2008 MOV R4,R5 ; 取 值 PC 

上 面 示 例 代 码 中 , 左 侧 一 列 是 地 址 ， 中 间 是 指令 ， 最 右边 是 流水 线 。 当 前 正在 执行 0X2000 
地 址 处 的 指令 “MOYV R1,R0”, 但 是 PC 里 面 已 经 保存 了 0X2008 地 址 处 的 指令 “MOV R4,R5”。 
假设 此 时 发 生 了 中 断 ， 中 断 发 生 的 时 候 保 存在 Ir 中 的 是 pc 的 值 ， 也 就 是 地 址 0X2008。 当 中 断 
处 理 完 成 以 后 肯定 需要 回 到 被 中 断 点 接着 执行 ， 如 果 直 接 跳 转 到 Ir 里 面 保存 的 地 址 处 (0X2008) 
开始 运行 ,那么 就 有 一 个 指令 没有 执行 ， 那 就 是 地 址 0X2004 处 的 指令 “MOYV R2, R3”， 显 然 这 
是 一 个 很 严重 的 错误 ! 所 以 就 需要 将 lr-4 赋值 给 pc， 也 就 是 pc=0X2004， 从 指令 “MOV R2, 
R3” 开 始 执行 。 
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17.3.3 通用 中 断 驱动 文件 编写 


在 start.S 文件 中 我 们 在 中 断 服 务 函 数 IRQ Handler 中 调用 了 C 函数 system. irqhandler 来 处 
理 具体 的 中 断 。 此 函数 有 一 个 参数 ， 参 数 是 中 断 号 ， 但 是 函数 system_irqhandler 的 具体 内 容 还 
没有 实现 ， 所 以 需要 实现 函数 system irqhandler 的 具体 内 容 。 不 同 的 中 断 源 对 应 不 同 的 中 断 处 
理 函 数 ，LMX6U 有 160 个 中 断 源 ， 所 以 需要 160 个 中 断 处 理 函 数 ， 我 们 可 以 将 这 些 中 断 处 理 
函数 放 到 一 个 数组 里 面 ， 中 断 处 理 函 数 在 数组 中 的 标号 就 是 其 对 应 的 中 断 号 。 当 中 断 发 生 以 后 
函数 system_irqhandler 根据 中 断 号 从 中 断 处 理 函 数 数组 中 找到 对 应 的 中 断 处 理 函 数 并 执行 即 可 。 
在 bsp 目录 下 新 建 名 为 “int” 的 文件 夹 , 在 bsp/int 文件 夹 里 面 创建 bsp_ intc 和 bsp_inth 这 
两 个 文件 。 在 bsp_int.h 文件 里 面 输入 如 下 内 容 : 

示例 代码 17.3.3.1 bsp_int.h 文件 代码 












































































































































1 #ifndef BSP INT H 

2 #define BSP INT H 

3 ime lude mou 

4 /汪汪 类 类 火炎 火炎 火炎 火炎 火炎 类 大 类 大火 类 类 大 类 大 类 大火 火炎 大 类 大 类 大 类 大 类 大 类 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 
Seoev elem © 7 nner (Coo Lec LO9G=20119 Unseen 
6 文件 名 3 bso mrem 

7 ET : AL 

8 版 本 3 Vis0 

9 qx : 中 断 驱 动 头 文件 。 

10 其 他 TE 

$0 WESES : www.openedv.com 

12 Els : 初版 V1.0 2019/1/4 左 忠 凯 创建 





1155) KCKCKCKCKCkCkCkCkCk Ck k Ck k Ck kCk Ck k kCk Ck k Ck k Ck k Ck Ck Ck k Ck k Ck k Ck Ck k Ck kCk Ck k Ck Ck k Ck ck k ck k kck ckckckokckok X ke x k f 
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14 

15 /* 中 断 处 理 函 数 形式 */ 

16 typedef void (*system irq handler t) (unsigned int giccIar, 
void *param); 

I 

18 /* 中 断 处 理 函 数 结构 体 */ 

19 typedef struct sys irq handle 

ZONE 

2l system irq handler t irgHandler; /* 中 断 处 理 函 数 */ 

22 void *userParam; /* 中 断 处 理 函 数 参数 */ 

2 

24 

2 


26 
2 
28 


29 
30 
3l 
92 


VONC abene doie (woeh) p 

uen System irorealbile init (vorc) p 

void system register irqhandler(IROQn Type irq, 
system irg handler © handler, 
void *userParam); 

voie system irghendler (unsigned imt GieeTtar)) e 


VOLC ole Li ne (unsigned mt ee volc tA PUE) p 


Hendi f 
第 16-23 行 是 中 断 处 理 结构 体 ， 结 构 体 sys irq handle tf 包含 一 个 中 断 处 理 函数 和 中 断 处 








理 函 数 的 用 户 参 数 。 一 个 中 断 源 就 需要 一 个 sys_irq handle t 变量 ，LMX6U 有 160 个 中 断 源 ， 





CONES Eo RE E E 





因此 需要 160 个 sys irq handle t 组 成 中 断 处 理 数组 。 





在 bsp int.c 中 输入 如 下 所 示 代 码 : 
示例 代码 17.3.3.2 bsp_intc 文件 代码 





finclude "bsp int.h" 


/汪汪 类 大 火炎 火炎 火炎 类 大 类 类 火炎 类 大 类 大 大大 类 大 类 大火 类 类 大 类 大 类 类 类 火炎 大 类 大 大大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 





文件 名 8 loo sns 

Ed : 左 忠 凯 

版 本 全 

描述 : 中 断 驱 动 文件 。 

其 他 Syn 

论坛 : www.openedv.com 

日 志 : 初版 V1.0 2019/1/4 左 忠 凯 创建 


KCKCKCKCKCKCkCkCkCk Ck k Ck k Ck k Ck k k k Ck k k Ck k Ck k Ck Ck kCk Ck k kCk Ck Ck kCk kCk Ck k Ck k ck k ck k ck k kck kckckok kk X ke x k f 


/* PREA */ 


static unsigned int irgNesting; 


/* 中 断 服 务 函数 表 */ 
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l7 statie sys iro hence t irgrelole [NUMBER (Oy JENMD WIBKCTNOJEASI] } 
18 

















dL) fes 

20 * Qdescription : 中 断 初始 化 函数 

21 * Gparam 2 JE 

22 * Qreturn E 

DIOE 

24 void int init (void) 

25m 

26 GIC Tanith)? /* 初始 化 GIC e 

2 system irqtable init(); /* 初始 化 中 断 表 

28 . Set VBAR((uint32 t)0x87800000); /* 中 断 向 量 表 偏 移 — */ 

29 

30 

NIME x 

32 * Qdescription : 初始 化 中 断 服务 函数 表 

SRSii 2 

34 * Qreturn 8 JE 

SER E 

36 void system irqtable init (void) 

pnl 

38 unsigned int i - 0; 

319 irgNesting = 0; 

40 

41 /* 先 将 所 有 的 中 断 服务 函数 设置 为 默认 值 */ 

42 for(i = 0; i< NUMBER OF INT VECTORS; itt) 

43 { 

44 system register irqhandler( (IROn Type)i, 
default irghandler, 
NULL); 

45 } 

46 } 

47 

48 /* 

49 * (description : 给 指定 的 中 断 号 注册 中 断 服 务 函 数 

50 * @param - irq :OXHAMB HP 

iu S parani handller : 要 注册 的 中 断 处 理 函 数 

52s etam = Usi Pas am : 中 断 服 务 处 理 函 数 参数 

53 * Qreturn 8 Jb 

520 


55 seu system register Lrohandiler(IROn Type ire, 
system irq handler t handler, 


void *userParam) 
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SST 

D irqTable[irq].irqHandler = handler; 

58 irqTable[irq].userParam = userParam; 

S 

60 

GU fw 

62 * Qdescription : C 语言 中 断 服务 函数 ，izq 汇 编 中 断 服务 函数 会 
63 调用 此 函数 ， 此 函数 通过 在 中 断 服 务 列表 中 但 
64 找 指定 中 断 号 所 对 应 的 中 断 处 理 函 数 并 执行 。 

65 * Qparam - giccIar : 中 有 断 号 

66 * @return 8 JE 

5 wy 

68 void system irqghandler(unsigned int giccIar) 

6971 

70 

gal uimtcs2 © imen —3 gelbe © Srk ung 

72 

que /* 检查 中 断 号 是 否 符合 要 求 */ 

74 if ((intNum == 1020) || (intNum >= NUMBER OF INT VECTORS)) 
p { 

76 return; 

qa } 

78 

79 irqNestingtt; /* PREŽI */ 

80 

81 /* 根据 传递 进来 的 中 断 号 ， 在 irgTable 中 调用 确定 的 中 断 服务 函数 */ 

82 irgTable[intNum].irgHandler(intNum, irqTable[intNum].userParam); 
83 


84 irqNesting--; /* PREHRÁTE., FREAR */ 
95 


86 ) 

87 

SEI 

89 * Qdescription : 默认 中 断 服 务 函 数 

O parani oee Tar : 中 断 号 

91 * @param = usrParam : 中 断 服 务 处 理 函 数 参数 
92 * Qreturn 2 zb 

OE) 


5) voici default irghandiler(unsignet] ini glee, Voi sn essen 
95 f 


96 while (1) 
97 { 
98 } 
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DO 

第 14 fTsE XL f —" AE & irqNesting, LA EME J P Wr ER EAN o 

第 17 行 定 了 中 断 服 务 函 数 数 组 irqTable,， 这 是 一 个 sys irq handle t 类 型 的 结构 体 数 组 ， 数 
组 大 小 为 LMX6U 的 中 断 源 个 数 ， 即 160 个 。 

第 24-28 行 是 中 断 初始 化 函数 int_init， 在 此 函数 中 首先 初始 化 了 GIC， 然 后 初始 化 了 中 断 






































服务 函数 表 ， 最 终 设置 了 中 断 向 量 表 偏 移 。 

第 36-46 行 是 中 断 服务 函数 表 初 始 化 函数 system_irqtable_init， 初 始 化 irqTable， 给 其 赋 初 
值 。 

第 55~59 行 是 注册 中 断 处 理 函 数 system register irqhandler， 此 函数 用 来 给 指定 的 中 断 号 注 
册 中 断 处 理 函 数 。 如 果 要 使 用 某 个 外 设 中 断 ， 那 就 必须 调用 此 函数 来 给 这 个 中 断 注册 一 个 中 断 
处 理 函 数 。 
第 68~86 行 就 是 前 面 在 start.S 中 调用 的 system. irqhandler 函数 ， 此 函数 根据 中 断 号 在 中 断 
处 理 函 数 表 irqTable 中 取出 对 应 的 中 断 处 理 函 数 并 执行 。 
第 94-99 行 是 默认 中 断 处 理 函 数 default irqhandler， 这 是 一 个 空 函数 ， 主 要 用 来 给 初始 化 
中 断 函 数 处 理 表 。 





























17.3.4 修改 GPIO 驱动 文件 


在 前 几 章节 试验 中 我 们 只 是 使 用 到 了 GPIO 最 基本 的 输入 输出 功能 ， 本 章 我 们 需要 使 用 
GPIO 的 中 断 功 能 。 所 以 需要 修改 文件 GPIO 的 驱动 文件 bsp_gpio.c 和 bsp_gpio.h， 加 上 中 断 相 
AR. XT GPIO 中 断 内 容 已 经 在 8.1.5 小 节 进 行 了 详细 的 讲解 ， 这 里 就 不 袭 述 了 。 打 开 
bsp_gpio.h 文件 ， 重 新 输入 如 下 内 容 : 

示例 代码 17.3.4.1 bsp_gpio.h 文件 代码 
























































1 4ifndef BSP GPIO H 

2 #define BSP GPIO H 

3 4define BSP KEY H 

4 dinclude "imxó6ul.h" 

5 Ck ckokok KK k kk k KC KCK kk d K KK KK do A KICK kdo K KICK Kock k ROCK Koo kok KK KK 
6 Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
7 文件 名 IE 

SEE : 左 忠 凯 

9 版 本 a Vi 0 

10 描述 : GPIO HRTESCIESESCHIE, 

11 其 他 B JE 

LA P : www.openedv.com 

13 Ela : 初版 V1.0 2019/1/4 左 忠 凯 创 建 

14 V2.0 2019/1/4 左 忠 凯 修 改 

15 添加 GPIO 中 断 相关 定义 

16 

17 OK KICK Kk ok K KK kk kdo K KK k kk ok K KK koc KK KC KORR KK Kee kk Kok eee kx / 
18 

WOES 

20 * 枚 举 类 型 和 结构 体 定义 

a 
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22 typedef enum gpio pin direction 

29 

24 kGPIO DigitalInput = OU, /* 输入 */ 

25 kGPIO DigitalOutput 三 10, /* 输出 */ 

25 ] juo pin direction t? 

2l 

ge 

29 * GPIO 中 断 触发 类 型 枚 举 

SORE 

31 typedef enum gpio interrupt mode 

f 

gs kGPIO NoIntmode = 0U, /* 无 中 断 功能 E 
34 kGPIO IntLowLevel = 1U, /* 低 电 平 触发 wy 
35 kGPIO IntHighLevel = 2U, /* 高 电 平 触发 m 
36 kGPIO IntRisingEdge = 3U, /* 上 升 沿 触 发 */ 
37 kGPIO IntFallingEdge = 4U, /* 下 降 沿 触发 */ 
38 kGPIO IntRisingOrFallingEdge = 5U, /* 上 升 沿 和 下 降 沿 都 触发 ”*/ 
59 j goio interrupt mode i; 

40 

41 /* 

42 * GPIO 配置 结构 体 

ALS eg) 

44 typedef struct gpio pin config 

45 ( 

46 gpio pin direction t direction; /* GPIO 方向 :输入 还 是 输出 */ 
47 uint8 t outputLogic; /* 如 果 是 输出 的 话 ， 默 认输 出 电 平 */ 


48 gpio interrupt mode t interruptMode;  /* DIS */ 
29 ]. golo pin comitig ©? 
50 
sA 
52 /* PUERPIH] */ 
53 VOLC Guo imn ((GP IO Type base, imc pam, Goilo pin (CXomurig; i "eem ig) s 
54 imt goio pinreec (GLIO Typs “base, inr DINn)? 
55 vorc gpio pinwrite(CLIO Type base, int pin, lot value), 
56 voici gopio imteoniig(GCPITO Typew base, Unsigned int Pin, 
gpio interrupt mode t pinInterruptMode); 

37 voici gopio cusislkeub (GEO Typen base, UNSIGAEC Tat Pim)? 
55 voie gpio Cisableint(CPIO Types base, Unsigned Ime pim) p 
50 voici gopio elearintileage(CPIO Toe bese, unsigned int pin)? 
60 
61 endif 

相 比 前 面试 验 的 bsp gpio.h 文件 ,“ 示 例 代 码 17.3.3.2” 中 添加 了 一 个 新 枚 举 类 型 : 
gpio interrupt mode t, 枚 举 出 了 GPIO 所 有 的 中 断 触 发 类 型 ,还 修改 了 结构 体 gpio_pin_ config t; 
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在 ， 在 里 面 加 入 了 interruptMode 成 员 变 量 。 最 后 就 是 添加 了 一 些 跟 中 断 有 关 的 函数 声明 ， 
bsp_gpio.h 文件 的 内 容 总 体 还 是 比较 简单 的 。 
打开 bsp gpio.c 文件 ， 重 新 输入 如 下 代码 : 
二 


























1  £include "bsp gpio.h" 

2 DK KK KICK KO KK ROI KK KK Kk KK KK KK KK KK RC KORR OK OK ROI ROI ROI RO 
3 Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
4 ”文件 名 a bao Goose 

PIE : 左 忠 凯 

6 ”版 本 3 VL 0 

7 DAR : GPIO Nl ve 

8 其 他 SIE 

9 ”论坛 : www.openedv.com 

10 EDS : 初版 V1.0 2019/1/4 左 忠 凯 创建 

11 V2.0 2019/1/4 左 忠 凯 修改 : 

12 修改 gpio init O HR xE FIE. 

13 添加 gpio_intconfig O 函数 ， 初 始 化 中 断 

14 添加 gpio enableint () 函数 ， 使 能 中 断 

15 添加 gpio clearintflags O 函数 ， 清 除 中 断 标志 位 

16 

d'y OKCKCKCKCkCKCkCk kCkCk kCk k Ck kCkCk kCk ck k kc k k kk Ck k Ck Ck kCk Ck k kk k kc k k kc k Ck kck ck kck ck ckck ck ckck ck kck c ke kx f 
18 

Jg. 

20  * Qdescription : GPIO 初始 化 。 

21  * Qparam - base : 要 初始 化 的 GPIO 组 。 

22  * (param - pin : 要 初始 化 cero 在 组 内 的 编号 。 

23  * Qparam - config : GPIO 配置 结构 体 。 

2 3 JE 

25 wi 

2$ void goio init (CRPIO Type "Dase, int pin, golo pin contig © “entlg) 
PEE 

28 base-»IMR &- ~(1U << pin); 

29) 

30 if(config-»direction == kGPIO DigitalInput)  /* GPIO 作为 输入 */ 
Sub { 

22 base->GDIR &= ~( 1 << pin); 

BS } 

34 else /* Hx 

25 { 

36 base->GDIR |= 1 << pin; 

3 gpio pinwrite(base,pin, config-»outputLogic);/* 设置 默认 电 平 */ 
38 ) 

39 gpio intconfig(base, pin, config-»interruptMode);/* 中 断 功 能 配置 */ 


439 


LMX6U AR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教学 : www.yuanzige.com 论坛 :Www.opendev.com 
40 ) 

41 

AX 

43  * Qdescription : 读 取 指定 GPIO 的 电 平 值 。 

44  * Qparam - base : 要 读 取 的 GPIO 组 。 

45 * (param - pin : 要 读 取 的 GPIO 脚 号 。 

46  * Greturn 3 JE 

47 */ 

48 int gpio pinread(GPIO Type *base, int pin) 
49 { 

50 return (((base->DR) >> pin) & 0x1); 

51 f 

52 

DE 


54 * Qdescription : 指定 GPIO 输出 高 或 者 低 电 平 。 
55  * Qparam ee 


56  * Qparam - pin  : ZH GPIO MG. 

57  * (param - value : 要 输出 的 电 平 ，1 输出 高 电 平 ， 0 输出 低 低 电 平 
58  * Qreturn TE 

59 */ 


510. void pio pinwrite(GCPIO Type base, ini pin, imt value) 
Ga 


62 if (value == 0U) 

63 { 

64 base-»DR &= ~(1U << pin); /* 输出 低 电 平 */ 

65 } 

66 else 

Gn { 

68 base->DR |= (1U << pin); /* 输出 高 电 平 */ 

69 } 

qo 

EIE 

Ja gy 

73  * Qdescription : 设置 SGPIO 的 中 断 配 置 功能 
74  * Qparam - base : 要 配置 的 IO 所 在 的 GPIO 组 。 
75  * (param - pin : 要 配置 的 GPIO 脚 号 。 

76  * Qparam - pinInterruptMode: 中 断 模式 ， 参 考 Golo abantrieweiewUguE moce t 
71] o s Qreturn E XE 

Rhe. my 


179) void goio inteconiig(GEIO Types base, wusibsumex! int piny 
golo Interrupt mode i: pin int mode) 
80 { 


81 volatile vinto © “ICES 
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82 gung 32 i TerSnifty 

83 

84 SE = poule 

85 

86 base-»EDGE SEL &= ~(1U << pin); 

87 

88 if(pin « 16) /* f& 164r */ 

89 { 

90 icr = &(base-»ICR1); 

9i } 

92 else /* Pied */ 

93 { 

94 icr = &(base->ICR2); 

9S ahexeSlmalitie = Ip 

96 } 

97 switch(pin int mode) 

98 { 

99 case(kGPIO IntLowLevel): 

100 *icr &- «(3U «« (2 * icrShift)); 

LON break; 

102 case(kGPIO IntHighLevel): 

103 Wer = (icr & (ete << (2 t* shessSuedute» pp)» | 
(Gig «eS (UU ow sessi) p 

104 break; 

OS case(kGPIO IntRisingEdge): 

106 xer E (oues B (eU cs (Q2 t9 TS Dp)» 
(ZU. «x ((U vr exeat) ) p 

TON break; 

108 case(kGPIO IntFallingEdge): 

109 wee |S (XU «€x (UU 9 ESET) a 

IT) break; 

TESTA case(kGPIO IntRisingOrFallingEdge): 

35312 base-»EDGE SEL |2 (iU << pin); 

ITS break; 

114 default: 

33; break; 

116 ) 

MILU I 

iie 

S yS 

120 * Qdescription : 使 能 GPIO 的 中 断 功 能 

121 * (Qparam - base : 要 使 能 的 10 所 在 的 GPIO 组 。 

122 * Q8param = pin : 要 使 能 的 GPIO 在 组 内 的 编号 。 
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123 * Qreturn 8 JE 
ju, ea 


125 void goio enableilnt (CLIO Tyser base, Unsignsc! im Pim) 
126 ( 


27, base-»IMR |= (1 << pin); 

128 } 

112219) 

Toom 

131 * Qdescription : 禁止 GPIO 的 中 断 功能 

132 * Qparam - base : 要 禁止 的 ro 所 在 的 SPIO 组 。 
133 * Gparam - pin : 要 禁止 的 GPIO 在 组 内 的 编号 。 
134 * Qreturn s JE 

IS Ay 


136 void gpio disableint(GPIO Type* base, unsigned int pin) 
13701 


B38 base->IMR &= ~(1 << pin); 

IESE i) 

140 

TA y 

142 * (description : 清除 中 断 标 志 位 ( 写 1 清除 ) 
143 * Qparam - base : 要 清除 的 Io 所 在 的 GPIO 组 。 
144 * Qparam - pin : 要 清除 的 GPIO MIH. 

145 * Greturn 8 Jb 

dL < 


IG void eon rm ee unsigned! ime piim) 
148 { 
149 base->ISR |= (1 << pin); 
TOORN 
在 bsp_gpio.c 文件 中 首先 修改 了 gpio init 函数 ， 在 此 函数 里 面 添加 了 中 断 配置 代码 。 男 外 
也 新 增加 了 4 个 函数 ， 如 下 : 

gpio intconfig: 配置 GPIO 的 中 断 功 能 。 

gpio enableint: GPIO 中 断 使 能 函数 。 

gpio disableint: GPIO 中 断 禁 止 函 数 。 

gpio clearintflags: GPIO 中 断 标 志 位 清除 函数 。 

bsp gpio.c 文件 重点 就 是 增加 了 一 些 跟 GPIO 中 断 有 关 的 函数 ， 都 比较 简单 。 




















17.3.5 按键 中 断 驱动 文件 编写 


本 例 程 的 目的 是 以 中 断 的 方式 编写 KEY 按键 驱动 ， 当 按 下 KEY 以 后 触发 GPIO 中 断 ， 然 
后 在 中 断 服务 函数 里 面 控制 蜂 鸣 器 的 开关 。 所 以 接 下 来 就 是 要 编写 按键 KEY 对 应 的 
UARTI CTS 这 个 IO 的 中 断 驱 动 , 在 bsp 文件 夹 里 面 新 建 名 为 “exit” 的 文件 夹 , 然后 在 bsp/exit 
里 面 新 建 bsp_exit.c 和 bsp_exit.h 两 个 文件 。 在 bsp_exit.h 文件 中 输入 如 下 代码 : 
示例 代码 17.3.5.1 bsp_exith 文件 代码 
1 #ifndef BSP EXIT H 
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$define BSP EXIT H 


2 
3 />kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
4 Copyright O zuozhongkai Co., Ltd. 1998-2019. AlII rights reserved. 
5 XC TEMA : bsp exit.h 
G ERT : 左 忠 凯 

7 版 本 a V0 

8 描述 : 外 部 中 断 驱 动 头 文件 。 

9 其 他 : 配置 按键 对 应 的 GPIP 为 中 断 模式 





10 iti : www.openedv.com 
1d Es : 初版 V1.0 2019/1/4 左 忠 凯 创建 





12 KCKCKCKCkCKCkCkCk Ck k kk k kk k kCkCk k kk k kk k kc k Ck k Ck Ck kCkCk k kc k k kk k kc k Ck kck ck kck ck ckck ck ckckck kk kx kx f 


ls me tee Verbis o DULL dt^ 


15 /* EUERRIH] */ 
16 void exit init(void); /* 中 断 初始 化 */ 
17 void gpiol io18 irqghandler(void);  /* 中 断 处 理 函 数 */ 


19 #endif 
bsp exith 就 是 函数 声明 ， 很 简单 。 接 下 来 在 bsp exit.c 里 面 输入 如 下 内 容 : 
示例 代码 17.3.5.2 bsp. exit.c 文件 代码 


J[ KCRCKCKCk kk kk kk kk kk kk kk kk kk kk kk kc kk kk kck kckckck ckck ckck ckck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ckck ok 








Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 -see 
作者 : 左 忠 凯 
版 本 -eal 
描述 : 外 部 中 断 驱 动 。 
其 他 : 配置 按键 对 应 的 GPIP 为 中 断 模 式 
论坛 : www.openedv.com 
RE : 初版 V1.0 2019/1/4 左 忠 凯 创建 
OK kk kokoK KC KK Kk ok K KICK do KCKCK KO KC KCKCK KOC ok K KOK Kee kokok Kock koe ek ko ee / 
1 #include "bsp exit.h" 
2 Jinclude "bsp gpio. n" 
3 4include "bsp int.h" 
dinolude Tbsp delay.-hn" 
5 #include "bsp beep.h" 
6 
y 
8 


/* 
* Qdescription : 初始 化 外 部 中 断 
9 * Qparam s JE 
10 * Greturn 3 Jb 
do wy 
ESG 
T3074 
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14 golo pin Contig © key eo 

T5 

16 ] is RE TO AR] = 

17] IOMUXC SetPinMux (IOMUXC UART1 CTS B GPIO1 IO18 210) 

18 IOMUXC SetPinConfig(IOMUXC UART1 CTS B GPIO1 IO18,0xF080); 

19 

20 /* 2、 初始 化 cPIO 为 中 断 模 式 */ 

2 key config.direction = kGPIO DigitallInput; 

22 key config.interruptMode - kGPIO IntFallingEdge; 

2:3 key config.outputLogic = 1; 

24 golo init(GPIOl1, 18, &key config); 

25 /* 3、 使 能 GIC 中 断 、 注 册 中 断 服务 函数 、 使 能 GPIO 中 断 */ 

26 GIC EnableIRQ(GPIOl Combined 16 31 TRON) ? 

zu system register irqhandler(GPIO1 Combined 16 31 IROn, 
(system irg handler ic) egouol le le 
NULL) ; 

28 goio enablerint (GPIOL, 12) 

29) 

30 

Sb fus 

32 * (description : GPIOl1 IO18 最 终 的 中 断 处 理 函 数 

33 * param S JE 

34 * Qreturn s JE 

oo, 

36 void gpiol io18 irghandler (void) 

3S 

38 static unsigned char state = 0; 

239 

40 Ma 














41 * 采 用 延 时 消 拌 ， 中 断 服务 函数 中 禁止 使 用 延 时 函数 ! 因为 中 断 服务 需要 
42 * 快 进 快 出 ! ! 这 里 为 了 演示 所 以 采用 了 延 时 函数 进行 消 拌 ， 后 面 我 们 会 讲解 
43 *x 定 时 器 中 断 消 抖 法 ! ! ! 














44 wy 

45 

46 delay(10); 

47 if(gpio pinread(GPIO1, 18) == 0) /* 按键 按 下 了 */ 
48 { 

49 state = !state; 

50 beep switch(state); 

5l } 

52 

58 gpio clearintflags(GPIOl, 18); /* 清除 中 断 标 志 位 */ 
54 ) 
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bsp exit.c 文件 只 有 两 个 函数 exit init 和 gpiol io18 irqhandler;exit init 是 中 断 初始 化 函数 。 
第 14-24 行 都 是 初始 化 KEY 所 使 用 的 UARTI. CTS 这 个 IO， 设 置 其 复 用 为 GPIO1 IO18， 然 
后 配置 GPIO1_ IO18 为 下 降 沿 触发 中 断 。 重点 是 第 26~28 fT, 在 26 行 调用 函数 GIC_EnableIRQ 
来 使 能 GPIO_IO18 所 对 应 的 中 断 总 开关 ,I.MX6U 中 GPIO1 1016-1031 这 16 个 IO 共用 ID99。 
27 行 调用 函数 system_register_irqhandler 注册 ID99 所 对 应 的 中 断 处 理 函 数 ，GPIO1_ IO16-1031 
这 16 个 IO 共用 一 个 中 断 处 理 函 数 ， 至 于 具体 是 哪个 IO 引起 的 中 断 ， 那 就 需要 在 中 断 处 理 函 
数 中 判断 了 。28 行 通过 函数 gpio_enableint 使 能 GPIO1 IO18 这 个 IO 对 应 的 中 断 。 

函数 gpiol io18_irqhandler 就 是 27 行 注 册 的 中 断 处 理 函 数 ， 也 就 是 我 们 学 习 STM32 的 时 
候 某 个 GPIO 对 应 的 中 断 服 务 函 数 。 在 此 函数 里 面 编写 中 断 处 理 代 码 ， 第 50 行 就 是 蜂 鸣 器 开 
关 控 制 代码 ， 也 就 是 我 们 本 试验 的 目的 。 当 中 断 处 理 完 成 以 后 肯定 要 清除 中 断 标 志 位 ， 第 53 
行 调用 函数 gpio_clearintflags 来 清除 GPIO1 IO18 的 中 断 标 志 位 。 
















































































17.3.6 编写 main.c 文件 


在 main.c 中 输入 如 下 代码 : 
示例 代码 17.3.6.1 main.c 文件 代码 


/玉米 类 火 火炎 类 火炎 大大 大大 类 类 类 大 炎炎 大 类 类 大 大 大 类 大 类 大 类 大 大 大 类 大 大 大大 大 类 类 类 大 大 大 类 大 类 大 类 大 类 大 类 大 类 大 大 大 类 大 大 





Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 ne 

















作者 : AMA 

版 本 g Val 

DAR : I.MX6U 开发 板 课 机 实验 9 系统 中 断 实验 
其 他 $. 3l. 

论坛 : Www.openedv .com 

Hi : 初版 V1.0 2019/1/4 左 忠 凯 创建 


KOKCKCKCKCkCkCk Ck k kk kCk Ck Ck kCk Ck kk ck k kc k k kk Ck k Ck Ck k kc k k kc k k kc k Ck kc k kckck ck kck ck ckck ck ckckck sk kc k kx 
JL pinelwde “bso el. 

finclude "bsp delay.h" 

dane el em es ome 

finclude "bsp beep.h" 





ipiimebwweke Moso Gmt -ini 





2 

3 

4 

5 finclude "bsp key.h" 
6 

We ea el ee 
8 


e) em 

10 * Qdescription : main 函数 

11 * param fA 

12 * Qreturn 3 JE 

TSIS 

lA main (Vond) 

We di 

16 unsigned char state - OFF; 

117 

18 ine dinit() p /* 初始 化 中 断 (一 定 要 最 先 调用 ! ) */ 
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19 imx6u clkinit(); /* 初始 化 系统 时 钟 orn 
20 clk enable(); /* 使 能 所 有 的 时 钟 e 
2 led imithe /* 初始 化 led 3 
29 beep init(); /* 初始 化 beep */ 
23 key init(); /* 初始 化 key */ 
24 exit damit (D) p /* 初始 化 按键 中 断 f 
25 

26 while(1) 

2n ( 

28 state = !state; 

29 lee) swabielm (raD, Stats) P 

30 delay(500); 

31 ) 

32 

29 return 0; 

34 ) 


main.c 很 简单 ， 重 点 是 第 18 行 调用 函数 int init 来 初始 化 中 断 系统 ， 第 24 行 调 用 函数 
exit init 来 初始 化 按键 KEY 对 应 的 GPIO 中 断 。 


17.4 编译 下 载 验 证 


17.4.1 编写 Makefile 和 链接 脚本 


在 第 十 六 章 实验 的 Makefile 基础 上 修改 变量 TARGET X int, 在 变量 INCDIRS 和 SRCDIRS 
中 追加 “bsp/exit” 和 bsp/int， 修 改 完成 以 后 如 下 所 示 : 
示例 代码 17.4.1.1 Makefile 文件 代码 





























1 CROSS COMPILE ?2 arm-linux-gnueabihf- 
2 TARGET 25 int 

3 

4 /* AR R A #7 

5 

6. INCDIRS := imx6ul \ 

7 bsp/clk Ñ 

8 bsp/led WV 

9 bsp delay N 
10 bsp/beep \ 
iil Eee 
1g bsp/key V 
13 bsp/exit \ 
14 bsp/int 

t5 

16 SRCDIRS 8e qorojeet \ 

iy bsp/clk wN 

18 bsp/led \ 
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19 bsp/delay \ 
20 bsp/beep ^ 
2 bsp/gpio \ 
22 bsp/key V 
29 bsp/exit N 
24 bsp/int 

2/5 

26 /* 省 略 掉 其 它 代码 ...... = 
2 

28 clean: 








DOE Cm cS OARE Me APC on ARCEn Ime (COBUS (oy 
第 2 行 修改 变量 TARGET X “int”, 也 就 是 目标 名 称 为 “int”。 
第 13、14 行 在 变量 INCDIRS 中 添加 GPIO 中 断 和 通用 中 断 驱 动 头 文件 (.h) 路 径 。 
第 23、24 行 在 变量 SRCDIRS 中 添加 GPIO rp RU Hd rp rs Sc f Cc) EE 
链接 脚本 保持 不 变 。 











17.4.2 编译 下 载 


使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 int.bin 文件 
下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload // 给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

Jimxdownload int.bin /dev/sdd / 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 。 本 试验 效果 其 实 和 试 
验 “8_key” 一 样 ， 按 下 KEY 就 会 打开 蜂 鸣 器 ， 再 次 按 下 就 会 关闭 蜂 鸣 器 。LED0 会 不 断 闪烁 ， 
周期 大 约 500ms。 
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第 十 八 章 EPIT 定时 器 试验 


定时 器 是 最 常用 的 外 设 ， 常 常 需要 使 用 定时 器 来 完成 精准 的 定时 功能 ，I.MX6U 提供 了 多 
种 硬件 定时 器 ,， 有 些 定时 器 功能 非常 强大 。 本 章 我 们 从 最 基本 的 EPIT 定时 器 开始 , 学 习 如 何 配 
置 EPIT 定时 器 , 使 其 按照 给 定 的 时 间 , 周期 性 的 产生 定时 器 中 断 , 在 定时 器 中 断 里 面 我 们 可 以 
做 其 它 的 处 理 ， 比 如 翻转 LED 灯 。 
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18.1EPIT 定时 器 简介 


EPIT 的 全 称 是 : Enhanced Periodic Interrupt Timer， 直 译 过 来 就 是 增强 的 周期 中 断定 时 器 ， 


























它 主要 是 完成 周期 性 中 断定 时 的 。 学 过 STM32 的 话 应 该 知道 ，STM32 里 面 的 定时 器 还 有 很 多 
其 它 的 功能 ， 比 如 输入 捕获 、PWM 输出 等 等 。 但 是 LMX6U 的 EPIT 定时 器 只 是 完成 周期 性 中 
断定 时 的 ， 仅 此 一 项 功能 ! 至 于 输入 捕获 、PWM 输出 等 这 些 功 能 ，LMX6U 有 其 它 的 外 设 来 完 
成 。 

EPIT 是 一 个 32 位 定时 器 ， 在 处 理 器 几乎 不 用 介入 的 情况 下 提供 精准 的 定时 中 断 ， 软 件 使 
能 以 后 EPIT 就 会 开始 运行 ，EPIT 定时 器 有 如 下 特点 : 

Q、 时 钟 源 可 选 的 32 位 向 下 计数 器 。 

@、12 位 的 分 频 值 。 

(@@)、 当 计数 值 和 比较 值 相等 的 时 候 产 生 中 断 。 

EPIT 定时 器 结构 如 图 18.1.1 所 示 : 

Clock off 


ze 
















































ipg_clk 






12 bit Prescaler 
1 .… 4096 







ipg_clk_32k 





ipg_clk_highfreq 







Counter Reload 





Counter Register EPITn_OUT 


32 bit 





Load Register 
32 bit 









interrupt 






Compare Register 
32 bit 





图 18.1.1 EPIT 定时 器 框图 

图 18.1.1 中 各 部 分 的 功能 如 下 : 

GD、 这 是 个 多 路 选择 器 ， 用 来 选择 EPIT 定时 器 的 时 钟 源 ，EPIT 共有 3 个 时 钟 源 可 选择 ， 
ipg clk、 ipg clk 32k 和 ipg clk highfreq。 

@、 这 是 一 个 12 位 的 分 频 器 ， 负 责 对 时 钟 源 进行 分 频 ，12 位 对 应 的 值 是 0~4095， 对 应 着 
1~4096 分 频 。 

@@、 经 过 分 频 的 时 钟 进入 到 EPIT 内 部 ， 在 EPIT 内 部 有 三 个 重要 的 寄存 器 :计数 寄存 器 
(EPIT_CNR)、 加 载 寄 存 器 (EPIT_LR) 和 比较 寄存 器 (EPIT_CMPR)， 这 三 个 寄存 器 都 是 32 位 的 。 
EPIT 是 一 个 向 下 计数 器 ,也 就 是 说 给 它 一 个 初 值 ， 它 就 会 从 这 个 给 定 的 初 值 开始 递减 ， 直 到 减 
为 0, 计数 寄存 器 里 面 保存 的 就 是 当前 的 计数 值 。 如 果 EPIT 工作 在 set-and-forget 模式 下 ， 当 计 
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数 寄存 器 里 面 的 值 减 少 到 0，EPIT 就 会 重新 从 加 载 寄存 器 读 取 数 值 到 计数 寄存 器 里 面 ， 重 新 开 
始 向 下 计数 。 比 较 寄 存 器 里 面 保存 的 数值 用 于 和 计数 寄存 器 里 面 的 计数 值 比 较 ， 如 果 相 等 的 话 
就 会 产生 一 个 比较 事件 。 

©, EPIT 可 以 设置 引 脚 输出 ， 如 果 设 置 了 的 话 就 会 通过 指定 的 引 脚 输出 信号 。 

@@、 产 生 比 较 中 断 ， 也 就 是 定时 中 断 。 

EPIT 定时 器 有 两 种 工作 模式 : set-and-forget 和 free-running， 这 两 个 工作 模式 的 区 别 如 下 : 

set-and-forget 模式 : EPITx CR(x=1，2) 寄 存 器 的 RLD MA 1 的 时 候 EPIT 工作 在 此 模式 
To 在 此 模式 下 EPIT 的 计数 器 从 加 载 寄 存 器 EPITx LR 中 获取 初始 值 , 不 能 直接 向 计数 器 寄存 
器 写 入 数据 。 不 管 什 么 时 候 ， 只 要 计数 器 计数 到 0， 那 么 就 会 从 加 载 寄 存 器 EPITx_LR 中 重新 
加 载 数 据 到 计数 器 中 ， 周 而 复 始 。 

free-running 模式 : EPITx CR 寄存 器 的 RLD 位 清 零 的 时 候 EPIT 工作 在 此 模式 下 ， 当 计数 
器 计数 到 0 以 后 会 重新 从 0XFFFFFFFF 开始 计数 ,并 不 是 从 加 载 寄存 器 EPITx_LR 中 获取 数据 。 

接 下 来 看 一 下 EPIT 重要 的 几 个 寄存 器 ， 第 一 个 就 是 EPIT 的 配置 寄存 器 EPITx_CR， 此 寄 
存 器 的 结构 如 图 18.1.2 所 示 : 



























































Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
R 0 z 0 
I] z 2: z 
CLKSRC OM o E |g |£ 9 
w D z a = 
Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
Bit 9 8 7 6 5 4 2 0 





PRESCALAR 








Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
图 18.1.2 EPITx CR 寄存 器 结构 图 

寄存 器 EPITx CR 我 们 用 到 的 重要 位 如 下 : 

CLKSRC(bit25:24): EPIT 时 钟 源 选 择 位 ， 为 0 的 时 候 关 闭 时 钟 源 ，1 的 时 候选 择 选择 
Peripheral 时 钟 (ipg_clk), 为 2 的 时 候选 择 High-frequency 参考 时 钟 (ipg_clk_highfreq), 为 3 的 时 
候选 择 Low-frequency 参考 时 钟 (ipg_clk_32k)。 在 本 例 程 中 ,我们 设置 为 1， 也 就 是 选择 ipg_clk 
作为 EPIT 的 时 钟 源 ，ipg_clk=66MHz。 

PRESCALAR(bit15:4): EPIT 时 钟 源 分 频 值 , 可 设置 范围 0-4095, 分 别 对 应 1~4096 分 频 。 

RLD(bit3): EPIT 工作 模式 ， 为 0 的 时 候 工作 在 free-running 模式 ， 为 1 的 时 候 工作 在 set- 
and-forget 模式 。 本 章 例 程 设置 为 1， 也 就 是 工作 在 set-and-forget 模式 。 

OCIEN(bit2): 比较 中 断 使 能 位 ,为 0 的 时 候 关 闭 比较 中 断 ， 为 1 的 时 候 使 能 比较 中 断 ， 本 
章 试 验 要 使 能 比较 中 断 。 

ENMOD(bitl): 设置 计数 器 初始 值 ， 为 0 时 计数 器 初始 值 等 于 上 次 关闭 EPIT 定时 器 以 后 
计数 器 里 面 的 值 ， 为 1 的 时 候 来 源 于 加 载 寄存 器 。 

EN(bit0): EPIT 使 能 位 ， 为 0 的 时 候 关 闭 EPIT， 为 1 的 时 候 使 能 EPIT. 

寄存 器 EPITx SR 结构 体 如 图 18.1.3 所 示 : 
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存 器 ， 这 三 个 寄存 器 都 是 用 来 存放 数据 的 ， 很 简单 。 


图 18.1.3 EPITx SR 寄存 器 结构 图 
寄存 器 EPITx SR 只 有 一 个 位 有 效 ， 那 就 是 OCIF(bit0), 这 个 位 是 比较 中 断 标志 位 , 为 0 的 
时 候 表 示 没 有 比较 事件 发 生 ， 为 1 的 时 候 表示 有 比较 事件 发 生 。 当 比较 中 断 发 生 以 后 需要 手动 
清除 此 位 ， 此 位 是 写 1 清 零 的 。 
寄存 器 EPITx LR, EPITx CMPR 和 EPITx CNR 分 别 为 加 载 寄存 器 、 比 较 寄 存 器 和 计数 寄 


























关于 EPIT 的 寄存 器 就 介绍 到 这 里 ， 关 于 这 些 寄存 器 详细 的 描述 ,请 参考 《I.MX6ULL 参考 














手册 》 第 1174 页 的 24.6 小 节 。 本 章 我 们 使 用 EPIT 产生 定时 中 断 ， 然 后 在 中 断 服 务 函 数 里 面 翻 
转 LED0， 接 下 来 以 EPIT1 为 例 ， 讲 解 需要 哪些 步骤 来 实现 这 个 功能 。EPIT 的 配置 步骤 如 下 : 











1, WE EPITI 的 时 钟 源 

设置 寄存 器 EPIT1_CR 寄存 器 的 CLKSRC(bit25:24) 位 ， 选 择 EPITI 的 时 钟 源 。 

2、 设 置 分 频 值 

设置 寄存 器 EPITI CR 寄存 器 的 PRESCALAR(bit15:4) 位 ， 设 置 分 频 值 。 

3、 设 置 工作 模式 

设置 寄存 器 EPIT1 CR 的 RLD(bit3) 位 ， 设 置 EPTI1 的 工作 模式 。 

4、 设 置 计数 器 的 初始 值 来 源 

设置 寄存 器 EPITI CR 的 ENMOD(bit1) 位 ， 设 置 计数 器 的 初始 值 来 源 。 

5、 使 能 比较 中 断 

我 们 要 使 用 到 比较 中 断 ， 因 此 需要 设置 寄存 器 EPITI CR 的 OCIEN(bit2) 位 ， 使 能 比较 中 











6、 设 置 加 载 值 和 比较 值 
设置 寄存 器 EPIT1 LR 中 的 加 载 值 和 寄存 器 EPIT1 CMPR 中 的 比较 值 , 通过 这 两 个 寄存 器 





就 可 以 决定 定时 器 的 中 断 周期 。 


7、EPIT1 中 断 设置 和 中 断 服 务 函 数 编写 
使 能 GIC 中 对 应 的 EPITI 中 断 ， 注 册 中 断 服务 函数 ， 如 果 需 要 的 话 还 可 以 设置 中 断 优先 


。 最 后 编写 中 断 服务 函 数 。 


8、 使 能 EPIT1 定时 器 
配置 好 EPIT1 以 后 就 可 以 使 能 EPIT1 了 ， 通 过 寄存 器 EPIT1_CR 的 EN(bit0) 位 来 设置 。 
通过 以 上 几 步 我 们 就 配置 好 EPIT 了 ， 通 过 EPIT 的 比较 中 断 来 实现 LEDO 的 翻转 。 
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18.2 硬件 原理 分 析 


本 试验 用 到 的 资源 如 下 : 
(D. LEDO. 
©., 定时 器 EPTI1。 
Asc EPTIL 的 中 断 来 控制 LED0 RÆK, LEDO 的 硬件 原理 前 面 已 经 介绍 过 了 。 


18.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 10 epit timer. 

本 章 实 验 在 上 一 章 例 程 的 基础 上 完成 ,更 改 工 程 名 字 为 “epit_timer”， 然 后 在 bsp 文件 夹 下 
创建 名 为 “epittimer” 的 文件 夹 , 然后 在 bsp/epittimer 中 新 建 bsp_epittimer.c 和 bsp_epittimer.h 这 
两 个 文件 。 在 bsp_epittimerh 中 输入 如 下 内 容 : 

示例 代码 18.3.1 bsp_epittimet.h 文件 代码 















































1 #ifndef BSP EPITTIMER H 

2 #define BSP EPITTIMER H 

Q0 XCKOK CK KC KICK KICK KK KICK KICK RC KK KICK ACKOKO KKK KAKKA KKA KK GIOI GRO 
i Dene ZunesnomolarL Cos, bech e 9S2 HO ALL :10ONnes esee 
5 IUE : bsp epittimer.h 

GNIS : 左 忠 凯 

7 版 本 g Wl) 

8 描述 : EPIT 定时 器 驱动 头 文件 。 

o JA ER 

10 论坛 : www.openedv.com 

11 Has : 初版 V1.0 2019/1/5 左 忠 凯 创建 





11527 KCKCKCKCkCKCk kCkck k kk k kk Ck kCk Ck k kk k kc k k kc k Ck k Ck Ck kCkCk k kk k kc k Ck kc k ck kck ck kck ck ckck ck ckck kc k ck kk f 


TES ME edel ESO EL 


15 /* mapay] =y 
JS void piril init (twasignec] int trac, unsigned ime value) e 


iy swexLel nam (vore) p 


19 #endif 
bsp_epittimer.h 文件 很 简单 ， 就 是 一 些 函数 声明 。 然 后 在 bsp_epittimerc 中 输入 如 下 内 容 : 
示例 代码 18.3.2 bsp. epittimer.c 文件 代码 


/大 炎炎 火 大 炎炎 火 大 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大 大 








Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 & bgp ejuitiswer © 

作者 : 左 忠 凯 

版 本 g WES, 

描述 : EPIT 定时 器 驱动 文件 。 

其 他 : 配置 EPIT 定时 器 ， 实 现 EPIT 定时 器 中 断 处 理 函 数 

论坛 : www.openedv.com 


日 志 : 初版 V1 .0 2019/1/5 左 忠 凯 创 建 
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Kk ck ck ckk kk kk ck kk kk kk kk kk kk kk kk kc kk kckckck ckck ckck ckck ckck ck ck ck ck ck ck ck ck ck ck ckck ck ck ck ck ck ck kk f 


1 4include "bsp epittimer.h" 




















2 sinclude "bsp int.h" 

3 4include "bsp led.h" 

4 

SEU de 

6 + description : 初始 化 EPIT 定时 器 . 

qo ow EPIT 定时 器 是 32 位 向 下 计数 器 , 时 钟 源 使 用 ipg-66Mhz 
8  * @param - frac  : 分 频 值 ， 范 围 为 0~4095， 分 别 对 应 1~4096 分 频 。 


9  * Qparam ve 

10 * Greturn & XB 

Jap 3e 

1.2 voici epiti sbmub (uasigase] ink trac, vnsignec) int valus) 
LS. 4 























14 if(frac » OXFFF) 

T5 frac = OXFFF; 

16 EPITI->CR = 0; /* WS CR ATA */ 

17 

18 Jes 

19 * CR 寄存 器 : 

20 * bit25:24 01 时 钟 源 选 择 Peripheral clock=66MHz 

P * bit15:4 frac 分 频 值 

22 * bit3: 1 当 计数 器 到 0 的 话 从 LR 重新 加 载 数值 

23 * bit2: 1 比较 中 断 使 能 

24 * bitl: 1 初始 计数 值 来 源 于 LR 寄存 器 值 

25 * bit0: 0 AuXH]EPITI 

26 Pr 

2 EPITi-»CR = (1««24 | frac << 4 | 1««3 | 1««2 | 1««1); 

28 EPIT1-»LR = value; /* 加 载 寄存 器 值 */ 

29 EPIT1-»CMPR = 0; /* 比较 寄存 器 值 */ 

30 

31 /* 使 能 GIC 中 对 应 的 中 断 */ 

32 GIC EnableIRQ(EPIT1 IRQnN); 

33 

34 /* 注册 中 断 服 务 函数 ^ 

25 system register irghandler (EPIT IROA, 
(system irq handler t)epitl irqhandler, 
NULL); 

36 EPIT1-»CR |= 1««0; /* 使 能 EPIT1 */ 

37 3 

38 

3 quu 

40 * Qdescription : EPIT 中 断 处 理 函 数 
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41 * @param 3 JE 

42 * Greturn NS 

23 

44 void epitl irghandler (void) 

45 { 

46 Static unsigned char state - 0; 

47 state = !state; 

48 if(EPIT1-»SR & (1««0)) /* 判断 比较 事件 发 生 */ 
49 { 

50 led_switch(LED0, state); /* 定时 器 周期 到 ， 反 转 LED wf 
5a } 

52 EPIT1->SR |= 1««0; /* 清除 中 断 标 志 位 */ 
592) 


bsp epittimer.c 里 面 有 两 个 函数 epitl_init 和 epitl _irqhandler， 分 别 是 EPIT1 初始 化 函数 和 











EPIT1 中 断 处 理 函 数 。epitl init 有 两 个 参数 frac 和 value, 其 中 frac 是 分 频 值 , value 是 加 载 值 。 


在 
值 











第 29 行 设置 比较 寄存 器 为 0， 也 就 是 当 计数 器 倒 计 数 到 0 以 后 就 会 触发 比较 中 断 ， 因 此 分 频 
frac 和 value 就 可 以 决定 中 断 频 率 ， 计 算 公 式 如 下 : 
Tout = ((frac +1 )* value) / Tclk; 





其 中 : 

Tclk: EPIT1 的 输入 时 钟 频率 (单位 Hz)。 

Tout: EPITI 的 溢出 时 间 ( 单 位 S). 

第 38 行 设置 了 EPIT1 工作 模式 为 set-and-forget， 并 且 时 钟 源 为 pg_clk=66MHz。 假 如 我 们 


现在 要 设置 EPIT1 中 断 周期 为 S00ms， 可 以 设置 分 频 值 为 0， 也 就 是 1 分 频 ， 这 样 进 入 EPITI 


的 





时 钟 就 是 66MHz。 如 果 要 实现 500ms 的 中 断 周 期 ，EPIT1 的 加 载 寄存 器 就 应 该 为 


66000000/2=33000000。 


前 
除 
最 





函数 epitl_irqhandler 是 EPIT1 的 中 断 处 理 函 数 ， 此 函数 先 读 取 EPITI SR 寄存 器 ， 判 断 当 
的 中 断 是 否 为 比较 事件 ， 如 果 是 的 话 就 翻转 LED 灯 。 最 后 在 退出 中 断 处 理 函 数 的 时 候 需 要 清 
中 断 标志 位 。 

后 就 是 mian.c 文件 了 ， 在 mian.c 里 面 输入 如 下 内 容 : 
示例 代码 18.3.3 main.c 文件 代码 



































/玉米 大火 火炎 类 火炎 炎炎 类 类 类 类 大 大 类 类 类 类 类 类 大 类 类 大 大 大 类 大 大 大 类 大 大 大大 大大 大大 大 类 大 大 大 大 大 类 大 类 大 类 大 类 大 类 大 类 大 大 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 & miaii E 





























eas : 左 忠 山 

版 本 RU 

描述 : I.MX6U 开发 板 裸 机 实验 10 EPIT 定时 器 实验 

其 他 : 本 实验 主要 学 习 使 用 工 .Mx6UL 自 带 的 EPIT 定时 器 ， 学 习 如 何 使 用 
EPIT 定时 器 来 实现 定时 功能 ， 巩 固 Cortex-A 的 中 断 知识 。 

论坛 : www.openedv.com 

Eis : 初版 V1.0 2019/1/4 左 忠 凯 创 建 


il 
2 


KOKCKCKCKCkCKCkCkCkCkCk kCk k Ck kCkCk k kk k kk k kc k Ck kCkCk k kc k k kc k kck ck kckck ck kck ck ckck ck ck ck ck ko e ke k x f 


tne el "Joy Cilik sint 
tne ole Wosa eedem. m" 
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3 #include "bsp led.h" 

de ue Mos OSE Im 

5 #include "bsp key.h" 

5. include "osp ime Rn" 

7 #include "bsp epittimer.h" 

8 

Sh. es 

10 * Qdescription : main MÆ 

manam 8 JE 

12 * Qreturn e E 

JS. my 

14 int main(void) 

(MET 

16 ine init() e /* 初始 化 中 断 (一 定 要 最 先 调 用 ! ) */ 
L7 imx6u clkinit(); /* 初始 化 系统 时 钟 ey 
18 clk enable(); /* 使 能 所 有 的 时 钟 m 
19 Ju&xel iwi (0) f /* 初始 化 leqd "fl 
20 beep init(); /* 初始 化 beep */ 
2i key init(); /* 初始 化 key m 
22 epitl_init(0, 66000000/2); /* 初始 化 EPIT1 定时 器 ，1 分 频 

23 * 计数 值 为 :66000000/2， 也 就 是 
24 * 定时 周期 为 500ms。 

25 a 

26 while(!) 

Dy { 

28 delay(500); 

29 ) 

30 

3l return 0; 

o2 


main.c 里 面 就 一 个 main 函数 ， 第 22 行 调用 函数 epitl init 来 初始 化 EPIT1， 分 频 值 为 0， 
也 就 是 1 分 频 ， 加 载 寄存 器 值 为 66000000/2=33000000，EPTI1 定时 器 中 断 周期 为 S00ms。 第 
26~29 行 的 while 循环 里 面 就 具有 一 个 延 时 函数 ， 没 有 做 其 他 处 理 ， 延 时 函数 都 可 以 取 掉 。 


18.4 编译 下 载 验证 
18.4.1 编写 Makefile 和 链接 脚本 


修改 Makfile 中 的 TARGET 7j epit, 7E INCDIRS 和 SRCDIRS 中 加 入 “bsp/epittimer”， 修 
改 后 的 Makefile 如 下 : 























示例 代码 18.4.1.1 Makefile 文件 代码 
1 CROSS COMPTA 2o arm-linux-gnueabuhf- 
2 TARGET ?= epit 
3 
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rm -rf S(TARGET).elf S(TARGET).dis S(TARGET).bin S$(COBJS) 


论坛 :www.opendev.com 








INCDIRS 中 添加 EPIT1 驱动 头 文件 CI) 路 径 。 
SRCDIRS 中 添加 EPIT1 驱动 文件 (.c) 路 径 。 





ee */ 
5) 
CNGRTRS = imx6ul \ 
7 bsp/clk ^ 
8 bsp/led \ 
9 bsp/delay \ 
10 bsp/beep V 
iil bsp/gpio \ 
118 bsp/key \ 
13 bsp/exit \ 
14 bsp/int V 
T5 bsp/epittimer 
16 
17 SRCDIRS e peojeet Y 
18 BEE CINN 
19 bsp/led \ 
20 bsp/delay \ 
2l bsp/beep V 
27 bsp/gpio 
DE bsp/key V 
24 bsp/exit \ 
25 bsp/int V 
26 bsp/epittimer 
2:7] 
28 /* 省 略 掉 其 他 代码 . . . .. */ 
2 
30 clean: 
Sl 
第 2 行 修改 变量 TARGET X “epit”, Hiii HIRIRA "epit". 
第 15 行 在 变量 
第 26 行 在 变量 
链接 脚本 保持 不 变 。 
18.4.2 编译 下 载 











使 用 Make 命令 编译 代码 ， 编 
件 下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload 

./imxdownload epit.bin /dev/sdd 














LED0 会 以 500ms 为 周期 不 断 的 亮 、 灭 闪烁 。 




















SD 卡 中 
中 ， 然 后 复位 开发 板 。 程 序 运 行 ] 


$ (SOBJS) 


译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 epit.bin X 


/给 予 imxdownload 可 执行 权限 ， 一 次 即 可 
// 烧 写 到 
烧 写成 功 以 后 将 SD 卡 插 到 开发 板 的 SD RI 


FE 常 的 话 
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第 十 九 章 定时 器 按键 消 拌 实验 














在 第 十 五 章 和 第 十 七 章 实验 中 都 用 到 了 按键 ， 用 到 按键 就 要 处 理 因 为 机 械 结构 带 来 的 按键 
抖动 问题 ， 也 就 是 按键 消 拌 。 前 面 的 实验 中 都 是 直接 使 用 了 延 时 函数 来 实现 消 拌 ， 因 为 简单 ， 
但 是 直接 用 延 时 函数 来 实现 消 拌 会 浪费 CPU 性 能 ， 因 为 在 延 时 函数 里 面 CPU 什么 都 做 不 了 。 
如 果 按 键 使 用 中 断 的 话 更 不 能 在 中 断 里 面 使 用 延 时 函数 ， 因 为 中 断 服务 函数 要 快 进 快 出 ! 本 章 
我 们 学 习 如 何 使 用 定时 器 来 实现 按键 消 拌 ， 使 用 定时 器 既 可 以 实现 按键 消 拌 ， 而 且 也 不 会 浪费 
CPU 性 能 ， 这 个 也 是 Linux 驱动 里 面 按键 消 拌 的 做 法 。 
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19.1 定时 器 按键 消 拌 简介 
按键 消 拌 的 原理 在 第 十 五 章 已 经 详细 的 讲解 了 ， 其 实 就 是 在 按键 按 下 以 后 延 时 一 段 时 间 再 
































去 读 取 按 键 值 , 如 果 此 时 按键 值 还 有 效 那 就 表示 这 是 一 次 有 效 的 按键 , 中 间 的 延 时 就 是 消 拌 的 。 
但 是 这 有 一 个 缺点 ,就 是 延 时 函数 会 浪费 CPU 性 能 ， 因 为 延 时 函数 就 是 空 跑 。 如 果 按 键 是 用 中 
断 方式 实现 的 ， 那 就 更 不 能 在 中 断 服务 函数 里 面 使 用 延 时 函数 ， 因 为 中 断 服务 函 数 最 基本 的 要 
求 就 是 快 进 快 出 ! 上 一 章 我 们 学 习 了 EPIT 定时 器 ， 定 时 器 设置 好 定时 时 间 ， 然 后 CPU 就 可 以 
做 其 他 事情 去 了 ， 定 时 时 间 到 了 以 后 就 会 触发 中 断 ， 然 后 在 中 断 中 做 相应 的 处 理 即 可 。 因 此 ， 
我 们 可 以 借助 定时 器 来 实现 消 拌 ， 按 键 采 用 中 断 驱 动 方式 ， 当 按键 按 下 以 后 触发 按键 中 断 ， 在 
按键 中 断 中 开启 一 个 定时 器 ， 定 时 周期 为 10ms， 当 定时 时 间 到 了 以 后 就 会 触发 定时 器 中 断 ， 最 
后 在 定时 器 中 断 处 理 函 数 中 读 取 按键 的 值 ， 如 果 按 键 值 还 是 按 下 状态 那 就 表示 这 是 一 次 有 效 的 
按键 。 定 时 器 按键 消 抖 如 图 19.1.1 所 示 : 

































































































































































图 19.1.1 定时 器 消 拌 示意 图 

在 图 19.1.1 中 1~t3 这 一 段 时 间 就 是 按键 拌 动 ， 是 需要 消除 的 。 设置 按键 为 下 降 沿 触发 ， 因 
此 会 在 刀 、 世 和 3 这 三 个 时 刻 会 触发 按键 中 断 , 每 次 进入 中 断 处 理 函 数 都 会 重新 开 器 定时 器 中 
Wr, 所 以 会 在 t、 世 和 3 这 三 个 时 刻 开 器 定时 器 中 断 。 但 是 t1~t2 和 t2~t3 这 两 个 时 间 段 是 小 于 
我 们 设置 的 定时 器 中 断 周 期 (也 就 是 消 抖 时 间 ， 比 如 10ms)， 所 以 虽然 tl 开启 了 定时 器 , 但 是 定 
时 器 定时 时 间 还 没 到 呢 t2 时 刻 就 重 置 了 定时 器 ， 最 终 只 有 t3 时 刻 开启 的 定时 器 能 完整 的 完成 
整个 定时 周期 并 触发 中 断 ， 我 们 就 可 以 在 中 断 处 理 函 数 里 面 做 按键 处 理 了 ， 这 就 是 定时 器 实现 
按键 防 拌 的 原理 ，Linux 里 面 的 按键 驱动 用 的 就 是 这 个 原理 

关于 定时 器 按键 消 拌 的 原理 就 介绍 到 这 里 ， 接 下 来 讲解 如 何 使 用 EPIT1 来 配合 按键 KEY 
来 实现 具体 的 消 拌 ， 步 又 如 下 : 

1、 配 置 按键 IO 中 断 

配置 按键 所 使 用 的 IO， 因为 要 使 用 到 中 断 驱 动 按键 ， 所 以 要 配置 IO 的 中 断 模式 。 

2、 初 始 化 消 拌 用 的 定时 器 

上 面 已 经 讲 的 很 清楚 了 ， 消 拌 要 用 定时 器 来 完成 ， 所 以 需要 初始 化 一 个 定时 器 ， 这 里 使 用 
上 一 章 讲解 的 EPITI 定时 器 , 也 算是 对 EPIT1 定时 器 的 一 次 巩固 。 定时 器 的 定时 周期 为 10ms， 
也 可 根据 实际 情况 调整 定时 周期 。 

3、 编 写 中 断 处 理 函 数 

需要 编写 两 个 中 断 处 理 函 数 : 按键 对 应 的 GPIO 中 断 处 理 函 数 和 EPIT1 定时 器 的 中 断 处理 
函数 。 在 按键 的 中 断 处 理 函 数 中 主要 用 于 开启 EPIT1 定时 器 ,EPIT1 的 中 断 处 理 函 数 才 是 重点 ， 
按键 要 做 的 具体 任务 都 是 在 定时 器 EPITI 的 中 断 处理 函 数 中 完成 的 ， 比 如 控制 蜂 鸣 器 打开 或 关 
闭 。 
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19.2 硬件 原理 分 析 


本 试验 用 到 的 资源 如 下 : 

Q@、 一 个 LED 灯 LEDO. 

@、 定 时 器 EPTI1。 

©, —^ ES KEY. 

四、 一 个 蜂 鸣 器 。 

本 试验 效果 和 第 十 五 章 的 试验 效果 一 样 ， 按 下 KEY 会 打开 蜂 鸣 器 ， 再 次 按 下 KEY 就 会 关 
闭 蜂 鸣 器 。LED0 作为 系统 提示 灯 不 断 的 闪烁 。 


19.3 试验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 11_key_filter。 

本 章 实 验 在 上 一 章 例 程 的 基础 上 完成 ， 更 改 工程 名 字 为 “key_filter”， 然 后 在 bsp HFR F 
创建 名 为 “keyfilter” 的 文件 夹 ， 然 后 在 bsp/keyfilter 中 新 建 bsp_keyfilter.c 和 bsp_keyfilter.h 这 
两 个 文件 。 在 bsp_keyfilter.h 中 输入 如 下 内 容 : 

示例 代码 19.3.1 bsp_keyfilter.h 文件 代码 
#ifndef BSP KEYFILTER H 
#define BSP KEYFILTER H 


/汪汪 火炎 火炎 火炎 火 大火 类 火炎 火炎 火炎 类 大 类 大 火炎 火炎 火炎 火炎 火炎 类 大 类 大 类 大 类 大火 大 大大 类 大 类 大火 大 类 大火 大 类 大 类 大 类 大 类 大 大 



























































Eeveen © Uo alo xe (o Sz in t Cosc, Tech 1998-20163 on Es es 
文件 名 Eee sis 

作者 : 左 忠 凯 

版 本 SEVO 

描述 : 定时 器 按键 消 拌 驱动 头 文 件 。 

其 他 z JE 

Ve : www.openedv.com 


日 志 : 初版 V1.0 2019/1/5 左 忠 凯 创 建 


KCKCKCKCKCKCkCk Ck k Ck k Ck kCkCkCk Ck Ck kCk Ck k Ck kCk Ck Ck k Ck Ck Ck kCkCk Ck k Ck k Ck k Ck k Ck k Ck k ck 放 人 


(eei A CO Cn 690 desi IE 


[— dye) 
[e 











= HKE 
w N H| 


eE E 


voie tilterkey init (vorc) P 


=e hre re 
O UO 心 


voL filterrtimer imit (unsignec! int value) y 


mm 
- 


wiuiol tilrertimer stop (vonc) 7 





co 


voile! tiltertimer restart (unsigned int value)? 








p 
1O 


vole tiltertimer iromandler (vorc) p 


N 
© 


voe goiol lge 31 _ irgnanciler (vorei) y 


N N 
Y he 


#endif 
bsp_keyfilterh 文件 很 简单 ， 只 是 函数 声明 。 在 bsp_keyfilterc 中 输入 如 下 内 容 : 
示例 代码 19.3.2 bsp. keyfilter.c. 文件 代码 


/大 炎炎 炎 大 炎炎 大大 炎炎 火 大 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 大大 火炎 火 大 火炎 大大 火炎 大大 火炎 大大 火炎 大 大 














Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 g loe lsewiiiliteu.e 


459 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 
































原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
作者 : 左 忠 凯 

版 本 SVITO 

pu : 定时 器 按键 消 拌 驱动 。 

其 他 : 按键 采用 中 断 方 式 ， 按 下 按键 触发 按键 中 断 ， 在 按键 中 断 里 面 


论坛 
志 
8s 























使 能 定时 器 定时 中 断 。 使 用 定时 器 定时 中 断 来 完成 消 抖 延 时 ， 
定时 器 中 断 周 期 就 是 延 时 时 间 。 如 果 定 时 器 定时 中 断 触发 ， 
表示 消 抖 完成 ( 延 时 周期 完成 ) ， 即 可 执行 按键 处 理 函 数 。 
www.openedv.com 


: 初版 V1.0 2019/1/5 左 忠 凯 创 建 





类 火炎 炎炎 火炎 炎炎 火炎 大大 大大 大大 大大 火炎 类 大 大 类 类 大 类 类 大 大 类 类 大 大 类 类 类 大 类 类 类 大 类 类 类 大 类 类 类 大 类 大 类 大 类 大 大 大 大大 大 类/ 


30 
Sal 


#include "bsp key.h" 
#include "bsp gpio.h" 
finclude "bsp int.h" 
finclude "bsp beep.h" 
Mimela e "sep. le lal 


/* 
* QGdescription : 按键 初始 化 
* @param TE 
* @return 8 ZB 
sf 

void filterkey init (void) 

( 


geio pin Coniig t ye 


/* 1. HLR IO */ 
IOMUXC SetPinMux(IOMUXC UART1 CTS B GPIO1 IO18, 0); 
IOMUXC SetPinConfig(IOMUXC UART1 CTS B GPIO1 IO18, 0xF080); 


/* 2、 初 始 化 cero 为 中 断 */ 
key Coniig Cirectlon = IGI DigitalTnpunt 2 





key config.interruptMode = kGPIO IntFallingEdge; 
key config.outputLogic = 1; 
Bio nit(eCPIol, 1 MS cvllfcommiei) 


/* 3、 使 能 GPIO 中 断 ， 并 且 注 册 中 断 处 理 函 数 2 
GIC EnableIRQ(GPIOl1 Combined 16 31 IRQn); 
system register irghoancler(GPIOL (Clonlouumec! 16 SI IRON, 
(system irg handler thgpiol 16 31 irohandler, 


NULL) ; 
gpio enableint (GPIO1, 18); /* 使 能 GPIO1 1018 的 中 断 功 能 — */ 
filtertimer init(66000000/100); /* 初始 化 定时 器 , 10ms */ 
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32 

33 

cr fe 

35  * Qdescription : 初始 化 用 于 消 抖 的 定时 器 ， 默 认 关 闭 定时 器 

36  * Qparam - value : 定时 器 EPIT 计数 值 

37  * Qreturn S E 

38 ir 

$9) vorc iiltertimer inir (unsigned int valus) 

40 { 

41 EPIT1->CR = 0; /* "iB ui 

42 EPIT1-»CR - (1««24 | 1««3 | 1««2 | 1««1); 

43 EPITI-»LR = value; /* 计数 值 Sf 

44 EPIT1->CMPR = 0; /* 比较 寄存 器 为 0 。 */ 

45 

46 /* 使 能 EPIT1 中 断 并 注册 中 断 处 理 函 数 */ 

47 GIC EnableIRQ(EPIT1 IROn) g 

48 system register irgheancler (ISP TTTPL IRON, 
(system irg handler t)filtertimer irqghandler, 
NULL); 

49 ) 

50 

Due is 

52  * Qdescription  : We 

53  * Qparam 8 JE 

54  * Qreturn 8 JE 

55 s 

55 vOe en (eoo (wosbely 

S 

58 EPITI1-»CR &= ~(1<<0) ; /* 关闭 定时 器 */ 

ONES 

60 

uL e 


62  * Qdescription  : 重启 定时 器 
63  * Qparam - value : 定时 器 PIT 计数 值 








64  * Qreturn 8 b 

65 5 

SS void tbe resteert (unsigned ine valus) 
Gn 

68 EPIT1-»CR &= ~(1<<0) : /* 先 关 闭 定时 器 */ 
69 EPIT1->LR = value; /* 计数 值 x 
70 EPIT1-»CR |= (1««0); /* 打开 定时 器 */ 
TL uh 

qe 
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TS 
74 
T5 
76 
yo 
78 
q9 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
OI 
92 
93 
94 
95 
96 
o 
98 
99 
100 
101 
102 
103 


/ * 

* Qdescription : 定时 器 中 断 处 理 函 数 
* Qparam 8 ib 

* Qreturn 3 JE 

i 

void filtertimer irghandler (void) 


{ 


Static unsigned char state - OFF; 





if(EPIT1-»SR & (1««0)) 


iilieseitiwwess Gne) p 
if(gpio pinread(GPIOl1, 18) z-2 0) 
{ 


state = !state; 


beep switch (state) ; 


} 
EPIT1-»SR |> 1««0; 





/* 

* Qdescription  : GPIO 中 断 处 理 函 数 

* Qparam 8 JE 

* Qreturn 8 JE 

#7 

void gpiol 16 31 irghandler (void) 

{ 
filtertimer restart(66000000/100); 
geio Clearintcilages(CPIOL, 16)? 

} 
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/* 判断 比较 事件 是 否 





/* 关闭 定时 器 
/* KEYO 按 下 





/* 反 转 蜂 鸣 器 


/* 清除 中 断 标 志 位 


/* 开局 定时 器 Su 
/* 清除 中 断 标 志 位 */ 


发 能 =f 


二 
dA 


Si 


is 


文件 bsp_keyfilter.c 一 共有 6 个 函数 ， 这 6 个 函数 其 实 都 很 简单 。filterkey_init 是 本 试验 的 


初始 化 函数 ， 此 函数 首先 初始 化 了 KEY 所 使 用 的 UARTI CTS 这 个 ID， 设置 这 个 IO 的 中 断 
模式 ， 并 且 注 册 中 断 处 理 函 数 ， 最 后 调用 函数 filtertimer init 初始 化 定时 器 EPITI 定时 周期 为 
10ms。 函 数 filtertimer init 是 定时 器 EPIT1 的 初始 化 函数 ， 内 容 基本 和 上 一 章 实验 的 EPIT1 初 














filtertimer irqhandler 是 EPTI1 H rFIBr At 


























面 就 是 开启 或 者 关闭 蜂 鸣 器 。 函 数 gpiol 16 31 irqhandler 是 GPIO1 IO18 的 中 断 处 到 
函数 只 有 一 个 工作 ， 那 就 是 重启 定时 器 EPIT1。 








bsp keyfilter.c 文件 内 容 总 体 来 说 并 不 难 ， 基 本 就 是 第 





在 mian.c 中 输入 如 下 所 示 代 码 : 


/玉米 矿业 火炎 类 类 炎炎 类 大 火炎 类 大 火炎 类 大 类 炎炎 大 类 类 类 大 类 类 类 大 类 类 大 大 类 类 大 大 类 类 大 大 类 类 大 大 大业 大 大 大大 大 大 类 类 大 大 类 大 


示例 代码 19.3.3 main.c 文件 代码 
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始 化 函数 一 样 。 函 数 filtertimer stop 和 filtertimer restart 分 别 是 EPIT1 的 关闭 和 重启 函数 。 
函数 ， 此 函数 里 面 就 是 按键 要 做 的 工作 ， 在 本 例 程 里 














EE 函数， 此 





上 七 章 和 第 十 八 章 实验 的 综合 。 最 后 


LMX6U RAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
Copyright oUzuozhomgiaud Go MEA 998—209 A ns Sener 
文件 名 8. xeu e 


作者 : IER 

版 本 g wb O 

描述 : 工 .MX6U 开发 板 裸 机 实验 11 定时 器 实现 按键 消 拌 实 验 

其 他 : 本 实验 主要 学 习 如 何 使 用 定时 器 来 实现 按键 消 拌 ， 以 前 的 按键 














消 拌 都 是 直接 使 用 延 时 函数 来 完成 的 ， 这 种 做 法 效率 不 高 ， 因 为 
延 时 函数 完全 是 浪费 CPU 资源 的 。 使 用 按键 中 断 + 定时 器 来 实现 按键 
驱动 效率 是 最 好 的 ， 这 也 是 Linux 驱动 所 使 用 的 方法 ! 

论坛 : www.openedv.com 


目 志 : 初版 V1.0 2019/1/5 左 忠 凯 创 建 


大 大 火炎 类 大 炎炎 类 大 类 火炎 大 大火 火炎 大 类 类 类 大 类 类 类 大 类 类 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 类 大 类 大 大 大 大 大 类 大 大 大 大 大 大 大 大/ 





Jl include "bsp CLK" 





2 Hinclude "bsp delav. Rh 

3 #include "bsp led.h" 

Zimt cM SNC 

5 #include "bsp key.h" 

6 £include "bsp int.h" 

7 #include "bsp keyfilter.h" 

8 

9 f 

10 * Qdescription : main KÆ 

11 * QGparam 8 3 

T2000 a ee e JE 

JDSj wy 

14 int main(void) 

dT 

16 unsigned char state - OFF; 

307) 

18 ine 下 让 (7 e /* 初始 化 中 断 (一 定 要 最 和 完 调 用 ! ) */ 
19 imx6u clkinit(); /* 初始 化 系统 时 钟 a 
20 Clik enable () 7 /* 使 能 所 有 的 时 钟 s 
2u IS imife OE /* 初始 化 lea E 
22 beep initi)? /* 初始 化 beep 2 
23 filterkey CURT /* 带 有 消 抖 功能 的 按键 * f 
24 

25 while (1) 

26 { 

2 state = !state; 

2:8 ces ejm INE» OMM y 

29 delay(500); 

30 } 

gl 
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32 return 0; 
Sou 


main.c 文件 只 有 一 个 main 函数 ， 在 第 23 行 调 用 函数 filterkey. init 来 初始 化 带 有 消 抖 的 按 
键 ， 最 后 在 while 循环 里 面 翻转 LED0， 周 期 大 约 为 500ms。 


19.4 编译 下 载 验证 
19.4.1 编写 Makefile 和 链接 脚本 


修改 Makefile 中 的 TARGET 为 keyfilter, 在 INCDIRS 和 SRCDIRS 中 加 入 “bsp/keyfilter”， 
修改 后 的 Makefile 如 下 : 























示例 代码 19.4.1 Makefile 代码 




















1 CROSS COMPILE ?2 arm-linux-gnueabihf- 
2 TARGET ?= keyfilter 

8 

NE */ 

S 

$$  JIUNICIDIIENS :5 imx6ul N 

7 bgo/elk Ņ 

8 bsp/led \ 

9 bsp/delay N 
EO bsp/beep ^ 

131 bsp/gpio \ 

12 bsp/key V 

13 bsp/exit 

14 bsp/int V 

IS bsp/epittimer NV 
16 bsp/keyfilter 
de 

18 SRCDIRS ses qouojecit \ 

19 bsp/clk V 

20 bsp/led \ 

Zu bsp/delay N 
22 bsp/beep \ 

DE bsp/gpio w^ 

24 bsp/key \ 

25 bsp/exit \ 

26 bsp/int \ 

27 bsp/epittimer RN 
28 bsp/keyfilter 
2e 

30 /* QkETREC ER x 

E 


232 elean: 
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3 emerat S (TARGET) M STER (TARGET Mais e (TARGET o m RN (80 BUSES SO BIS) 
第 2 行 修 改变 量 TARGET 为 “keyfilter”， 也 就 是 目标 名 称 为 “keyfilter”。 
第 16 行 在 变量 INCDIRS 中 添加 按键 消 拌 驱动 头 文件 (.h) 路 径 。 
第 28 行 在 变量 SRCDIRS 中 添加 按键 消 拌 驱动 文件 (.c) 路 径 。 
链接 脚本 保持 不 变 。 




















19.4.2 编译 下 载 


使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 keyfilter.bin 
文件 下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

./imxdownload keyfilterbin /dev/sdd / 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 。 本 例 程 的 效果 和 第 十 
五 章 一 样 ， 按 下 KEY 就 会 控制 蜂 鸣 器 的 开关 ， 并 且 LEDO 不 断 的 内 烁 ， 提 示 系 统 正在 运行 。 
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第 二 十 章 高 精度 延 时 实验 


延 时 函数 是 很 常用 用 到 的 API 函数 ， 在 前 面 的 实验 中 我 们 使 用 循环 来 实现 延 时 函数 ， 但 是 
使 用 循环 来 实现 的 延 时 函数 不 准确 ， 误 差 会 很 大 。 虽 然 使 用 到 延 时 函数 的 地 方 精度 要 求 都 不 会 
很 严格 (要 求 严格 的 话 就 使 用 硬件 定时 器 了 )， 但 是 延 时 函数 肯定 是 越 精确 越 好 ， 这 样 延 时 函数 
就 可 以 使 用 在 某 些 对 时 许 要 求 严格 的 场合 。 本 章 我 们 就 来 学 习 一 下 如 何 使 用 硬件 定时 器 来 是 实 
现 高 精度 延 时 。 
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20.1 高 精度 延 时 简介 


20.1.1 GPT 定时 器 简介 


学 过 STM32 的 同学 应 该 知道 ， 在 使 用 STM32 的 时 候 可 以 使 用 SYSTICK 来 实现 高 精度 延 
时 。LMX6U 没有 SYSTICK 定时 器 , 但 是 LMX6U 有 其 他 定时 器 啊 ,， 比 如 第 十 八 章 讲解 的 EPIT 
定时 器 。 本章 我 们 使 用 IMX6U 的 GPT 定时 器 来 实现 高 精度 延 时 , 顺便 学 习 一 下 GPT 定时 器 ， 




















GPT 定时 器 全 称 为 General Purpose Timer. 








GPT 定时 器 是 一 个 32 位 向 上 定时 器 (也 就 是 从 0X00000000 开始 向 上 递增 计数 )，GPT 定时 
器 也 可 以 跟 一 个 值 进行 比较 ， 当 计数 器 值 和 这 个 值 相 等 的 话 就 发 生 比 较 事 件 ， 产 生 比 较 中 断 。 
GPT 定时 器 有 一 个 12 位 的 分 频 器 ， 可 以 对 GPT 定时 器 的 时 钟 源 进行 分 频 ，GPT 定时 器 特性 如 


下 : 
、 一 个 可 选 时 钟 源 的 32 位 向 上 计数 器 。 
、 两 个 输入 捕获 通道 ， 可 以 设置 触发 方式 。 
、 三 个 输出 比较 通道 ， 可 以 设置 输出 模式 。 
、 可 以 生成 捕获 中 断 、 比 较 中 断 和 溢出 中 断 。 
、 计 数 器 可 以 运行 在 重新 启动 (restart) 或 (自由 运行 )free-run 模式 。 
GPT 定时 器 的 可 选 时 钟 源 如 图 20.1.1.1 所 示 : 


Clock off 























9 eooo0 








Crystal Oscillator 
(ipg. clk 24M) Prescaler 24M 


External Clock 


(PT cLk) OO ———ÁÀ 


F oriproral Clock 
(ipg_clk) 













Low Frequency Reference Clock 
(ipg. clk 32k 


High Frequency Reference Clock 
(ipg. clk highfreq) 





图 20.1.1.1 GPT 时 钟 源 





To Prescaler 


从 图 20.1.1.1 可 以 看 出 一 共有 五 个 时 钟 源 ， 分 别 为 : ipg_clk 24M、GPT_CLK( 外 部 时 钟 )、 
ipg_clk\ipg_clk 32k 和 ipg_clk highfreq。 本 例 程 选择 ipg_clk 为 GPT 的 时 钟 源 ,ipg_clk-66MHz。 














GPT 定时 器 结构 如 图 20.1.1.2 所 示 : 
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Prescaler 
© output 
Clock input from | Prescaler 
clock selection 12-bit (2) © 
block ——————», 1... 4096 | | 







nter Value Bus 


GPT_CAPTURE 1 | a S 
< Input Reg 1 KT 3 
iz a 





Processor Interrupt Bus 


GPT CAPTURE2 


Processor Data Bus 


图 20.1.1.2 GPT 定时 器 结构 图 
图 20.1.1.2 中 各 部 分 意义 如 下 : 


©, ERRIA GPT 定时 器 的 时 钟 源 ， 前 面 已 经 说 过 了 ， 本 章 例 程 选择 ipg_clk 作为 GPT 定 


时 器 时 钟 源 。 


©, ERDA 12 位 分 频 器 ， 对 时 钟 源 进行 分 频 处 理 ， 可 设置 0*4095， 分 别 对 应 1 4096 分 





昌 、 经 过 分 频 的 时 钟 源 进入 到 GPT 定时 器 内 部 32 位 计数 器 。 











和 @@、 这 两 部 分 是 GPT 的 两 路 输入 捕获 通道 ， 本 章 不 讲解 6PT 定时 器 的 输入 





获 。 





























@@、 此 部 分 为 输出 比较 寄存 器 ， 一 共有 三 路 输出 比较 ， 因 此 有 三 个 输出 比较 寄存 器 ， 输 出 


比较 寄存 器 是 32 位 的 。 





GO、 此 部 分 位 输出 比较 中 断 ， 三 路 输出 比较 中 断 ， 当 计数 器 里 面 的 值 和 输出 比较 寄存 器 里 











面 的 比较 值 相等 就 会 触发 输出 比较 中 断 。 














模式 的 区 别 如 下 : 





GPT 定时 器 有 两 种 工作 模式 : 重新 启动 (restart) 模 式 和 自由 运行 (free-run) 模 式 ， 这 两 个 工作 


重新 启动 (restarb 模 式 : ^4 GPTx_CR(x=1，2) 寄 存 器 的 FRR 位 清 零 的 时 候 GPT 工作 在 此 
模式 。 在 此 模式 下 ， 当 计数 值 和 比较 寄存 器 中 的 值 相 等 的 话 计 数值 就 会 清 零 ， 然 后 重新 从 




















0X00000000 开始 向 上 计数 ， 只 有 比较 通道 1 才 有 此 模式 ! 向 比较 通道 1 的 比较 寄存 器 写 入 任何 























数据 都 会 复位 GPT 计数 器 。 对 于 其 他 两 路 比较 通道 《通道 2 和 3)， 当 发 生 比较 事件 以 后 不 会 


复位 计数 器 。 


468 





LMX6U 嵌入 式 Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 

自由 运行 (free-run) 模 式 : 当 GPTx_CR(x=1，2) 寄 存 器 的 FRR 位 置 1 时 候 GPT 工作 在 此 模 
式 下 ， 此 模式 适用 于 所 有 三 个 比较 通道 ， 当 比较 事件 发 生 以 后 并 不 会 复位 计数 器 ， 而 是 继续 计 
数 ， 直 到 计数 值 为 0XFFFFFFFF， 然 后 重新 回 滚 到 0X00000000。 

接 下 来 看 一 下 GPT 定时 器 几 个 重要 的 寄存 器 ， 第 一 个 就 是 GPT 的 配置 寄存 器 GPTx CR, 
此 寄存 器 的 结构 如 图 20.1.1.3 所 示 ; 























Bit — 31 30 29 28 27 26 25 24 | 23 22 21 20 19 18 17 16 
R 
OM3 OM2 OM1 IM2 IM1 
e N Pd 
w| oO O O 
u uL uL 
Reset 0 0 0 0 0 0 0 olo 0 0 0 0 0 0 0 
Bit 9 8 7 6 5 4 3 2 0 












CLKSRC EN 


STOPEN 
WAITEN 

















Ree 0 0 0 0 0 0 o oo o 
图 20.1.1.3. 寄存 器 GPTx CR 

寄存 器 GPTx CR 我 们 用 到 的 重要 位 如 下 : 

SWR(bitl5): 复位 GPT 定时 器 ， 向 此 位 写 1 就 可 以 复位 GPT 定时 器 ， 当 GPT 复位 完成 以 
后 此 为 会 自动 清 零 。 

FRR(bit9); 运行 模式 选择 ， 当 此 位 为 0 的 时 候 比 较 通 道 1 工作 在 重新 启动 (restart) 模 式 。 当 
此 位 为 1 的 时 候 所 有 的 三 个 比较 通道 均 工作 在 自由 运行 模式 (free-rum)。 

CLKSRC(bit8:6): GPT 定时 器 时 钟 源 选择 位 ， 为 0 的 时 候 关 闭 时 钟 源 ; 为 1 的 时 候选 择 
ipg clk 作为 时 钟 源 ; 为 2 的 时 候选 择 ipg clk highfreq 为 时 钟 源 ; 73 3 的 时 候选 择 外 部 时 钟 为 
时 钟 源 ; 为 4 的 时 候选 择 ipg_clk 32k 为 时 钟 源 ; 为 5 的 时 候选 择 ip clk 24M 为 时 钟 源 。 本 章 
例 程 选择 ipg clk 作为 GPT 定时 器 的 时 钟 源 ， 因 此 此 位 设置 位 1(0b001). 

ENMODE(bitl): GPT 使 能 模式 ， 此 位 为 0 的 时 候 如 果 关 闭 GPT 定时 器 ， 计 数 器 寄存 器 人 
存 定时 器 关闭 时 候 的 计数 值 。 此 位 为 1 的 时 候 如 果 关 闭 GPT 定时 器 ， 计 数 器 寄存 器 就 会 清 零 。 

EN(bit): GPT 使 能 位 ， 为 1 的 时 候 使 能 GPT 定时 器 ， 为 0 的 时 候 关 闭 GPT 定时 器 。 

接 下 来 看 一 下 GPT 定时 器 的 分 频 寄存 器 GPTx PR， 此 寄存 器 结构 如 图 20.1.1.4 所 示 : 


o 
o 
o 
o 
o 
o 









































图 20.1.1.4 寄存 器 GPTx PR 寄存 器 
寄存 器 GPTx PR 我 们 用 到 的 重要 位 就 一 个 : PRESCALER(bit11:0)， 这 就 是 12 位 分 频 值 ， 
可 设置 0~4095， 分 别 对 应 1~4096 分 频 。 
接 下 来 看 一 下 GPT 定时 器 的 状态 寄存 器 GPTx_SR， 此 寄存 器 结构 如 图 20.1.1.5 所 示 : 


469 


LMX6U AR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 








图 20.1.1.5 GPTx SR 寄存 器 结构 
寄存 器 GPTx SR 重要 的 位 如 下 : 
ROV(bitS):， 回 滚 标志 位 ， 当 计数 值 从 OXFFFFFFFF 回 滚 到 0X00000000 的 时 候 此 位 置 1。 























IF2~IF1(bit4:3): 输入 捕获 标志 位 ， 当 输入 捕获 事件 发 生 以 后 此 位 置 1， 一 共有 两 路 输入 
获 通 道 。 如 果 使 用 输入 捕获 中 断 的 话 需要 在 中 断 处 理 函 数 中 清除 此 位 。 

OF3-OFl1(bit2:0): 输出 比较 中 断 标志 位 ， 当 输出 比较 事件 发 生 以 后 此 位 置 1， 一 共有 三 路 
输出 比较 通道 。 如 果 使 用 输出 比较 中 断 的 话 需要 在 中 断 处 理 函 数 中 清除 此 位 。 
接着 看 一 下 GPT 定时 器 的 计数 寄存 器 GPTx CNT， 这 个 寄存 器 保存 着 GPT 定时 器 的 当前 
计数 值 。 最 后 看 一 下 GPT 定时 器 的 输出 比较 寄存 器 GPTx_OCR， 每 个 输出 比较 通道 对 应 一 个 
输出 比较 寄存 器 ， 因 此 一 个 GPT 定时 器 有 三 个 OCR 寄存 器 ， 它 们 的 作 都 是 相同 的 。 以 输出 比 
较 通 道 1 为 例 ， 其 输出 比较 寄存 器 为 GPTx OCR1， 这 是 一 个 32 位 寄存 器 ， 用 于 存放 32 位 的 
比较 值 。 当 计数 器 值 和 寄存 器 GPTx_OCR1 中 的 值 相等 就 会 产生 比较 事件 ， 如 果 使 能 了 比较 中 
断 的 话 就 会 触发 相应 的 中 断 。 

关于 GPT 的 寄存 器 就 介绍 到 这 里 ， 关 于 这 些 寄存 器 详细 的 描述 ， 请 参考 《I.MX6ULL 参 
考 手册 》 第 1432 页 的 30.6 小 节 。 


Hy 

























































































20.1.2 定时 器 实现 高 精度 延 时 原理 


高 精度 延 时 函数 的 实现 肯定 是 要 借助 硬件 定时 器 , 前 面 说 了 本 章 实验 使 用 GPT 定时 器 来 实 
现 高 精度 延 时 。 如 果 设 置 GPT 定时 器 的 时 钟 源 为 ipg_clk=66MHz, 设置 66 分 频 , 那么 进入 GPT 
定时 器 的 最 终 时 钟 频 率 就 是 66/66=1MHz, 周期 为 lus。GPT 的 计数 器 每 计 一 个 数 就 表示 “过 去 ” 
了 lus。 如 果 计 10 个 数 就 表示 “过 去 ”了 10us。 通 过 读 取 寄存 器 GPTx CNT 中 的 值 就 知道 计 
了 个 数 ,比如 现在 要 延 时 100us, 那么 进入 延 时 函数 以 后 纪录 下 寄存 器 GPTx_CNT 中 的 值 为 200， 
24 GPTx_CNT 中 的 值 为 300 的 时 候 就 表示 100us 过 去 了 ， 也 就 是 延 时 结束 。GPTx_CNT 是 个 
32 位 寄存 器 , 如 果 时 钟 为 IMHz 的 话 , GPTx_CNT 最 多 可 以 实现 OXFFFFFFFFus-4294967295us 
724294s7 72min. WE 72 分 钟 以 后 GPTx_CNT 寄存 器 就 会 回 滚 到 0X00000000, iE 
出 ， 所 以 需要 在 延 时 函数 中 要 处 理 溢出 的 情况 。 关 于 定时 器 实现 高 精度 延 时 的 原理 就 讲解 到 这 
里 ， 原 理 还 是 很 简单 的 ， 高 精度 延 时 的 实现 步骤 如 下 : 

1. WE GPTI 定时 器 

首先 设置 GPTI CR 寄存 器 的 SWR(bit15) 位 来 复位 寄存 器 GPT1。 复 位 完成 以 后 设置 寄存 
器 GPTI CR 寄存 器 的 CLKSRC(bit8:6) 位 ， 选 择 GPTI 的 时 钟 源 为 ipg_clk。 设 置 定时 器 GPTI 
的 工作 模式 ， 


2、 设 置 GPTI1 的 分 频 值 
设置 寄存 器 GPT1_PR 寄存 器 的 PRESCALAR(bitll11:0) 位 ， 设 置 分 频 值 。 
3、 设 置 GPT1 的 比较 值 
























































470 


LMX6U S X Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 

如 果 要 使 用 GPTI 的 输出 比较 中 断 ， 那 么 GPTI 的 输出 比较 寄存 器 GPT1_ OCRI 的 值 可 以 
根据 所 需 的 中 断 时 间 来 设置 。 本 章 例 程 不 使 用 比较 输出 中 断 ， 所 以 将 GPT1_OCR1 设置 为 最 大 
值 ， 即 : OXFFFFFFFF. 











4、 使 能 GPTI 定时 器 

设置 好 GPT1 定时 器 以 后 就 可 以 使 能 了 , 设置 GPT1_CR 的 EN(bit0) 位 为 1 来 使 能 GPTI XE 
时 器 。 

5、 编 写 延 时 函数 

GPTI 定时 器 已 经 开始 运行 了 , 可 以 根据 前 面 介绍 的 高 精度 延 时 函数 原理 来 编写 延 时 函数 ， 
针对 us 和 ms 延 时 分 别 编写 两 个 延 时 函数 。 


20.2 硬件 原理 分 析 


本 试验 用 到 的 资源 如 下 : 

Q@、 一 个 LED 灯 : LEDO. 

©, ás GPT1。 

本 实验 通过 高 精度 延 时 函数 来 控制 LED0 的 闪烁 , 可 以 通过 示波器 来 观察 LED0 的 控制 IO 
输出 波形 ， 通 过 波形 的 频率 或 者 周期 来 判断 延 时 函数 精度 是 否 正常 。 


20.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光 盘 -> 1、 裸 机 例 程 -> 12 highpreci delay. 
本 章 实验 在 上 一 章 例 程 的 基础 上 完成 ， 更 改 工 程 名 字 为 “delay” 直接 修改 bsp_delayc 和 
bsp delay.h 这 两 个 文件 ， 将 bsp delay.h 文件 改 为 如 下 所 示 内 容 : 
示例 代码 20.3.1 bsp_delay.h 文件 代码 













































































1 #ifndef BSP DELAY H 

2 #define BSP DELAY H 

3 J[ KCKCKCKCkCkCk kk kk kk ckCkckckckckckckckckckckck ckck ck k ckckckckckck ck ck ck ck ckck ck ck ckck ck ck ckck ck ck ck ck ckck ck ck kk 
4 Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
5 文件 名 osea 

G EE : 左 忠 凯 

7 版 本 3 Wb. 

8 描述 : XEBESE SCR. 

9o JA 3 JE 

30. WESES : www.openedv.com 

11 Eb : 初版 V1.0 2019/1/4 左 忠 凯 创建 

12 

13 V2.0 2019/1/15 左 忠 凯 修改 

14 添加 了 一 些 函 数 声 明 。 

15 KOKCKCKCKCkCkCkCk k kk k kk Ck k kCk kCk Ck k kc k k kk Ck kc k Ck k kk k kc k k kc k Ck k k Ck kck ck kck ck ckck ck ckckck kk kk x f 
16 £4$include "imxó6ul.nh" 

E 

18 /* BH] */ 

Wo voil deley (ee 

20 void delayus (unsigned int usdelay); 
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21 void delayms(unsigned int msdelay); 


22 void delay(volatile unsigned int n); 
25 valel eyeul. abxeedmeuallese (roic) g 
24 
25 #endif 
bsp delay.h 文件 就 是 一 些 函 数 声明 ， 很 简单 。 在 文件 bsp_delay.c 中 输入 如 下 内 容 : 
示例 代码 20.3.2 bsp_delay.c 文件 代码 


AR 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 





文件 名 a bsp Celay -C 

作者 : 左 忠 凯 

版 本 VO 

描述 EN 

其 他 e JE 

论坛 : www.openedv .com 

Hs : 初版 V1.0 2019/1/4 左 忠 凯 创建 


v2.0 2019/1/15 AS 

使 用 定时 器 GPT 实现 高 精度 延 时 ,添加 了 : 
delay init 延 时 初始 化 函数 

gptl irghandler gptl 定时 器 中 断 处 理 函 数 
delayus us 4ER Pg 

delayms ms 延 时 函数 


KEOKCKCKCKCKCk kCkCk k kk k kk Ck k Ck Ck kk k k kc k k k Ck Ck kk Ck kCkck k kc k k kk k kc k ck kck ck kck ck ck ck ck ckokck kk kk / 


1  f£include "bsp delay.h" 

2 

MEAS 

4 * Qdescription : 延 时 有 关 硬件 初始 化 , 主要 是 GPT 定时 器 

5 GPT 定时 器 时 钟 源 选择 ipg clk-66Mhz 

6 * (üiparam e JE 

qj * (return S E 

8 ef 

9 void delay init (void) 

10 f 

1d GPT1-»CR > 0; /* 清 零 E 
12 GPT1->CR = 1 << 15; /* biti5 E ENN AN */ 
13 while ( (GPT1->CR >> 15) & 0x01); /* 等 待 复位 完 */ 
14 

15 /* 

16 * GPT 的 CR 寄存 器 , GPT 通用 设置 

17 * pit22:20 000 输出 比较 1 的 输出 功能 关闭 ， 也 就 是 对 应 的 引 脚 没 反 应 
18 * bit9: 0 Restart 模式 , 当 CNT 等 于 OCR1 的 时 候 就 产生 中 断 

19 * bit8:6 001 GPT 时 钟 源 选 择 ipg clk-66Mhz 
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20 
29i 
22 
29 
24 
25 
26 
2 
28 
29 
30 
Sl 
32 
3S 
34 
25 
36 
3a 
38 
S 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
SS 
54 
55 
SIG 
9m 
58 
59 
60 
61 
62 


vp 
GPT1-»CR = (1««6); 


/ * 
* GPT 的 PR 寄存 器 ，GPT 的 分 频 设置 
* bit11:0 设置 分 频 值 ， 设 置 为 0 表示 1 分 频 ， 


论坛 :www.opendev.com 


* 以 此 类 推 ， 最 大 可 以 设置 为 0XEFEFE， 也 就 是 最 大 4096 分 频 





mf 
GPT1-»PR = 65; /* 66 分 频 ，GPT1 时 钟 为 66M/ (65+1) =1MHz */ 


/* 
* GPT 的 OCR1 寄存 器 ，GPT 的 输出 比较 1 比较 计数 值 ， 
* GPT 的 时 钟 为 1Mz， 那 么 计数 器 每 计 一 个 值 就 是 就 是 1us。 
* 为 了 实现 较 大 的 计数 ， 我 们 将 比较 值 设 置 为 最 大 的 OXFFFFFFEF, 
* 这 样 一 次 计 满 就 是 ，0XEEEEEEEEus = 4294967296us = 4295s 
* 也 就 是 说 一 次 计 满 最 多 71 .5 分 钟 ， 存 在 溢出 。 
i 
GPT1-»OCR[0] S OXFFFFFFFF; 
GPT1-»CR |= 1««0; /* 使 能 GPT1 */ 


/* 一 下 屏蔽 的 代码 是 GPT 定时 器 中 断代 码 ， 
* 如 果 想 学 习 GPT 定时 器 的 话 可 以 参考 一 下 代码 。 
*/ 

Kif O 

/ * 
* GPT 的 PR 寄存 器 ，GPT 的 分 频 设置 
* bit11:0 设置 分 频 值 ， 设 置 为 0 表示 1 分 频 ， 
* 以 此 类 推 ， 最 大 可 以 设置 为 0XEEE， 也 就 是 最 大 4096 分 频 
*/ 





GPT1-»PR = 65; /* 66 分 频 ，GPT1 时 钟 为 66M/ (65+1)=1MHz */ 
/ * 
* GPT 的 OCR1 寄存 器 ，GPT 的 输出 比较 1 比较 计数 值 ， 
* 当 GPT 的 计数 值 等 于 OCR1 里 面值 时 候 ， 输 出 比较 1 就 会 发 生 中 断 
* 这 里 定时 500ms 产生 中 断 ， 因 此 就 应 该 为 1000000/2=500000; 
es 

GPT1-»OCR[0] = 500000; 














/ * 

* GPT 的 IR 寄存 器 ， 使 能 通道 1 的 比较 中 断 
* bit0: 0 使 能 输出 比较 中 断 

bt 

GPT1-»IR |» 1 «« 0; 
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63 
64 As 
65 * 使 能 GIC 里 面相 应 的 中 断 ， 并 且 注 册 中 断 处 理 函 数 
66 x 
67 GIC_EnableIRQ(GPT1_IRQn);  /* 使 能 GIC 中 对 应 的 中 断 */ 
68 system rəgister irghancdler (mn 
(system irq handler t)gptl irqghandler, 
NULL); 
69 enda 
70 
gi f 
K2 
D3 ara O 
74 /* 中 断 处 理 函数 */ 
75 void goril irghandler (void) 
VIGET 
77 Static unsigned char state = 0; 
78 state = '!state; 
T9 rz 
80 * GPT 的 SR 寄存器， 状态 寄存 器 
81 * bit2: 1 f$tH EE 1 AER 
82 AU 
83 if(GPT1-»SR & (1««0)) 
84 { 
85 lee smiten (LED, STETS) s 
86 ) 
87 GPT1->SR |= 1««0; /* 清除 中 断 标志 位 */ 
88 ) 
89 dendif 
90 
HL. Rm 
92  * Qdescription : 微 秒 (us) 级 延 时 
93  * Qparam - value : 需要 延 时 的 us 数 , 最 大 延 时 0XFFFFFFFFUS 
94  * Qreturn s 2B 
DES. 
96 void delayus (unsigned int usdelay) 
Su wq 
98 unsigned long oldcnt,newocnt; 
99 unsigned long tcntvalue = 0; /* 走 过 的 总 时 间 */ 
100 
IRON oldcnt = GPT1-»CNT; 
102 while(!) 
103 { 
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104 newcnt - GPT1-»CNT; 

OS if(newcnt != oldcnt) 

106 { 

107 if(newcnt > oldocnt) /* GPT EI Eiis, HARA */ 
108 tcntvalue += newcnt - oldcent; 

109 else /* Aid ue 
EIE tentvalue -*- OXFFFFFFFF-oldcnt * Newent, 





ILa oldcnt = newcnt; 

1352 if(tcntvalue >= usdelay) /* 延 时 时 间 到 了 */ 
S break; /* Bkh i 
114 } 

TIS } 

JS i 

TAN 

UE e 

119 * Qdescription : 毫秒 (ms) 级 延 时 

120 * @param - msdelay : 需要 延 时 的 ms 数 

121 * Qreturn E JE 

32. S 

123 void delayms (unsigned int msdelay) 

124 ( 

112/55; int i - 0; 

126 for(iz0; i«msdelay; i++) 

1527 7) { 

1152/8] delayus (1000); 

12/6] } 

ISO i; 

Tad 

JUS ss 

133 * Qdescription  : 短 时 间 延 时 函数 

134 * param - n : 要 延 时 循环 次 数 ( 空 操作 循环 次 数 ， 模 式 延 时 ) 
135 * Qreturn 3 JE 

i9 wy 

137 void delay short(volatile unsigned int n) 
J 

ISS) while (n--){} 

140 } 

141 

WAR f 

143 * @description : 延 时 函数 ,在 396Mhz 的 主 频 下 
144 * 延 时 时 间 大 约 为 Ims 

145 * (aiparam - n : 要 延 时 的 ms 数 

146 * Qreturn 3 JE 
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加 

148 void delay(volatile unsigned int n) 

149 ( 

150 while (n--) 

JUS { 

152 delay short (0x7ff); 

53 } 

154 ) 


文件 bsp delay.c 中 一 共有 5 个 函数 ， 分 别 为 : delay init, delayus, delayms . delay short 
和 delay。 除 了 delay short 和 delay 以 外 ， 其 他 三 个 都 是 新 增加 的 。 函 数 delay init 是 延 时 初始 
化 函数 ， 主 要 用 于 初始 化 GPTI 定时 器 ,设置 其 时 钟 源 、 分 频 值 和 输出 比较 寄存 器 值 。 第 43 到 
68 行 被 屏蔽 掉 的 程序 是 GPTI 的 中 断 初始 化 代码 ， 如 果 要 使 用 GPTI 的 中 断 功 能 的 话 可 以 参考 
此 部 分 代码 。 第 73 到 89 行 被 屏蔽 掉 的 程序 是 GPTI 的 中 断 处 理 函 数 gptl irqhandler， 同 样 的 ， 
如 果 需 要 使 用 GPTI 中 断 功 能 的 话 可 以 参考 此 部 分 代码 。 

函数 delayus 和 delayms 就 是 us 级 和 ms 级 的 高 精度 延 时 函数 ， 函 数 delayus 就 是 按照 我 们 
在 20.1.2 小 节 讲 解 的 高 精度 延 时 原理 编写 的 ，delayus 函数 处 理 GPT1 计数 器 溢出 的 情况 。 函 数 
delayus 只 有 一 个 参数 usdelay， 这 个 参数 就 是 要 延 时 的 us 数 。delayms 函数 很 简单 ， 就 是 对 
delayus(1000) 的 多 次 车 加 ， 此 函数 也 只 有 一 个 参数 msdelay， 也 就 是 要 延 时 的 ms 数 。 

最 后 修改 mian.c 文件 ， 内 容 如 下 : 

示例 代码 20.3.3 main.c 文件 代码 


/玉米 类 火炎 火炎 火炎 火炎 类 大 火炎 类 大 类 类 大 大 类 类 大 类 类 类 大 大 类 大 大 大 类 大 大 大火 大 大大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 类 大 类 大 类 大 大 















































Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 


文件 名 : mian.c 

Ed : 左 忠 凯 

版 本 SO 

描述 : I.MX6U 开发 板 裸 机 实验 12 高 精度 延 时 实验 

其 他 : 本 实验 我 们 学 习 如 何 使 用 工 .MX6U 的 GPT 定时 器 来 实现 高 精度 延 时 ， 


以 前 的 延 时 都 是 靠 空 循环 来 实现 的 ， 精 度 很 差 ， 只 能 用 于 要 求 
不 高 的 场合 。 使 用 工 .MX6U 的 硬件 定时 器 就 可 以 实现 高 精度 的 延 时 ， 
最 低 可 以 做 到 20us 的 高 精度 延 时 。 

论坛 : www.openedv.com 


日 志 : 初版 V1.0 2019/1/15 左 忠 凯 创建 


KOKCKCKCKCkCKCkCk k kk kCk k Ck kCkCk kCkCk k kk k kk Ck kCk Ck kCk Ck k kk k kc k Ck kc k Ck kck ck kck ck ckck ck ckckck sk ke k kx 


























ne le gso ulis. int 
finclude "bsp delay.h" 
finclude "bsp led.h" 
finclude "bsp beep.h" 





finclude "bsp int.h" 





iaaedbs(eke "Joey iewaEst liue c Igi" 


/ * 


i 
2 
3 
4 
5j sisexedbwWele Hap kay dm 
6 
E] 
8 
8 
10 * Qdescription : main KZ 
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mm S 

T2 C frs TESTIS S XE 

I9. 4 

14 int main (void) 

di 

16 unsigned char state - OFF; 

257 

18 im 1 0d /* 初始 化 中 断 (一 定 要 最 先 调用 ! ) */ 
19 imx6u clkinit(); /* 初始 化 系统 时 钟 nA 
20 delay init(); /* 初始 化 延 时 */ 
2l clk enable(); /* 使 能 所 有 的 时 钟 jw 
22 led init(); /* 初始 化 lea z 
23 beep init(); /* 初始 化 beep ej 
24 

25 while(!) 

26 { 

2 state = !state; 

28 led switch(LED0, state); 

29 delayms (500); 

30 } 

zil 

32 return 0; 

280) 


main.c 函数 很 简单 ， 在 第 20 行 调用 delay init 函数 进行 延 时 初始 化 ， 最 后 在 while 循环 中 





周期 性 的 点 亮 和 熄灭 LED0， 调 用 函数 delayms 来 实现 延 时 。 
20.4 编译 下 载 验证 
20.4.1 编写 Makefile 和 链接 脚本 

















因为 本 章 例 程 并 没有 新 建 任何 文件 ， 所 以 只 需要 修改 Makefile 中 的 TARGET 为 delay BH 





可 ， 链 接 脚 本 报纸 不 变 。 


20.4.2 编译 下 载 








使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 delay.bin 文 











件 下 载 到 SD 卡 中 ， 命 令 如 下 : 
chmod 777 imxdownload /给予 imxdownload 可 执行 权 
./imxdownload delay.bin /dev/sdd / 烧 写 到 SD 卡 中 


限 ， 一 次 即 可 








烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 , 然后 复位 开发 板 。 程 序 运行 正常 的 话 LED0 








会 以 500ms 为 周期 不 断 的 亮 、 灭 闪烁 。 可 以 通过 肉眼 观察 LED 亮 灭 的 时 间 是 否 为 S00ms。 但 是 
肉眼 观察 肯定 不 准确 ， 既 然 本 章 号 称 高 精度 延 时 实验 ， 那 么 就 得 经 得 他 





























专业 仪器 的 测试 。 我 们 





将 “示例 代码 20.3.3” 中 第 29 行 ， 也 就 是 mian 函数 while 循环 中 的 延 时 改 为 “delayus(20)”， 也 
就 是 LEDO 亮 灭 的 时 间 各 为 20us， 那 么 一 个 完整 的 周期 就 是 20+20=40us，LED0 对 应 的 IO 频 
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率 就 应 该 是 1/0.00004=25000Hz=25KHz。 使 用 示波器 测试 LEDO 对 应 的 IO 频率 ， 结 果 如 图 
20.4.3.1 所 示 : 





























H 100us |1 





图 20.4.3.1 20us 延 时 波形 





























从 图 20.4.3.1 可 以 看 出 ，LED0 对 应 的 IO 波形 频率 为 22.3KHz， 周 期 是 44.9us， 那 么 main 
函数 中 while 循环 执行 一 次 的 时 间 就 是 44.9/2=22.45us， 大 于 我 们 设置 的 20us， 看 起 来 好 像 是 延 
时 不 准确 。 但 是 我 们 要 知道 这 22.45us 是 main 函数 里 面 while 循环 总 执行 时 间 ， 也 就 是 下 面 代 
码 的 总 执行 时 间 : 

while(1) 
{ 





































































































state = !state; 

led_switch(LEDO, state); 

delayus(20); 
} 
在 上 面 代码 中 不 止 有 delayus(20) 延 时 函数 , 还 有 控制 LED 灯亮 灭 的 函数 ， 这些 代码 的 执行 
也 需要 时 间 的 ， 即 使 是 delayus 函数 ， 其 内 部 也 是 要 消耗 一 些 时 间 的 。 假 如 我 们 将 while 循环 里 
面 的 代码 改 为 如 下 形式 : 
























































while(1) 

1 
GPIOI-^DR &- -(1««3); 
delayus(20); 
GPIOI --DR |= (1««3); 
delayus(20); 


} 





























上 述 代码 我 们 通过 直接 操作 寄存 器 的 方式 来 控制 IO 输出 高 低 电 平 , 理论 上 while 循环 执行 
时 间 会 更 小 ,并 且 while 循环 里 面 使 用 了 两 个 delayus(20)， 因 此 执行 一 次 while 循环 的 理论 时 间 
应 该 是 40us， 和 上 面 做 的 实验 一 样 。 重 新 使 用 示波器 测量 一 下 ， 结 果 如 图 20.4.3.2 所 示 : 

























































































pan 
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H 10.0us 120 








图 20.4.3.2 修改 while 循环 后 的 波形 











从 图 20.4.3.2 可 以 看 出 ， 此 时 while 循环 执行 一 次 的 时 间 是 41.8us， 那 么 一 次 delayus(20) 的 
时 间 就 是 41.8/2=20.9us， 很 接近 我 们 的 20us 理论 值 。 但 是 还 是 因为 有 其 他 程序 开销 存在 ， 在 加 
上 示波器 测量 误差 ， 所 以 不 可 能 测量 出 绝对 的 20us。 但 是 其 已 经 非常 接近 了 ， 基 本 可 以 证 明 我 
们 的 高 精度 延 时 函数 是 成 功 的 、 可 以 用 的 。 
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第 二 十 一 章 UART 串口 通信 实验 


不 管 是 单片机 开发 还 是 嵌入 式 Linux 开发 ， 串 口 都 是 最 常用 到 的 外 设 。 可 以 通过 串口 将 开 




















发 板 与 电脑 相连 ， 然 后 在 电脑 上 通过 串口 调试 助手 来 调试 程序 。 还 有 很 多 的 模块 ， 比 如 蓝牙 、 
GPS, GPRS 等 都 使 用 的 串口 来 与 主 控 进 行 通 信 的 ， 在 嵌入 式 Linux. 中 一 般 使 用 串口 作为 控 和 
台 ， 所 以 掌握 串口 是 必 备 的 技能 。 本 章 我 们 就 来 学 习 如 何 驱动 IMX6U 上 的 串口 ， 并 使 用 串口 
和 电脑 进行 通信 。 



































mm 
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21.1 LMX6U 串口 简介 


21.1.1 UART 简介 


1、UART 通信 格式 


串口 全 称 叫做 串 行 接口 ， 通 常 也 叫做 COM 接口 ， 串 行 接口 指 一 个 一 个 的 顺序 传 
输 ， 通 信 线 路 简单 。 使 用 两 条 线 即 可 实现 双向 通信 ， 一 条 用 于 发 送 ， 一 条 用 于 接收 。 串 口 通信 
距离 远 ， 但 是 速度 相对 会 低 ， 串 口 是 一 种 很 常用 的 工业 接口 。LMX6U 自 带 的 UART 外 设 就 是 
串口 的 一 种 ,UART 全 称 是 Universal Asynchronous Receiver/Trasmitter, 也 就 是 异步 串 行 收发 器 。 
既然 腊 步 串 行 收发 器 ， 那 肯定 也 有 同步 串 行 收发 器 ， 学 过 STM32 的 同学 应 该 知道 ，STM32 
除了 有 UART 外 ， 还 有 另外 一 个 叫做 USART 的 东西 。USART 的 全 称 是 Universal 
Synchronous/Asynchronous ReceiverTransmitter， 也 就 是 同步 /异步 串 行 收发 器 。 相 比 UART 多 了 
一 个 同步 的 功能 ， 在 硬件 上 体现 出 来 的 就 是 多 了 一 条 时 钟 线 。 一 般 USART 是 可 以 作为 UART 
使 用 的 ， 也 就 是 不 使 用 其 同步 的 功能 
UART 作为 串口 的 一 种 ， 其 工作 原理 也 是 将 数据 一 位 一 位 的 进行 传输 ， 发 送 和 接收 个 用 一 





























































































































条 线 ， 因 此 通过 UART 接口 与 外 界 相连 最 少 只 需要 三 条 线 : TXD( 发 送 )、RXD( 接 收 ) 和 GND( 地 
线 )。 图 21.1.1.1 就 是 UART 的 通信 格式 : 


一 一 一 一 个 字 节 的 数据 一 一 一 一 > 
1 1 2 3 4 T 











LESE asd giu 

LEFT Bg. 

! 位， 位 | < 位 有 效 位 一 一 一 > BC 位 | 位 | 

1 $ um ' 1 LI 
位 











图 21.1.1.1 UART 通信 格式 
图 21.1.1.1 中 各 位 的 含义 如 下 : 
空闲 位 : 数据 线 在 空闲 状态 的 时 候 为 逻辑 “1 状态 , 也 就 是 高 电 平 , 表示 没有 数据 线 空 闲 ， 

没有 数据 传输 。 
起 始 位 : 当 要 传输 数据 的 时 候 先 传输 一 个 逻辑 “0”， 也 就 是 将 数据 线 拉 低 ， 表 示 开 始 数据 

传输 。 
数据 位 ; 数据 位 就 是 实际 要 传输 的 数据 ， 数 据 位 数 可 选择 5-8 位 ， 我 们 一 般 都 是 按照 字 节 
传输 数据 的 ， 一 个 字 节 8 位 ， 因 此 数据 位 通常 是 8 位 的 。 低 位 在 前 ， 先 传输 ， 高 位 最 后 传输 。 
奇偶 校 验 位 ， 这 是 对 数据 中 “1” 的 位 数 进行 奇偶 校 验 用 的 ， 可 以 不 使 用 奇偶 校 验 功 能 。 
停止 位 : 数据 传输 完成 标志 位 ,停止 位 的 位 数 可 以 选择 1 位 、1.5 位 或 2 位 高 电 平 ， 一般 都 
选择 1 位 停止 位 。 
波 特 率 : 波 特 率 就 是 UART 数据 传输 的 速率 , 也 就 是 每 秒 传输 的 数据 位 数 , 一 般 选 择 9600, 
19200、115200 等 。 


2、UART 电 平 标准 
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UART 一 般 的 接口 电 平 有 TTL 和 RS-232， 一 般 开 发 板 上 都 有 TXD 和 RXD 这 样 的 引 脚 ， 
这 些 引 脚 低 电 平 表示 逻辑 0， 高 电 平 表示 逻辑 1， 这 个 就 是 TTL 电 平 。RS-232 采用 差分 线 ，-3~- 
15V 表示 逻辑 1，+3~+15V 表示 逻辑 0。 一 般 图 21.1.1.2 中 的 接口 就 是 TTL. 电 平 : 















































| VCC , 7 | 
y op , ATK-USB-UART-V12: 
RD www.openedv.com 


s www.alientek.com i'd 
- 4 Eie 


| © RTS | 
acis. / D CON ALIENTEK į 


图 21.1.1.2 TTL 电 平 接口 
图 21.1.1.2 中 的 模块 就 是 USB 转 TTL 模块 ，TTL 接口 部 分 有 VCC、GND、RXD、TXD、 
RTS 和 CTS。RTS 和 CTS 基本 用 不 到 ， 使 用 的 时 候 通 过 杜邦 线 和 其 他 模块 的 TTL 接口 相连 即 
可 。 
RS-232 电 平 需要 DB9 接口 , LMX6U-ALPHA 开发 板 上 的 COM3(UART3) 口 就 是 RS-232 接 
口 的 ， 如 图 21.1.1.3 所 示 : 



























































图 21.1.1.3 LMX6U-ALPHA 开发 板 RS-232 接口 
由 于 现在 的 电脑 都 没有 DB9 接口 了 ， 取 而 代 之 的 是 USB 接口 ， 所 以 就 催生 出 了 很 多 USB 
转 串 口 TTL 芯片 ,比如 CH340、PL2303 等 .通过 这 些 芯片 就 可 以 实现 串口 TTL 转 USB. I.MX6U- 
ALPHA 开 发 板 就 使 用 CH340 芯片 来 完成 UART1 和 电脑 之 间 的 连接 , 只 需要 一 条 USB 线 即 可 ， 
如 图 21.1.1.4 所 示 。 












































USB 转 TTL 接 口 ,使 用 





图 21.1.1.4 LMX6U-ALPHA 开发 板 USB 转 TTL 接口 
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21.1.2 LMX6U UART 简介 


上 一 小 节 介 绍 了 UART 接口 ， 本 小 节 来 具体 看 一 下 IMX6U 的 UART 接口 ，LMX6U 一 共 
有 8 个 UART， 其 主要 特性 如 下 : 

(QD. FX TIA/EIA-232F 标准 ， 速 度 最 高 可 到 5Mbit/S. 
@、 支 持 串 行 IREO, WA IDA， 最 高 可 到 115.2Kbit/s。 
©, XF 9 位 或 者 多 节点 模式 (RS-485)。 
(4), 
©, 

















1 或 2 位 停止 位 。 
可 编程 的 奇偶 校 验 ( 奇 校 验 和 偶 校 验 )。 

@@、 自 动 波 特 率 检测 (最 高 支持 115.2Kbit/S). 

LMX6U 的 UART 功能 很 多 ， 但 是 我 们 本 章 就 只 用 到 其 最 基本 的 串口 功能 ， 关 于 UART 其 
它 功 能 的 介绍 请 参考 《I.MX6ULL 参考 手册 》 第 3561 页 的 “Chapter 55 Universal Asynchronous 
Receiver/Transmitter(UART)” 章 节 。 

UART 的 时 钟 源 是 由 寄存 器 CCM. CSCDRI 的 UART_CLK_SEL(bit) 位 来 选择 的 , 当 为 0 的 
时 候 UART 的 时 钟 源 为 pll3_80m(80MHz)， 如 果 为 1 的 时 候 UART 的 时 钟 源 为 osc_clk(24M)， 
一 般 选 择 pll3_80m 作为 UART 的 时 钟 源 。 寄 存 器 CCM CSCDRI 的 UART_CLK_PODF(bit5:0) 
位 是 UART 的 时 钟 分 频 值 ， 可 设置 0~63， 分 别 对 应 1-64 分 频 ， 一 般 设置 为 1 分 频 ， 因 此 最 终 
进入 UART 的 时 钟 为 80MHz。 

接 下 来 看 一 下 UART 几 个 重要 的 寄存 器 ， 第 一 个 就 是 UART 的 控制 寄存 器 1， 即 
UARTx_UCR1(x=1~8)， 此 寄存 器 的 结构 如 图 21.1.2.1 所 示 : 






































Bit 15 14 12 11 10 9 8 7 6 3 2 1 
z z z 之 
R z z & frr z x Z & z 
iu iu Es P iu [s u d iu 
> > i a tü i i E 
à â & a D a T 
w FE Ex Zitilá&K RIE E 
x c T č o [es « 
Reset 0 0 0 0 0 0 0 0 0 


21.1.2.1 寄存 器 UARTx UCRI 结构 
寄存 器 UARTx UCRI 我 们 用 到 的 重要 位 如 下 : 
ADBR(bit14): 自动 波 特 率 检测 使 能 位 ， 为 0 的 时 候 关 闭 自动 波 特 率 检测 ， 为 1 的 时 候 使 
能 自动 波 特 率 检测 。 
UARTEN(bit0): UART 使 能 位 ， 为 0 的 时 候 关 闭 UART， 为 1 的 时 候 使 能 UART. 
接 下 来 看 一 下 UART 的 控制 寄存 器 2， 即 : UARTx UCR2， 此 寄存 器 结构 如 图 21.1.2.2 所 
ZN: 
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Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 











图 21.1.2.2 寄存 器 UARTx UCR2 结构 

寄存 器 UARTx UCR2 用 到 的 重要 位 如 下 : 

IRTS(bit14): 为 0 的 时 候 使 用 RTS 引 脚 功能 ， 为 1 的 时 候 忽略 RTS 引 脚 。 

PREN(bit8): 奇偶 校 验 使 能 位 ， 为 0 的 时 候 关 闭 奇偶 校 验 ， 为 1 的 时 候 使 能 奇偶 校 验 。 

PROE(bit7): 奇偶 校 验 模式 选择 位 ， 开 启 奇 偶 校 验 以 后 此 位 如 果 为 0 的 话 就 使 用 偶 校 
验 ， 此 位 为 1 的 话 就 使 能 奇 校 验 。 

STOP(bit6): 停止 位 数量 ， 为 0 的 话 1 位 停止 位 ， 为 1 的 话 2 位 停止 位 。 

WS(bitS): 数据 位 长 度 ， 为 0 的 时 候选 择 7 位 数据 位 ， 为 1 的 时 候选 择 8 位 数据 位 。 

TXEN(bit2): 发 送 使 能 位 ， 为 0 的 时 候 关 闭 UART 的 发 送 功能 ， 为 1 的 时 候 打 开 UART 





的 发 送 功能 。 

RXEN(bit1): 接收 使 能 位 ， 为 0 的 时 候 关 闭 UART 的 接收 功能 ， 为 1 的 时 候 打 开 UART 
的 接收 功能 。 

SRST(bit0): 软件 复位 ， 为 0 的 是 时 候 软 件 复位 UART， 为 1 的 时 候 表示 复位 完成 。 复 位 














完成 以 后 此 位 会 自动 置 1， 表 示 复 位 完成 。 此 位 只 能 写 0， 写 1 会 被 忽略 掉 。 





接 下 来 看 一 下 UARTx_UCR3 寄存 器 ， 此 寄存 器 结构 如 图 21.1.2.3 所 示 : 








AIRINTEN 
AWAKEN 
DTRDEN 





o| PARERREN | 总 
o| FRAERREN 
o| RXDMUXSEL |» 


21.1.2.3 UARTx UCR3 寄存 器 结构 体 
本 章 实验 就 用 到 了 寄存 器 UARTx UCR3 中 的 位 RXDMUXSEL(bit2), 这 个 位 应 该 始终 为 1， 
找 个 在 《I.MX6ULL 参考 手册 》 第 3624 页 有 说 明 。 
接 下 来 看 一 下 寄存 器 UARTx USR2， 这 个 是 UART 的 状态 寄存 器 2， 此 寄存 器 结构 如 图 
21.1.2.4 所 示 : 
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Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 








Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 
Bit 15 14 13 12 11 10 9 8 Y 6 5 4 3 2 1 0 

m w u = 5 上 LJ z z u o a 
ag Elaa B8 £z|l2|£|[8]|8|8|8 g E 8 
«|^lo|^|«&|g tts & | & r | Ff ia| Oj 





Reset 0 1 0 0 0 0 0 0 0 0 1 0 1 0 0 0 
图 21.1.2.4 寄存 器 UARTx USR2 结构 

寄存 器 UARTx USR2 用 到 的 重要 位 如 下 : 

TXDC(bit3): 发 送 完成 标志 位 ， 为 1 的 时 候 表 明 发 送 缓冲 (TxFIFO) 和 移 位 寄存 器 为 空 ， 也 
就 是 发 送 完成 ， 向 TxFIFO 写 入 数据 此 位 就 会 自动 清 零 。 

RDR(bito) : 数据 接收 标志 位 ， 为 1 的 时 候 表明 至 少 接收 到 一 个 数据 ， 从 寄存 器 
UARTx URXD 读 取 数据 接收 到 的 数据 以 后 此 为 会 自动 清 零 。 

接 下 来 看 一 下 寄存 器 UARTx UFCR UARTx UBIR 和 UARTx UBMR, ， 寄 存 器 
UARTx UFCR 中 我 们 要 用 到 的 是 位 RFEDIV(bit9:7)， 用 来 设置 参考 时 钟 分 频 ， 设 置 如 表 21.1.2.1 






































所 示 : 
ESTNE NENNEN 

000 6 分 频 
001 5 分 频 
010 4 分 频 
011 3 分 频 
100 2 分 频 
101 1 分 频 
110 7 分 频 
111 保留 

















表 21.1.2.1 RFDIV 分 频 表 
通过 这 三 个 寄存 器 可 以 设置 UART 的 波 特 率 ， 波 特 率 的 计算 公式 如 下 : 
Baud Rate = O 
C6 TBR FI? 
Ref Freq: 经 过 分 频 以 后 进入 UART 的 最 终 时 钟 频率 。 
UBMR: 寄存 器 UARTx UBMR 中 的 值 。 
UBIR: 寄存 器 UARTx UBIR 中 的 值 。 
通过 UARTx UFCR 的 RFDIV 4, UARTx UBMR 和 UARTx UBIR 这 三 者 的 配合 即 可 得 
到 我 们 想 要 的 波 特 率 。 比 如 现在 要 设置 UART 波 特 率 为 115200， 那 么 可 以 设置 RFDIV 为 
5(0b101D)， 也 就 是 1 分 频 ， 因 此 Ref Freq=80MHz。 设 置 UBIR=71，UBMR=3124， 根 据 上 面 的 
公式 可 以 得 到 : 























Ref Fre 80000000 
Baud Rate = Banm = 一 5 = 115200 
( UBIR * 1) (16 x 71+1 


最 后 来 看 一 下 寄存 器 UARTx URXD 和 UARTx UTXD， 这 两 个 寄存 器 分 别 为 UART 的 接 
收 和 发 送 数据 寄存 器 ， 这 两 个 寄存 器 的 低 八 位 为 接收 到 的 和 要 发 送 的 数据 。 读 取 寄 存 器 
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UARTx URXD 即 可 获取 到 接收 到 的 数据 ， 如 果 要 通过 UART 发 送 数据 ， 直 接 将 数据 写 入 到 寄 





存 器 UARTx UTXD 即 可 。 

XT UART 的 寄存 器 就 介绍 到 这 里 ， 关 于 这 些 寄存 器 详细 的 描述 ， 请 参考 《LMX6ULL 参 
考 手 册 》 第 3608 页 的 55.15 小 节 。 本 章 我 们 使 用 IMX6U 的 UARTI 来 完成 开发 板 与 电脑 串口 
调试 助手 之 间 串 口 通信 ， UARTI 的 配置 步骤 如 下 : 

1、 设 置 UARTI 的 时 钟 源 

设置 UART 的 时 钟 源 为 pll3 80m， 设 置 寄存 器 CCM CSCDRI 的 UART CLK SEL 位 为 0 



























































即 可 。 
2、 初 始 化 UARTI 
初始 化 UARTI 所 使 用 IO， 设 置 UARTI1 的 寄存 器 UARTI UCRI-UARTI UCR3, 设置 内 
容 包括 波 特 率 ， 奇 偶 校 验 、 停 止 位 、 数 据 位 等 等 。 

4、 使 能 UARTI 

UARTI 初始 化 完成 以 后 就 可 以 使 能 UART1 了 ， 设 置 寄存 器 UART1_UCR1 的 位 UARTEN 
为 1 。 

5、 编 写 UARTI 数据 收发 函数 

编写 两 个 函数 用 于 UARTI1 的 数据 收发 操作 。 


21.2 硬件 原理 分 析 


本 试验 用 到 的 资源 如 下 : 

(D. —^* LED 灯 : LEDO. 

©, &HI. 

LMX6U-ALPHA 开发 板 串口 1 硬件 原理 图 如 图 22.2.1 所 示 : 




















DCDC 5V 


VUSB 







USB 232 


CH340 D- 








C78 
104 
GND 
C79 C80 
22 22 
GND 
UARTI TXD RXD KI4UARTI TXD 
2 4 | 
UARTI RXD| |] DD [F OUT/UARIS TX'TeTGUARTI RXD 


[Ol IO17/SPDIF IN 
JP5 


图 22.2.1 LMX6U-ALPHA 开发 板 串口 1 原理 图 
在 做 实验 之 前 需要 用 USB 串口 线 将 串口 1 和 电脑 连接 起 来 ， 并 且 还 需要 设置 JPS MRE, 
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将 串口 1 的 RXD、TXD 两 个 引 脚 分 别 于 P116、P117 连接 一 起 ， 如 图 22.2.2 所 示 ; 


| oO— 





eo 

JP5 o co 

RET o 
TXD 


vU RXD P116(T) 
| P11 Do) 





图 22.22 串口 1 硬件 连接 设置 图 
硬件 连接 设置 好 以 后 就 可 以 开始 软件 编写 了 ， 本 章 实验 我 们 初始 化 好 UART1， 然 后 等 待 
SecureCRT 给 开发 板 发 送 一 个 字 节 的 数据 ， 开 发 板 接收 到 SecureCRT 发 送 过 来 的 数据 以 后 在 同 
通过 串口 1 发 送 给 SecureCRT。 


21.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 13_uart。 

本 章 实 验 在 上 一 章 例 程 的 基础 上 完成 ， 更 改 工 程 名 字 为 “uart”， 然 后 在 bsp 文件 夹 下 创建 
名 为 “uart” 的 文件 夹 , 然后 在 bsp/uart 中 新 建 bsp_uart.c 和 bsp uart.h 这 两 个 文件 。 在 bsp. uart.h 
中 输入 如 下 内 容 : 




















示例 代码 21.3.1 bsp_uatth 文件 代码 








1 #ifndef BSP UART H 

2 #define BSP UART H 

3 4include "imxóul.h" 

A0 KCKOK KK kk kk kk de kk ek KC kk Kk ke KK de KICK KORR KK d KK KORR KORR ROO 
5 Copyrigae © zioznonekar Coco, bech 1996-2019. ALL sese ee ee 
E Xia 3 bgp varch 

R : 左 忠 凯 

8 版 本 g Wil. 

9 描述 : FE SC PESCE. 

10 其 他 E 

11 1555 : www.openedv.com 

12 55s : WIR v1.0 2019/1/15 左 忠 凯 创建 





Ilet KCKCKCKCkCKCk kCkCk kCkCck k k Ck Ck kCkCk k kk k kc k k kk Ck k Ck Ck kCkCk k kk k kc k Ck kc k Ck kck ck kck ck ckckck ckckck kk kk f 


15 /ed */ 
i$; wel tekeleie imit (Vore) 9 
17 voici wert io aloe (waa) P 


18 void uart disable(UART Type *base); 
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19 voici uert enelsle (VART Type wiomse 7 

20 void uart softreset (UART Type *base); 

21 void uart setbavcdrate (UART Type “ase, 


unsigned int baudrate, 
wuaksiiiGpoKexe! imne jewexedhexele ha) p 
2/27 wexiel pute em (eene (6) P 
Sl px (Char ASEE) 
24 unsigned char gete (void), 


Z5: Wale iemeLexe (bee Sle wey p 


27 #endif 
文件 bsp uart.h 内 容 很 简单 ， 就 是 一 些 函数 声明 。 继 续 在 文件 bsp. uart.c 中 输入 如 下 所 示 
内 容 : 








示例 代码 21.3.2 bsp_uatt.c 文件 代码 


J[KCKCKCKCKCKCKCk KCkCk kCkCk kCKCKCkCKCkCk KCkCk KOC KC kCkCkCkCKCkCk kCk ck k k Ck Ck kc k Ck k ck ck k kc k k kc k kck ck kckck ck ck ck k 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 se 


作者 : 左 忠 凯 
版 本 g Vas 
描述 eal ya 
其 他 NS In 
论坛 : Www.openedv.com 
E : 初版 V1.0 2019/1/15 左 忠 凯 创建 


KCKCKCKCkCKCk kCkCk k kk k kk Ck k Ck Ck kCk Ck k kk k k Ck Ck kCk Ck kk k k kc k k kk k kc kckckck ck kck ck ckck ck ckokck kk e kk / 


l  spaamelbsele "se queue sm" 


2 

3ye 

4 * Qdescription : 初始 化 串口 1 波 特 率 为 115200 

5 * (üiparam 3 JE 

6 * Qreturn 8 B 

7 RA 

8 vorc wart imite oa) 

2g ox 

10 /* 1. Wd ne */ 

Ta uart 10 init () 8 

152) 

13 /* 2. AR 

14 uart disable (UART1); /* 先 关 闭 UARTI */ 
l5 uart softreset (UART1); /* 软件 复位 UART1 */ 
16 

8 UART1-»UCR1 = 0; /* 先 清除 UCR1 寄存 器 */ 
18 UART1->UCR1 &= «(1««14); /* 关闭 自动 波 特 率 检 测 。 */ 
19 
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20 [5 

2 * 设置 UART 的 UCR2 寄存 器 ， 设 置 字 长 ， 停 止 位 ， 校 验 模式 ， 关 闭 硬件 流 控 
22 * bit14: 1 忽略 RTS 引 脚 

23 * bit8: 0 关闭 奇偶 校 验 

24 * bit6: 0 1 位 停止 位 

25 * bits: 1 8 位 数据 位 

26 * bit2: 1 1TJ AXE 

27 * bit1: 1 打开 接收 

28 i 

29 UART1->UCR2 |= (1««14) | (1««5) | (1««2) | (1««1); 

30 UART1-»UCR3 |= 1««2; /* UCR3 的 bit2 必须 为 1 */ 

31 

E? Js 

33 * 设置 波 特 率 

34 * 波 特 率 计算 公式 :Baud Rate = Ref Freq / (16 * (UBMR + 1)/ (UBIR+1)) 
35 * 如 果 要 设置 波 特 率 为 115200， 那 么 可 以 使 用 如 下 参数 : 

36 * Ref Freq = 80M 也 就 是 寄存 器 UFCR 的 bit9:7=101， 表 示 1 分 频 
3 * UBMR = 3124 

38 SUBIRE 

39 * 因此 波 特 率 = 80000000/(16 * (312441)/(71*1)) 

40 * = 80000000/(16 * 3125/72) 

41 * - (80000000*72) / (16*3125) 

42 * = 115200 

43 nA 

44 UART1-»UFCR = 5««7; /* get freq ^T ipg clk/1-80Mhz */ 
45 UARTI-»UBIR -2 71; 

46 UART1->UBMR = 3124; 

47 

48 sif 0 

49 uart setbaudrate(UART1, 115200, 80000000); /* 设置 波 特 率 */ 
50 gendir 

51 

52 uart enable(UART1); /* [EBERLII */ 

53 j 

54 

Ss gH 

56  * Qdescription  : 初始 化 串口 1 所 使 用 的 ro 引 脚 

i * (üiparam 3 JE 

58  * Qreturn 8 

59  */ 

60 void uart io init (void) 

61 ( 

62 /* 1. Jik EH Io 
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63 * UARTI RXD -» UARTI TX DATA 

64 * UART1 TXD -» VARTI RX DATA 

65 e 

66 IOMUXC SetPinMux(IOMUXC UART1 TX DATA UART1 TX, 0); 

67 IOMUXC SetPinMux(IOMUXC UART1 RX DATA UART1 RX, 0); 

68 IOMUXC SetPinConfig(IOMUXC UART1 TX DATA UART1 TX, 0x10B0); 
69 IOMUXC SetPinConfig(IOMUXC UART1 RX DATA UART1 RX, 0x10B0); 
70 ] 

qat 

WA 4 

73  * Qdescription : 波 特 率 计 算 公式 ， 

74 È 可 以 用 此 函数 计算 出 指定 串口 对 应 的 UFCR， 
mes UBIR 和 UBMR 这 三 个 寄存 器 的 值 

76  * Qparam - base : 要 计算 的 串口 。 

qd * (param - baudrate : 要 使 用 的 波 特 率 。 

78  * Q(param - srcclock hz : 串口 时 钟 源 频 率 ， 单 位 Hz 

79  * Qreturn a Z5 

80 i 


81 void uart setbaudrate(UART Type *base, 
unsigned int baudrate, 


unsigned int srcclock hz) 


926 

83 uint32 t numerator = Ou; 

84 uint32 t denominator = 0U; 

85 uint32 t divisor = 0U; 

86 ignes? © refreDiv = (000g 

87 uint32 t divider = 1U; 

88 uint64 t baudDiff -2 0U; 

89 uint64 t tempNumerator - 0U; 
90 uint32 t tempDenominator = 0u; 
iil 

92 /* get the approximately maximum divisor */ 
93 mm ae ee oz 

94 denominator = baudrate << 4; 
95 divisor NC 

96 

9 while (denominator !- 0) 

98 { 

9S divisor = denominator; 

100 denominator = numerator $ denominator; 
IKONE numerator = divisor; 

102 } 

103 
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104 numerator = srcclock hz // gas 

1O05 denominator = (baudrate << 4) / divisor; 

106 

107 /* numerator ranges from l « 7 * 64k */ 

108 /* denominator ranges from 1 -« 64k */ 

TOS if ((numerator » (UART UBIR INC MASK * 7)) || (denominator » 
UART UBIR INC MASK)) 

110 { 

ITE ind e m = (nmeraor = 1) / (UART SUR TNE MASK = 7) i Ip 

w2 uint32 t n = (denominator - 1) / UARE UBIR LING MASEK ap 11g 

ALS uint 15 mex =m >n gmn S mng 

TA numerator /2 max; 

JE.) denominator /= max; 

IEG if (0 == numerator) 

dL3 9 { 

118 numerator = 1; 

15159 ) 

120 if (0 == denominator) 

Zil { 

122 denominator = |; 

12S } 

124 } 

25 divider = (numerator - 1) / UART UBIR INC MASK + 1; 

126 

215277) switch (divider) 

128 { 

TAS case 1|: 

130 refFreqDiv = 0x05; 

dL Syl break; 

1592 case 2: 

11:559) refFreqDiv = 0x04; 

134 break; 

T35 case 3: 

136 refFreqDiv = 0x03; 

S break; 

198 case 4: 

JST) refFreqDiv = 0x02; 

140 break; 

141 case 5: 

142 refFreqDiv = 0x01; 

143 break; 

144 case 6: 

145 refFreqDiv = 0x00; 
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146 break; 

147 case /: 

148 refFreqDiv = 0x06; 

149 break; 

S default: 

LS refFreqDiv = 0x05; 

152 break; 

153 

154 /* Compare the difference between baudRate Bps and calculated 

T55 * baud rate. Baud Rate - Ref Freq / (16 * (UBMR -* 1)/(UBIR-*1)). 

LSG ** paudDicf = (ercClock Mz/aivider)/ ( 118 numerator / 
divider)/ denominator). 

1557 À 

158 tempNumerator — srcclock hz; 

15/9 tempDenominator = (numerator «« 4); 

160 divisor = 1; 

iSd /* get the approximately maximum divisor */ 

ROZ while (tempDenominator != 0) 

TES { 

164 divisor = tempDenominator; 

JS) tempDenominator = tempNumerator $ tempDenominator; 

166 tempNumerator = divisor; 

167 } 

168 tempNumerator = srcclock hz / divisor; 

1569 tempDenominator = (numerator «« 4) / divisor; 

170 baudDiff = (tempNumerator * denominator) / tempDenominator; 

d grt baudDiff - (baudDiff »-2 baudrate) ? (baudDiff - baudrate) 

(baudrate - baudDiff); 

dL 072 

S if (baudDiff « (baudrate / 100) * 3) 

174 { 

TES) base-2UFCR &- «UART UFCR RFDIV MASK; 

176 base-»UFCR |= UART UFCR RFDIV (refFreqDiv); 

WT base-»UBIR - UART UBIR INC(denominator - 1); 

IS base->UBMR = UART UBMR MOD (numerator / divider - 1); 

179 } 

Jio 

igal 

WIZ es 

183 * @description : 关闭 指定 的 UART 

184 * Qparam - base : 要 关闭 的 UART 

185 * Masri e Jb 

ld 2 
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LE 
188 
189 
190 
dL SE 
192 
19S 
194 
i95 
1L 95 
AT) 
198 
199 
200 
200 
202 
203 
204 
205 
206 
207 
208 
209 
210 
2b 
212 
2S 
214 
25 
26 
2al 
218 
219) 
220 
22 
222 
228 
224 
275 
226 
22 
228 
229 


void uart disable(UART Type *base) 


( 
base-»UCR1 &= «4(1««0); 


/* 
* (description  : 打开 指定 的 UART 
* @param - base : 要 打开 的 UART 

* Qreturn 3 JE 

BA 

void uart enable(UART Type *base) 
( 


base-»UCR1 |= (1««0); 
) 
/* 
* Qdescription  : 复位 指定 的 UART 
* @param = base : 要 复位 的 UART 
* Qreturn TE 
A 


void uart softreset(UART Type *base) 


( 
base-»UCR2 &= ~(1<<0); 


while((base-»UCR2 & 0x1) == 0); 
} 
/* 
* Qdescription  : sos PS i 
* (param - c : 要 发 送 的 字符 
* Qreturn S DE 
a 


void putc(unsigned char c) 


{ 


e31E B B 


论坛 :www.opendev.com 


/* 复位 UART F 


/* 等 待 复位 完成 */ 


while(((UART1-»USR2 >> 3) &0X01) == 0);/* 等 待 上 一 次 发 送 完 成 


UARTI-»2UTXD — c & OXFF; 


/* 
* Qdescription  : A a 
* (param - str  : 要 发 送 的 字符 串 
* (üóreturn 3 JE 

30 


void puts(char *str) 
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250 

2o Char rka p= Str 

292 

233 while (*p) 

234 pute (*p-tt); 

Zu 

296 

297 f 

238 * Qgdescription  : $U—4ET 

239 * Qparam S 

240 * (return : 接收 到 的 字符 

2 

242 unsigned char getc(void) 

243-4 

244 while((UART1-»USR2 & 0x1) == 0);  /* 等 待 接收 完成 */ 
245 return UART1-»URXD; /* 返回 接收 到 的 数据 */ 
246 ) 

247 

QNS fes 

249 * Qdescription  : 防止 编译 器 报错 

250 * Gparam NS 

251 * Greturn 3 Jb 

2E s 

25:3! VOC ieeitexe (Gumi eie miz) 

254 ( 

299 

AI h 


文件 bsp_uart.c 中 共有 10 个 函数 ， 我 们 依次 来 看 一 下 这 些 函 数 都 是 做 什么 的 ， 第 一 个 函数 
是 uart_init， 这 个 函数 是 UARTI 初始 化 函数 , 用 于 初始 化 UARTI 相关 的 IO、 并 且 设 置 UARTI 
的 波 特 率 、 字 长 、 停 止 位 和 校 验 模式 等 ， 初 始 化 完成 以 后 就 使 能 UART1。 第 二 个 函数 是 
uart io_init， 用 于 初始 化 UART1 所 使 用 的 IO。 第 三 个 函数 是 uart setbaudrate， 这 个 函数 是 从 
NXP 官方 的 SDK 包 里 面 移植 过 来 的 ， 用 于 设置 波 特 率 。 我 们 只 需 将 要 设置 的 波 特 率 告 诉 此 函 
数 ， 此 函数 就 会 使 用 逐次 逼近 方式 来 计算 出 寄存 器 UARTI UFCR 的 FRDIV 人 位、 寄存器 
UARTI UBIR 和 寄存 器 UART1_UBMR 这 三 个 的 值 。 第 四 和 第 五 这 两 个 函数 为 uart_disable 和 
art enable, 分 别 是 使 能 和 关闭 UART1。 第 6 个 函数 是 uart_softreset, 用 于 软件 复位 指定 的 UART。 
肿 七 个 函数 是 putc, 用 于 通过 UARTI1 发 送 一 个 字 节 的 数据 。 第 八 个 函数 是 puts, 用 于 通过 UARTI1 
发 送 一 串 数据 。 第 九 个 函数 是 getc， 用 于 通过 UARTI1 获取 一 个 字 节 的 数据 ， 最 后 一 个 函数 是 
raise， 这 是 一 个 空 函 数 ， 防 止 编译 器 报错 。 

最 后 在 main.c 中 输入 如 下 所 示 内 容 : 

示例 代码 21.3.3 main.c 文件 代码 


/玉米 类 火炎 火炎 火炎 类 类 类 大火 类 大 大 类 类 类 类 类 类 大 类 类 类 大 大 类 大 大 大 类 大 大 大大 大大 大 类 大 大 大大 大 大 大 类 大 类 大 类 大 类 大 类 大 类 大 大 

































































nr S 














Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 TETEE 
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作者 : 左 忠 凯 

版 本 a Wb a 

描述 : I.MX6U 开发 板 裸 机 实验 13 串口 实验 

其 他 : 本 实验 我 们 学 习 如 何 使 用 工 .MX6 的 串口 ， 实 现 串口 收发 数据 ， 了 解 
I.MX6 的 串口 工作 原理 。 

论坛 : www.openedv.com 

目 志 : 初版 V1 .0 2019/1/15 左 忠 凯 创建 


OKCKCKCKCKCKCkCkCk Ck Ck k Ck Ck k k Ck k kCkCkCkCk kCkCk k k Ck ck k k ck k k ck k k ck k k ck ck k ckckck ck ckck ck ck ck sk ke ke e x x x f 


il 


人 


1B 
14 
Ig 
16 
Jy 
18 
EE 
20 
2 
22 
DS 
24 
25 
26 
2 
28 
29 
30 
Es 
97 
33 
34 
S5 


include "bsp cik:h" 
#include "bsp delay.h" 
finclude "bsp led.h" 
$&include "bsp beep.h" 
finclude "bsp key.h" 
finclude "bsp int.h" 
finclude "bsp uart.h" 
/ * 

* Qdescription : main 函数 
* Qparam 8 JE 
* Qreturn 3 JE 


i 


int main (void) 


{ 


unsigned char az0; 


unsigned char state - OFF; 
picem e) /* 初始 化 中 断 (一 定 要 最 先 调 用 ! ) 
imx6u clkinit(); /* 初始 化 系统 时 钟 
delay init(); /* 初始 化 延 时 
clk enable(); /* 使 能 所 有 的 时 钟 
led init(); /* 初始 化 leqd 
beep init(); /* 初始 化 peep 
uae /* 初始 化 串口 ， 波 特 率 115200 
while(!) 
{ 
puts ("mA 1-4 :U): 
a=getc () ; 
putc (a); /* 回 显 功能 */ 


PUES ee Nm). 


/* 显示 输入 的 字符 */ 


puts (" 您 输入 的 字符 为 :") ; 


e31E m B 
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36 putc (a); 

E Bot e (On Nas Vra NOE 1) 

38 

39 state = !state; 

40 led switch(LEDO0,state); 

41 } 

42 return 0; 

43 } 





第 5 行 调用 函数 uart init 初始 化 UART1， 最 终 在 while 循环 里 面 获取 串口 接收 到 的 数据 ， 
并 且 将 获取 到 的 数据 通过 串口 打印 出 来 。 


21.4 编译 下 载 验证 


21.4.1 编写 Makefile 和 链接 脚本 


在 Makefile 文件 中 输入 如 下 内 容 : 
示例 代码 21.4.1 Makefile 文件 代码 



























































1 CROSS COMPILE ?- arm-linux-gnueabihf- 

2 TARGET = Ua 

3 

Z2 EG := S$(CROSS COMPILE)gcc 

5 1 := $ (CROSS COMPILE)1d 

6 OBJCOPY := S$(CROSS COMPILE)objcopy 

7 OBJDUMP := $(CROSS COMPILE)objdump 

8 

9 LIBPATH ses leee =L /usr/local/arm/gec-linaro-T.3.1-2016.05= 
x86 64 arm-linux-gnueabihf/lib/gcc/arm-linux-gnueabihf/7.3.1 

10 

1I 

IZ TNCDITRS -= 

T3 bsp/clk V 

14 bsp/led \ 

15 bsp/delay \ 

16 bsp/beep \ 

17) bsp/gpio \ 

18 bsp/key \ 

19 bsp/exit \ 

20 bsp/int V 

2 bsp/epittimer \ 

22 bsp/keyfilter wN 

23 bsp/uart 

24 

DRS se gexeeject AN 

26 bsp/clk V 
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2 bsp/led WV 

28 bsp/delay N 

29 bsp/beep \ 

30 bsp/gpio \ 

Ell bsp/key \ 

32 bsp exitiN 

93 bsp/int V 

34 bsp/epittimer NV 

35 bsp/keyfilter NN 

36 bsp/uart 

357 

38 

39 INCLUDE = (Ss (enee 

40 

MS E TEES ex (forca ch air, S (SROCDIRS) S ivi ldeard S(O/ 9 59) 
A (CEILES ec gBemeechm ob, S(QSECIDImSS), S(wLlekesse S (eb) .)) 
43 

44 SFILENDIR = S(notdir $(SEILES)) 

45 CFILENDIR ac (ee (ES 

46 

47 SOBJS se (ls Ww. ole mp 6 SIE ILIIISNIDILRG 5559) ) 

48 COBJS c3 au OO a e CET TENDRE ee O) 

49 OBJS —- S$(SOBJS) S$(COBJS) 

50 

51 VPATH = S$(SRCDIRS) 

52 

SSEM PHONT: me ieam 

54 

55 S$(TARGET).bin : $(OBJS) 

56 S(LD) -Timx6ul.lds -o $(TARGET).elf $^ S(LIBPATH) 

Sy S$(OBJCOPY) -O binary -S S(TARGET).elf $Q 

58 $ (OBJDUMP) -D -m arm $ (TARGET) .elf > $ (TARGET) .dis 

59 

60 S(S908J$9) & obyg/$.9 9 9$ 

61 s (CC) mall -mostelil -fwe-lwsliim =e -02 (INCLUDE) -© $0 $< 
62 

55 S(COmBUJS) s ooJ/€.O 8 95€ 

64 SCC) wall -mesteinl —fme-louiliim =€ =02 S$(IENCLUDE) —o $8 $< 
65 

66 clean: 


67 rm -rf S(TARGET).elf S(TARGET).dis S(TARGET).bin S$(COBJS) S$(SOBJS) 
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上 述 的 Makefile 文件 内 容 和 上 一 章 实 验 的 区 别 不 大 。 将 TARGET 为 uart， 在 INCDIRS 和 
SRCDIRS 中 加 入 “bsp/uart”。 但 是 ， 相 比 上 一 章 中 的 Makefile 文件 ， 本 章 实验 的 Makefile 有 两 
处 重要 的 改变 : 

©, KÆ Makefile 文件 在 链接 的 时 候 加 入 了 数学 库 ， 因为 在 bsp_uartc 中 有 个 函数 


























uart setbaudrate, 在 此 函数 中 使 用 到 了 除法 运算 , 因此 在 链接 的 时 候 需 要 将 编译 器 的 数学 库 也 链 
接 进 来 .第 9 行 的 变量 LIBPATH 就 是 数学 库 的 目录 ,在 第 56 行 链接 的 时 候 使 用 了 变量 LIBPATH.。 
在 后 面 的 学 习 中 ， 我 们 常常 要 用 到 一 些 第 三 方 库 ， 那 么 在 连接 程序 的 时 候 就 需要 指定 这 些 
第 三 方 库 所 在 的 目录 ，Makefile 在 链接 的 时 候 使 用 选项 “-L” 来 指定 库 所 在 的 目录 ， 比 如 “ 示 
例 代码 21.4.1” 中 第 9 行 的 变量 LIBPATH 就 是 指定 了 我 们 所 使 用 的 编译 器 库 所 在 的 目录 。 

©, 在 第 61 行 和 64 行 中 , 加 入 了 选项 “-fno-builtin” 否则 编译 的 时 候 提 示 “putc”、“puts” 
这 两 个 函数 与 内 建 函 数 冲突 ， 错 误 信 息 如 下 所 示 : 


warning: conflicting types for built-in function “putc” 

























































































warning: conflicting types for built-in function ‘puts’ 
在 编译 的 时 候 加 入 选项 “-fno-builtin” 表 示 不 使 用 内 建 函 数 ， 这 样 我 们 就 可 以 自己 实现 pute 
和 puts 这 样 的 函数 了 。 

链接 脚本 保持 不 变 。 














21.4.2 编译 下 载 


使 用 Make 命令 编译 代码 , 编译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 uart.bin 文件 
下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

/imxdownload uart.bin /dev/sdd / 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 。 打 开 SourceCRT， 点 
击 File->Quick Connect...， 打 开 快 速 连接 设置 界面 ， 设 置 好 相应 的 串口 参数 ， 比 如 在 我 的 电脑 
上 是 COM8， 设 置 如 图 21.4.2.1 所 示 : 















































Quick Connect X 

Protocol: Serial v 
Port: COMS v Flow Control 
Baud rate: 115200 v L.]DTRIDSR 

| [DRTs/CTS 
Data bits: 8 - v o XON/XOFF 
Parity: None v 
Stop bits: 1 vv| 
[ ] Show quick connect on startup [v] Save session 

Open in a tab 
Cancel 
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图 21.4.2.1 SecureCRT 串口 设置 

设置 好 以 后 就 点 击 “Connect” 就 可 以 了 ,连接 成 功 以 后 SecureCRT 收 到 来 自 开 发 板 的 数据 ， 
但 是 SecureCRT 显示 可 能 会 是 乱码 ， 如 图 21.4.2.2 所 示 : 








serial-com8 - SecureCRT 
File Edit View Options Transfer Script Tools Window Help 
dad tc 72351 e E 5 











Ps Hr £j X 3a 








Filter by session name «Alt«l: X 
日 - 国 Sessions 
A serial-com13 
A serial-com4 


A serial-com5 
A serial-com8 





v 


Serial: COMB, 115200 VT100 CAP NUM 


Ready 


1, 16 13 Rows, 60 Cols 





图 21.4.2.2 SecureCRT 显示 乱码 
这 是 因为 有 些 设置 还 没 做 ， 点 击 Options->Session Options...， 打 开会 话 设置 窗口 ， 按 照 图 
21.4.2.3 所 示 设 置 : 























Session Options - serial-com8 x | 
Category: 
日 -Connecion Window and Text Appearance 
Logon Actions 
Current color scheme 
-Terminal Monochrome xd Edit... New... 
B- Emulation 
Modes Fonts 
Emacs 3 
Normal font: Lucida console 10pt Font... 
Mapped Keys 
| Advanced L Narrow font: Font... 
-Appearance 
MET 
Window : 
Log Fie [7] Use Unicode graphics characters 
d E 2、 选 择 UTF-8 
Cursor style: Block v 
1. muhAppearance 
Cluse color: Color... 
回 Bink 
Highlight keywords 
Name: <None> | SRE Edit.. 
Style: Reverse video Bold Color 
Cox ]| c 


21.233 会 话 设 置 








设置 好 以 后 点 击 “OK” 按 钮 就 可 以 了 ， 清 屏 ， 然 后 重新 复位 一 次 开发 板 ， 此 时 SecureCRT 


显示 就 正常 了 ， 如 图 21.4.2.4 所 示 : 
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serial-com8 - SecureCRT 一 口 x 








Filter by session name «Alt«l: X 


d serial-com13 
| A) serial-com4 
-网 serial-com5 
-网 serial-com8 








Ready Serial: COM8, 115200 1, 15 13 Rows, 60 Cols VT100 CAP NUM . 





21.4.2.4 显示 正常 
根据 提示 输入 一 个 字符 ， 这 个 输入 的 字符 就 会 通过 串口 发 送 给 开发 板 ， 开 发 板 接收 到 字符 
以 后 就 会 通过 串口 提示 你 接收 到 的 字符 是 什么 ， 如 图 21.4.2.5 所 示 : 


serial-com8 - SecureCRT 一 
File Edit View Options Transfer Script Tools Window Help 

























入 1 = ^ 
您 输入 的 字符 为 :1 


请 输入 1 个 字符 :2 
您 输入 的 字符 为 :2 


请 输入 1 个 字符 :3 
您 输入 的 字符 为 :3 


请 输入 1 个 字符 : 





d 3 suns 1L 













v 












Serial: COMB, 115200 


图 21.4.2.5 实验 效果 
至 此 ，LMX6U 的 串口 1 就 工作 起 来 了 ， 以 后 我 们 就 可 以 通过 串口 来 调试 程序 。 但 是 本 章 
只 实现 了 串口 最 基本 的 收发 功能 ， 如 果 我 们 要 想 使 用 格式 化 输出 话 就 不 行 了 ， 比 如 最 常用 的 
printf 函数 ， 下 一 章 就 讲解 如 何 移植 printf 函数 。 


10, 15 13 Rows, 68 Cols  VT100 CAP NUM . 
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第 二 十 二 章 串口 格式 化 函数 移植 实验 


上 一 章 实验 我 们 实现 了 UARTI 基本 的 数据 收发 功能 ， 虽 然 可 以 用 来 调试 程序 ， 但 是 功能 
太 单 一 了 ， 只 能 输出 字符 。 如 果 需 要 输出 数字 的 时 候 就 需要 我 们 自己 先 将 数字 转换 为 字符 ， 非 
常 的 不 方便 。 学 习 STM32 串口 的 时 候 我 们 都 会 将 printf 函数 映射 到 串口 上 ， 这 样 就 可 以 使 用 
printf 函数 来 完成 格式 化 输出 了 ， 使 用 非常 方便 。 本 章 我 们 就 来 学 习 如 何 将 printf 这 样 的 格式 化 
函数 移植 到 I.MX6U-ALPHA 开发 板 上 。 
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22.1 串口 格式 化 函数 简介 
格式 化 函数 说 的 是 printf、sprintf 和 scanf 这 样 的 函数 ， 分 为 格式 化 输入 和 格式 化 输出 两 类 




















函数 。 学 习 C 语言 的 时 候 常常 通过 printf 函数 在 屏幕 上 显示 字符 串 , 通过 scanf 函数 从 键盘 获取 
输入 。 这 样 就 有 了 输入 和 输出 了 ， 实 现 了 最 基本 的 人 机 交互 。 学 习 STM32 的 时 候 会 将 printf 映 
STIS II E, 这 样 即使 没有 屏幕 ， 也 可 以 通过 串口 来 和 开发 板 进行 交互 。 在 LMX6U-ALPHA F 
发 板 上 也 可 以 使 用 此 方法 , 将 printf 和 scanf 映射 到 串口 上 , 这 样 就 可 以 使 用 SecureCRT 作为 开 
发 板 的 终端 ， 完 成 与 开发 板 的 交互 。 也 可 以 使 用 printf 和 sprintf 来 实现 各 种 各 样 的 格式 化 字符 
串 ， 方 便 我 们 后 续 的 开发 。 串 口 驱 动 我 们 上 一 章 已 经 编写 完成 了 ， 而 且 实 现 了 最 基本 的 字 节 收 
发 ， 本 章 我 们 就 通过 移植 网 上 别人 已 经 做 好 的 文件 来 实现 格式 化 函数 。 


22.2 硬件 原理 分 析 
本 章 所 需 的 硬件 和 上 一 章 相同 。 


22.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光 盘 -> 1、 裸 机 例 程 -> 14_printf。 
本 章 实验 所 需要 移植 的 源码 已 经 放 到 了 开发 板 光 盘 中 ， 路 径 为 : 1、 例 程 源 码 ->5、 模 块 驱 动 源 
码 ->2、 格 式 化 函数 源码 ->stdio， 文 件 夹 stdio 里 面 的 文件 就 是 我 们 要 移植 的 源码 文件 。 本 章 实 
验 在 上 一 章 例 程 的 基础 上 完成 ， 将 stdio 文件 夹 复 制 到 实验 工程 根 目录 中 ， 如 图 22.3.1 所 示 : 


$ ls -a 
imx6ul.lds imxdownload Makefile 
























































































































图 22.3.1 添加 实验 源码 
stdio 里 面 有 两 个 文件 夹 : include 和 lib， 这 两 个 文件 夹 里 面 的 内 容 如 图 22.3.2 所 示 : 














Ø ctypeh Ø ctype.c 

Ø div64.h Ø div64.c 

© gcclibh Hs lib1funcs.S 
图 kernel.h 图 muldi3.c 


Ø printf.h Ø printf.c 


@ stdio.h Ø string.c 


€ string.h Ø vsprintf.c 
Ø system.h 

Ø types.h 

Ø vsprintf.h 





include 文 件 夹 lib 文 件 夹 


图 22.3.2 stdio 所 有 源码 文件 
图 22.3.2 就 是 stdio 里 面 的 所 有 文件 ，stdio 里 面 的 文件 其 实 是 从 uboot 里 面 移 植 过 来 的 。 后 
面 学 习 uboot 以 后 大 家 有 兴趣 的 话 可 以 自行 从 uboot 源码 里 面 “ 扣 ”出 相应 的 文件 ， 完 成 格式 化 
函数 的 移植 。 这 里 要 注意 一 点 ，stdio 中 并 没有 实现 完全 版 的 格式 化 函数 ， 比 如 printf 函数 并 不 
支持 浮 点 数 ， 但 是 基本 够 我 们 使 用 了 。 
移植 好 以 后 就 要 测试 相应 的 函数 工作 是 否 正 常 ， 我 们 使 用 scanf 函数 等 待 键盘 输入 两 个 整 
数 ， 然 后 将 两 个 整数 进行 想 加 并 使 用 printf 函数 输出 结果 。 在 main.c 里 面 输入 如 下 内 容 : 
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示例 代码 22.3.1 main.c 文件 代码 


/大大 大 大 炎炎 大大 炎炎 炎炎 炎炎 大大 炎炎 大 大 火炎 大 火炎 大 大大 炎炎 大 大 火炎 大 大 大 大大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 "mamme 

作者 : 左 忠 凯 

版 本 a Wb ld 

描述 : I.MX6U 开发 板 裸 机 实验 14 FREI print 实验 

其 他 : 本 实验 在 串口 上 移植 printf， 实 现 printf 函数 功能 ， 方 便 以 后 的 

程序 调试 。 

论坛 : wwW.openedv.com 


志 : 初版 V1.0 2019/1/15 左 忠 凯 创 建 


KCKCKCKCKCkCk Ck k Ck Ck k Ck Ck k k Ck k kCkCkCkCk CK k Ck k k Ck ck k k ck k k ck k k ck k k ck ck k ck ck k ck ck k ck kk k ke ke e x x kx f 








l include "bsp clk.hY 
2 Hinclude "bsp delay. n" 
3 #include "bsp led.h" 

4 #include "bsp beep. h" 
5 #include "bsp key.h" 

6 #include "bsp int.h" 

7 $£$include "bsp uart.h" 
8 





ee Lele ES 

















9 

dH) i 

11 * Qdescription : main 函数 

12 * Qparam 3 Jb 

13 * Qreturn 3 元 

TAT 

15 int main(void) 

God 

17 unsigned char state - OFF; 

18 rat mh 5 19$ 

T9 

20 int init(); /* 初始 化 中 断 (一 定 要 最 先 调用 ! ) */ 
2 imx6u clkinit(); /* 初始 化 系统 时 钟 af 
a delay init(; /* 初始 化 延 时 */ 
gs clk enable(); /* 使 能 所 有 的 时 钟 xj 
24 led bots 00H /* 初始 化 lea wy 
25 besp init (0) 7 /* 初始 化 beep */ 
26 uart mt () /* 初始 化 串口 ， 波 特 率 115200 sy 
2 

28 while (1) 

29 { 

30 BEintE(" 输 入 两 个 整数 ， 使 用 空格 隔 开 :") ; 

E scam (mel me". Cap Aos /* 输入 两 个 整数 */ 
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32 printf("NVrXn Zijás$d 4 $d —- $dNrNAnNr Nn", a, b, a*b);/* ÜHHA */ 
99 

34 state = !state; 

35 leel Swi tEn (QLIEIDIO sole 

36 } 

sy 

38 return 0; 

Soup 











第 30 行使 用 printf 函数 输出 一 段 提示 信息 ， 第 31 行使 用 函数 scanf 等 待 键盘 输入 两 个 整 
数 。 第 32 行使 用 printf 函数 输出 两 个 整数 的 和 。 程 序 很 简单 ， 但 是 可 以 验证 printf 和 scanf 这 
两 个 函数 是 否 正 常 工 作 。 
22.4 编译 下 载 验证 


22.4.1 编写 Makefile 和 链接 脚本 


修改 Makefile 中 的 TARGET 为 printf， 在 INCDIRS 中 加 入 “stdio/include”， 在 SRCDIRS 
中 加 入 “stdio/lib”， 修 改 后 的 Makefile 如 下 : 
示例 代码 22.4.1.1 Makefile 文件 代码 
































1 CROSS COMPILE ?- arm-linux-gnueabihf- 
2 TARGET 2 e NEE 

B 

4 /* NARE o ooo a uh 

5 

6. INCDIRS :2 imx6ul N 

7 stdio/include * 
8 bsp/clk ^ 

9 bsp/led \ 

10 bsp/delay \ 

下 于 bsp/beep \ 

下 多 BSR OPTION 

ls bsp/key \ 

14 bsp/exit \ 

1.5 bsp/int V 

16 bsp/epittimer 
TN bsp/keyfilter \ 
18 bsp/uart 

LS 

20RSREDITRS s= project X 

2 swei N 

22 bsp/clk V 

23 bsp/led \ 

24 bsp/delay N 

25 bsp/beep \ 
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26 BSE OP TORN 

257 bsp/key V 

28 bsp/exit 

29 bsp/int V 

30 bsp/epittimer \ 

Syal bsp key ilter 

32 bsp/uart 

ES 

34 /* ARME HIR. */ 

SD 

95$ (COBISS) s esg/9$.e s Se 

27 ICC) small =Wa, -mimolicirt=itsthaumo -nosiais -—itwo-lowaLlism =e =02 
(INCLUDE) -o $6 $< 

38 

Exams 

40) em ccxcar [9 ARCEN ES (TARCE T Gs TAREEN I lebe (S (COBISS) (SOBIS) 














第 2 行 修改 变量 TARGET 为 “printf”， 也 就 是 目标 名 称 为 “printf”。 

第 7 行 在 变量 INCDIRS 中 添加 stdio 相关 头 文 件 (. 路 径 。 

第 28 行 在 变量 SRCDIRS 中 添加 stdio 相关 文件 (.c) 路 径 。 

第 37 行 在 编译 C 文件 的 时 候 添加 了 选项 “-Wa,-mimplicit-it=thumb” 否则 的 话 会 有 如 下 



































类 似 的 错误 提示 : 
thumb conditional instruction should be in IT block -- 'addcs r5,r5,#65536' 


链接 脚本 保持 不 变 。 


22.4.2 编译 下 载 





件 下 载 到 SD 卡 中 ， 命 令 如 下 : 








使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 printf.bin 文 











chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 
./imxdownload printf.bin /dev/sdd // 烧 写 到 SD 卡 中 
烧 写成 功 以 后 将 SD 卡 插 到 开发 板 的 SD RIF, HIF SourceCRT， 设 置 好 连接 ， 然 后 复 


















































位 开发 板 。SourceCRT 显示 如 图 22.4.2.1 所 示 : 
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serial-com8 - SecureCRT = 口 X 


PS EO SQUE Too. Wiper Help 











Ready Serial: COM8, 115200 1, 28 14 Rows, 49 Cols VT100 CAP NI . 


22.4.2.1 SourceCRT 默认 显示 界面 
根据 图 22.4.2.1 所 示 的 提示 ， 输 入 两 个 整数 ， 使 用 空格 隔 开 ， 输 入 完成 以 后 按 下 “ 回 车 
键 ” 结果 如 图 22.4.2.2 所 示 : 
serial-com8 - SecureCRT m 口 X 
File Edit View Options Transfer me Tools Window Help 














Ready Serial: COM8, 115200 4, 28 14 Rows, 49 Cols VT100 CAP NI . 
图 22.4.2.2 计算 输入 结果 显示 
从 图 22.4.2.2 可 以 看 出 ， 输 入 了 32 和 5， 这 两 个 整数 ， 然 后 计算 出 32+5=37。 计 算 和 显示 
都 正确 ， 说 明 格 式 化 函数 移植 成 功 ， 以 后 我 们 就 可 以 使 用 printf 来 调试 程序 了 。 
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第 二 十 三 章 DDR3 实验 


LMX6U-ALPHA 开发 板 上 带 有 一 个 256MB/512MB 的 DDR3 内 存 芯片 ， 一 般 Cortex-A 芯 
片 自 带 的 RAM 很 小 ， 比 如 IMX6U 只 有 128KB 的 OCRAM。 如 果 要 运行 Linux 的 话 完 全 不 够 
用 的 ,所 以 必须 要 外 接 一 片 RAM 芯片 ,IMX6U 支持 LPDDR2、LPDDR3/DDR3,IMX6U-ALPHA 
开发 板 上 选择 的 是 DDR3， 本 章 就 来 学 习 如 何 驱 动 ILMX6U-ALPHA 开发 板 上 的 这 片 DDR3. 
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23.1 DDR3 内 存 简 介 


在 正式 学 习 DDR3 内 存 之 前 , 我 们 要 先 了 解 一 下 DDR 内存 的 发 展 历史 , 通过 对 比 SRAM, 
SDRAM, DDR, DDDR2 和 DDR3 的 区 别 , 有 助 于 我 们 更 加 深入 的 理解 什么 是 DDR. 在 看 DDR 
之 前 我 们 先 来 了 解 一 个 概念 ， 那 就 是 什么 叫做 RAM? 












































23.1.1 何 为 RAM Ñ ROM? 


相信 大 家 在 购买 手机 、 电 脑 等 电子 设备 的 时 候 , 通常 都 会 听 到 RAM, ROM, ERER, 
很 多 人 都 是 一 头 雾 水 的 。 普 通用 户 区 分 不 清楚 RAM. ROM 到 可 以 理解 ， 但 是 作为 一 个 嵌入 式 
Linux 开发 者 ， 要 是 不 清楚 什么 是 RAM、 什 么 是 ROM 就 绝对 不 行 ! RAM fI ROM 专业 的 解释 
如 下 : 

RAM: 随机 存储 器 ， 可 以 随时 进行 读 写 操作 ， 速 度 很 快 ， 掉 电 以 后 数据 会 丢失 。 比 如 内 存 
条 、SRAM、SDRAM、DDR 等 都 是 RAM。RAM 一 般 用 来 保存 程序 数据 、 中 间 结 果 ， 比 如 我 
们 在 程序 中 定义 了 一 个 变量 a， 然 后 对 这 个 a 进行 读 写 操作 ， 示 例 代 码 如 下 : 

示例 代码 23.1.1.1 RAM 中 的 变量 




































































jl Bb: LP 
2L i3 WE 

a 是 一 个 变量 ， 我 们 需要 很 方便 的 对 这 个 变量 进行 读 写 操作 ， 方 法 就 是 直接 “a” 进 行 读 写 
操作 , 不 需要 在 乎 具体 的 读 写 过 程 。 我 们 可 以 随意 的 对 RAM 中 任何 地 址 的 数据 进行 读 写 操作 ， 
非常 方便 。 

ROM: 只 读 存 储 器 ， 笔 者 认为 目前 “只 读 存 储 器 ”这 个 定义 不 准确 。 比 如 我 们 买 手 机 ， 通 
常会 告诉 你 这 个 手机 是 4-64 或 6+128 配置 ， 说 的 就 是 RAM 为 4GB 或 6GB，ROM 为 64G 或 
128GB。 但 是 这 个 ROM 是 Flash， 比 如 EMMC 或 UFS 存储 器 ， 因 为 历史 原因 ， 很 多 人 还 是 将 
Flash 叫做 ROM。 但 是 EMMC 和 UFS， 甚 至 是 NAND Flash， 这 些 都 是 可 以 进行 写 操作 的 ! 只 
是 写 起 来 比较 麻烦 ， 要 先 发 送 要 先进 行 控 除 ， 然 后 在 发 送 要 写 的 地 址 或 扇 区 ， 最 后 才 是 要 写 入 
的 数据 , 学 习 过 STM32, 使 用 过 WM25QXX 系列 的 SPI Flash 的 同学 应 该 深 有 体会 。 可 以 看 出 ， 
相 比 于 RAM, 向 ROM 或 者 Flash 写 入 数据 要 复杂 很 多 , 因此 意味 着 速度 就 会 变 慢 ( 相 比 RAM), 
但 是 ROM 和 Flash 可 以 将 容量 做 的 很 大 , 而 且 掉 电 以 后 数据 不 会 丢失 ,适合 用 来 存储 资料 ， 比 
如 音乐 、 图 片 、 视 频 等 信息 。 

综 上 所 述 ，RAM 速度 快 ， 可 以 直接 和 CPU 进行 通信 ， 但 是 掉 电 以 后 数据 会 丢失 ， 容 量 不 
容易 做 大 (和 同 价格 的 Flash 相 比 )。ROM( 目 前 来 说 ， 更 适合 叫做 Flash) 速 度 虽然 慢 ， 但 是 容量 
大 、 适 合 存储 数据 。 对 于 正点 原子 的 LMX6U-ALPHA 开发 板 而 言 ， 256MB/512MB 的 DDR3 就 
Æ RAM, Mi 512MB NANF Flash 或 8GB EMMC 就 是 ROM。 








































































































































































































23.1.2 SRAM 简介 


为 什么 要 讲 SRAM 呢 ? 因为 大 多 数 的 朋友 最 先 接触 RAM 臣 片 都 是 从 SRAM 开始 的 ， 因 
为 大 量 的 STM32 单片机 开发 板 都 使 用 到 了 SRAM， 比 如 F103、F407 等 ， 基 本 都 会 外 扩 一 个 
512KB 或 1MB 的 SRAM 的 ， 因 为 STM32F103/F407 内 部 RAM 比较 小 ， 在 一 些 比较 耗费 内 存 
的 应 用 中 会 出 现 内 存 捉 紧 的 情况 ， 比 如 emWin 做 UI 界面 。 我 们 简单 回顾 一 下 SRAM， 如 果 想 
要 详细 的 了 解 SRAM 请 阅读 正点 原子 STM32F103 战舰 开发 板 的 开发 指南 。 
SRAM 的 全 称 叫 做 StaticRandom-Access Memory, 也 就 是 静态 随机 存储 器 , 这 里 的 “静态 ” 
说 的 就 是 只 要 SRAM 上 电 ， 那 么 SRAM 里 面 的 数据 就 会 一 直 保存 着 ， 直 到 SRAM 掉 电 。 对 于 
RAM 而 言 需要 可 以 随机 的 读 取 任意 一 个 地 址 空间 内 的 数据 ， 因 此 采用 了 地 址 线 和 数据 线 分 离 
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的 方式 ， 这 里 就 以 STM32F103/F407 开发 板 常 用 的 I862WV51216 这 颗 SRAM 芯片 为 例 简 单 的 
讲解 一 下 SRAM, 这 是 一 颗 16 位 宽 (数据 位 为 16 位 )、1MB 大 小 的 SRAM, 芯片 框图 如 图 23.1.2.1 




















所 示 : 


512Kx 16 
MEMORY ARRAY 


© 
l/O0-I/O7 
— COLUMN IO 
1/O8-I/O15 (E CIRCUIT 


Upper Byte 


CONTROL 
CIRCUIT 





图 23.1.2.1 IS62WV51216 框图 
图 23.1.2.1 主要 分 为 三 部 分 ， 我 们 依次 来 看 一 下 这 三 部 分 : 
©., Hh 




















这 部 分 是 地 址 线 ， 一 共 A0~A18， 也 就 是 19 根 地 址 线 ， 因 此 可 访问 的 地 址 大 小 就 是 








2^19=524288=512KB。 不 是 说 IS62WV51216 是 个 1MB 的 SRAM B? 为 什么 地 址 空间 只 有 























512KB? 前 面 我 们 说 了 IS62WV51216 是 16 位 宽 的 ， 也 就 是 一 次 访问 2 个 字 节 ， 因 此 需要 对 
512KB 进行 乘 2 处 理 ， 得 到 512KB*2=1MB。 位 宽 的 话 一 般 有 8 位 /16 位 /32 位 ， 根 据 实际 需求 
选择 即 可 ， 一 般 都 是 根据 处 理 器 的 SRAM 控制 器 位 宽 来 选择 SRAM 位 宽 。 




















Q. HER 

















这 部 分 是 SRAM 的 数据 线 ， 根 据 SRAM 位 宽 的 不 同 ， 数 据 线 的 数量 要 不 同 ，8 位 宽 就 有 8 
根 数据 线 ，16 位 宽 就 有 16 根 数据 线 ，32 位 宽 就 有 32 根 数据 线 。IS62WV51216 是 一 个 16 位 宽 
的 SRAM， 因 此 就 有 16 根 数据 线 ， 一 次 访问 可 以 访问 16bit 的 数据 ， 也 就 是 2 个 字 节 。 因 此 就 
有 高 字 节 和 低 字 节 数 据 之 分 ， 其 中 IO0~IO7 是 低 字 节 数 据 ，IO8~IO15 是 高 字 节 数据 。 





@@、 控 制 线 




















SRAM 要 工作 还 需要 一 堆 的 控制 线 ，CS2 和 CS1 是 片 选 信号 ， 低 电 平 有 效 ， 在 一 个 系统 中 
可 能 会 有 多 片 SRAM( 目 的 是 为 了 扩展 SRAM 大 小 或 位 宽 )， 这 个 时 候 就 需要 CS 信号 来 选择 当 
前 使 用 哪 片 SRAM。 男 外 ， 有 的 SRAM 内 部 其 实 是 由 两 片 SRAM 拼接 起 来 的 ， 因 此 就 会 提供 

















两 个 片 选 信号 。 














OE 是 输出 使 能 信号 ， 低 电 平 有 效 ， 也 就 是 主 控 从 SRAM 读 取 数 据 。 

















WE 是 写 使 能 信号 ， 低 电 平 有 效 ， 也 就 是 主 控 向 SRAM 写 数 据 。 














UB 和 LB 信号 ， 前 面 我 们 已 经 说 了 ,IS62WV51216 是 个 16 位 宽 的 SRAM, 分 为 高 字 节 和 
低 字 节 ， 那 么 如 何 来 控制 读 取 高 字 节 数据 还 是 低 字 节 数 据 昵 ?这 个 就 是 UB 和 LB 这 两 个 控制 
线 的 作用 ， 这 两 根 控制 线 都 是 低 电 平 有 效 。UB 为 低 电 平 的 话 表 示 访 问 



































话 表示 访问 低 字 节 。 关 于 IS62WV51216 的 简单 原理 就 讲解 到 这 里 。 
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高 字 节 ，LB 为 低 电 平 的 


那么 SRAM 有 什么 缺点 没有 ? 那 必 须 有 的 啊 , 要 不 然 就 不 可 能 有 本 章 教程 了 , SRAM 最 大 
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的 缺点 就 是 成 本 高 ! 价格 高 ， 大 家 可 以 在 淘宝 上 搜索 一 下 IS62WV51216 这 个 仅仅 只 有 1MB 
大 小 的 SRAM 售 价 为 多 少 ， 大 概 为 5,6 块 钱 。 大 家 在 搜索 一 下 32MB 的 SDRAM 多 钱 ， 以 华 邦 





的 W9825G6KH 为 例 ， 大 概 4,5 








块 钱 ， 可 以 看 出 SDRAM 比 SRAM 容量 大 ， 但 是 价格 更 低 。 





SRAM 突出 的 特点 就 是 无 需 刷新 (SDRAM 需要 刷新 ， 后 面 会 讲解 )， 读 写 速度 快 ! 所 以 SRAM 








通常 作为 SOC 的 内 部 RAM 使 月 
OCRAM 都 是 SRAM. 


23.1.3 SDRAM 简介 

















有 或 Cache 使 用 ， 比 如 STM32 内 存 的 RAM 或 MX6U 内 部 的 














前 面 给 大 家 简单 讲解 了 SRAM， 可 以 看 出 SRAM 最 大 的 缺点 就 是 价格 高 、 容 量 小 ! 但 是 应 


用 对 于 内 存 的 需求 越 来 越 高， 必须 提供 大 内 存 解决 方案 。 为 此 半导体 厂商 想 了 很 多 办 法 ， 提 出 





























了 很 多 解决 方法 ， 最 终 SDRAM 营运 而 生 ， 得 到 推广 。SDRAM 全 称 是 Synchronous Dynamic 
Random Access Memory， 翻 译 过 来 就 是 同步 动态 随机 存储 器 ,“ 同 步 ” 的 意思 是 SDRAM 工作 
需要 时 钟 线 , “动态 ”的 意思 是 SDRAM 中 的 数据 需要 不 断 的 刷新 来 保证 数据 不 会 丢失 ,“ 随 机 ” 





的 意思 就 是 可 以 读 写 任意 地 址 的 数据 。 
与 SRAM 相 比 ，SDRAM 集成 度 高 、 功 耗 低 、 成 本 低 、 适 合 做 大 容量 存储 ， 但 是 需要 定时 
刷新 来 保证 数据 不 会 丢失 。 因 此 SDRAM 适合 用 来 做 内 存 条 ，SRAM 适合 做 高 速 缓存 或 MCU 









































STM32F429/F767/H743 的 朋友 应 该 知道 SDRAM， 这 里 我 们 就 以 STM32 开发 板 最 常用 的 华 邦 





内 部 的 RAM. SDRAM 目前 已 经 发 展 到 了 第 四 代 ， 分 别 为 : SDRAM. DDR SDRAM, DDR2 


SDRAM, DDR3 SDRAM、DDR4 SDRAM。STM32F429/F767/H743 等 芯片 支持 SDRAM， 学 过 











W9825G6KH 为 例 ，W9825G6KH 是 一 款 16 位 宽 ( 数 据 位 为 16 位 )、32MB 的 SDRAM、 速 度 一 
般 为 133MHz、166MHz 或 200MHz。W9825G6KH 框图 如 图 23.1.3.1 所 示 : 
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图 23.1.3.1 W9825G6KH ff 
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©, hak 

SDRAM 也 需要 很 多 控制 线 ， 我 们 依次 来 看 一 下 : 

CLK: 时 钟 线 ，SDRAM 是 同步 动态 随机 存储 器 ,“ 同 步 ” 的 意思 就 是 时 钟 ， 因 此 需要 一 根 
额外 的 时 钟 线 ， 这 是 和 SRAM 最 大 的 不 同 ，SRAM 没有 时 钟 线 。 

CKE: 时 钟 使 能 信号 线 ，SRAM 没有 CKE 信和 号 。 

CS: 片 选 信号 ， 这 个 和 SRAM 一 样 ， 都 有 片 选 信号 。 

RAS: 行 选 通信 号 ， 低 电 平 有 效 ，SDRAM 和 SRAM 的 寻 址 方式 不 同 ，SDRAM 按照 行 、 
列 来 确定 某 个 具体 的 存储 区 域 。 因 此 就 有 行 地 址 和 列 地 址 之 分 ， 行 地 址 和 列 地 址 共同 复 用 同一 
组 地 址 线 , 要 访问 某 一 个 地 址 区 域 , 必须 要 发 送行 地 址 和 列 地 址 , 指定 要 访问 哪 一 行 ? 哪 一 列 ? 
RAS 是 行 选 通信 号 ， 表 示 要 发 送行 地 址 ， 行 地 址 和 列 地 址 访问 方式 如 图 23.1.3.2 所 示 : 
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存储 区 域 


列 地 址 





行列 复 用 地 址 线 





图 23.1.3.2 SDRAM 行列 寻 址 方式 

CAS: 列 选 通信 号 ， 和 RAS 类似， 低 电 平 有 效 ， 选 中 以 后 就 可 以 发 送 列 地 址 了 。 

WE: 写 使 能 信号 ， 低 电 平 有 效 。 

©, A10 地 址 线 

A10 是 地 址 线 , 那么 这 里 为 什么 要 单独 将 A10 地 址 线 给 提出 来 呢 ? 因为 A10 地 址 线 还 有 另 
外 一 个 作用 ,Al10 还 控制 着 Auto-precharge, 也 就 是 预 充 电 。 这 里 又 提 到 了 预 充电 的 概念 ,SDRAM 
蕊 片 内 部 会 分 为 多 个 BANK， 关 于 BANK 我 们 稍 后 会 讲解 。SDRAM 在 读 写 完成 以 后 ， 如 果 要 
对 同一 个 BANK 中 的 另 一 行进 行 寻 址 操作 就 必须 将 原来 有 效 的 行 关闭 ， 然 后 发 送 新 的 行 / 列 地 
hb, 关闭 现在 工作 的 行 , 准备 打开 新 行 的 操作 就 叫做 预 充电 。 一般 SDSRAM 都 支持 自动 预 充电 









































































































































@@、 地 址 线 

对 于 W9825G6KH 来 说 一 共有 A0-A12, 共 13 根 地 址 线 , 但 是 我 们 前 面 说 了 SDRAM 寻 址 
是 按照 行 地 址 和 列 地 址 来 访问 的 ， 因 此 这 A0~A12 包含 了 行 地 址 和 列 地 址 。 不 同 的 SDRAM čt 
片 ， 根 据 其 位 宽 、 容 量 等 的 不 同 ， 行 列 地 址 数 是 不 同 的 ， 这 个 在 SDRAM 的 数据 手册 里 面 会 也 
清楚 的 。 比 如 W9825G6KH 的 A0~A8 是 列 地 址 , 一 共 9 位 列 地 址 ，A0~A12 是 行 地 址 , 一 共 13 
位 ， 因 此 可 寻 址 范围 为 :， 2^9*2^13=4194304B=4MB，W9825G6KH 为 16 位 宽 (2 个 字 节 )， 因 此 
还 需要 对 4MB 进行 乘 2 处 理 ,得 到 4*2=8MB, 但 是 W9825G6KH 是 一 个 32MB 的 SDRAM 啊 ， 
为 什么 算出 来 只 有 8MB, 仅仅 为 实际 容量 的 1/4。 不 要 急 , 这 个 就 是 我 们 接 下 来 要 讲 的 BANK， 
8MB 只 是 一 个 BANK 的 容量 ，W9825G6KH 一 共有 4 个 BANK。 

Q). BANK 选择 线 

BS0 和 BS1 是 BANK 选择 信号 线 ， 在 一 片 SDRAM 中 因为 技术 、 成 本 等 原因 ， 不 可 能 做 
一 个 全 容量 的 BANK。 而 且 ， 因 为 SDRAM 的 工作 原理 ， 单 一 的 BANK 会 带 来 严重 的 寻 址 冲 
突 , 减低 内 存 访问 效率 。 为 此 , 人 们 在 一 片 SDRAM 中 分 割 出 多 块 BANK, 一 般 都 是 2 的 次 方 ， 
比如 2，4，8 等 。 图 23.1.1.2 中 的 @@ 就 是 W9825G6KH 就 是 4 个 BANK 示意 图 ， 每 个 SDRAM 
数据 手册 里 面 都 会 写 清楚 自己 是 几 BANK。 前 面 我 们 已 经 计算 出 来 了 一 个 BANK 的 大 小 为 8MB， 
那么 四 个 BANK 的 总 容量 就 是 8MB*4=32MB。 

既然 有 4 个 BANK, 那么 在 访问 的 时 候 就 需要 告诉 SDRAM, 我 们 现在 需要 访问 哪个 BANK， 
BS0 和 BS1 就 是 为 此 而 生 的 , 4 个 BANK 刚好 2 根 线 , 如 果 是 8 个 BANK 的 话 就 需要 三 根 线 ， 
也 就 是 BS0~BS2。BS0、BS1 这 两 个 线 也 是 SRAM 所 没有 的 。 
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©, BANK 区 域 
关于 BANK 的 概念 前 面 已 经 讲 过 了 ， 这 部 分 就 是 W9825G6KH 的 4 个 BANK 区 域 。 这 个 
概念 也 是 SRAM 所 没有 的 。 


@@、 数 据 线 


W9825G6KH 是 16 位 宽 的 SDRAM， 因 此 有 16 根 数 据 线 ，DQ0~DQ15， 不 同 的 位 宽 其 数 
据 线 数量 不 同 ， 这 个 和 SRAM 是 一 样 的 。 


C. RE ERE 


W9825G6KH 是 一 个 16 位 的 SDRAM， 因 此 就 分 为 低 字 节 数 据 和 高 字 节 数据 ，LDQM 和 
UDQM 就 是 低 字 节 和 高 字 节 选择 信号 ， 这 个 也 和 SRAM 一 样 。 

































































23.1.4 DDR 简介 


终于 到 了 DDR 内 存 了 ，DDR 内 存 是 SDRAM 的 升级 版 本 ，SDRAM 分 为 SDR SDRAM, 
DDR SDRAM、DDR2 SDRAM、DDR3 SDRAM, DDR4 SDRAM。 可 以 看 出 DDR 本 质 上 还 是 
SDRAM， 只 是 随 着 技术 的 不 断 发 展 ，DDR 也 在 不 断 的 更 新 换代 。 先 来 看 一 下 DDR, t 
DDR1， 人 们 对 于 速度 的 追求 是 永 无 止境 的 ， 当 发 现 SDRAM 的 速度 不 够 快 的 时 候 人 们 就 在 思 
考 如 何 提 高 SDRAM 的 速度 ，DDR SDRAM 由 此 诞生 。 

DDR 全 称 是 Double Data Rate SDRAM, 也 就 是 双 倍 速率 SDRAM， 看 名 字 就 知道 DDR 的 
速率 (数据 传输 速率 ) 比 SDRAM 高 一 倍 ! 这 1 倍 的 速度 不 是 简 简 单单 的 将 CLK 提高 1 倍 ， 
SDRAM 在 一 个 CLK 周期 传输 一 次 数据 ，DDR 在 一 个 CLK 周期 传输 两 次 数据 ， 也 就 是 在 上 升 
沿 和 下 降 沿 各 传输 一 次 数据 ， 这 个 概念 叫做 预 取 (prefetch)， 相 当 于 DDR 的 预 取 为 2bit， 因 此 
DDR 的 速度 直接 加 倍 ! 比如 SDRAM 速度 一 般 是 133~200MHz， 对 应 的 传输 速度 就 是 
133~200MT/s， 在 描述 DDR 速度 的 时 候 一 般 都 使 用 MT/s， 也 就 是 每 秒 多 少 兆 次 数据 传输 。 
133MT/S 就 是 每 秒 133M 次 数据 传输 ，MTVs 描述 的 是 单位 时 间 内 传输 速率 。 同 样 133~200MHz 
的 频率 ，DDR 的 传输 速度 就 变 为 了 266~400MTS， 所 以 大 家 常 说 的 DDR266、DDR400 就 是 这 
么 来 的 。 

DDR2 的 IO 时 钟 是 DDR 的 2 倍 ， 因 此 DDR. 内 核 时 钟 依旧 是 133-200MHz 的 时 候 ， 总 线 
速度 就 是 266~400MHz。 而 且 DDR2 在 DDR 基础 上 进一步 增加 预 取 (prefetch)， 增 加 到 了 4bit, 
相当 于 比 DDR 多 读 取 一 倍 的 数据 ， 因 此 DDR2 的 数据 传输 速率 就 是 533~ 800MT/s， 这 个 也 就 
是 大 家 常 说 的 DDR2 533、DDR2 800。 当 然 了 ，DDR2 还 有 其 他 速度 ， 这 里 只 是 说 最 常见 的 几 
种 。 

DDR3 在 DDR2 的 基础 上 将 预 取 (prefetch) 提 高 到 8bit， 因 此 又 获得 了 比 DDR2 高 一 倍 的 传 
输 速 率 , 因此 在 总 线 时钟 同 样 为 266~400MHz 的 情况 下 , DDR3 的 传输 速率 就 是 1066~1600MT/S。 
LMX6U 的 MMDC 外 设 用 于 连接 DDR， 支 持 LPDDR2、DDR3、DDR3L， 最 高 支持 16 位 数据 
位 宽 。 总线 速 度 为 400MHz( 实 际 是 396MHz)， 数 据 传输 速率 最 大 为 800MT/S。 这 里 我 们 讲 一 下 
LPDDR3、DDR3 和 DDR3L 的 区 别 , 这 三 个 都 是 DDR3, 但 是 区 别 主要 在 于 工作 电压 , LPDDR3 
叫做 低 功 耗 DDR3， 工 作 电 压 为 1.2V。DDR3 叫做 标 压 DDR3， 工 作 电压 为 1.5V， 一 般 台 式 内 
存 条 都 是 DDR3。DDR3L 是 低压 DDR3， 工 作 电 压 为 1.3SV， 一 般 手 机 、 奶 入 式 、 笔 记 本 等 都 
使 用 DDR3L。 
正点 原子 的 LMX6U-ALPHA 开发 板 上 接 了 一 个 256MB/512MB 的 DDR3L, 16 位 宽 ， 型 号 为 
NT5CCI28MI6JR/MT5CC256MIGEP, nanya 公司 出 品 的 ， 分 为 对 应 256MB 和 512MB 容量 。 
EMMC 核心 板 上 用 的 512MB 容量 的 DDR3L, NAND 核心 板 上 用 的 256MB 容量 的 DDR3L。 本 
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讲解 我 们 就 以 EMMC 核心 板 上 使 用 的 NT5CC256M16EP-EK 为 例 讲解 一 下 DDR3。 可 以 到 nanya 
官网 去 查找 一 下 此 型 号 ， 信 息 如 图 23.1.4.1 所 示 : 








NT5CC256M16EP-EK 








Specifications Density Config Voltage Package 
4Gb x16 1.35V BGA 
Ball Number Speed Temperature Grade 
96-ball 1866Mbps 0C-95C Commercial 
Availability 
MP 


图 23.1.4.1 NTSCC256MI6EP-EK 信息 
从 图 23.1.4.1 可 以 看 出 ，NT5CC256M16EP-EK 是 一 款 容 量 为 4Gb， 也 就 是 512MB 大 小 、 
16 位 宽 、1.35SV、 传 输 速 率 为 1866MT/S 的 DDR3L $x} o NT5CC256MIGEP-EK 的 数据 手册 没 
有 在 nanya 官网 找到 ， 但 是 找到 了 NTSCC256MIGER-EK 数据 手册 ， 在 官网 上 没有 看 出 这 两 个 
有 什么 区 别 ， 因 此 我 们 就 直接 用 NTSCC256MIGER-EK 的 数据 手册 。 数 据 手册 已 经 放 到 了 开发 
板 光 盘 中 ， 路 径 为 : 6、 硬 件 资 料 -》1、 蕊 片 资料 -》NT5CC256M16EP-EK.pdf。 但 是 数据 手册 并 
没有 给 出 DDR3L 对 的 结构 框图 ， 这 里 我 就 直接 用 镁 光 MT41K256M16 数据 手册 里 面 的 结构 框 
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23.1.4.2 DDR3L 结构 框图 
à D l^ > EL El [AZ EI 
从 图 23.1.4.2 可 以 看 出 ，DDR3L 和 SDRAM 对 的 结构 框图 很 类 似 ， 但 是 还 是 有 点 区 别 。 








Q、 控 制 线 

ODT: 片上 终端 使 能 ，ODT 使 能 和 禁止 片 内 终端 电阻 。 

ZQ: 输出 驱动 校准 的 外 部 参考 引 脚 ， 此 引 脚 应 该 外 接 一 个 240 欧 的 电阻 到 VSSQ 上 , 一 般 
就 是 直接 接地 了 。 

RESET: 复位 引 脚 ， 低 电 平 有 效 。 
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CKE: 时 钟 使 能 引 脚 。 
A12: A12 是 地 址 引 脚 , 但 是 有 也 有 另外 一 个 功能 ， 因 此 也 叫做 BC 引 脚 ，A12 会 在 READ 
和 WRITE 命令 期 间 被 采样 ， 以 决定 burst chop 是 否 会 被 执行 。 
CK 和 CK#: 时 钟 信 号 ，DDR3 的 时 钟 线 是 差分 时 钟 线 ， 所 有 的 控制 和 地 址 信号 都 会 在 CK 


























对 的 上 升 沿 和 CK# 的 下 降 沿 交叉 处 被 采集 。 
CSH: 片 选 信号 ， 低 电 平 有 效 。 
RAS#、CAS#H 和 WE#: 行 选 通信 号 、 列 选 通 信号 和 写 使 能 信和 号 。 

@、 地 址 线 
A[14:0] 为 地 址 线 ，A0~A14， 一 共 15 根 地 址 线 ， 根 据 NT5CC256M16ER-EK 的 数据 手册 可 

知 ， 列 地 址 为 A0~A9， 共 10 根 ， 行 地 址 为 A0~A14， 共 15 根 ， 因 此 一 个 BANK 的 大 小 就 是 

2^10*2^15*2=32MB*2=64MB， 根 据 图 23.1.4.2 可 知 一 共有 8 个 BANK， 因 此 DDR3L 的 容量 就 

是 64*8=512MB。 

Q8. BANK 选择 线 

一 片 DDR3 有 8 个 BANK， 因 此 需要 3 个 线 才 能 实现 8 个 BANK 的 选择 ，BA0~BA2 就 是 
用 于 完成 BANK 选择 的 。 

(à. BANK 区 域 

DDR3 一 般 都 是 8 个 BANK 区 域 。 

©, Huge 

因为 是 16 位 宽 的 ， 因 此 有 16 根 数据 线 ， 分 别 为 DQ0~DQ15。 

@、 数 据 选 通 引 脚 

DQS 和 DQS# 是 数据 选 通 引 脚 , 为 差分 信号 , 读 的 时 候 是 输出 , 写 的 时 候 是 输入 。 LDQS( 有 
的 叫做 DQSL) 和 LDQS# 有 的 叫做 DQSL 术 对 应 低 字 节 , 也 就 是 DQ0~7,UDQS( 有 的 叫做 DQSU) 
和 UDQS#( 有 的 叫做 DQSU 帮 ， 对 应 高 字 节 ， 也 就 是 DQ8~15。 

@、 数 据 收入 屏蔽 引 脚 

DM 是 写 数据 收入 屏蔽 引 脚 。 

关于 DDR3L 的 框图 就 讲解 到 这 里 ， 想 要 详细 的 了 解 DDR3 的 组 成 ， 请 阅读 相应 对 的 数据 
手册 。 



































































































































23.2 DDR3 关键 时 间 人 参数 
大 家 在 购买 DDR3 内 存 的 时 候 通常 会 重点 观察 几 个 常用 的 时 间 参 数 : 
1、 传 输 速率 


比如 1066MT/S. 1600MT/S. 1866MT/S 等 ,这 个 是 首要 考虑 的 ， 因 为 这 个 决定 了 DDR3 内 
存 的 最 高 传输 速率 。 

2. tRCD 参数 

tRCD 全 称 是 RAS-to-CAS Delay， 也 就 是 行 寻 址 到 列 寻 址 之 间 的 延迟 。DDR 的 寻 址 流程 是 
先 指定 BANK 地 址 ， 然 后 在 指定 行 地 址 ， 最 后 指定 列 地 址 确定 最 终 要 寻 址 的 单元 。BANK 地 址 
和 行 地 址 是 同时 发 出 的 ， 这 个 命令 叫做 “ 行 激 活 ”(Row Active)。 行 激活 以 后 就 发 送 列 地 址 和 具 
体 的 操作 命令 ( 读 还 是 写 )， 这 两 个 是 同时 发 出 的 ， 因 此 一 般 也 用 “ 读 / 写 命令 ”表示 列 寻 址 。 在 
行 有 效 ( 行 激活 ) 到 读 写 命令 发 出 的 这 段 时 间 间 隔 叫 做 芯 CD， 如 图 23.2.1 所 示 : 
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23.2.1 tRCD 
一 般 DDR3 数据 手册 中 都 会 给 出 ICD 的 时 间 值 ， 
NT5CC256MI6EP-EK 这 个 DDR3, tRCD 参数 如 图 23.2.1 所 示 : 





比如 正点 原子 所 使 用 的 


ET 
[o9 [9p Te 
ow m 9] 
[ms pwe[mwen[m | 
[ow [emp [9] 





23.22 tRCD 时 


间 参 数 





从 图 23.2.2 可 以 看 出 ，tRCD 为 13.91ns， 这 个 我 们 在 初始 化 DDR3 的 时 候 需 要 配置 。 有 时 


候 大 家 也 会 看 到 


Organization 


Part Number Package 


Speed 


“13-13-13” 之 类 的 参数 , 这 个 是 用 来 描述 CL-tRCD-TRP 的 , 如 图 23.2.3 所 示 : 





Clock 
(MHz) 


| 


Data Rate 
(Mb/s) 


CL-TRCD-TRP 





512M x 8 


NT5CC512M8EQ-DIB 


NT5CC512M8EQ-DI 


NT5CB512M8EQ-DI 


NT5CC512M8bEQ-EK 


NTS5CB512M8EQ-EK 


NT5CB512M8EQ-FL 





78-Ball 


DDR3(L) Commercial Grade 


DDR3L-1600 ! 


11-11-11 





DDR3L-1600 1 


11-11-11 


DDR3-1600 11-11-11 


|. 983 | DDR3L-1866 ' 


DDR3-1866 13-13-13 


DDR3-2133 


14-14-14 





256M x 16 


NT5CC256M16ER-DIB 
NT5CC256M16ER-DI 
NT5CB256M16ER-DI 


NT5CC256M16ER-EK | ^"^ 
NT5CB256M16ER-EK 








DDR3L-1600 ! 


11-11-11 





DDR3L-1600! | 


11-11-11 














NT5CB256M16ER-FL 


23.2.3 CL-TRCD-TRP 时 间 参 数 


| 933 | DDR3L-18661 


DDR3-1600 





DDR3-1866 


11-11-11 


13-13-13 








DDR3-2133 


14-14-14 


从 图 23.2.2 可 以 看 出 ,NT5CC256M16ER-EK 这 个 DDR3 的 CL-TRCD-TRP 时 间 参 数 为 "13- 
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13-13”。 因 此 让 CD=13， 这 里 的 13 不 是 ns 数 ， 而 是 CLK 时 间 数 ， 表 示 13 个 CLK 周期 。 
3、CL 参数 











当 列 地 址 发 出 以 后 就 会 触发 数据 传输 ， 但 是 从 数据 从 存储 单元 到 内 存 芯 片 IO 接口 上 还 需要 一 
段 时 间 ， 这 段 时 间 就 是 非常 著名 的 CL(CAS Latency)， 也 就 是 列 地 址 选 通 潜伏 期 ， 如 图 23.2.4 所 


Z7: 











命令 n 7 NOP Xi DCN NOP V 
数据 Y DC 


4 CL 




















图 23.2.4 CL 

CL 参数 一 般 在 DDR3 的 数据 手册 中 可 以 找到 , 比如 NTSCC256MIGEP-EK 的 CL 值 就 是 13 
个 时 钟 周期 ， 一 般 妇 CD 和 CL 大 小 一 样 。 

4、AL 参数 
在 DDR 的 发 展 中 ， 提 出 了 一 个 前 置 CAS 的 概念 ， 目 的 是 为 了 解决 DDR 中 的 指令 冲突 ， 
它 人 允许 CAS 信号 紧 随 着 RAS 发 送 ， 相 当 于 将 DDR 中 的 CAS 前 置 了 。 但 是 读 / 写 操作 并 没有 因 
此 提前 ， 依 旧 要 保证 足够 的 延迟 /潜伏 期 ， 为 此 引入 了 AL(Additive Latency), 单位 也 是 时 钟 周期 
数 。AL+CL 组 成 了 RL(Read Latency)， 从 DDR2 开始 还 引入 了 写 潜 伏 期 WL(Write Latency), 
WL 表示 写 命令 发 出 以 后 到 第 一 笔 数据 引入 AL 以 后 的 读 时 序 如 图 23.2.5 所 示 : 
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图 23.2.5. 加 入 AL 后 的 读 时 序 图 

图 32.2.5 就 是 镁 光 DDR3L 的 读 时 序 图 ， 我 们 依次 来 看 一 下 图 中 这 四 部 分 都 是 什么 内 容 

QD、tRCD， 前 面 已 经 说 过 了 。 

©, AL. 

®©, CL. 

QD. RL 为 读 潜伏 期 ，RL=AL+CL。 

5. tRC 参数 

tRC 是 两 个 ACTIVE 命令 ， 或 者 ACTIVE 命令 到 REFRESH 命令 之 间 的 周期 ，DDR3L 数 
据 手 册 会 给 出 这 个 值 ， 比 如 NTSCC256M16EP-EK 的 tRC 值 为 47.91ns， 参 考 图 23.2.2。 


6. tRAS 参数 
tRAS 是 ACTIVE 命令 到 PRECHARGE 命令 之 间 的 最 小 时 间 ，DDR3L 的 数据 手册 同样 也 
会 给 出 此 参数 ，NT5CC256M16EP-EK 的 tRAS 值 为 34ns， 参 考 图 23.2.2。 
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23.3 LMX6U MMDC 控制 器 简介 


23.3.1 MMDC 控制 器 


学 过 STM32 的 同学 应 该 记得 ,STM32 的 FMC 或 FSMC 外 设 用 于 连接 SRAM 或 SDRAM, 
对 于 I.MX6U 来 说 也 有 DDR 内 存 控制 器 , 否则 的 话 它 怎么 连接 DDR 呢 ? MMDC 就 是 LIMX6U 
的 内 存 控制 器 ，MMDC 是 一 个 多 模 的 DDR 控制 器 ， 可 以 连接 16 位 宽 的 DDR3/DDR3L、16 位 
宽 的 LPDDR2, MMDC 是 一 个 可 配置 、 高 性 能 的 DDR 控制 器 。MMDC 外 设 包含 一 个 内 核 
(MMDC_CORE) 和 peer PHY)， 内 核 和 PHY 的 功能 如 下 : 

MMDC 内 核 : 内 核 负责 通过 AXI 接口 与 系统 进行 通信 、DDR 命令 生成 、DDR 命令 优化 、 
读 / 写 数据 路 径 。 

MMDC PHY: PHY 负责 时 序 调整 和 校准 , 使 用 特殊 的 校准 机 制 以 保障 数据 能 够 在 400MHz 
被 准确 捕获 。 

MMDC 的 主要 特性 如 下 : 

Q@、 支 持 DDR3/DDR3Lx16、 支 持 LPDDR2x16， 不 支持 LPDDRIMDDR 和 DDR2。 

@、 支 持 单 片 256Mbit~8Gbit 容量 的 DDR， 列 地 址 范围 ，8-12 位 ， 行 地 址 范围 11-16bit。2 
个 片 选 信号 

©, XF DDR3， 最 大 支持 8bit 的 突 发 访问 。 

由 、 对 于 LPDDR2 最 大 支持 4bit 的 突 发 访问 。 

©, MMDC 最 大 频率 为 400MHz， 因 此 对 应 的 数据 速率 为 800MT/S 。 

@、 支 持 各 种 校准 程序 , 可 以 自动 或 手动 运行 。 支 持 ZQ 校准 外 部 DDR 设备 , ZQ 校准 DDR 
VO 引 脚 、 校 准 DDR 驱动 能 




























































































23.32 MMDC 控制 器 信号 引 脚 


我 们 在 使 用 STM32 的 时 候 FMC/FSMC 的 IO 引 脚 是 带 有 复 用 功能 的 ， 如 果 不 接 SRAM 或 
SDRAM 的 话 FMC/FSMC 是 可 以 用 作 其 他 外 设 IO 的 。 但 是 ， 对 于 DDR 接口 就 不 一 样 了 ， 因 为 
DDR 对 于 硬件 要 求 非 常 严格 ， 因 此 DDR 的 引 脚 都 是 独立 的 ， 一 般 没 有 复 用 功能 ， 只 做 为 DDR 










































































引 脚 使 用 。LMX6U 也 有 专用 的 DDR 引 脚 ， 如 图 23.3.2.1 所 示 : 
人 
DRAM. ADDR[15:0] Address Bus Signals DRAM A[15:0] No Muxing 

DRAM CAS Column Address Strobe Signal DRAM CAS No Muxing O 
DRAM CS[1:0] Chip Selects DRAM CS[1:0] No Muxing O 
DRAM_DATA[31:0] Data Bus Signals DRAM_D[31:0] No Muxing yo 
DRAM DQN[1:0] Data Mask Signals DRAM DQN[!1:0] No Muxing O 
DRAM_ODT[1:0] On-Die Termination Signals DRAM_SDODT[1:0] No Muxing O 
DRAM_RAS Row Address Strobe Signal DRAM_RAS No Muxing O 
DRAM_RESET Reset Signal DRAM_RESET No Muxing O 
DRAM SDBA[2:0] Bank Select Signals DRAM SDBA[2:0] No Muxing O 
DRAM_SDCKE[1:0] Clock Enable Signals DRAM_SDCKE[1:0] No Muxing O 
DRAM_SDCLKO_N Negative Clock Signals DRAM SDCLK [1:0] No Muxing Oo 
DRAM SDCLKO P Positive Clock Signals DRAM SDCLK [1:0] | No Muxing Oo 
DRAM SDQS[1:0] N  |Negative DQS Signals DRAM SDQS[1:0] N No Muxing 1/0 
DRAM_SDQS[1:0]_P |Positive DQS Signals DRAM SDQS[1:0] P |No Muxing 1/0 
DRAM_SDWE WE signal DRAM_SDWE No Muxing Oo 
DRAM ZQPAD ZQ signal DRAM ZQPAD No Muxing Oo 
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图 23.3.2.1 DDR 信号 引 脚 
由 于 图 23.3.2.1 中 的 引 脚 是 DDR 专属 的 ， 因 此 就 不 存在 缩 为 的 DDR 引 脚 复 用 配置 ， 只 









































需 
要 设置 DDR 引 脚 的 电气 属性 即 可 ， 注 意 ，DDR 引 脚 的 电气 属性 寄存 器 和 普通 的 外 设 引 脚 电气 
属性 寄存 器 不 同 ! 








23.3.3 MMDC 控制 器 时 钟 源 


前 面 说 了 很 多 次 , LMX6U 的 DDR 或 者 MDDC 的 时 钟 频率 为 400MHz, 那么 这 400MHz 时 
钟 源 怎 么 来 的 呢 ? 这 个 就 要 查阅 LMX6ULL 参考 手册 的 《Chapter 18 Clock Controller 
Module(CCM)》 章 节 。MMDC 时 钟 源 如 图 23.3.3.1 所 示 : 

el CBQMR[PRE PERIPH2 CLK_SEL]  CBCDR[PERIPH2 CLK SEL] CBCDRIFABRIC Muno. EPn —— Aam 


-CLK ROOT, MDC 
1 @ 













图 23.3.3.1 MMDC 时 钟 源 

图 23.3.3.1 就 是 MMDC 的 时 钟 源 路 径 图 , 主要 分 为 4 部 分 , 我们 依次 来 看 一 下 每 部 分 所 组 
的 工作 : 

(D、pre_periph2 时 钟 选择 器 ， 也 就 是 periph2 clkd 的 前 级 选择 器 ， 由 CBCMR 寄存 器 的 
PRE PERIPH2 CLK SEL 位 (bit22:21) 来 控制 ， 一 共有 四 种 可 选 方案 ， 如 表 23.3.3.1 所 示 ; 








A 

















00 PLL2 
01 PLL2 PFD2 
10 PLL2 PFDO 
11 PLL4 














表 23.3.3.1 pre_periph2 时 钟 源 

从 表 23.3.3.1 可 以 看 出 ， 当 PRE PERIPH2 CLK SEL 为 0x1 的 时 候选 中 PLL2 PFD2 为 
pre periph2 时 钟 源 。 在 前 面 的 《第 十 六 章 主 频 和 时 钟 配置 》 中 我 们 已 经 将 PLL2 PFD2 设置 为 
396MHz( 约 等 于 400MHz)，I.MX6U 内 部 bootrom 就 是 设置 PLL2 PFD2 作为 MMDC 的 最 终 时 
钟 源 ， 这 就 是 IMX6U 的 DDR 频率 为 400MHz 的 原因 。 

Q2). periph2 clk 时 钟 选择 器 ， 由 CBCDR 寄存 器 的 PERIPH2_CLK_SEL 位 (bit26) 来 控制 |， 
当 为 0 的 时 候选 择 pll2_main_clk 作为 periph2_clk 的 时 钟 源 , 当 为 1 的 时 候选 择 periph2_clk2 clk 
作为 periph2 clk 的 时 钟 源 。 这 里 肯定 要 将 PERIPH2 CLK SEL 设置 为 0， 也 就 是 选择 
pll2_main_clk 作为 periph2_clk 的 时 钟 源 ， 因 此 periph2 clIk-PLL2 PFD0-396MHz. 

©, 最 后 就 是 分 频 器 , 由 CBCDR 寄存 器 的 FABRIC MMDC PODF 位 (bit5:3) 设 置 分 频 值 ， 
可 设置 0~7， 分 别 对 应 1~8 分 频 ， 要 配置 MMDC 的 时 钟 源 为 396MHz， 那 么 此 处 就 要 设置 为 1 
分 频 ， 因 此 FABRIC MMDC PODF=0。 

以 上 就 是 MMDC 的 时 钟 源 设 置 ，LMX6U 参考 手册 一 直 说 DDR 的 频率 为 400MHz， 但 是 
实际 只 有 396MHz， 就 和 NXP 宣传 自己 的 LMX6ULL 有 800MHz 一 样 ， 实 际 只 有 792MHz。 



















































































23.4 ALPHA 开发 板 DDR3L 原理 图 


ALPHA FRIKA EMMC 和 NAND 两 种 核心 板 ，EMMC 核心 板 使 用 的 DDR3L 的 型 号 为 
NT5CC256MI6EP-EK, 容量 为 S12MB.NAND 核心 板 使 用 的 DDR3L 型 号 为 NT5CC128M16JR- 
EK， 容 量 为 256MB， 这 两 种 型 号 的 DDR3L 封装 一 摸 一 样 ， 有 人 可 能 就 有 疑问 了 ， 容 量 不 同 的 
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话 地 址 线 是 不 同 的 ， 比 如 行 地 址 和 列 地 址 线 数 就 不 同 ， 没 错 ! 但 是 DDR3L 厂商 为 了 方便 选择 
将 不 同 容量 的 DDR3 封装 做 成 一 样 ， 没 有 用 到 的 地 址 线 DDR3L 忆 片 会 屏蔽 掉 。 而 且 ， 根 据 规 
定 ， 所 有 厂商 的 DDR 芯片 IO 一 摸 一 样 ， 不 管 是 引 脚 定义 还 是 引 脚 间距 ， 但 是 芯片 外 形 大 小 可 














能 不 同 。 因 此 只 要 做 好 硬件 ， 可 以 在 不 需要 修改 硬件 PCB 的 前 提 下 ， 随 意 的 更 换 不 同 容量 、 不 
同 品 牌 的 DDR3L 芯片 ， 极 大 的 方便 了 我 们 的 芯片 选 型 。 
正点 原子 ALPHA 开发 板 EMMC 和 NAND 核心 板 的 DDR3L 原理 图 一 样 ， 如 图 23.4.1 所 








ZIN: 
E3 DRAM DATAO x 
F7 DRAM DATAT RAM ADI L r Boisi iins 
DRAM ADDRZ2 : T6 DRAM DATA2 
DRAM ADDR3 : DA. UT DRAM DATA3 
DRAM ADDR4 ALE ADNA DATA Us DRAM DATA4 
H7DRAM DATAT 
D7DRAM DATAS 
RI DRAM DATAIS 
#Layout: Route L000lun DIFF 
DRAM SDBAO . P6 DRAM SDQSO P 
DRAM SDBAT : F ea [P7 DRAM SDOSO NC) 
DRAM SDBA2 K2.| DRAM SDBA2 TI DRAM sDQsi zA 
ET 
RAM DOMI DRAM CS0 B 2 M EI mem 
, | L8DRAM zoo „R48 240R DRAM CSL B. M DRAM D i 一 Tu 
MSDRAM VREF 【一 
f$ DRAM RAS - 
E. JI DRAM ODT1“- ?2 DRAM CAS B : M o [NL DRAM ODTO 
DEAM RETE xi DRAM SDWE B n UE -OpT] [EL_ DRAM ODTI 
5 4 @RAM SDCLKO P PI x : M3 DRAM SDCKEO. 
S ys L9 DRAM ZQIR49 一 24 (DRAM SDCLK0 N P2 : : J3 DRAM SDCKEI 
= Payout: Route 1000hm DIFF f R50 R51 
[EL | HI DRAM VREE 224 DRAM RESET B. G4 
[GS | vs "m CS. 
[-ps[ IDRAM 1V35 ok Dok 
H- A R53 
TE e VDD HIGH CAP. N6 = 
Pr] [KS] GND 
fes Vs : OR | DRAM VREF P4 
S "sspse 
Hio vs ED 
bE [ R9] 24 MCIMX6Y2CVM05AB 
S [A1] 
pi 
上 -一 
E [3 
[ E9] 
一 
cM 
[ us] 
ES MT41K256MIG6TW 
DRAM 1V35 267 ces 69 [C70 E71 E72 c73 p74 E75 E76 E77 E78 
nn il pups p24 poa poa bz 





23.4.1 DDR3L 原理 图 
图 23.4.1 中 左 侧 是 DDR3L 原理 图 ， 可 以 看 出 图 中 DDR3L 的 型 号 为 MT41K256MIGTW, 
这 个 是 镁 光 的 512MB DDR3L。 但 是 我 们 实际 使 用 的 512MB DDR3L 型 号 为 NT5CC256M16EP- 
EK， 不 排除 以 后 可 能 会 更 换 DDR3L 型 号 ， 更 换 DDR3L 芯片 是 不 需要 修改 PCB 。 图 23.4.1 中 
右边 的 是 ILMX6U 的 MMDC 控制 器 IO. 


23.5 DDR3L 初始 化 与 测试 


23.5.1 ddr stress tester 简介 


NXP 提供 了 一 个 非常 好 用 的 DDR 初始 化 工具 ， 叫 做 ddr_stress_tester。 此 工具 已 经 放 到 了 
开发 板 光盘 中 ， 路 径 为 : 5S、 开 发 工具 ->6、NXP 官方 DDR 初始 化 与 测试 工具 
->ddr stress_tester_V2.90_setup.exe.zip， 我 们 简单 介绍 一 下 ddr stress tester 工具 ， 此 工具 特点 如 
F: 











Q@、 此 工具 通过 USB OTG 接口 与 开发 板 相 连接 ， 也 就 是 通过 USB OTG 口 进行 DDR 的 初 
始 化 与 测试 。 
@@、 此 工具 有 一 个 默认 的 配置 文件 ， 为 excel 表 ， 通 过 此 表 可 以 设置 板子 的 DDR 信息 ， 最 
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后 生成 一 个 .inc 结尾 的 DDR 初始 化 脚本 文件 。 这 个 .inc 文件 就 包含 了 DDR 的 初始 化 信息 ， 一 
般 都 是 寄存 器 地 址 和 对 应 的 寄存 器 值 。 











(@@)、 此 工具 会 加 载 .inc 表 里 面 的 DDR 初始 化 信息 ， 然 后 通过 USB OTG 接口 向 板子 下 载 
DDR 相关 的 测试 代码 ， 包 括 初始 化 代码 。 

@@、 对 此 工具 进行 简单 的 设置 ， 即 可 开始 DDR 测试 ， 一 般 要 先 做 校准 ， 因 为 不 同 的 PCB 
其 结构 肯定 不 同 ， 必 须要 做 一 次 校准 ， 校 准 完成 以 后 会 得 到 两 个 寄存 器 对 应 的 校准 值 ， 我 们 需 
要 用 这 个 新 的 校准 值 来 重新 初始 化 DDR。 

@、 此 工具 可 以 测试 板子 的 DDR 超频 性 能 ， 一 般 认 为 DDR 能 够 以 超过 标准 工作 频率 
10%~20% 稳 定 工作 的 话 就 认定 此 硬件 DDR 走 线 正常 。 

@、 此 工具 也 可 以 对 DDR 进行 12 小 时 的 压力 测试 。 

我 们 来 看 一 下 正点 原子 开发 板 光 盘 里 面 $5、 开发 工具 ->6、NXP 官方 DDR 初始 化 与 测试 工 
具 目 录 下 的 文件 ， 如 图 23.5.1.1 所 示 : 




























































































( ] ALIENTEK 256MB.inc 2019-06-06 20:16 INC 文件 8 KB 

| ALIENTEK 512MB.inc 2019-06-06 18:06 INC 文件 8 KB 
BY dar stress tester v2.90 setup.exezzip 2018-07-31 11:47 360 压 缩 ZIP 文件 2,207 KB 
BY LMX6UL DDR3 Script Aid V0.02.xlsx 2018-07-31 12:08 Microsoft Excel T... 84 KB 
加 MX6X DDR3 调 校 应 用 手册 V4 20150730... — 2018-08-11 9:38 Foxit Reader PDF D... 1,326 KB 
图 飞 思 卡尔 MX6 平 台 DRAM 接 口 高 阶 应 用 指导 -2018-07-31 11:54 Foxit Reader PDF D... 3,164 KB 














图 23.5.1.1 XP 官方 DDR 初始 化 与 测试 工具 目录 下 的 文件 

我 们 依次 来 看 一 下 图 23.5.1.1 中 的 这 些 文件 的 作用 : 

(D). ALIENTEK 256MB.inc 和 ALIENTEK 512MB.inc， 这 两 个 就 是 通过 excel 表 配 置 生成 
的 ， 针 对 正点 原子 开发 板 的 DDR 配置 脚本 文件 。 

(2. ddr stress tester v2.90 setup.exe.zip 就 是 我 们 要 用 的 ddr_stress_tester 软件 ， 大 家 自行 
安装 即 可 ， 一 定 要 记得 安装 路 径 。 

(3. LMX6UL DDR3 Script Aid V0.02.xlsx 就 是 NXP 编写 的 针对 LMX6UL 的 DDR 初始 
化 execl 文件 , 可 以 在 此 文件 里 面 填写 DDR 的 相关 参数 , 然后 就 会 生成 对 应 的 .inc 初始 化 脚本 。 

由、 最 后 两 个 PDF 文档 就 是 关于 LMX6 系列 的 DDR 调试 文档 ， 这 两 个 是 NXP 编写 的 。 




























































































23.5.2 DDR3L 驱动 配置 


1、 安 装 ddr stress tester 

首先 要 安装 ddr_stress_testr 软件 ， 安 装 方法 很 简单 ， 这 里 就 不 做 详细 的 讲解 了 。 但 是 一 定 
要 记得 安装 路 径 ! 因为 我 们 要 到 安装 路 径 里 面 找到 测试 软件 。 比 如 我 安装 到 了 D:\Program Files 
(x86) 里 面 ， 安 装 完成 以 后 就 会 在 此 目录 下 生成 一 个 名 为 ddr_stress_tester_v2.90 的 文件 夹 ， 此 文 
件 夹 就 是 DDR 测试 软件 ， 进 入 到 此 文件 夹 中 ， 里 面 的 文件 如 图 23.5.2.1 所 示 : 

















































































































| bin 2019-06-06 18:39 文件 夹 

T log 2019-06-06 18:39 文件 夹 

T script 2019-06-06 18:39 文件 夹 

& DDR Tester.exe 2017-08-02 10:44 应 用 程序 3,451 KB 
€: LA OPT Base License.html 2018-07-06 13:37 360 se HTML Docu... 195 KB 
| SCR-ddr stress tester v2.9.0.txt 2018-07-06 15:10 文本 文档 4KB 





图 23.5.2.1 ddr stress tester 安装 文件 
图 23.5.2.1 中 的 DDR  Tester.exe 就 是 我 们 稍 后 要 使 用 的 DDR 测试 软件 。 


2、 配 置 DDR3L， 生 成 初始 化 脚本 
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YE JT OR ROG HEP HU: 5、 开 发 工具 ->6、NXP 官方 DDR 初始 化 与 测试 工具 
->IMX6UL DDR3 Script Aid V0.02.xlsx 文件 找 贝 到 ddr_stress_testr 软件 安装 目录 中 ， 完 成 以 
后 如 图 23.5.2.2 所 示 : 


T bin 2019-06-06 18:39 文件 夹 
- log 2019-06-06 18:39 文件 夹 
T script 2019-06-06 18:39 文件 夹 
dl DDR Testerexe 2017-08-02 10:44 应 用 程序 3,451 KB 
[& LA OPT Base License.html 2018-07-06 13:37 360 se HTML Docu... 195 KB 





© SCR-ddr stress tester v2.9.0.txt 2018-07-06 15:10 文本 文档 4KB 
I. MX6UL DDR3 Script Aid VO.02.xlsx 2018-07-31 12:08 Microsoft Excel T... 84 KB 


I.MX6UBSDDR3ROEIexcelz& 


图 23.5.2.2 拷贝 完成 以 后 的 测试 软件 目录 
LMX6UL DDR3 Script Aid_V0.02.xlsx 就 是 NXP 为 LIMX6UL 编写 的 DDR3 配置 excel 表 ， 
虽然 看 名 字 是 为 LMX6UL 编写 的 ， 但 是 LIMX6ULL 也 是 可 以 使 用 的 。 
打开 IMX6UL DDR3 Script Aid V0.02.xlsx， 打 开 以 后 如 图 23.5.2.3 所 示 : 








LMX6UL DDR3 Script Aid V0.02.xlsx - Excel 左 忠 凯 TA 


LI MES MEE NES 操作 说 明 搜索 


B 条 件 格式 - E 


D 套用 表格 格式 - 单元 格 












































(E 单元 格 样式 - 








| Readme | |Register Configuration © i [TI 


计数 14 R 显示 器 设置 















































图 23.5.2.3 配置 excel 表 
图 23.5.2.3 中 最 下 方 有 三 个 选项 卡 ， 这 三 个 选项 卡 的 功能 如 下 : 
(D. Readme 选项 卡 ， 此 选项 卡 是 帮助 信息 ， 告 诉 用 户 此 文件 如 何 使 用 。 
(2), Register Configuration 选项 卡 ， 顾 名 思 义 ， 此 选项 卡 用 于 完成 寄存 器 配置 ， 也 就 是 配置 
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DDR3， 此 选项 卡 是 我 们 重点 要 讲解 的 。 

(3. RealView.inc 选项 卡 ， 当 我 们 配置 好 Register Configuration 选项 卡 以 后 ，RealView.inc 
选项 卡 里 面 就 保存 着 寄存 器 地 址 和 对 应 的 寄存 器 值 。 我 们 需要 另外 新 建 一 个 后 缀 为 .inc 的 文件 
来 保存 RealView.inc 中 的 初始 化 脚本 内 容 ，ddr_stress_testr 软件 就 是 要 使 用 此 .inc 结尾 的 初始 化 
脚本 文件 来 初始 化 DDR3. 

选中 “Register Configuration ”选项 卡 ， 如 图 23.5.2.4 所 示 : 

Device Information 
Manufacturer: 
Memory part number: 
Memory type: 

DRAM density (Gb) 
DRAM Bus Width 
Number of Banks 

Number of ROW Addresses 
Number of COLUMN Addresses 
Page Size (K) 
Self-Refresh Temperature (SRT) 
tRCD=tRP=CL (ns) 
tRC Min (ns) 


System Information 







































































Bus Width 





Density per chip select (Gb) 


DRAM Clock Freq (MHz) 
DRAM Clock Cycle Time (ns) 
Address Mirror (for CS1) 
Sl Configuration . 








DRAM DSE Setting - ADDR/CMD/CTL (ohm) 
DRAM DSE Setting - CK (ohm) 
DRAM DSE Setting - DQS (ohm) 


System ODT Setting (ohm) 


Readme | Register Configuration | RealView .inc (e 
图 23.5.2.4 配置 界面 
图 23.5.2.4 就 是 具体 的 配置 界面 ， 主 要 分 为 三 部 分 : 
(D. Device Information 
DDR3 艺 片 设备 信息 设置 ， 此 部 分 需要 根据 所 使 用 的 DDR3 芯片 来 设置 ， 有 具体 的 设置 项 如 
F: 
Manufacturer: DDR3 芯片 厂商 , 默认 为 镁 光 (Micron), 这 个 没有 意义 ， 比 如 我 们 用 的 nanya 
的 DDR3， 但 是 此 配置 文件 也 是 可 以 使 用 的 。 
Memory part number: DDR3 世 片 型 号 ， 可 以 不 用 设置 ， 没 有 实际 意义 。 
Memory type:DDR3 类 型 ， 有 DDR3-800、DDR3-1066、DDR3-1333 和 DDR3-1600， 在 此 
选项 右 侧 有 个 下 拉 箭 头 ， 点 击 下 拉 箭 头 即 可 查看 所 有 的 可 选 选项 ， 如 图 23.5.2.5 所 示 : 
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DDR3-1600 
图 23.5.2.5 Memory type 可 选 选 项 

从 图 23.5.2.5 可 以 看 出 ， 最 大 只 能 选择 DDR3-1600， 没 有 DDR3-1866 选项 ， 因 此 我 们 就 只 
能 选择 DDR3-1600。 

DRAM density(Gb): DDR3 容量 ， 根 据 实际 情况 选择 ， 同 样 右边 有 个 下 拉 箭 头 ， 打 开 下 拉 
箭头 即 可 看 到 所 有 可 选 的 容量 ， 如 图 23.5.2.6 所 示 : 



































图 23.5.2.6 容量 选择 
从 图 23.5.2.6 可 以 看 出 ， 可 选 的 容量 为 1、2、4 和 8Gb， 如 果 使 用 的 512MB 的 DDR3 就 应 
该 选择 4， 如 果 使 用 的 256MB 的 DDR3 就 应 该 选择 2。 
DRAM Bus width: DDR3 位 宽 ， 可 选 的 选项 如 图 23.5.2.7 所 示 : 























图 23.5.2.7 DDR3 位 宽 

正点 原子 ALPHA 开发 板 所 有 的 DDR3 都 是 16 位 宽 ， 因 此 选择 16。 

Number of Banks: DDR3 内 部 BANK 数量 ， 对 于 DDR3 来 说 内 部 都 是 8 个 BANK， 因 此 
固定 为 8。 

Number of ROW Addresses: 行 地 址 宽度 ， 可 选 11-16 位 ， 这 个 要 具体 所 使 用 的 DDR3 č 
片 来 定 ， 如 果 是 EMMC 核心 板 (DDR3 型 号 为 NT5CC256M16EP-EK)， 那 么 行 地 址 为 15 位 。 如 
果 是 NAND 核心 板 (DDR3 型 号 为 NT5CC128M16JR-EK)， 行 地 址 就 为 14 位 。 

Number COLUMN Addresses: 列 地 址 宽度 ， 可 选 9~12 位 。 如 果 是 EMMC 核心 板 (DDR3 
型 号 为 NT5CC256M16EP-EK)， 那 么 列 地 址 为 10 位 。 如 果 是 NAND 核心 板 (DDR3 型 号 为 
NT5CC128M16JR-EK)， 行 地 址 就 为 10 位 。 

Page Size(K): DDR3 页 大 小 ,可 选 1 和 2, NT5CC256M16EP-EK 和 NT5CC128M16JR-EK 
的 页 大 小 都 为 2KB， 因 此 选择 2。 

Self-Refresh Temperature(SRT): 固定 为 Extended， 不 需要 修改 。 

tRCD-tRP-CL(ns): DDR3 的 tRCD-tRP-CL 时 间 参 数 , 要 查阅 所 使 用 的 DDR3 芯片 手册 ， 
NT5CC256M16EP-EK 和 NT5CC128M16JR-EK 都 为 13.91ns， 因 此 在 后 面 填写 13.91. 

tRC Min(ns): DDR3 fj tRC 时 间 参 数 ，NT5CC256M16EP-EK 和 NT5CC128M16JR-EK 都 
为 47.91ns， 因 此 在 后 面 填写 47.91。 

tRAS Min(ns): DDR3 的 tRAS 时 间 参 数 ，NT5CC256M16EP-EK 和 NT5CC128M16JR-EK 
都 为 34ns， 因 此 在 后 面 填写 34。 


@, System Information 
此 部 分 设置 LMX6UL/6ULL 相关 属性 ， 有 具体 的 设置 项 如 下 : 
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i.Mx Part， 固 定 为 1MX6UL 。 
Bus Width: 总 线 宽度 ，16 位 宽 。 
Density per Chip select(Gb): 每 个 片 选 对 应 的 DDR3 容量 ， 可 选 1~16， 根 据 实际 所 使 用 的 








DDR3 芯片 来 填写 ，512MB 的 话 就 选择 4，25 

















都 只 使 用 了 一 个 片 选 信号 ， 因 此 选择 1。 
Total DRAM Density(Gb): 整个 DDR3 的 容量 ， 单 位 为 Gb， 如 果 是 S12MB 的 话 就 是 4， 
如 果 是 256MB 的 话 就 是 2。 
DRAM Clock Freq(MHz): DDR3 工作 频 
DRAM Clock Cycle Time(ns): DDR3 工作 频率 对 应 的 周期 ,单位 为 ns, 如 果 工 作 在 400MHz， 
那么 周期 就 是 2.Sns。 
Address Mirror(for CS1): 地 址 镜像 ， 仅 CS1 有 效 ， 此 处 选择 关闭 ， 也 就 是 “Disable”， 此 
选项 我 们 不 需要 修改 。 
@、 SI Configuratin 


此 部 分 是 信号 完整 性 方面 的 配置 , 主要 是 
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6MB 的 话 就 选择 2。 








Number of Chip Select used: 使 用 几 个 片 选 信号 ? 可 选择 1 或 2， 正 点 原子 所 有 的 核心 板 

















率 ， 设 置 为 400MHz。 









































这 里 我 们 直接 使 用 NXP 的 默认 设置 即 可 。 











关于 














些 信 号 线 的 阻抗 设置 , 这 个 要 咨询 硬件 工程 师 ， 


























DDR3 的 配置 我 们 就 讲解 到 这 里 ， 如 果 是 EMMC 核心 板 (DDR3 型 号 为 








NT5CC256M16EP-EK)， 那 么 配置 如 图 23.5.2.8 所 示 : 





_ Device Information 








Manufacturer: 








Memory part number: 











Memory type: 









DRAM density (Gb) 





DRAM Bus Width 








Number of Banks 











Number of ROW Addresses 








Number of COLUMN Addresses 





Page Size (K) 











Self-Refresh Temperature (SRT) 





tRCD=tRP=CL (ns) 








tRC Min (ns) 















i.Mx Part 








Bus Width 











Density per chip select (Gb) 





Number of Chip Selects u 





sed 





Total DRAM Density (G| 





b) 








DRAM Clock Freq (MHz) 





DRAM Clock Cycle Time 





(ns) 









Address Mirror (for CS1 


SI Configuration 





DRAM DSE Setting - DQ/DQM (ohm) 











DRAM DSE Setting - ADDR/CMD/CTL (ohm) 











DRAM DSE Setting - CK (ohm) 








DRAM DSE Setting - DQS (ohm) 





System ODT Setting (oh 





m) 





| Readme | Register Configuration | RealView.inc | © 





图 23.5.2.8 EMMC 核心 板 配置 。 




















NAND 核心 板 配置 (DDR3 型 号 为 NT5CC128M16JR-EK) 配 置 如 图 23.5.2.9 所 示 : 
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Device Information 
Manufacturer: 
Memory part number: 
Memory type: 

DRAM density (Gb) 
DRAM Bus Width 
Number of Banks 

Number of ROW Addresses 
Number of COLUMN Addresses 
Page Size (K) 
Self-Refresh Temperature (SRT) 
tRCD=tRP=CL (ns) 
tRC Min (ns) 
tRAS Min (ns) 






































































i.Mx Part 
Bus Width 

Density per chip select (Gb) 

Number of Chip Selects used 
Total DRAM Density (Gb) 
DRAM Clock Freq (MHz) 

DRAM Clock Cycle Time (ns) 

Address Mirror (for CS1) 



























SI Configuration 
DRAM DSE Setting - DQ/DQM (ohm) 
DRAM DSE Setting - ADDR/CMD/CTL (ohm) 
DRAM DSE Setting - CK (ohm) 
DRAM DSE Setting - DQS (ohm) 
System ODT Setting (ohm) 


Readme | Register Configuration | RealView .inc © 


&| 23.5.2.9 NAND 核心 板 配置 
后 面 我 就 以 EMMC 核心 板 为 例 讲 解 了 ， 配 置 完成 以 后 点 击 RealView.inc 选项 卡 ， 如 图 
23.5.2.10 所 示 : 
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/一 
// Revision History 
// x01 
E 一 一 一 —— 
wait = on 
/ /======================= ===================: === ======================= = 
)|// Disable WDOG 
[|//======================= c-—cccczczczclz--- === ===== ===== 
?|setmem /16 0x020bc000 = 0x30 
3 
1|//=========== c——--czcccccczc2-2l2222222---- =========: === 
5|// Enable all clocks (they are disabled by ROM code) 
3 [// === ===========: =========================================== 
7|setmem /32 0x020c4068 = Oxffffffff 
3 |setmem /32 0x020c406c = Oxffffffff 
)|setmem /32 0x020c4070 = Oxffffffff 
)|setmem /32 0x020c4074 = Oxffffffff 
l| |setmem /32 0x020c4078 = Oxffffffff 
?|setmem /32 0x020c407c = Oxffffffff 
l|setmem /32 0x020c4080 - Oxffffffff 
t 
) 
j | /============================================================================= 
7 |// IOMUX 
3 - 


Readme | Register Configuration | RealView .inc 中 4 


图 23.5.2.10 生成 的 配置 脚本 。 
图 23.5.2.10 中 的 RealView.inc 就 是 生成 的 配置 脚本 ， 全 部 是 “寄存 器 地 址 = 寄存 器 值 ” 这 
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种 形式 。RealView.inc 不 能 直接 用 ， 我 们 需要 新 建 一 个 以 .inc 结尾 的 文件 ， 名 字 自 定义 ， 比 如 我 
名 为 “ALIENTEK 512MB” ffJ.inc 文件 ， 如 图 23.5.2.11 所 示 : 











| bin 2019-06-06 18:39 文件 夹 
T log 2019-06-06 18:39 文件 夹 
T script 2019-06-06 18:39 文件 夹 
4l DDR Tester.exe 2017-08-02 10:44 应 用 程序 3,451 KB 
S LA OPT Base License.html 2018-07-06 13:37 360 se HTML Docu... 195 KB 
E] SCR-ddr stress tester v2.9.0.txt 2018-07-06 15:10 文本 文档 4KB 
3: |.MX6UL DDR3 Script Aid VO.02.xlsx 2018-07-31 12:08 Microsoft Excel T... 84 KB 
2019-10-061717 INC 文件 0 KB 


新 建 的 .inc 文 件 


图 23.5.2.11 新 建 .inc 文件 
用 notepad++ 打 开 ALIENTEK. 512MB.inc 文件 ， 然 后 将 图 23.5.2.10 中 RealView.inc 里 面 的 
所 有 内 容 全 部 拷贝 到 ALIENTEK 512MB.ine 文件 中 ， 完 成 以 后 如 图 23.5.2.12 所 示 : 


























































































































i DAProgram Files (x86)\ddr_stress_tester_v2.90\ALIENTEK_512MB.inc - Notepad++ = x 
文件 (F) 编辑 (E) 搜索 (S$) 视图 (V) 编码 (N) 语言 (L) 设置 (T) 工具 (O) 宏 (M) 运行 (R) 插件 (P) 窗口 (W) ? X 
o3 E LENN EA | 23 A d ^| AE R A AEn e v x EB MX 

NE-// ^ 

2 //init script for i.MX6UL DDR3 

EM // 

4 |// Revision History 

5 // v01 

6 t// 

7 

8 wait = on 

9 g// 

10 |// Disable WDOG 

11 -// 

12 setmem /16 0x020bc000 = 0x30 

Hs 

14 g8// 

15 // Enable all clocks (they are disabled by ROM code) 

16 -// 

1:7) setmem /32  0x020c4068 z üxftitttttf 

8 setmem /32  0x020c406c = Oxffftffff 

19  setmem /32  0x020c4070 = Oxtrtitttftt 

20 setmem /32  0x020c4074 z Oxtffttftf T 
< » 








Pascal source file length:7,557 lines: 208 In:6 Col:30 Sel:0|0 Windows (CR LF) UTF-8 IN 


23.5.2.12. 完成 后 的 ALIENTEK 512MB.inc 文件 内 容 
至 此 ，DDR3 配置 就 全 部 完成 ，DDR3 的 配置 文件 ALIENTEK 512MB.inc 已 经 得 到 了 ， 接 
下 来 就 是 使 用 此 配置 文件 对 正点 原子 ALPHA 开发 板 的 DDR3 进行 校准 并 进行 超频 测试 。 











23.5.3 DDR3L 校准 

首先 要 用 DDR Tester.exe 软件 对 正点 原子 ALPAH 开发 板 的 DDR3L 进行 校准 ， 因 为 不 同 
的 PCB 其 走 线 不 同 ， 必 须要 进行 校准 ， 经 过 校准 一 会 DDR3L 就 会 工作 到 最 佳 状态 。 

1、 将 开发 板 通过 USB OTG 线 连 接 到 电脑 上 


DDR Tester 软件 通过 USB OTG 线 将 测试 程序 下 载 到 开发 板 中 ， 因 此 首先 需要 使 用 USB 
OTG 线 将 开发 板 和 电脑 连接 起 来 ， 如 图 23.5.3.1 所 示 : 
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区 到 R32 | ad ERU z v v 
Ef 


ZE | 








图 23.5.3.1 USB OTG 连接 示意 图 


USB OTG 线 连 接 成 功 以 后 还 需要 如 下 两 步 : 
O, HE TF 卡 ， 如 果 插 入 了 TF 卡 ， 那 么 一 定 要 弹出 来 !! 
@、 设 置 拨 码 开关 从 USB 启动 ， 如 图 23.5.3.2 所 示 : 














图 23.5.3.2 USB 启动 





2、DDR_Tester 软件 
双击 “DDR_Tester.exe”， 打开 测试 软件 ， 如 图 23.5.3.3 所 示 : 
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大 NXP DDR Test Tool x 
Load Init Script 
Download 
TARGET MX6DQ Y ARM Speed Default i£ | Verify DCD Address 
DDR Density Default ~ DDR CS 0 v DDR channel 0 ~ 
VDD ARM CAP Auto ~ - auto + VDD SOC CAPAuo ~| - auo + Set Voltage 
DDR Calibration DDR Stess Test 32bit Memory Read/Write 
Over Night Test || Stop when Fail 
MR1 Value(HEX) |0000 
IE StatFreq(MHz) |0 ADDR(HEX) 
0 ES 
pone EndFreq(MHz) |0 sıze 1WORD | Read 
Calibration Save Result Stress Test Save Result DATA(HEX) Write 




















23.5.3.3 NXP DDR Test Tool 


点 击 图 23.5.3.3 中 的 “Load init Script ”加 载 前 面 已 经 生成 的 初始 化 脚本 文件 
ALIENTEK 512MB.inc， 完 成 以 后 如 图 23.5.3.4 所 示 ; 























di NXP DDR Test Tool 加 载 的 .inc 脚 本 文件 
Load Init Script 
Download 
TARGET MX6DQ Y ARM Speed Defaut ~ Z] Verify DCD Address ads 
DDR Density Default ~ DDRCS 0 v DDRchanel 0 ~ 





23.5.3.4 .inc 文件 加 载 成 功 后 的 界面 
ALIENTEK_512MB.inc 文件 加 载 成 功 以 后 还 不 能 直接 用 ， 还 需要 对 DDR Test Tool 软件 进 
行 设置 ， 设 置 完 成 以 后 如 图 23.5.3.5 所 示 : 
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大 NXP DDR Test Tool x 
不 能 勾 选 此 选项 





Load Init Script | D:\Program Files (x86)\ddr_stress_tester_v2.90\ALIENTEK_512MB.inc 
d 
选择 6ULL Download 
TARGET MX6ULL v ARM Speed | 528MHz ~ Verify DCD Address 


DDR 容 量 512MB 























6ULL 速 度 选择 528MHz 
VDD ARM CAP Auto ~  . auto |+ VDD SOC _CAPAuto ~| - jauto + Set Voltage 
DDR Calibration DDR Stess Test 32bit Memory Read/Write 
Over Night Test || Stop when Fail 


























0000 
ae pe | Start Freq(MHz) "P — | ADDR(HEX) | | 
400 
DDR Freq(MHz) End Freq(MHz) am sıze WORD ~|| Read 


DDRi }400 
Calibration Save Result Stress Test Mim Result DATA(HEX) Write 


























图 23.5.3.5 DDR Test Tool 配置 

一 切 设置 好 以 后 点 击 图 23.5.3.5 中 右上 方 大 大 的 “Download” 按 钮 ， 将 测试 代码 下 载 到 开 

发 板 中 (具体 下 载 到 哪里 笔者 也 不 清楚 , 估计 是 LIMX6ULL 内 部 的 OCRAMD), 下载 完 成 以 后 DDR 
Test Tool 下 方 的 信息 窗口 就 会 输出 一 些 内 容 ， 如 图 23.5.3.6 所 示 : 

















Boot Configuration 
SRC_SBMR1(0x020d8004) = 0x00000002 
SRC_SBMR2(0x020d801c) = 0x01000001 


DDR configuration 
DDR type is DDR3 
Data width: 16, bank num: 8 








图 23.5.3.6 信息 输出 
图 23.5.3.6 输出 了 一 些 关 于 板子 的 信息 ， 比 如 SOC 型 号 、 工 作 频 率 、DDR 配置 信息 等 等 。 
DDR Test Tool 工具 有 三 个 测试 项 :DDR Calibration, DDR Stess Test 和 32bit Memory Read/Write， 
我 们 首先 要 做 校准 测试 ， 因 为 不 同 的 PCB、 不 同 的 DDR3L 芯片 对 信和 号 的 影响 不 同 ， 必 须要 进 
行 校准 ， 然 后 用 新 的 校准 值 重新 初始 化 DDR。 点 击 “Calibraton” 按 钮 ， 如 图 23.5.3.7 所 示 : 
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DDR Calibration DDR Stess Test 32bit Memory Read/Write 




















Over Night Test || Stop when Fail 


(0000 — | 
MR a(S) pee 7 Start Freq(MHz) 0 ADDR(HEX) | | 
40 .— 
DDR Freq(MHz) "S Freq(MHz) Eo J| size 1WORD ~ | Read 
ax MENS 
Save Result Stress Test Save Result DATA(HEX) Write 
图 23.5.3.7. 开始 校准 


点 击 图 23.5.3.7 中 的 “Calibration ”按钮 以 后 就 会 自动 开始 校准 ， 最 终 会 得 到 Write leveling 
calibtarion、Read DQS Gating Calibration、Read calibration 和 Write calibration， 一 共 四 种 校准 结 
果 ， 校 准 结果 如 下 : 




























































示例 代码 23.5.3.1 DDR3L 校准 结果 









































1 Write leveling calibration 
2 MMDC MPWLDECTRLO ch0 (0x0215080c) = 0x00000000 
3 MMDC MPWLDECTRL1 ch0 (0x02150810) = 0x000B8000B 
4 
5 Read DQS Gating calibration 
6 MPDGCTRLO PHYO (0x0215083c) = 0x0138013C 
7 MPDGCTRL1 PHYO (0x021500840) = 0x00000000 
8 
9 Read calibration 
10 MPRDDLCTL PHYO (0x02100848) = 0x40402E34 
I 
12 Write calibration 
13 MPWRDLCTL PHYO (0x02150850) = 0x40403A34 
所 谓 的 校准 结果 其 实 就 是 得 到 了 一 些 寄存 器 对 应 的 值 ， 比 如 MMDC MPWLDECTRLO f 
存 器 地 址 为 0X021B080C， 此 寄存 器 是 PHY 写 平衡 延 时 寄存 器 0， 经 过 校准 以 后 此 寄存 器 的 值 











应 该 为 0X00000000 ， 以 此 类 推 。 我 们 需要 修改 ALIENTEK 512MB.inc 文件 ， 找 到 
MMDC MPWLDECTRLO0,MMDC MPWLDECTRLI , MPDGCTRL0 PHYO, MPDGCTRL1 PHYO, 
MPRDDLCTL PHY0 fll MPWRDLCTL PHYO 这 6 个 寄存 器 ， 然 后 将 其 值 改 为 示例 代码 23.5.3.1 
中 的 校准 后 的 值 。 注 意 ， 在 ALIENTEK 512MB.inc 中 可 能 找 不 到 
MMDC MPWLDECTRL1(0x021b0810) 和 MPDGCTRL1 PHY0(0x021b0840) 这 两 个 寄存 器 , 找 不 
到 就 不 用 修改 了 。 

ALIENTEK_512MB.inc 修改 完成 以 后 重新 加 载 并 下 载 到 开发 板 中 ， 至 此 DDR 校准 完成 ， 
校准 的 目的 就 是 得 到 示例 代码 23.5.3.1 中 这 6 个 寄存 器 的 值 ! 





























23.5.4 DDR3L 超频 测试 


校准 完成 以 后 就 可 以 进行 DDR3 超频 测试 ， 超 频 测试 的 目的 就 是 为 了 检验 DDR3 硬件 设 
计 合 不 合理 ， 一 般 DDR3 能 够 超频 到 比 标准 频率 高 10%~15% 的 话 就 认为 硬件 没有 问题 ， 因 此 
对 于 正点 原子 的 ALPHA 开发 板 而 言 ， 如 果 DDR3 能 够 超频 到 440MHz~460MHz 那么 就 认为 
DDR3 硬件 工作 良好 。 
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DDR Test Tool 支持 DDR3 超频 测试 ， 只 要 指定 起 始 频率 和 终止 频率 ， 那 么 工具 就 会 自动 

开始 一 点 点 的 增加 频率 ， 直 到 达到 终止 频率 或 者 测试 失败 。 设 置 如 图 23.5.4.1 所 示 : 

DDR Calibration DDR Stess Test 32bit Memory Read/Write 






































Over Night Test |V| Stop when Fail 起 始 频率 
0000 
MRU VEERE Start Freq(MHz) |j — | ADDR(HEX) [| ] 
0 开启 测试 
DDR Freq(MHz) End Freq(MHz) size 1WORD | Read 


终止 频率 
Calibration Save Result Save Result DATA(HEX) Write 























23.5.4.1 超频 测试 配置 
图 23.5.4.1 中 设置 好 其 实 频率 为 400MHz， 终 止 频率 为 600MHz， 设 置 好 以 后 点 击 “Stress 
Test” 开 启 超频 测试 ， 超 频 测试 时 间 比 较 久 , 大 家 耐心 等 待 测试 结果 即 可 。 超 频 测试 完成 以 后 结 
果 如 图 23.5.4.2 所 示 ( 因 为 硬件 不 同 ， 测 试 结果 可 能 有 些许 区 别 ): 




















DDR Freq: 556 MHz 

t0.1: data is addr test 

t0: memcpy11 SSN test 

t1: memcpy8 SSN test 

t2: byte-wise SSN test 

t3: memcpy11 random pattern test 

t4: IRAM to DDRv2 test 

t5: IRAM to DDRv1 test 

t6: read noise walking ones and zeros test 


DDR Freq: 561 MHz 

t0.1: data is addr test 

Address of failure(step2): 0x809f29c0 
Data was: 0x00000000 

But pattern should match address 
Error: failed to run stress test!!! 








23.5.4.2 超频 测试 结果 


从 图 23.5.4.2 可 以 看 出 ， 正 点 原子 的 ALPAH 开发 板 EMMC 核心 板 DDR3 最 高 可 以 超频 到 
556MHz, 当 超 频 到 561MHz 的 时 候 就 失败 了 。556MHz 超过 了 460MHz, 说 明正 点 原子 的 ALPHA 
开发 板 DDR3 硬件 是 没有 任何 问题 的 。 








23.5.5 DDR3L 驱动 总 结 


ALIENTEK 512MB.inc 就 是 我 们 最 终 得 到 的 DDR3L 初始 化 脚本 ， 其 中 包括 了 时 钟 、IO 等 
初始 化 。LMX6U 的 DDR3 接口 关于 IO 有 一 些 特殊 的 寄存 器 需要 初始 化 ， 如 表 23.5.5.1 所 示 : 









































0X020E04B4 IOMUXC SW PAD CTL GRP DDR TYPE 0X000C0000 
0X020E04AC IOMUXC SW PAD CTL GRP DDRPKE 0X00000000 
0X020E027C IOMUXC SW PAD CTL PAD DRAM SDCLK 0 0X00000028 
0X020E0250 IOMUXC SW PAD CTL PAD DRAM CAS 0X00000028 
0X020E024C IOMUXC SW PAD CTL PAD DRAM RAS 0X00000028 
0X020E0490 IOMUXC SW PAD CTL GRP ADDDS 0X00000028 
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0X020E0288 IOMUXC SW PAD CTL PAD DRAM RESET 0X00000028 
0X020E0270 IOMUXC SW PAD CTL PAD DRAM SDBA2 0X00000000 
0X020E0260 IOMUXC SW PAD CTL PAD DRAM SDODTO 0X00000028 
0X020E0264 IOMUXC SW PAD CTL PAD DRAM SDODTI 0X00000028 
0X020E04A0 IOMUXC SW PAD CTL GRP CTLDS 0X00000028 
0X020E0494 IOMUXC SW PAD CTL GRP DDRMODE CTL 0X00020000 
0X020e0280 IOMUXC SW PAD CTL PAD DRAM SDQSO 0X00000028 
0X020E0284 IOMUXC SW PAD CTL PAD DRAM SDQSI 0X00000028 
0X020E04B0 IOMUXC SW PAD CTL GRP DDRMODE 0X00020000 
0X020e0498 IOMUXC SW PAD CTL GRP BODS 0X00000028 
0X020E04A4 IOMUXC SW PAD CTL GRP BIDS 0X00000028 
0X020E0244 IOMUXC SW PAD CTL PAD DRAM DQMO 0X00000028 
0X020E0248 IOMUXC SW PAD CTL PAD DRAM DOMI 0X00000028 
表 23.5.5.1 DDR3 IO 相关 初始 化 
接 下 来 看 一 下 MMDC 外 设 寄存 器 初始 化 ， 如 表 23.5.5.2 所 示 : 
0X021B0800 DDR PHY PO MPZQHWCTRL 0XA1390003 
0X021B080C MMDC MPWLDECTRLO 0X00000000 
0X021B083C MPDGCTRLO 0X0138013C 
0X021B0848 MPRDDLCTL 0X40402E34 
0X021B0850 MPWRDLCTL 0X40403A34 
0X021B081C MMDC MPRDDQBYODL 0X33333333 
0X021B0820 MMDC MPRDDQBYIDL 0X33333333 
0X021B082C MMDC MPWRDQBYODL 0XF3333333 
0X021B0830 MMDC MPWRDQBYIDL 0XF3333333 
0X021B08CO MMDC MPDCCR 0X00921012 
0X021B08B8 DDR PHY PO MPMURO 0X00000800 
0X021B0004 MMDC0 MDPDC 0X0002002D 
0X021B0008 MMDC0 MDOTC 0X1B333030 
0X021B000C MMDC0 MDCFGO0 0X676B52F3 
0X021B0010 MMDC0 MDCFGI 0XB66D0B63 
0X021B0014 MMDC0 MDCFG2 0X01FF00DB 
0X021b002c MMDC0 MDRWD 0X000026D2 
0X021b0030 MMDC0 MDOR 0X006B1023 
0X021b0040 MMDC MDASP 0X0000004F 
0X021b0000 MMDCO0 MDCTL 0X84180000 
0X021b0890 MPPDCMPR2 0X00400238 
0X021b0020 MMDC0 MDREF 0X00007800 
0X021b0818 DDR PHY PO MPODTCTRL 0X00000227 
0X021b0004 MMDC0 MDPDC 0X0002556D 
0X021b0404 MMDC0 MAPSR 0X00011006 











K 23.5.5.2 MMDC 外 设 寄存 器 初始 化 及 初始 化 序列 
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XT LMX6U 的 DDR3 就 讲解 到 这 里 ， 因 为 牵扯 到 的 寄存 器 太 多 了 ， 因 此 没有 详细 的 去 分 
析 这 些 寄存 器 ， 大 家 感 兴趣 的 可 以 对 照 着 参考 手册 去 分 析 各 个 寄存 器 的 含义 以 及 配置 值 。 
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第 二 十 四 章 RGBLCD 显示 实验 


LCD 液晶 屏 是 常用 到 的 外 设 ， 通 过 LCD 可 以 显示 绚丽 的 图 形 、 界 面 等 ， 提 高 人 机 交互 的 
效率 。LMX6U 提供 了 一 个 eLCDIF 接口 用 于 连接 RGB 接口 的 液晶 屏 。 本 章 我 们 就 学 习 如 何 驱 
动 RGB 接口 液晶 屏 ， 并 且 在 屏幕 上 显示 字符 。 
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24.1 LCD 和 eLCDIF 简介 


24.1.1LCD 简介 





























LCD 全 称 是 Liquid Crystal Display， 也 就 是 液晶 显示 器 ， 是 现在 最 常用 到 的 显示 器 ,手机 、 
电脑 、 各 种 人 机 交互 设备 等 基本 都 用 到 了 LCD， 最 常见 就 是 手机 和 电脑 显示 器 了 。 由 于 笔者 不 
是 LCD 从 业 人 员 ， 对 于 LCD 的 具体 原理 不 了 解 ， 百 度 百科 对 于 LCD 的 原理 解释 如 下 : 

LCD 的 构造 是 在 两 片 平 行 的 玻璃 基板 当中 放置 液晶 盒 , 下 基板 玻璃 上 设置 TFT (薄膜 晶体 
管 )， 上 基板 玻璃 上 设置 彩色 滤 光 片 ， 通 过 TFT 上 的 信号 与 电压 改变 来 控制 液晶 分 子 的 转动 方 
向 ， 从 而 达到 控制 每 个 像素 点 偏振 光 出 射 与 否 而 达到 显示 目的 。 

我 们 现在 要 在 LIMX6U-ALPHA 开发 板 上 使 用 LCD, 所 以 不 需要 去 研究 LCD 的 具体 实现 原 

理 ， 我 们 只 需要 从 使 用 的 角度 去 关注 LCD 的 几 个 重要 点 : 





































































































1、 分 辩 率 
提起 LCD 显示 器 ， 我 们 都 会 听 到 720P、1080P、2K 或 AK 这 样 的 字眼 ， 这 个 就 是 LCD 显 
示 器 分 辨 率 。LCD 显示 器 都 是 由 一 个 一 个 的 像素 点 组 成 ， 像 素 点 就 类 似 一 个 灯 ( 在 OLED 显示 























器 中 ,像素 点 就 是 一 个 小 灯 )， 这 个 小 灯 是 RGB AT, 也 就 是 由 R( 红 色 )、G( 绿 色 ) 和 B( 蓝 色 ) 这 三 
种 颜色 组 成 的 ， 而 RGB 就 是 光 的 三 原色 。1080P 的 意思 就 是 一 个 LCD 屏幕 上 的 像素 数量 是 
1920*1080 个 ， 也 就 是 这 个 屏幕 一 列 1080 个 像素 点 ， 一 共 1920 列 ， 如 图 24.1.1.1 所 示 : 












































A (0 0) D (1919, 0) 





















































BO) —  — C (1919, 1079) Xo 
图 24.1.1.1 LCD 像素 点 排 布 

在 图 24.1.1.1 就 是 1080P 显示 器 的 像素 示意 图 , X 轴 就 是 LCD 显示 器 的 横 轴 , Y 轴 就 是 显 
示 器 的 竖 轴 。 图 中 的 小 方块 就 是 像素 点 ， 一 共有 1920*1080=2073600 个 像素 点 。 左 上 角 的 A 点 
是 第 一 个 像素 点 ， 右 下 角 的 C 点 就 是 最 后 一 个 像素 点 。2K 就 是 2560*1440 个 像素 点 ，4K 是 
3840*2160 个 像素 点 。 很 明显 ， 在 LCD 尺寸 不 变 的 情况 下 ， 分辨 率 也 高 越 清 晰 。 同 样 的 ， 分 辨 
率 不 变 的 情况 下 ，LCD 尺寸 越 小 越 清 晰 。 比 如 我 们 常用 的 24 寸 显示 器 基本 都 是 1080P 的 ， 而 
我 们 现在 使 用 的 5 寸 的 手机 基本 也 是 1080P 的 ， 但 是 手机 显示 细腻 程度 就 要 比 24 寸 的 显示 器 
要 好 很 多 ! 
由 此 可 见 ，LCD 显示 器 的 分 辩 率 是 一 个 很 重要 的 参数 ， 但 是 并 不 是 分 辩 率 越 高 的 LCD 就 
越 好 。 衡 量 一 款 LCD 的 好 坏 分 ， 辩 率 只 是 其 中 的 一 个 参数 ， 还 有 色彩 还 原 程度 、 色 彩 偏离 、 亮 
度 、 可 视角 度 、 屏 幕 刷新 率 等 其 他 参数 。 

2、 像 素 格式 

上 面 讲 了 ， 一 个 像素 点 就 相当 于 一 个 RGB 小 灯 ， 通 过 控制 R、G、B 这 三 种 颜色 的 亮度 就 
可 以 显示 出 各 种 各 样 的 色彩 。 那 该 如 何 控制 R、G、B 这 三 种 颜色 的 显示 亮度 呢 ? 一 般 一 个 R, 
G、B 这 三 部 分 分 别 使 用 8bit 的 数据 ， 那 么 一 个 像素 点 就 是 8bit*3=24bit， 也 就 是 说 一 个 像素 点 
3 个 字 节 ， 这 种 像素 格式 称 为 RGB888。 如 果 在 加 入 8bit 的 Alpha( 透 明 ) 通 道 的 话 一 个 像素 点 就 
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是 32bit， 也 就 是 4 个 字 节 ， 这 种 像素 格式 称 为 ARGB8888。 如 果 学 习 过 STM32 的 话 应 该 还 听 





过 RGB565 这 种 像素 格式 ， 在 本 章 实验 中 我 们 使 用 ARGB8888 这 种 像素 格式 ， 一 个 像素 占用 4 
个 字 节 的 内 存 ， 这 四 个 字 节 每 个 位 的 分 配 如 图 24.1.1.2 所 示 : 








Ee ee [eT e Ter eT eT Tes] 
加 加 加 加 加 加 四 可 










国 四 四 四 四 四 





图 24.1.1.2 ARGB8888 数据 格式 

在 图 24.1.1.2 中 ， 一 个 像素 点 是 4 个 字 节 ， 其 中 bit31~bit24 是 Alpha 通道 ，bit23~bit16 是 
RED 通道 ，bit15~bit14 是 GREEN 通道 ，bit7~bit0 是 BLUE 通道 。 所 以 红色 对 应 的 值 就 是 
0X00FF0000, 蓝 色 对 应 的 值 就 是 0X0000FF00, 绿色 对 应 的 值 为 0X000000FF。 通过 调节 R、G、 
B 的 比例 可 以 产生 其 它 的 颜色 ,比如 0X00FFFF00 就 是 黄色 ,0X00000000 就 是 黑色 , 0X00FFFFFF 
就 是 白色 。 大 家 可 以 打开 电脑 的 “画图 ”工具 ， 在 里 面 使 用 调 色 板 即 可 获取 到 想 要 的 颜色 对 应 
的 数值 ， 如 图 24.1.1.3 所 示 : 






































































































































— 1、 选 择 颜色 
B I 
BEN g< 
o f 
EE 
EEE 
LN 
选中 的 颜色 
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EXTA ZE 全 
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图 24.1.1.3. 颜色 选取 


3、LCD 屏幕 接口 


LCD 屏幕 或 者 说 显示 器 有 很 多 种 接口 ， 比 如 在 显示 器 上 常见 的 VGA、HDMI、DP 等 等 ， 
但 是 LMX6U-ALPHA 开 发 板 不 支持 这 些 接口 .MX6U-ALPHA 支 持 RGB 接口 的 LCD,RGBLCD 
接口 的 信号 线 如 表 24.1.1.1 所 示 : 






































R[7:0] 8 根 红色 数据 线 。 

G[7:0] 8 根 绿色 数据 线 。 

B[7:0] 8 根 蓝 色 数据 线 。 
DE 数据 使 能 线 。 
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VSYNC 垂直 同步 信号 线 。 
HSYNC 水 平 同 步 信号 线 。 
PCLK 像素 时 钟 信号 线 。 














表 24.1.1.1 RGB 数据 线 

表 24.1.1.1 就 是 RGBLCD 的 信号 线 ,R[7:0]、G[7:0] 和 BI[7:0] 这 24 根 是 数据 线 ,DE、VSYNC、 
HSYNC 和 PCLK 这 四 根 是 控制 信号 线 。 RGB LCD 一 般 有 两 种 驱动 模式 : DE 模式 和 HYV 模式 ， 
这 两 个 模式 的 区 别 是 DE 模式 需要 用 到 DE 信号 线 ， 而 HV 模式 不 需要 用 到 DE 信号 线 ， 在 DE 
模式 下 是 可 以 不 需要 HSYNC 信号 线 的， 即使 不 接 HSYNC 信号 线 LCD 也 可 以 正常 工作 。 

ALIENTEK 一 共有 三 款 RGB LCD 屏幕 ， 型 号 分 别 为 : ATK-4342(4.3 寸 ，480*272)、ATK- 
7084(7 寸 ，800*480) 和 ATK-7016(7 寸 ，1024*600)， 本 教程 就 以 ATK-7016 这 款 屏幕 为 例 讲 解 ， 
ATK-7016 的 屏幕 接口 原理 图 如 图 24.1.1.4 所 示 : 





























VCC5 
cl 
A A 1 
GND ||| HI A — | |l GND VCC3.3 
LCD RO 104 3 40 RESET onpl| WOE ml TCD TR 
LCD RI 4| 2 39 [39 TP PEN = 
LCD R2 5 5 3a [38 IP SCK M 5 
LCD R3 $5 3; 57 TP MISO T 
LCD R4 7| 7 35 [36 IP MOSI GND 4| 6 | LCD UD 
LCD R5 s NEUE 35 TP CS T 
LCD R6 > ia [34 LCD BL 
LCDR7 30 EMEANE 3 DODDE — — vu 7 
exp. 1 MOM 32 LCD VSYNC m 
LCD G0 12| 1j 31 [31 LCD HSYNC onpil] 8 | LCD R7 
LCD GI i EE 3) LCD CIK = 
LCD G2 i4 | 14 29 [29 OND a 11 
LCD G3 5 MENS 2: LCD E7 Jm 
LCD G4 16 MN 27 LCD 56 onpil] 12 | LCD G7 
LCD G5 17 MEME 25 LCD B5 cm 
LCD G6 1 | lj 2$ 25 LCD B4 m 13 
LCD G7 i9 | i9. 24 [24 LCD B3 T 
d 20 EE 23 LcD B2 MT 14 | LCD B7 
| LCD BO 21 EE 2 LCD! | Ta 
TFTLCD 


图 24.1.1.4 RGB LCD 液晶 屏 屏 幕 接口 

图 中 J1 就 是 对 外 接口 ， 是 一 个 40PIN 的 FPC Æ (0.5mm 间距 )， 通 过 FPC 线 ， 可 以 连接 
到 I.MX6U-ALPHA 开发 板 上 面 ， 从 而 实现 和 IMX6U 的 连接 。 该 接口 十 分 完善 ， 采 用 RGB888 
格式 ， 并 支持 DE&HV 模式 ， 还 支持 触摸 屏 和 背光 控制 。 右 侧 的 几 个 电阻 ， 并 不 是 都 焊接 的 ， 
而 是 可 以 用 户 自 己 选择 。 默 认 情 况 ，R1 和 R6 焊接 ， 设 置 LCD LR 和 LCD_UD， 控 制 LCD 的 
扫描 方向 ， 是 从 左 到 右 ， 从 上 到 下 ( 横 屏 看 )。 而 LCD R7/G7/B7 则 用 来 设置 LCD 的 ID， 由 于 
RGBLCD 没有 读 写 寄存 器 ， 也 就 没有 所 谓 的 ID， 这 里 我 们 通过 在 模块 上 面 ， 控 制 R7/G7/B7 的 
EFA, 来 自 定义 LCD 模块 的 ID， 帮 助 MCU 判断 当前 LCD 面板 的 分 辨 率 和 相关 参数 ， 以 提 
高 程序 兼容 性 。 这 几 个 位 的 设置 关系 如 表 24.1.1.2 所 示 : 
























































































































































M2 M1 MO 2 
LCD G7 | LCD. G7 | LCD R7 ib 说 明 
0 0 0 4342 | ATK-4342 RGBLCD 模块 ， 分 辨 率 : 480*272 
0 0 1 7084 | ATK-7084 RGBLCD 模块 ， 分 辨 率 : 800*480 
0 1 0 7016 | ATK-7016, RGBLCD 模块 ， 分 辨 率 : 1024*600 
0 1 1 7018 | ATK-7018, RGBLCD 模块 ， 分 状 率 :1280*800 
X X X NC 暂时 未 用 到 
表 24.1.1.2 ALIENTEK RGBLCD 模块 ID 对 应 关系 
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ATK-7016 模块 , 就 设置 M2:M0=010 即 可 。 这样 , 我 们 在 程序 里 面 , 读 取 LCD_R7/G7/B7， 
得 到 M0:M2 的 值 ， 从 而 判断 RGBLCD 模块 的 型 号 , 并 执行 不 同 的 配置 ， 即 可 实现 不 同 LCD 模 
块 的 兼容 。 
4、LCD 时 间 参 数 
如 果 将 LCD 显示 一 帧 图 像 的 过 程 想象 成 绘画 ， 那么 在 显示 的 过 程 中 就 是 用 一 根 “ 笔 ”在 不 
同 的 像素 点 画 上 不 同 的 颜色 。 这 根 笔 按 照 从 左 至 右 、 从 上 到 下 的 顺序 扫描 每 个 像素 点 ， 并 且 在 
像素 画 上 对 应 的 颜色 ， 当 画 到 最 后 一 个 像素 点 的 时 候 一 幅 图 像 就 绘制 好 了 。 假如 一 个 LCD 的 分 
辩 率 为 1024*600， 那 么 其 扫描 如 图 24.1.1.5 所 示 : 
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LCD 有 效 显 示 区 域 
1024 X 600 分 辨 率 




















图 24.1.1.5 LCD 一 帧 图 像 扫 描 图 

结合 图 24.1.1.4 我 们 来 看 一 下 LCD 是 怎么 扫描 显示 一 帧 图 像 的 。 一 帧 图 像 也 是 由 一 行 一 行 
组 成 的 。 HSYNC 是 水 平 同步 信号 ， 也 叫做 行 同步 信 号 ， 当 产生 此 信和 号 的 话 就 表示 开始 显示 新 的 
一 行 了 ， 所 以 此 信号 都 是 在 图 24.1.1.5 的 最 左边 。 当 VSYNC 信和 号 是 垂直 同步 信号 ， 也 叫做 帧 
同步 信号 ， 当 产生 此 信号 的 话 就 表示 开始 显示 新 的 一 帧 图 像 了 ， 所 以 此 信号 在 图 24.1.1.4 的 左 
Ef. 
在 图 24.1.1.5 可 以 看 到 有 一 圈 “ 黑 边 ” 真正 有 效 的 显示 区 域 是 中 间 的 白色 部 分 。 那 这 一 圈 
“ 黑 边 ”是 什么 东西 呢 ? 这 就 要 从 显示 器 的 “祖先 ”CRT 显示 器 开始 说 起 了 ，CRT 显示 器 就 是 
以 前 很 常见 的 那 种 大 屁股 显示 器 ， 在 2019 年 应 该 很 少见 了 ， 如 果 在 农村 应 该 还 是 可 以 见 到 的 。 
CRT 显示 器 屁股 后 面 是 个 电子 枪 , 这 个 电子 枪 就 是 我 们 上 面 说 的 “画笔 ”电子 枪 打出 的 电子 撞 
击 到 屏幕 上 的 痰 光 物 质 使 其 发 光 。 只 要 控制 电子 枪 从 左 到 右 扫 打 万 一 行 (也 就 是 扫描 一 行 )， 然 
后 从 上 到 下 扫描 完 所 有 行 ， 这 样 一 帧 图 像 就 显示 出 来 了 。 也 就 是 说 ， 显 示 一 帧 图 像 电子 枪 是 按 
照 “Z” 形 在 运动 ， 当 扫描 速度 很 快 的 时 候 看 起 来 就 是 一 幅 完成 的 画面 了 。 

当 显 示 完 一 行 以 后 会 发 出 HSYNC 信号 ， 此 时 电子 枪 就 会 关闭 ， 然 后 迅速 的 移动 到 屏幕 的 
左边 ， 当 HSYNC 信号 结束 以 后 就 可 以 显示 新 的 一 行 数据 了 ， 电 子 枪 就 会 重新 打开 。 在 HSYNC 
信号 结束 到 电子 枪 重新 打开 之 间 会 插入 一 段 延 时 ， 这 上 段 延 时 就 图 24.1.1.5 中 的 HBP。 当 显示 完 
一 行 以 后 就 会 关闭 电子 枪 等 待 HSYNC 信号 产生 ， 关 闭 电 子 枪 到 HSYNC 信号 产生 之 间 会 插入 
一 段 延 时 ， 这 段 延 时 就 是 图 24.1.1.5 中 的 HFP 信号 。 同 理 ， 当 显示 完 一 帧 图 像 以 后 电子 枪 也 会 
关闭 ,然后 等 到 VSYNC 信号 产生 , 期 间 也 会 加 入 一 段 延 时 , 这 段 延 时 就 是 图 24.1.1.5 中 的 VFP. 
VSYNC 信号 产生 ， 电 子 枪 移动 到 左上 角 ， 当 VSYNC 信号 结束 以 后 电子 枪 重新 打开 ， 中间 也 会 
加 入 一 段 延 时 ， 这 段 延 时 就 是 图 24.1.1.5 中 的 VBP. 
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HBP, HFP, VBP 和 VFP 就 是 导致 图 24.1.1.5 中 黑 边 的 原因 , 但 是 这 是 CRT 显示 器 存在 黑 
边 的 原因 , 现在 是 LCD 显示 器 , 不 需要 电子 枪 了 , 那么 为 何 还 会 有 黑 边 呢 ? 这 是 因为 RGB LCD 
屏幕 内 部 是 有 一 个 IC 的 ， 发 送 一 行 或 者 一 帧 数据 给 IC，IC 是 需要 反应 时 间 的 。 通 过 这 段 反 应 
时 间 可 以 让 IC 识别 到 一 行 数 据 扫 描 完 了 ， 要 换行 了 ， 或 者 一 帧 图 像 扫 描 完 了 ， 要 开始 下 一 帧 图 
像 显 示 了 。 因 此 ， 在 LCD 屏幕 中 继续 存在 HBP、HFP、VPB 和 VFP 这 四 个 参数 的 主要 目的 是 
为 了 锁定 有 效 的 像素 数据 。 这 四 个 时 间 是 LCD 重要 的 时 间 参 数 ， 后 面 编 写 LCD 驱动 的 时 候 要 
用 到 的 ， 至 于 这 四 个 时 间 参 数 具 体 值 是 多 少 ， 那 要 需要 去 查看 所 使 用 的 LCD 数据 手册 了 。 

5. RGBLCD 屏幕 时 序 


上 上 面 讲 了 行 显示 和 帧 显示 ， 我 们 来 看 一 下 行 显示 对 应 的 时 序 图 ， 如 图 24.1.1.6 所 示 : 
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有 效 的 像素 数据 
图 24.1.1.6 行 显 示 时 序 
图 24.1.1.6 就 是 RGB LCD 的 行 显示 时 序 ， 我 们 来 分 析 一 下 其 中 重要 的 几 个 参数 : 
HSYNC: 行 同步 信号 ， 当 此 信号 有 效 的 话 就 表示 开始 显示 新 的 一 行 数据 ， 查 阅 所 使 用 的 
LCD 数据 手册 可 以 知道 此 信号 是 低 电 平 有 效 还 是 高 电 平 有 效 ， 假 设 此 时 是 低 电 平 有 效 。 
HSPW: 有 些 地 方 也 叫做 thp, 是 HSYNC 信号 宽度 , 也 就 是 HSYNC 信号 持续 时 间 。HSYNC 
信号 不 是 一 个 脉冲 ， 而 是 需要 持续 一 段 时 间 才 是 有 效 的 ， 单 位 为 CLK。 
HBP: 有 些 地 方 叫做 thb， 前 面 已 经 讲 过 了 ， 术 语 叫 做 行 同步 信号 后 肩 ， 单 位 是 CLK. 
HOZVAL: 有 些 地 方 叫做 thd， 显 示 一 行 数据 所 需 的 时 间 ， 假 如 屏幕 分 辩 率 为 1024*600， 
那么 HOZVAL 就 是 1024， 单 位 为 CLK。 
HFP: 有 些 地 方 叫 做 thf， 前 面 已 经 讲 过 了 ， 术 语 叫 做 行 同步 信号 前 肩 ， 单 位 是 CLK。 
当 HSYNC 信和 号 发 出 以 后 ， 需 要 等 待 HSPW+HBP 个 CLK 时 间 才 会 接收 到 真正 有 效 的 像素 
数据 。 当 显示 完 一 行 数据 以 后 需要 等 待 HFP 个 CLK 时 间 才 能 发 出 下 一 个 HSYNC 信和 号， 所 以 
显示 一 行 所 需要 的 时 间 就 是 : HSPW + HBP + HOZVAL + HFP。 
一 帧 图 像 就 是 由 很 多 个 行 组 成 的 ，RGB LCD 的 帧 显示 时 序 如 图 24.1.1.7 所 示 : 
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图 24.1.1.7 帧 显示 时 序 图 
图 24.1.1.7 就 是 RGB LCD 的 帧 显示 时 序 ， 我 们 来 分 析 一 下 其 中 重要 的 几 个 参数 : 
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VSYNC: 帧 同步 信号 ， 当 此 信号 有 效 的 话 就 表示 开始 显示 新 的 一 帧 数据 ， 查 阅 所 使 用 的 












































LCD 数据 手册 可 以 知道 此 信号 是 低 电 平 有 效 还 是 高 电 平 有 效 ， 假 设 此 时 是 低 电 平 有 效 。 

VSPW: 些 地 方 也 叫做 typ， 是 VSYNC 信和 号 宽度 ， 也 就 是 VSYNC 信和 号 持续 时 间 ， 单 位 为 
1 行 的 时 间 。 

VBP: 有 些 地 方 叫做 tvb， 前 面 已 经 讲 过 了 ， 术 语 叫 做 帧 同步 信号 后 肩 ， 单 位 为 1 行 的 时 
间 。 

LINE: 有 些 地 方 叫 做 tvd， 显 示 一 帧 有 效 数 据 所 需 的 时 间 ， 假 如 屏幕 分 辨 率 为 1024*600， 
那么 LINE 就 是 600 行 的 时 间 。 

VFP: 有 些 地 方 叫做 tvf, 前 面 已 经 讲 过 了 , 术语 叫做 帧 同步 信号 前 肩 , 单位 为 1 行 的 时 间 。 

显示 一 帧 所 需要 的 时 间 就 是 ， VSPW-VBP-LINE-VFP 个 行 时 间 ， 最 终 的 计算 公式 : 

T = (VSPW+VBP+LINE+VFP) * (HSPW + HBP + HOZVAL + HFP) 
因此 我 们 在 配置 一 球 RGB LCD 的 时 候 需 要 知道 这 几 个 参数 : HOZVAL( 屏 幕 有 效 宽度 )、 


LINE( 屏 幕 有 效 高 度 )、HBP、HSPW、HFP、VSPW、VBP 和 VFP。ALIENTEK 三 款 RGB LCD 
屏幕 的 参数 如 表 24.1.1.3 所 示 : 








































































































水 平 显 示 区 域 480 tCLK 
















































































HSPW(thp) 1 tCLK 
HBP(thb) 40 tCLK 
HFP(thf) 5 tCLK 
ATK4342 垂直 显示 区 域 272 th 
VSPW(tvp) 1 也 
VBP(tvb) 8 th 
VFP(tvf) 8 th 
像素 时 钟 9 MHz 
水 平 显示 区 域 800 tCLK 
HSPW(thp) 48 tCLK 
HBP(thb) 88 tCLK 
HFP(thf) 40 tCLK 
ATK4384 垂直 显示 区 域 480 也 
VSPW(tvp) 3 th 
VBP(tvb) 32 th 
VFP(tvf) 13 th 
像素 时 钟 31 MHz 
水 平 显示 区 域 800 tCLK 
HSPW(thp) 1 tCLK 
HBP(thb) 46 tCLK 
HFP(thf) 210 tCLK 
ATK7084 垂直 显示 区 域 480 也 
VSPW(tvp) 1 th 
VBP(tvb) 23 th 
VFP(tvf) 22 th 
像素 时 钟 33.3 MHz 
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水 平 显示 区 域 1024 tCLK 
HSPW(thp) 20 tCLK 
HBP(thb) 140 tCLK 
HFP(thf) 160 tCLK 
ATK7016 垂直 显示 区 域 600 th 
VSPW(tvp) 3 th 
VBP(tvb) 20 th 
VEP(tvf) 12 th 
像素 时 钟 51.2 MHz 




















表 24.1.1.3 RGB LCD 屏幕 时 间 参 数 


6、 像 素 时 钟 
像素 时 钟 就 是 RGB LCD 的 时 钟 信 号 ， 以 ATK7016 这 款 屏 幕 为 例 ， 显 示 一 帧 图 像 所 需要 的 
时 钟 数 就 是 : 
= (VSPW-VBP-LINE-VFP) * (HSPW + HBP + HOZVAL + HFP) 
=(3+20+600+12)*(20+ 140+1024+160) 
— 635 * 1344 
= 853440. 
显示 一 帧 图 像 需 要 853440 个 时 钟 数 ,那么 显示 60 帧 就 是 :853440 * 60 = 51206400751.2M, 
所 以 像素 时 钟 就 是 51.2MHz。 
LMX6U 的 eLCDIF 接口 时 钟 图 如 图 24.1.1.8 所 示 : 
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图 24.1.1.8 LCDIF 接口 时 钟 图 
Q@、 此 部 分 是 一 个 选择 器 ， 用 于 选择 哪个 PLL 可 以 作为 LCDIF 时 钟 源 ， 由 寄存 器 
CCM CSCDR2 的 位 LCDIF1 PRE CLK _SEL(bit17:15) 来 决定 , LCDIF1 PRE CLK SEL 选择 设 
置 如 表 24.1.1.4 所 示 : 












PLL2 作为 LCDIF 的 时 钟 源 。 





PLL3_PFD3 作为 LCDIF 的 时 钟 源 。 
PLLS5 作为 LCDIF 的 时 钟 源 。 
PLL2 PFDO 作为 LCDIF 的 时 钟 源 。 
PLL2 PFDI 作为 LCDIF 的 时 钟 源 。 
PLL3 PFDI 作为 LCDIF 的 时 钟 源 。 
K 24.1.1.4 LCDIF 时 钟 源 选 择 

在 第 16 章 讲解 LMX6U 时 钟 系统 的 时 候 说 过 有 个 专用 的 PLL5 给 VIDEO 使 用 ， 所 以 
LCDIF1 PRE CLK SEL 设置 为 2。 

多、 此 部 分 是 LCDIF 时 钟 的 预 分 频 器 ,由 寄存 器 CCM_CSCDR2 的 位 LCDIF1_PRED 来 决 
定 预 分 频 值 。 可 设置 值 为 0~7， 分 别 对 应 1~8 分 频 。 
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图 、 此 部 分 进一步 分 频 ， 由 寄存 器 CBCMR 的 位 LCDIFI. PODF 来 决定 分 频 值 。 可 设置 值 
为 0~7， 分 别 对 应 1-8 分 频 。 

@@、 此 部 分 是 一 个 选择 器 ， 选 择 LCDIF 最 终 的 根 时 钟 ， 由 寄存 器 CSCDR2 的 位 
LCDIFI CLK SEL XE, LCDIFI CLK SEL 选择 设置 如 表 24.1.1.5 所 示 : 








前 面 复 用 器 出 来 的 时 钟 ， 也 就 是 前 面 PLLS 出 来 的 时 钟 作 
为 LCDIF 的 根 时 钟 。 
ipp diO clk 作为 LCDIF 的 根 时 钟 。 
ipp_dil_clk 作为 LCDIF 的 根 时 钟 。 
ldb diO clk 作为 LCDIF 的 根 时 钟 。 
ldb_dil_clk 作为 LCDIF 的 根 时 钟 。 

表 24.1.1.4 LCDIF 根 时 钟 选择 

这 里 肯定 选择 PLLS 出 来 的 那 一 路 时 钟 作为 LCDIF 的 根 时 钟 ， 因 此 LCDIF1_CLK_SEL ix 
置 为 0。LCDIF 既然 选择 了 PLLS 作为 时 钟 源 ， 那 么 还 需要 初始 化 PLL5，LCDIF 的 时 钟 是 由 
PLLS 和 图 24.1.1.8 中 的 @@、@ 这 两 个 分 频 值 决定 的 ， 所 以 需要 对 这 三 个 进行 合理 的 设置 以 搭配 
出 所 需 的 时 钟 值 ， 我 们 就 以 ATK7016 屏幕 所 需 的 51.2MHz 为 例 ， 看 看 如 何 进行 配置 。 

PLLS 频率 设置 涉及 到 四 个 寄存 器 : CCM PLL VIDEO CCM PLL VIDEO NUM., 
CCM PLL VIDEO DENOM 、 CCM MISC2 。 其 中 CCM PLL VIDEO NUM 和 
CCM PLL VIDEO DENOM 这 两 个 寄存 器 是 用 于 小 数 分 频 的 ， 我 们 这 里 为 了 简单 不 使 用 小 数 
分 频 ， 因 此 这 两 个 寄存 器 设置 为 0。 
PLLS 的 时 钟 计算 公式 如 下 : 

PLLS CLK = OSC24M * (loopDivider + (denominator / numerator)) / postDivider 
不 使 用 小 数 分 频 的 话 PLL5 时 钟 计算 公式 就 可 以 简化 为 : 
PLLS CLK = OSC24M * loopDivider / postDivider 

OSC24M 就 是 24MHz 的 有 源 晶 振 ， 现 在 的 问题 就 是 设置 loopDivider 和 postDivider。 先 来 

看 一 下 寄存 器 CCM_PLL VIDEO， 此 寄存 器 结构 如 图 24.1.1.9 所 示 : 
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24.1.1.9 寄存 器 CCM PLL VIDEO 结构 
寄存 器 CCM PLL VIDEO 用 到 的 重要 的 位 如 下 : 
POST_DIV_SLECT(bit20:19): 此 位 和 寄存 器 CCM_ANALOG CCMSC2 的 VIDEO_DIV 位 
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共同 决定 了 postDivider， 为 0 的 话 是 4 分 频 ， 为 1 的 话 是 2 分 频 ， 为 2 的 话 是 1 分 频 。 本 章 设 
置 为 2， 也 就 是 1 分 频 。 
ENABLE(bit13):; PLLS(PLL VIDEO) 使 能 为 ， 为 1 的 话 使 能 PLL5， 为 0 的 话 关 闭 PLLS. 
DIV SELECT(bit6:0): loopDivider 值 ， 范 围 为 27~5$4， 本 章 设置 为 32。 
寄存 器 CCM _ ANALOG MISC2 的 位 VIDEO_DIV(bit31:30) 与 寄存 器 CCM PLL VIDEO 的 位 






































POST_DIV_SLECT(bit20:19) 共 同 决定 了 postDivider， 通 过 这 两 个 的 配合 可 以 获得 2、4、8、16 
分 频 。 本 章 将 VIDEO_DIV 设置 为 0， 也 就 是 1 分 频 ， 因 此 postDivider 就 是 1, loopDivider 设 
置 为 32，PLL5 的 时 钟 频率 就 是 : 
PLLS CLK = OSC24M * loopDivider / postDivider 
-24M *32/1 
= 768MHz. 

PLLS 此 时 为 768MHz， 在 经 过 图 24.1.1.8 中 的 @@ 和 @ 进 一 步 分 频 ， 设 置 包 中 为 3 分 频 ， 也 
就 是 寄存 器 CCM_CSCDR2 的 位 LCDIF1 PRED(bit14:12)7 2. 设置 @ 中 为 5 分 频 , 就 是 寄存 器 
CCM CBCMR 的 位 LCDIF1 PODF(bit25:23) 为 4。 设置 好 以 后 最 终 进入 到 LCDIF 的 时 钟 频率 就 
是 : 768/3/5 =51.2MHz， 这 就 是 我 们 需要 的 像素 时 钟 频率 。 

7、 显 存 

在 讲 像素 格式 的 时 候 就 已 经 说 过 了 ， 如果 采 用 ARGB8888 格式 的 话 一 个 像素 需要 4 个 字 节 
的 内 存 来 存放 像素 数据 , 那么 1024*600 分 辨 率 就 需要 1024*600*4=2457600B 守 2.4MB 内 存 。 但 
是 RGB LCD 内 部 是 没有 内 存 的 ， 所 以 就 需要 在 开发 板 上 的 DDR3 中 分 出 一 段 内 存 作 为 RGB 
LCD 屏幕 的 显存 ， 我 们 如 果 要 在 屏幕 上 显示 什么 图 像 的 话 直接 操作 这 部 分 显存 即 可 。 

















































































































24.1.2 eLCDIF 接口 








eLCDIF 是 LMX6U 自 带 的 液晶 屏幕 接口 ， 用 于 连接 RGB LCD 接口 的 屏幕 ，eLCDIF 接口 
特性 如 下 : 

Q@、 支 持 RGB LCD 的 DE 模式 。 

@、 支 持 VSYNC 模式 以 实现 高 速 数 据 传输 。 

©, Z ITU-R BT.656 格式 的 4:2:2 的 YCbCr 数字 视频 ， 并 且 将 其 转换 为 模拟 TV 信号 。 

D, ZF 8/16/18/24/32 位 LCD. 

eLCDIF 支持 三 种 接口 : MPU 接口 .VSYNC 接口 和 DOTCLK 接口 , 这 三 种 接口 区 别 如 下 : 

1. MPU 接口 

MPU 接口 用 于 在 LMX6U 和 LCD 屏幕 直接 传输 数据 和 命令 ， 这 个 接口 用 于 6080/8080 接 
口 的 LCD 屏幕 ， 比 如 我 们 学 习 STM32 的 时 候 常 用 到 的 MCU 屏幕 。 如 果 寄 存 器 LCDIF_CTRL 
的 位 DOTCLK MODE, DVI MODE 和 VSYNC MODE 都 为 0 的 话 就 表示 LCDIF 工作 在 MPU 
接口 模式 。 关 于 MPU 接口 的 详细 信息 以 及 时 序 参考 4LMX6ULL 参考 手册 》 第 2150 页 的 “34.4.6 
MPU Interface” 小 节 ， 本 教程 不 使 用 MPU 接口 。 

2、VSYNC 接口 

VSYNC 接口 时 序 和 MPU 接口 时 序 基 本 一 样 ， 只 是 多 了 VSYNC 信号 来 作为 帧 同步 ， 当 
LCDIF CTRL 的 位 VSYNC MODE 为 1 的 时 候 此 接口 使 能 .关于 VSYNC 接口 的 详细 信息 请 参 
考 《I.MX6ULL 参考 手册 》 第 2152 页 的 “34.4.7VSYNC Interface” 小 节 ， 本 教程 不 使 用 VSYNC 
接口 。 


3. DOTCLK 接口 
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DOTCLK 接口 就 是 用 来 连接 RGB LCD 接口 屏幕 的 ， 它 包括 VSYNC、HSYNC、DOTCLK 
和 ENABLE( 可 选 的 ) 这 四 个 信号 ， 这 样 的 接口 通常 被 成 为 RGB 接口 。 DOTCLK 接口 时 序 如 图 


24.1.2.1 所 示 : 


One Frame (VSYNC) Period 


Vertical Back Porch Vertical Front Porch 
> i 





VSYNC 


VSYNCE Pulse Width 


em Fu 





AVertical Valid Data TR 


RIRIBIRIE RINT 





VSYNC POL =0 
HSYNC POL -0 
DOTCLK POL -0 
ENABLE POL = 0 





< » 
Horizontal Valid Data Count 


图 24.1.2.1 DOTCLK 接口 时 序 
24.1.2.1 是 不 是 和 图 24.1.1.6、 图 24.1.1.7 很 类 似 ， 因 为 DOTCLK 接口 就 是 连接 RGB Bf 
幕 的 ， 本 教程 使 用 的 就 是 DOTCLK 接口 。 
eLCDIF 要 驱动 起 来 RGB LCD 屏幕 ， 重 点 是 配置 好 上 一 小 节 讲解 的 那些 时 间 参 数 即 可 ， 这 
个 通过 配置 相应 的 寄存 器 就 可 以 了 , 所 以 我 们 接 下 来 看 一 下 eLCDIF 接口 的 几 个 重要 的 寄存 器 ， 
首先 看 一 下 LCDIF_CTRL 寄存 器 ， 此 寄存 器 结构 如 图 24.1.2.1 所 示 : 
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图 24.1.2.1 寄存 器 LCDIF. CTRL 结构 

寄存 器 LCDIF CTRL 用 到 的 重要 位 如 下 : 

SFTRST(bit31): eLCDIF 软 复位 控制 位 ， 当 此 位 为 1 的 话 就 会 强制 复位 LCD. 

CLKGATE(bit30): 正常 运行 模式 下 ， 此 位 必须 为 0! 如 果 此 位 为 1 的 话 时 钟 就 不 会 进入 到 
LCDIF. 

BYPASS COUNT(bit19): 如 果 要 工作 在 DOTCLK 模式 的 话 就 此 位 必须 为 1。 

VSYNC_MODE(bit18): 此 位 为 1 的 话 LCDIF 工作 在 VSYNC 接口 模式 。 

DOTCLK MODE(bit17): 此 位 为 1 的 话 LCDIF 工作 在 DOTCLK 接口 模式 。 

INPUT DATA SWIZZLE(bit15:14): 输入 数据 字 节 交换 设置 , 此 位 为 0 的 话 不 交换 字 节 也 
就 是 小 端 模式 ， 为 1 的 话 交 换 所 有 字 节 ， 也 就 是 大 端 模 式 ; 为 2 的 话 半 字 交 换 ， 为 3 的 话 在 每 
个 半 字 内 进行 字 节 交换 。 本 章 我 们 设置 为 0， 也 就 是 不 使 用 字 节 交换 。 

CSC DATA SWIZZLE(bit13:12) : CSC 数据 字 节 交换 设置 ， 交 换 方 式 和 
INPUT DATA SWIZZLE 一 样 ， 本 章 设置 为 0， 不 使 用 字 节 交换 。 
LCD DATABUS WIDTH(bit11:10): LCD 数据 总 线 宽度 ， 为 0 的 话 总 线 宽 度 为 16 位 ; 为 
1 的 话 总 线 宽度 为 8 位 ; 为 2 的 话 总 线 宽度 为 18 位 ; 为 3 的 话 总 线 宽度 为 24 位 。 本 章 我 们 使 
用 24 位 总 线 宽度 。 

WORD LENGTH(bit9:8): 输入 的 数据 格式 ， 也 就 是 像素 数据 宽度 ， 为 0 的 话 每 个 像素 16 
位 ; 为 1 的 话 每 个 像素 8 位 ; 为 2 的 话 每 个 像素 18 位 ; 为 3 的 话 每 个 像素 24 位 。 

MASTER(bitS): 为 1 的 话 设 置 eLCDIF 工作 在 主 模式 。 

DATA FORMAT 16 BIT(bit3): 当 此 位 为 1 并 且 WORD LENGTH 为 0 的 时 候 像素 格式 
为 ARGB555， 当 此 位 为 0 并 且 WORD LENGTH 为 0 的 时 候 像素 格式 为 RGB565。 

DATA FORMAT 18 BIT(bit2): 只 有 当 WORD LENGTH 为 2 的 时 候 此 位 才 有 效 ， 此 位 
为 0 的 话 低 18 位 有 效 ， 像 素 格 为 RGB666， 高 14 位 数据 无 效 。 当 此 位 为 1 的 话 高 18 位 有 效 ， 
像素 格式 依旧 是 RGB666， 但 是 低 14 位 数据 无 效 。 

DATA FORMAT 24 BIT(bit1): 只 有 当 WORD LENGTH 为 3 的 时 候 此 位 才 有 效 , 为 0 的 
时 候 表示 全 部 的 24 位 数据 都 有 效 。 为 1 的 话 实 际 输入 的 数据 有 效 位 只 有 18 位 ， 虽 然 输入 的 是 
24 位 数据 ， 但 是 每 个 颜色 通道 的 高 2 位 数据 会 被 丢弃 掉 。 
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RUN(bit0): eLCDIF 接口 运行 控制 位 ， 当 此 位 为 1 的 话 eLCDIF 接口 就 开始 传输 数据 ， 也 
就 是 eLCDIF 的 使 能 位 。 

接 下 来 看 一 下 寄存 器 LCDIF CTRLI ， 此 寄存 器 我 们 只 用 到 位 
BYTE PACKING FORMAT(bit19:16), 此 位 用 来 决定 在 32 位 的 数据 中 哪些 字 节 的 数据 有 效 ， 默 
认 值 为 0XF， 也 就 是 所 有 的 字 节 有 效 ， 当 为 0 的 话 表 示 所 有 的 字 节 都 无 效 。 如 果 显 示 的 数据 是 
24 位 (ARGB 格式 ， 但 是 A 通道 不 传输 ) 的 话 就 设置 此 位 为 0X7。 

接 下 来 看 一 下 寄存 器 LCDIF TRANSFER COUNT， 这 个 寄存 器 用 来 设置 所 连接 的 RGB 
LCD 屏幕 分 辨 紊 大 小 ， 此 寄存 器 结构 如 图 24.1.2.2 所 示 : 

Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16|15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
sl V. COUNT | H COUNT | 
Rs(0000000000000001|0000000000000000 
24.1[2.2 寄存 器 LCDIF TRANSFER. COUNT 结构 

寄存 器 LCDIF_ TRANSFER. COUNT 分 为 两 部 分 ,高 16 位 和 低 16 位 ,高 16 位 是 V_COUNT， 
是 LCD 的 垂直 分 辨 率 。 低 16 位 是 H_ COUNT， 是 LCD 的 水 平分 辨 率 。 如 果 LCD 分 辨 率 为 
1024*600 的 话 ， 那 么 V_COUNT 就 是 600， 也 COUNT 就 是 1024。 

接 下 来 看 一 下 寄存 器 LCDIF VDCTRL0， 这 个 寄存 器 是 VSYNC 和 DOTCLK 模式 控制 寄 
存 器 0， 寄存 器 结构 如 图 24.1.2.3 所 示 : 
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图 24.1.2.3 寄存 器 LCDIF VDCTRLO 结构 

寄存 器 LCDIF VDCTRLO 用 到 的 重要 位 如 下 : 

VSYNC_OEB(bit29): VSYNC 信号 方向 控制 位 ， 为 0 的 话 VSYNC 是 输出 ， 为 1 的 话 
VSYNC 是 输入 。 

ENABLE PRESENT(bit28): EBABLE 数据 线 使 能 位 ， 也 就 是 DE 数据 线 。 为 1 的 话 使 能 
ENABLE 数据 线 ， 为 0 的 话 关 闭 ENABLE 数据 线 。 

VSYNC POL(bit27): VSYNC 数据 线 极 性 设置 位 ,为 0 的 话 VSYNC 低 电 平 有 效 , 为 1 的 
话 VSYNC 高 电 平 有 效 ， 要 根据 所 使 用 的 LCD 数据 手册 来 设置 。 

HSYNC_POL(bit26): HSYNC 数据 线 极 性 设置 位 ,为 0 的 话 HSYNC 低 电 平 有 效 , 为 1 的 
话 HSYNC 高 电 平 有 效 ， 要 根据 所 使 用 的 LCD 数据 手册 来 设置 。 

DOTCLK_POL(bit25): DOTCLK 数据 线 (像素 时 钟 线 CLK) 极 性 设置 位 , 为 0 的 话 下 降 沿 
锁 存 数据 ， 上 升 沿 捕 获 数据 ， 为 1 的 话 相反 ， 要 根据 所 使 用 的 LCD 数据 手册 来 设置 。 

ENABLE POL(bit24); EANBLE 数据 线 极 性 设置 位 ， 为 0 的 话 低 电 平 有 效 ， 为 1 的 话 高 
电 平 有 效 。 

VSYNC PERIOD UNIT(bit21): VSYNC 信号 周期 单位 ,为 0 的 话 VSYNC 周期 单位 为 像 
素 时 钟 。 为 1 的 话 VSYNC 周期 单位 是 水 平行 ， 如 果 使 用 DOTCLK 模式 话 就 要 设置 为 1。 
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VSYNC PULSE WIDTH UNIT(bit20) : VSYNC 信号 脉冲 宽度 单位 ， 和 
VSYNC PERIOD UNUT 一 样 ， 如 果 使 用 DOTCLK 模式 的 话 要 设置 为 1。 

VSYNC PULSE WIDTH(bit17:0): VSPW 参数 设置 位 。 

接 下 来 看 一 下 寄存 器 LCDIF VDCTRL1， 这 个 寄存 器 是 VSYNC 和 DOTCLK 模式 控制 寄 














存 器 1, 此 寄存 器 只 有 一 个 功能 ,用 来 设置 VSYNC 总 周期 ,就 是 : 屏幕 高 度 +-VSPW+VBP+VFP。 
接 下 来 看 一 下 寄存 器 LCDIF_VDCTRL2, 这 个 寄存 器 分 为 高 16 位 和 低 16 位 两 部 分 , 高 16 
位 是 HSYNC PULSE WIDTH， 用 来 设置 HSYNC 信号 宽度 ， 也 就 是 HSPW。 低 16 位 是 
HSYNC_PERIOD， 设 置 HSYNC 总 周期 ， 就 是 : 屏幕 宽度 HHSPW+HBP+HFP。 
接 下 来 看 一 下 寄存 器 LCDIF VDCTRL3， 此 寄存 器 结构 如 图 24.1.2.4 所 示 ; 
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图 24.1.24 寄存 器 LCDIF VDCTRL3 结构 
寄存 器 LCDIF VDCTRL3 用 到 的 重要 位 如 下 : 
HORIZONTAL WAIT CNT(bit27:16): 此 位 用 于 DOTCLK 模式 ， 用 于 设置 HSYNC 信号 
产生 到 有 效 数据 产生 之 间 的 时 间 ， 也 就 是 HSPW+HBP。 
VERTICAL WAIR _CNT(bit15:0): 和 HORIZONTAL WAIT CNT 一 样 ， 只 是 此 位 用 于 
VSYNC 信号 ， 也 就 是 VSPW+VBP。 
接 下 来 看 一 下 寄存 器 LCDIF VDCTRL4， 此 寄存 器 结构 如 图 24.1.2.5 所 示 : 
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|! DOTCLK H. 
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DATA CNT 


DOTCLK H VALID DATA CNT 








0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
图 24.1.2.5 寄存 器 LCDIF VDCTRLA 结构 
寄存 器 LCDIF VDCTRLA 用 到 的 重要 位 如 下 : 
SYNC_SIGNALS_ON(bit18): 同步 信号 使 能 位 ， 设 置 为 1 的 话 使 能 VSYNC、HSYNC、 
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DOTCLK 这 些 信 和 号。 
DOTCLK H VALID DATA CNT(bit15:0); 设置 LCD 的 宽度 ， 也 就 是 水 平 像素 数量 。 
最 后 在 看 一 下 寄存 器 LCDIF CUR. BUF 和 LCDIF NEXT. BUF， 这 两 个 寄存 器 分 别 为 当前 

















帧 和 下 一 帧 缓冲 区 , 也 就 是 LCD 显存 。 一 般 这 两 个 寄存 器 保存 同一 个 地 址 , 也 就 是 划分 给 LCD 
的 显存 首 地 址 。 

XT eLCDIF 接口 的 寄存 器 就 介绍 到 这 里 , 关于 这 些 寄存 器 详细 的 描述 ,请 参考 4IMX6ULL 
参考 手册 》 第 2165 页 的 34.6 小 节 。 本 章 我 们 使 用 I.MX6U 的 eLCDIF 接口 来 驱动 ALIENTEK 
的 ATK7016 这 款 屏幕 ， 配 置 步骤 如 下 : 

1、 初 始 化 LCD 所 使 用 的 IO 
首先 肯定 是 初始 化 LCD 所 示 使 用 的 IO， 将 其 复 用 为 eaLCDIF 接口 IO。 

2、 设 置 LCD 的 像素 时 钟 

查阅 所 使 用 的 LCD 屏幕 数据 手册 ， 或 者 自己 计算 出 的 时 钟 像素 ， 然 后 设置 CCM 相应 的 寄 
存 器 。 

3、 配 置 eLCDIF 接口 

设置 LCDIF 的 寄存 器 CTRL, CTRLI, TRANSFER COUNT, VDCTRLO~4, CUR_BUF 和 
NEXT_BUF。 根 据 LCD 的 数据 手册 设置 相应 的 参数 。 


4、 编 写 API 函数 


驱动 LCD 屏幕 的 目的 就 是 显示 内 容 ， 所 以 需要 编写 一 些 基 本 的 API 函数 ， 比 如 画 点 、 夯 
线 、 画 圆 函 数 ， 字 符 串 显示 函数 等 。 


24.2 硬件 原理 分 析 


本 试验 用 到 的 资源 如 下 : 
QD、 指 示人 灯 LEDO. 
©, RGB LCD 接口 。 
(3. DDR3 

QD. eLCDIF 

RGB LCD 接口 在 LMX6U-ALPHA 开发 板 底板 上 ， 原 理 图 如 图 24.2.1 所 示 : 
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LCD DATA20 LCD R4 EN 36 DC2 SDA 

LCD DATA21 LCD R5 | 3. [35CT RST Rl4 10K 


LCD DATA22 LCD R6 S D [G4BLT PWM 二 一 10K 
LCD DATA23S LCD R7 EE 33 LCD DE 一 
| VSYNC 
LCD DATAS LCD GO Een HSYNC GND 
LCD DATA9 LCD GI E | PCLK E 
LCD DATAIO LCD G2 dee 
LCD DATAI! LCD G3 d B7 LCD DATA7S 
LCD DATAI2 LCD G4 A B6 LCD DATAG 
LCD DATAI3 LCD G5 JA B5 LCD DATAS 
LCD DATAI4 LCD G6 Sd B4 LCD DATA4 
LCD DATAISS LCD G7 4 B3 LCD DATA3 
Gp En B2 LCD DATA2 
LCD DATAO LCD B0 21 | ^ BI LCD DATAI 


RGBLCD 
24.2.1RGB LCD 接口 原理 图 
24.2.1 中 三 个 SGM3157 的 目的 是 在 未 使 用 RGBLCD 的 时 候 将 LCD_DATA7、 
LCD DATAIS 和 LCD_DATA23 这 三 个 线 隔 离开 来 , 因为 ALIENTEK 的 屏幕 的 LCD_R7/G7/B7 
着 几 个 线 用 来 设置 LCD 的 ID， 所 以 这 几 根 线 上 有 上 拉 / 下 拉 电 阻 。 但 是 LIMX6U 的 BOOT 设置 
也 用 到 了 LCD DATA7. LCD DATAI5 和 LCD DATA23 这 三 个 引 脚 ， 所 以 接 上 屏幕 以 后 屏幕 
上 的 ID 电阻 就 会 影响 到 BOOT 设置 ， 会 导致 代码 无 法 运行 ， 所 以 先 将 其 隔离 开 来 ， 如 果 要 使 
H RGB LCD 屏幕 的 时 候 再 通过 LCD _DE 将 其 “连接 ”起 来 ,我 们 需要 40P 的 FPC 线 将 ATK7016 
屏幕 和 IMX6U-ALPHA 开发 板 连接 起 来 ， 如 图 24.2.2.2 所 示 : 









GND 咱 
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| | 
24.2.2 屏幕 和 开发 板 连接 图 





24.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 16_lcd。 
本 章 实验 在 上 一 章 例 程 的 基础 上 完成 ,更改 工 程 名 字 为 “lcd” 然后 在 bsp 文件 夹 下 创建 名 
为 “lcd” 的 文件 夹 ， 在 bsp/lcd 中 新 建 bsp_ lcd.c、bsp_ lcd.h、bsp_ lcdapi.c、bsp_lcdapih 和 font.h 
这 五 个 文件 。bsp_lcd.c 和 bsp_lcd.h 是 LCD 的 驱动 文件 ，bsp_lcdapi.c 和 bsp_lcdapih 是 LCD 的 
API 操作 函数 文件 ，font.h 是 字符 集 点 阵 数 据 数 组 文件 。 在 bsp_lcd.h 中 输入 如 下 内 容 : 
示例 代码 24.3.1 bsp_lcd.h 文件 代码 









































1 #ifndef BSP LCD H 

2 define BSP LCD H 

B /玉米 类 大火 火炎 大 类 火炎 大 炎炎 类 大 类 类 类 大 类 类 大 大大 大大 大大 大大 大大 类 大 大 类 类 大 大 类 大 大 类 类 类 大 类 大大 大 类 大大 大 类 大 大 大 类 大 类 大 
4 Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
5 文件 名 g bep lechai 

a ERT : 左 忠 凯 

7 版 本 3 V10 

8 描述 BO eID Wye eS 

o JA 9 JE 

10 A : Wwww.openedv.com 

11 Hi : 初版 V1.0 2019/1/3 左 忠 凯 创建 

2 KECKCKCKCkCKCk kCkCk kCkck k kk Ck kCkCk k kk k kc k k kk Ck kCkCk kCkCk k kc k k kc k Ck kc k Ck kck ck kck ck ckck ck ckckck kk k kx f 
13 kine lude "imxóul.nh" 

14 

15 /* BN&ZOEX */ 

16 $define LCD BLUE 0x000000FF 

17 $define LCD GREEN 0x0000FF00 

18 $define LCD RED 0x00FF0000 

19 /* 省 略 掉 其 它 宏 定义 ， 完 整 的 请 参考 实验 例 程 */ 
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20 4$define LCD ORANGE 0x00FFA500 

21 #define LCD TRANSPARENT  0x00000000 

22 

23 #define LCD FRAMEBUF ADDR (0x89000000) /* LCD 显存 地 址 */ 








24 
25 /* LCD 控制 参数 结构 体 */ 
2S SELUCE LEELEE types id 





2 unsigned short height; /* LCD 屏幕 高 度 2 
28 unsigned short width; /* LCD 屏幕 宽度 */ 
219 unsigned char pixsize; /* LCD 每 个 像素 所 占 字 节 大 小 */ 
30 unsigned short vspw; /* VSYNC 信号 宽度 uA 
E unsigned short vbpd; /* 帧 同步 信号 后 肩 nr 
32 unsigned short vfpd; /* 帧 同步 信号 前 肩 DA 
BE unsigned short hspw; /* HSYNC 信号 宽度 Au 
34 unsigned short hbpd; /* 水 平 同 步 信 号 后 见 肩 an 
B5 unsigned short hfpd; /* 水 平 同 步 信 号 前 肩 wf 
36 unsigned int framebuffer; /* LCD 显存 首 地 址 = 
om unsigned int forecolor; /* 前 景色 m 
38 unsigned int backcolor; /* 背景 色 A 
E MEI 

40 

4i estern Sevee TEELE typeert EIELC dey? 

42 


43 /* 函数 声明 */ 
44 void lcd init (void); 
45 void lcdgpio init (void); 
le voici ledel imit(tnsigned folo Rama Korojo]Dhis M Plor omee Chet oda To b a 
unsigned char div); 
2.7 suene leal reset (vorc) g 
48 void lcd noreset (void); 
10 voie led enable (vorc) 7 
5/0) voici video pillinit(tnsicgned char Jhexeyexelbwal;, vasignec! Char posteivi) 2 
51 inline void lcd drawpoint(unsigned short x,unsigned short y, 
unsigned int color); 
52 imline unsigned) iot led readboine (unsigned SNTE Sx 
unsigned short y); 
33 voici leel eleen (unsigned iar Golar) 
54 yore leel TiU (unsigned chore z0, vosigoce snort yo, 
unsigned short x1, unsigned short yl, 
unsigned int color); 
55 fendif 
在 文件 bsp_ lcd.h 中 一 开始 定义 了 一 些 常 用 的 颜色 宏 定 义 ， 颜 色 格式 都 是 ARGBSSSS HJ. 
第 23 fT] LCD FRAMEBUF ADDR 是 显存 首 地 址 ， 此 处 将 显存 首 地 址 放 到 了 0X89000000 
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地 址 处 。 这 个 要 根据 所 使 用 的 LCD 屏幕 大 小 和 DDR 内 存 大 小 来 确定 的 , 前面 我 们 说 了 ATK7016 
这 款 RGB 屏幕 所 需 的 显存 大 小 为 2.4MB， 而 LMX6U-ALPHA 开发 板 配 置 的 DDR 有 256 和 
512MB 两 种 类 型 , 内存 地 址 范围 分 别 为 0X80000000~0X90000000 和 0X80000000~0XA0000000。 
所 以 LCD 显存 首 地 址 选择 为 0X89000000 不 管 是 256MB 还 是 512MB 的 DDR 都 可 以 使 用 。 

第 26 行 的 结构 体 tftlcd_typedef 是 RGB LCD 的 控制 参数 结构 体 ， 里 面包 含 了 跟 LCD 配置 


























有 关 的 一 些 成 员 变量 。 最 后 就 是 一 些 变量 和 函数 是 声明 。 
在 bsp led.c 中 输入 如 下 内 容 : 
示例 代码 24.3.2 bsp_lcd.c 文件 代码 


/大 炎炎 炎 大 炎炎 火 大 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 炎炎 大 大 











(eer yore e TES COT DEZ neonek ee ET t TRO OI C ORTRO ASISTE eno SIS See el 
XT o SoSS CO 





fex : 左 忠 凯 

版 本 a Vi 

描述 : LCD 驱动 文件 。 

其 他 E 

论坛 : www.openedv.com 

irs : 初版 V1.0 2019/1/3 左 忠 凯 创建 


KCKCKCKCkCkCk kCk ck k kk k kCk Ck kc k Ck kk ck k kc k k k k k kCk Ck kk k k kc k k kk kck ck ck kck ck kckck ckck ck ckckck kk e kx kf 


ii molvele “sejp lecli in“ 


EET citadas e 

3 spyaamebswele "Sep: clelcu -nm 

de ne seo 

5 

6  /* 液晶 屏 参 数 结构 体 */ 

D) Struct wieled typeert iexileo dey, 

8 

Sp. yn 

10 * Qdescription : 始 化 LCD 

11  * Qparam 8 Àb 

12  * Qreturn 3 JE 

15, 

14) von eam oeh] 

Sa 

16 lcdgpio init(); /* 初始 化 IO am 
by ledeik aiE(32 =; 5)7 /* 初始 化 LCD 时 钟 */ 
18 

19 lcd reset(); /* RM LCD E 
20 delayms (10); /* 延 时 10ms */ 
PH lcd noreset(); /* 结束 复位 
2A 

23 /* RGB LCD 参数 结构 体 初 始 化 */ 

24 tftlcd dev.height = 600; /* 屏幕 高 度 E 
25 Erntlcdedevewidbh = T0240 /* 屏幕 宽度 f 
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26 trelled dev.pizsize 5 1 /* ARGB8888 模式 ， 每 个 像素 4 字 节  */ 
27 tftlcd dev.vspw = 3; /* VSYNC 信号 宽度 i 
28 tftlcd dev.vbpd = 20; /* WEA S JH a 
29 tfeled dev- vied = 12; /* Mile] 2 fs S AT x 
30 tftlod dev.hspw = 20; /* HSYNC 信号 宽度 m 
S EEEled dev- led = 1497 /* 水 平 同步 信号 后 见 肩 E 
32 tfeled dev afpa S 160} /* 水 平 同步 信号 前 肩 e 
E tftlcd dev.framebuffer = LCD FRAMEBUF ADDR; /* lWi£m */ 
34 tftlcd dev.backcolor = LCD WHITE;  /* XB vw 
35 tftlcd dev. forecolor = LCD BLACK; ”i 于 重光 半生 ur 
36 
37 /* 初始 化 ELCDIF ÉJ CTRL 寄存 器 
38 ET 人 
39 * bit [19] 1 : 旁 路 计数 器 模式 
40 * bit rn 
41 * bit [15:14] 00 : 输入 数据 不 交换 
42 * put pisst2] 00 s €8€ 4351 
43 * bit [11:10] 11 : 244 i£ E 
44 * pit [9:8] 11 : 24 位 数据 宽度 , 也 就 是 RGB888 
45 * bit [5] 1 : elcdif 工 作 在 主 模式 
46 * but [1] 0 : 所 有 的 24 位 均 有 效 
47 */ 
48 LODIEEXCIBD gp (3 «€ 19) | Cb*€ 173 ] «09«« 123) < 
49 (3 ec 10» << 8) odes) qq «e 1)» 
50 /* 
51 * 初始 化 ELCDIF 的 寄存 器 CTRL1 
52 * bit [19:16] : 0X7 ARGB 模式 下 ， 传 输 24 位 数据 ，A 通道 不 用 传输 
53 */ 
54 TiGDIEE—CLEBNT OXI << 16; 
55 
56 /* 
57 * 初始 化 ELCDIE 的 寄存 器 TRANSFER COUNT 寄存 器 
58 有 
59 = bie [15:0] m SE 
60 */ 
61 LCDIF-»TRANSFER COUNT 三 (臣下 让 十 CQ dey height «oy 
(tftlcd dev.width «« 0); 
62 
63 /* 
64 * 初始 化 ELCDIF 的 VDCTRL0 寄存 器 
65 * bit [29] O : VSYNC aim 
66 * pit [28] 1 : 使 能 ENABLE 输出 
67 * bit [27] 0 : VSYNC 低 电 平 有 效 
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68 * bit [26] 0 : HSYNC 低 电 平 有 效 
69 * bit [25] 0 : DOTCLK EINTE 2 
70 * bit [24] 1 : ENABLE 信号 高 电 平 有 效 
zal * pit [21] 1 : DOTCLK ÉGX PAE 1 
72 * bit [20] 1 : DOTCLK EX FUE EE 1 
73 * bit [17:0] : vspw 24i 
qua n 
75 LCDIF-»VDCTRLO = 0; /* 先 清 零 */ 
76 LCDIF-»VDCTRLO = (0 «« 29) | (1 «« 28) | (0 «« 27) | 
T w x 16) l A a a 15x24) 
78 (u <s 2i E ERE C I0) M ev << O) MP 
79 fs 
80 * 初始 化 ELCDIF 的 VDCTRL1 寄存 器 ， 设 置 VSYNC 总 周期 
81 E 
82 LCDIF-»2VDCTRL1 = titled dev.height v titled dev.vspw * 
wurieleo! dey vipe lle 
83 
84 [E 
85 * 初始 化 ELCDIF 的 VDCTRL2 寄存 器 ， 设 置 HSYNC 周期 
86 XOT aee 
87 * bit[17:0] : HSYNC 时 局 并 
88 2n] 
89 LCDIF-»VDCTRL2 = (tftlcd dev.hspw << 18) | (tftlcd dev.width + 
titled dey- hspw v titlec dev nipel x» tireled dev. hose) p 
90 
91 £* 
92 * 初始 化 ELCDIF 的 VDCTRL3 寄存 器 ， 设 置 HSYNC 周期 
93 = bit[27:16] s YE 
94 * bit[15:0] : 垂直 等 待 时 钟 数 
95 E 
96 ICIDIDIS—EAWADXCUIENSS) —2 (((üeielhee! Glewrclmie;exel eelieomelev ns css 15) [| 
(titled! dey vood o titled dev vS) s 
97 
98 A 
99 * 初始 化 ELCDIF 的 VDCTRL4 寄存 器 ， 设 置 HSYNC 周期 
100 * bit[18] 1 : 当 使 用 VSHYNC、HSYNC、DOTCLK 的 话 此 为 置 1 
101 * prE[17:0] s JE 
102 E 
103 
104 LCDIF-»VDCTRLA = (1««18) | (tftlcd dev.width); 
105 
106 irs 
107 * 初始 化 ELCDIF 的 CUR BUF 和 NEXT BUF 寄存 器 
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108 * 设置 当前 显存 地 址 和 下 一 帧 的 显存 地 址 

109 d 

110 LCDIF-2CUR BUF > (unsigned int)tftlcd dev.framebuffer; 
WAN LCDIF-2NEXT BUF - (unsigned int)tftlcd dev.framebuffer; 
112 

113 led enable(); /* 使 能 LCD =f 

114 delayms (10); 

135 lcd clear(LCD WHITE); /* 清 屏 

116 

JT 

118 

icit) s 

120 * Q(description  : LCD GPIO 初始 化 

121 * param e Jb 

122 * Qreturn 8 JE 

doce 

124 void lcdgpio init (void) 

11275 f 

126 gpio pin config t gpio config; 

152) 

128 /* 1. I0 初始 化 复 用 功能 */ 

129 IOMUXC SetPinMux(IOMUXC LCD DATAO0 LCDIF DATA00,0); 

130 IOMUXC SetPinMux(IOMUXC LCD DATAO1 LCDIF DATA01,0); 

137 IOMUXC SetPinMux(IOMUXC LCD DATAO2 LCDIF DATA02,0); 

132 IOMUXC SetPinMux(IOMUXC LCD DATA03 LCDIF DATA03,0); 

154 IOMUXC SetPinMux(IOMUXC LCD ENABLE LCDIF ENABLE,0); 

155 IOMUXC SetPinMux(IOMUXC LCD HSYNC LCDIF HSYNC,0); 

156 IOMUXC SetPinMux(IOMUXC LCD VSYNC LCDIF VSYNC,0); 

157 IOMUXC SetPinMux(IOMUXC GPIO1 IO08 GPIO1 IO08,0); /* 背光 引 脚 */ 
158 

159 /* 2. NIE Lcp ro 属性 

160 *pit 16:0 HYS XH] 

161 *bit [15:14]: 0 PA 22K Edu 

162 soie 3l: © pall Us 

163 *bit [12]: 0 pull/keeper Tiiz 

164 *bit [11]: 0 关闭 开路 输出 

165 *bit [7:6]: 10 EE 100Mhz 

166 *pit [5:3]: 111 驱动 能 力 为 R0/7 

167 *bit [0]: 1 高 转换 率 

168 e 

169 IOMUXC SetPinConfig(IOMUXC LCD DATAO0 LCDIF DATAO0,0xB9); 
170 IOMUXC SetPinConfig(IOMUXC LCD DATAO1 LCDIF DATAO1,0xB9); 
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193 IOMUXC SetPinConfig(IOMUXC LCD CLK LCDIF CLK,0xB9); 

194 IOMUXC SetPinConfig(IOMUXC LCD ENABLE LCDIF ENABLE,0xB9); 

1595 IOMUXC SetPinConfig(IOMUXC LCD HSYNC LCDIF HSYNC, 0xB9). ; 

196 IOMUXC SetPinConfig(IOMUXC LCD VSYNC LCDIF VSYNC,OxB9); 

197 IOMUXC SetPinConfig(IOMUXC GPIO1 IO08 GPIO1 IO08,0xB9); 

RON 

199 /* GPIO 初始 化 */ 

200 gpio config.direction = kGPIO DigitalOutput; /* 输出 ia 
20 goio config.outputLogic = 1; /* 默认 关闭 背光 */ 
202 gpio init(GPIO1, 8, &gpio config); /* 背光 默认 打开 */ 
203 gpio pinwrite(GPIOl, 8, 1); /* 打开 背光 */ 
204 ) 

205 

206 m 

207 * @description : LCD 时 钟 初始 化 ，LCD 时 钟 计算 公式 如 下 : 

2g TED (JE — 24 oD red / div 

209 * @param - loopDiv : loopDivider ÍË 

210 * Qparam - loopDiv : lcdifprediv fH 

211 * G8param - div : loedifdiv fü 

212 * Greturn 3 JE 

2s my 


21,2 volc lecdelk imit(unsignet char logpDiv, wnsigned char re 


unsigned char div) 





























216 t 

216 /* 先 初 始 化 video pli 

2a * VIDEO PLL —- OSC24M * (loopDivider -* (denominator / 
numerator)) / postDivider 

218 * 不 使 用 小 数 分 频 器 ， 因 此 denominator fll numerator 设置 为 0 

219 eq 

220 CCM ANALOG-»PLL VIDEO NUM = 0; /* 不 使 用 小 数 分 频 器 */ 

D CCM ANALOG-»PLL VIDEO DENOM = 0; 

QU: 

209 (6s 

224 * PLL VIDEO 寄存 器 设置 

225 * orelis] : 1 使 能 VIDEO PLL 时 钟 

226 * bit[20:19] : 2 XE »postDivider JJ 1 4 

2g * bit[6:0] : 32 WE loopDivider 寄存 器 

228 n 

229 CCM ANALOG-»PLL VIDEO = (2 << 19) | (1 << 13) | (loopDiv << 0); 

230 

23] A 


232 * MISC2 寄存 器 设置 
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2g * bit[31:30]: 0 VIDEO 的 post-div 设置 ，1 分 频 

234 x 

235 CCM ANALOG-2MISC2 &= «(3 << 30); 

236 CCM ANALOG->MISC2 = 0 << 30; 

Don 

238 /* LCD 时 钟 源 来 源 与 PLL5， 也 就 是 VIDEO PLL */ 

239 CCM-»CSCDR2 &= ~(7 << 15); 

240 CCM->CSCDR2 |= (2 << 15); Me CREER LCDR PRE CT (Ga ELLS 7 
241 

242 /* RA LCDIF PRE 分 频 */ 

243 CCM-»CSCDR2 &= «(7 << 12); 

244 CCM-»CSCDR2 |= (prediv - 1) << 12; /* 设置 分 频 */ 
245 

246 /* 设置 LCDIF 分 频 */ 

247 CCM-»CBCMR &- «(7 << 23); 

248 CCM-»CBCMR |= (div - 1) << 23; 

249 

250 /* 设置 LCD 时钟 源 为 LCDIF PREH[?R */ 

251 CCM-»CSCDR2 &= «(7 << 9);  /* 清除 原来 的 设置 2m 
252 CCM-»CSCDR2 |= (0 << 9); /* LCDIF PRE 时 钟 源 选 择 LCDIF PRE 时 钟 */ 
DM 

254 

2350/2 

256 * @description : 复位 ELCDIF 接口 

257 * Qparam 8 JE 

258 * Greturn 8 JE 

25S ey 

2610 vorc! leel resst (vorc) 

261 ( 

262 LCDIF-»CTRL = 1««31; /* 强制 复位 */ 

263 } 

264 

DIG dS 

266 * Qdescription  : 结束 复位 ELCDIF 接口 

267 * Gparam 8 iE 

268 * Greturn 8 3 

DES wf 

270 void lcd noreset (void) 

DTi i 

Qu LCDIF-»CTRL = 0««31; /* 取消 强制 复位 */ 

2 SY 

274 

eue hs 
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276 * Qdescription  : 使 能 ELCDIE 接口 


277] * Qparam e Jb 

278 * Greturn 8 JE 

PN 

280 void lcd enable (void) 

29J t 

282 LCDIF-»CTRL |= 1««0; /* 使 能 ELCDIE */ 
ASA p 

284 

2E fn 

286 * Qdescription : 画 点 函数 

287 * Qparam - x : x AES 

288 * @param = y : y 轴 坐 标 

000 Goazan = colas : 颜色 值 

290 * Greturn = JE 

ONE 

292 inline void lcd drawpoint(unsigned short x,unsigned short y, 


unsigned int color) 


oS 

294 (us ee imt) (unsi caed. int) titled! deyv. nam 

295 title cevy. pPizsize © (titled dev widina c 
Veo 

2916) 

29m 

2/98 

ZONE 

300 * Qdescription : 读 取 指定 点 的 颜色 值 

301 * @param - x :ox Ab 

302 * @param - y : y BER 

303 * Qreturn : 读 取 到 的 指定 点 的 颜色 值 

304 */ 


S0 5; imline iwusussbepee! ime lea reacpornt ((wmusiLcpmec! Sie xp 


unsigned short y) 


306 ( 

307 returnes (nsemeen me) (mene em ame To TUUS on 
308 titled cev pizsize ee move 

EISE 

310 

EIS s 

312 * Qdescription : JBBÉ 

SEE (hosueswn —- eol: : BACH 

314 * QGreturn : 读 取 到 的 指定 点 的 颜色 值 

Subs 9f 
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Sle voil! led elear(tasicmec mak IE) 

Su | 

DILE unsigned int num; 

SALS) unsigned int i = 0; 

320 

321 unsigned int *startaddr-(unsigned int*)tftlcd dev.framebuffer; 

222 num-(unsigned int)tftlcd dev.width * tftlcd dev.height; 

o for(i = 0; i < num; itt) 

324 { 

325 starcaddriil = color, 

326 ) 

327 ) 

328 

SIS. ue 

330 * Qdescription : 以 指定 的 颜色 填充 一 块 矩形 

331 * Qparam - x0 : EJIRE X 轴 

332 * Qparam - yO : 矩形 起 始点 坐标 立轴 

333 * Qparam - x1 : 矩形 终止 点 坐标 X 轴 

334 * Qparam - yl : 矩形 终止 点 坐标 Y 轴 

353 = [Crosveen = COLOR : 要 填充 的 颜色 

BG et : 读 取 到 的 指定 点 的 颜色 值 

S Sy 

35/5 vole led F111(vnsiensa Shorti 0 uns Ro Polo Mo Top an no. 

5939 unsigned short x1, unsigned short yl, 
unsigned int color) 

340 ( 

341 ipumieitensrexel gmiowouziE $25 WB 

342 

343 if(xO0 « 0) x02 0; 

344 if(yO0 < 0) y02 0; 

345 dml rz titled dey- wiota) zi = tieled Glewowoelum = 17 

346 (过 EEC deyv- heigat) yl c titigel dev- height — 55 

347 

348 for(y = y0; y <= yl; y++) 

349 { 

350 for(x = x0; x <= x1; x++) 

E lcd drawpoint(x, y, color); 

952 } 

353 ] 


文件 bsp_lcd.c 里 面 一 共有 10 个 函数 ， 第 一 个 函数 是 lcd_init， 这 个 是 LCD 初始 化 函数 ， 
此 函数 先 调 用 LCD 的 IO 初始 化 函数 、 时 钟 初始 化 函数 、 复 位 函数 等 ， 然 后 会 按照 我 们 前 面 讲 
解 的 步 又 初始 化 eLCDIF 相关 的 寄存 器 ， 最 后 使 能 eLCDIF。 第 二 个 函数 是 lcdgpio_init， 这 个 是 


LCD fi 


















































^] IO 初始 化 函数 。 第 三 个 函数 lcdclk init 是 LCD 的 时 钟 初始 化 函数 。 第 四 个 函数 lcd_reset 
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和 第 五 个 函数 lcd_noreset 分 别 为 复位 LCD 的 停止 LCD 复位 函数 。 第 六 个 函数 lcd_enable 是 























eLCDIF 使 能 函数 , 用 于 使 能 eLCDIF。 第 七 个 和 第 八 个 是 画 点 和 读 点 函数 , 分 别 为 lcd_drawpoint 
和 led readpoint， 通 过 这 两 个 函数 就 可 以 在 LCD. 的 指定 像素 点 上 显示 指定 的 颜色 ， 或 者 读 取 指 
定 像素 点 的 颜色 。 第 九 个 函数 lcd_clear 是 清 屏 函数 ， 使 用 指定 的 颜色 清除 整个 屏幕 。 最 后 一 人 
函数 led fill 是 填充 函数 ， 使 用 此 函数 的 时 候 需 要 指定 算 形 的 起 始 坐 标 、 终 止 坐 标 和 填充 颜色 ， 
这 样 就 可 以 填充 出 一 个 矩形 区 域 。 
在 bsp_lcdapih 中 输入 如 下 所 示 内 容 : 

示例 代码 24.3.3 bsp_lcdapi.h 文件 代码 
























































1 4ifndef BSP LCDAPI H 

2 4define BSP LCDAPI H 

3 /汪汪 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 类 大 火炎 火炎 类 大 类 大 类 大 类 大 大大 类 大 类 大 类 类 类 大 类 大 类 大 大 大 类 大 大 
4 Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
5 Niz ES 

G EE : IER 

7 版 本 Vl 

8 描述 : LCD 显示 API HR. 

9 其 他 TE 

10 i&dx : www.openedv.com 

11 Eb : WIR v1.0 2019/3/18 左 忠 凯 创建 

12 OK KCKOKCK Kk ok k KICK kk ok KK KK kk kk KK KK Ck ke Rok KICK ok Kok Kk oko Kok kk / 
13 $include "imxó6ul.h" 

iu pacius Uosg Toci im^ 

ill; 

16 /* RÆ H */ 

iy seuil leel cdreanline (unsigned short xil, wasigned short yl, unsicmnmetl 


sime Ar Weneo gnore 3/2) 7p 

le voici leel draw rectangle usomee shore xil, wnsigned shoct yl, 

unsigned short x2, unsigned short y2); 

19 voici leel craw cirele(unsigned chorc z0 unsigned shorct yo, 

unsigned char r); 

20 void lcd showchar(unsigned short x,unsigned short y, 
unsigned char num,unsigned char size, 
unsigned char mode); 

2il unsienee tot lee pow (unsigned! Char m Unsigned eamm) 

22 void led shownum(unsigned short x, unsigned short y, 

unsigned int num, unsigned char len, 
unsigned char size); 

23 void lcd showxnum(unsigned short x, unsigned short y, 
unsigned int num, unsigned char len, 
unsigned char size, unsigned char mode); 

24 void lcd show string(unsigned short x,unsigned short y, 

unsigned short width, unsigned short height, 


unsigned char size, char *p); 
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25 #endif 


文件 bsp_lcdapi.h 内 容 很 简单 ， 就 是 函数 声明 。 在 bsp ledapi.c 中 输入 如 下 内 容 : 
示例 代码 24.3.4 bsp. lcdapi.c 文件 代码 


/玉米 业 火 炎炎 炎炎 大 火炎 大 大 类 类 类 大 类 类 大 大 类 类 大 大 类 类 大 大 类 类 大 大火 大大 大大 大 大 大 类 大 大 大 类 大 大 大大 大大 大 类 大 类 大 类 大 类 大 类 大 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 


文件 名 SEEeewaoaee 
作者 : 左 忠 凯 
版 本 eV 
描述 : LCD API 函数 文件 。 
其 他 e JE 
论坛 : www.openedv.com 
pi : WI v1.0 2019/3/18 左 忠 凯 创建 


KCKCKCKCKCKCk kk ck k kk k kCk Ck k Ck Ck kk k k kk k k Ck Ck kCk Ck kCk Ck k kc k k kk k kc kckckck ck kck ck ckck ck ckckck kk ke kk / 


1  £include "bsp lcdapi.h" 


2  dinclude "font.h" 

m 

4 x 

5 * Qdescription : 画 线 函 数 

6 * Qparam - x1 : 线 起 始点 坐标 xX 轴 
E * (param - yl : 线 起 始点 坐标 Y S 
8 * @param - x2 : 线 终止 点 坐标 xX d 
9 * (param - y2 : 线 终止 点 坐标 Y 轴 
10  * Qreturn US 

ial e 


l2 voici Led crewlins(unsignee snort xil, unsigned ghort yil, 


unsigned short x2, unsigned short y2) 


ii. 

14 ui t 

IS int zerre S 0, yerr = 0, delta x, delta y, Qisrtance; 

15; iat, alme, sme. UG, 1vWCol p 

3l 7) delta x = x2 - x1; /* 计算 坐标 增 量 x 
18 delre y = y2 = wr 

19 uRow = xl; 

20 uCol 2 yl; 

ZH if(delta x > 0) inox = 1; /* 设置 单 步 方向 A 
22 else if(delta xe-0) incx = 0; /* ERES vu 
29 else 

24 { 

25 incx - -1; 

26 delita £3 —elslbwe 5x5 

AT } 

28 
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29 if(delta y»0) incyzi; 

30 else if(delta y = 0)  incyzs0; e RFE 1 

el else 

97 { 

BS ie €&3 cg 

34 celra y = Celta yp 

35 } 

36 eus(( delta x > delta y) Cietance = Celta zp /* 选 取 基 本 增 量 坐标 轴 */ 
27 else distance = delta y; 

38 for(t = 0; t <= distance*!; t++ ) /* 画 线 输出 */ 
39 { 

40 lod grawpoint(uRow, uCol, rele! dev.forecolor),;/~" HA */ 
41 zerri delto 

42 yeu uc eelues y p 

43 if(xerr » distance) 

44 { 

45 xerr -= distance; 

46 uRow += incx; 

47 } 

48 if (yerr > distance) 

49 { 

50 yerr -= distance; 

Sal uCol s= incy; 

52 } 

58 } 

54 } 

55 

Sa fe 

57 * Qdescription : 男 和 矩形 函数 


58  * @param - x1 : XUEAS EHER x fü 

59 * Qparam - yl : AEJÉAA Ef Ae bg v 轴 

SO dam o2 : EEA TAER x 轴 

61 ^* [Biexeueewn — 2 : 矩形 右 下 角 坐 标 Y 轴 

62  * Qreturn & 25 

GS. o Eel 

94 yord led drew receandlel((uns ne Short zl, unsigned ghort yi; 


unsigned short x2, unsigned short y2) 


GONE 
66 led crawline(xi, wi, s wig 
67 lel eheeesligae (Gl quo sio q2)5 
68 lee crawline (xil, wZ, x2, V2) 
69 eel eben (C2 
Oe 
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mal 
72 
73 
74 
75 
76 
T3 
78 
l9 


80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
SHl 
07 
SE 
94 
95 
96 
om 
98 
99 
100 
ILO 
102 
103 
104 
105 
106 
107 
108 
109 
JESE 
ll 
15052 


/* 

= (idescription 
* (param - x0 
* (param - yO 
= (iparam = y2 
* (üóreturn 


z 


e31E B B 


论坛 :www.opendev.com 


: 在 指定 位 置 画 一 个 指定 大 小 的 圆 


: 圆心 坐标 X 轴 
圆心 坐标 立轴 

: 圆 形 半径 

3 JE 


void lcd draw circle(unsigned short x0,unsigned short yO0, 


ine d Ek UL c 8p 
while(y » x) 
( 


lcd drawpoint (x 
lcd drawpoint (y 
lcd drawpoint(-x 


lcd drawpoint (-y 


lcd drawpoint(-x 
lcd drawpoint (-y 
lcd drawpoint (x 


lcd drawpoint (y 


TE( < 0 
|! 

ola el ar 
} 
else 


{ 


unsigned char r) 


/* Y>x 即 第 一 象限 的 第 1 区 八 分 圆 */ 


mx, 


mx, 





y 
x 
WES Y 
mx, x 


WES = 


WES = 





2X cape 


i my, titled ekew.zowecolos) 7 
i amy, (iile dev. torecolor) i 
i my, tieled elew.ieuecolos) 2 
T my, ticled dev. torecolor) s 


y v my, titled deyv. torecolor)) 
z oap mý, dite! devr. tTorecolor) 


ms, =y v my; titled dey. Torecolor) 7 


me, =x qp my, titie cev torecolor)) ? 


GES dg «£i w) wu 3g 


/* 
* (idescription 
* param - x 


* (param - y 


: 在 指定 位 置 显示 
: 起 始 坐 标 X 轴 
: AED AS Y 轴 


IN P ghe 


和 字符 
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113 * 8param - num  : 显示 字符 


114 * aparam - size : FANI, mf 12/16/24/32 
115 * Qparam - mode : JJ (1) 还 是 非 登 加 方式 (0) 














116 * return 3 JE 
Iiye wy 
118 void lcd showchar (unsigned Elmo. ss aSc SOLE wy 
119 unsigned char num, unsigned char size, 
120 unsigned char mode) 
T2 
12727 unsicnedkehdar trenpa ri E 
i23 unsigned short yi -2 y; 
/* 得 到 字体 一 个 字符 对 应 点 阵 集 所 占 的 字 节 数 Su 
TZA unsigned char csize = (size / 8+ ((size $ 8) ? 1: 0)) * 
(ize 2) 
128 num e num - ' a /* 得 到 偏 移 后 的 值 CASCII 字库 是 从 空格 开始 取 模 ， 
所 以 -' ' 就 是 对 应 字符 的 字库 ) */ 
126 for(t = 0; t < csize; CFF) 
127 { 
128 if (size == 12) temp = asc2 1206[num][t];  /* 调用 1206 字体 */ 
129 else if(size == 16)temp = asc2 1608[num][t];/* 调用 1608 字体 */ 
130 else if(size == 24)temp = asc2 2412[num][t];/* 调用 2412 字体 */ 
T1 else if(size == 32)temp = asc2 3216[num][t];/* 调用 3216 字体 */ 
139 else return; /* 没有 的 字库 un 
133 for(tl = 0; tT < 8; EE) 
134 { 
135 if(temp & 0x80)lcd drawpoint(x, y, tftlcd dev.forecolor); 
ISI else if(mode--0)lcd drawpoint(x, y, 
ieitielhegl olesy.loexelkeolo) 7 
JST y) temp <<= 1; 
138 yoti 
139 if(y >= tftlcd dev.height) return; /* EKRI */ 
140 if((y - y0) == size) 
141 { 
142 y = y0; 
143 xtt; 
144 if(x >= tftlcd dev.width) return; /* EKRI */ 
145 break; 
146 } 
147 } 
148 } 
149 } 
150 
JUS s 
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5 
SS : 要 计算 的 值 


JE. Rparami m 3 a VO 
155 * Qreturn e onis E78 o 
A. wy 


157 unsigned int lcd pow(unsigned char m,unsigned char n) 
se 








159 unsigned int result = 1; 

160 while (n--) result *= m; 

ied return result; 

162 ) 

163 

164 /* 

165 * Qdescription  : 显示 指定 的 数字 ， 高 位 为 0 的 话 不 显示 
166 * @param - x : 起 始 坐 标点 xX 轴 。 

167 * (Qparam - y : 起 始 坐 标点 Y 轴 。 


168 * Qparam - num  : 数值 (0~999999999)。 
169 * Qparam - len  : 数字 位 数 。 
170 * Qparam - size : FAND 


W è Gretwza 3 Jb 

JL sy 

173 void lcd shownum (unsigned Sigo 3e 

174 unsigned short y, 

TS unsigned int num, 

IG unsigned char len, 

T0 3) unsigned char size) 

EES N 

179 unsigned char t, temp; 

180 unsigned char enshow = 0; 

8 for(t = 0; t < len; ttt) 

182 { 

11818] temp = (num / lcd pow(10, len - t - 1)) $ 10; 
184 if(enshow == 0 && t < (len - 1)) 

185 { 

186 if(temp == 0) 

187 { 

188 ld Slo ea (Ge x» (iunme / ?) € t, wy " "', eume, 0) 
189 continue; 

E90 }else enshow = 1; 

1E } 

192 le! hw el (x «» leize / 2) = t, yp cama "0", sime, 0)5 
EOS ) 

194 } 
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T95 

TOE (S 

197 * @description : 显示 指定 的 数字 ， 高 位 为 0, 还 是 显示 

198 * @param - x : 起 始 坐 标点 X e 

199 * Qparam - y : 起 始 坐 标点 Y 轴 。 

200 * @param - num : 数值 (0~999999999) 。 

201 * Qparam - len : 数字 位 数 。 

202 * Qparam - size : 字体 大 小 

203 * Qparam - mode zoo d BE 

204 * [6:1] :保留 

205 è [0] :0, FAMER; 1, DIS. 

206 * GQreturn 8 6 

20]. wy 

208 void lcd showxnum (unsigned shorti MEUSE GT GIESSEN. 
209 unsigned int num, unsigned char len, 
210 unsigned char size, unsigned char mode) 
2i q 

2002 unsigned char t, temp; 

213 unsigned char enshow = 0; 

214 for(t = 0; t < len; t++) 

21s { 

2S temp = (num / lcd pow(10, len - t- 1)) $ 10; 

Zl y if(enshow == 0 && t < (len - 1)) 

218 { 

2 if(temp == 0) 

220 { 

2/21 if(mode & 0X80) lcd showchar(x * (size / 2) * t, y, N 


'Q', size, mode & 0X01); 
2272 else icai howela («eo (Usb 7/2) er E 
mode & 0X01); 


223 continue; 

22 Jelse enshowz!; 

2215 

226 } 

22 led Simsweleur( x a» (size / 2) * t, yp tawo o "OY , Sime ; 
mode & 0X01); 

229 ) 

229 

230 

zT IUE 

232 * Qdescription : 显示 一 串 字 符 串 

233 * @param - x : 起 始 坐 标点 xX 轴 。 

234 * (param = y : 起 始 坐 标点 Y 轴 。 
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235 * Qparam - width : 字符 串 显 示 区 域 长 度 

236 * @param - height : 字符 串 显 示 区 域 高 度 

23] * Qparam - size : 字体 大 小 

238 * Qparam - p : 要 显示 的 字符 串 首 地 址 

239 * Qreturn 8 JE 

240 */ 

2 voie lee mimo IhEseabexgy((Uhars)éieamrerel Shori x soe short yr 

242 unsigned short width,unsigned short height, 
243 unsigned char size,char *p) 

244 { 

245 unsigned char x0 2 x; 

246 width += x; 

247 height += y; 

248 while((*p <= '-') &&(*p >= ' ')) /* 判断 是 不 是 非法 字符 ! */ 
249 { 

250 if(x >= width) (x = x0; y += size;} 

251 if(y >= height) break; /* iR */ 

2597 lec simowehmeur(G, wo gp y sume; O)? 

253 x += size / 2; 

254 ptt; 

256 } 

ZONE) 




















文件 bsp ledapi.h 里 面 都 是 一 些 LCD 的 API PRÍEPRZA Linz. mE d. ihv 








数字 、 显 示 字 符 和 字符 串 等 函数 。 这 些 函 数 都 是 从 STM32 例 程 里 面 移植 过 来 的 ， 如 果 学 习 过 
ALIENTEK 的 STM32 教程 的 话 就 会 很 熟悉 ， 都 是 一 些 纯 软件 的 东西 。 


led showchar 函数 是 字符 显示 函数 , 要 理解 这 个 函数 就 得 先 了 解 一 下 字符 (ASCII 字符 集 ) 
在 LCD 上 的 显示 原理 。 要 显示 字符 ,我 们 先 要 有 字符 的 点 阵 数 据 ，ASCII 常用 的 字符 集 总 共有 



































95 个 ， 从 空格 符 开始 ， 分 别 为 : 1"#$%&'()*+,-0123456789:;<=>?@ABCDEFGHIJKLMNOPQR 
STUVWXYZ[M^ `abcdefghijklmnopqrstuvwxyz{|}~. 





我 们 先 要 得 到 这 个 字符 集 的 点 阵 数 据 ， 这 里 我 们 介绍 一 个 款 很 好 的 字符 提取 软件 : 
PCtoLCD2002 完美 版 。 该 软件 可 以 提供 各 种 字符 ， 包 括 汉字 【字体 和 大 小 都 可 以 自己 设置 ) 阵 




















提取 , 且 取 模 方式 可 以 设置 好 几 种 ,常用 的 取 模 方式 ,该 软件 都 支持 。 该 软件 还 支持 图 形 模式 ， 











是 用 户 








可 以 自己 定义 图 片 的 大 小 ， 然 后 画图 ， 根 据 所 画 的 图 形 再 生成 点 阵 数据 ， 这 功能 在 

















制作 








图 标 或 
该 软件 


图 片 的 时 候 很 有 用 。 








的 界面 如 图 24.3.1 所 示 : 
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模式 (C) HERO) ”帮助 (H) 


Bex po 


winsin rdemRHKO X 16 


**: fie ~| 字 高 |le | 三 AU 





XHA ”编辑 (E) 


| 19 


请 选择 字体 : 
宋体 


论坛 :www.opendev.com 





ir dri da rabia 
FEX 16 X 16 
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Te B BP mp a 
B|z|u| aia Ael 
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生成 字模 | 保存 字模 | 清除 数据 | 
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图 24.3.1 PCtoLCD2002 软件 界面 





然后 我 们 点 击 字模 选项 按钮 只; 


dn 24.3.2 所 示 : 


e 


c Sis 
C FE 


取 模 走向 


输出 数 制 





占星 :24 | 
索引 jie v] 


= z | Wama 


= s | BEA h: 


右上 角 的 取 模 说 明 里 面 有 ， 即 : 从 第 一 列 开始 向 下 每 取 8 个 点 作 


上 图 设置 的 取 模 方式 ， 在 





为 一 个 字 节 , 如 果 最 后 不 足 8 个 点 就 补 满 8 位 。 取 模 顺 序 是 从 高 到 低 , HI 
取 为 10000000。 其 实 就 是 按 如 图 24.3.3 所 示 的 这 种 方式 : 


个 wa ETER 
(ai 

E 十 六 进 制 数 

C 十 进 制 数 


p EET 
-号 行 显 于吉 二 | 输出 精简 格 


|v Suc Rus 


液晶 面板 仿真 
^ E 














入 字模 选项 设置 界面 。 设置 界面 中 点 阵 格式 和 取 模 方式 等 























EXET 
[csi Jm 自 定义 格 5 


T RIISSS : 

[2j E 
HEBES: 
FRAR: 
EAI: 
HRR: |, 
TANER: 
TES: 
ER: 


高 位 在 前 
[]* 
员 10000000 


取 模 演示 MRE] 


[s -j 


图 24.3.2. 设置 取 模 方式 




















第 一 个 点 作为 最 高 位 。 
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D7 
D6 
D5 
D4 
D3 
D2 
D1 
DO 


di 
e 


NHH 
ub 





图 24.3.3. 取 模 方式 图 解 
从 上 到 下 ,从 左 到 右 ， 高 位 在 前 。 我 们 按 这 样 的 取 模 方式 ,然后 把 ASCII 字符 集 按 12*6 大 



































小 、16*8、24*12 和 32*16 大 小 取 模 出 来 (对 应 汉字 大 小 为 12*12、16*16、24*24 和 32*32， 字 
符 的 只 有 汉字 的 一 半 大 !)。 将 取出 的 点 阵 数 组 保存 在 fonth 里 面 ， 每 个 12*6 的 字符 占用 12 个 
字 节 , 每 个 16*8 的 字符 占用 16 个 字 节 ,每 个 24*12 的 字符 占用 36 个 字 节 , 每 个 32*16 的 字符 
占用 64 个 字 节 。fonth 中 的 字符 集 点 阵 数 据 数组 asc2 1206、asc2 1608、asc2 2412 和 asc2 3216 
就 对 应 着 这 四 个 大 小 字符 集 ， 具 体 见 font.h 部 分 代码 (该 部 分 我 们 不 再 这 里 列 出 来 了 ， 请 大 家 
参考 光盘 里 面 的 代码 )。 
最 后 在 main.c 中 输入 如 下 所 示 内 容 : 
示例 代码 24.3.5 main.c 文件 代码 


/玉米 矿业 火炎 类 类 火炎 类 大 类 类 类 大 火炎 类 类 类 类 类 大 类 类 大 大 类 类 大 大 类 大大 大 类 类 大 大 类 类 大 大 类 大 大 大 类 类 大 大 大大 大 大 大大 大 大 类 大 
















































































COP r ONET EN zo UR GJ Ie SLE CO or ro Lo 2 ns ero 
文件 名 a mieno E 












































作者 : ABL 
版 本 -lO 
i 述 : I.MX6U 开发 板 裸 机 实验 16 LCD 液晶 屏 实验 
其 他 : 本 实验 学 习 如 何在 工 .MX6U 上 驱动 RGB LCD 液晶 屏幕 ，I .MX6U 有 个 
ELCDIF 接口 ， 通 过 此 接口 可 以 连接 一 个 RGB LCD 液晶 屏 。 
论坛 : www.openedv.com 
E s : 初版 V1.0 2019/1/15 左 忠 凯 创建 


类 类 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 类 大火 类 类 类 类 类 类 类 类 大 类 类 类 类 类 类 大 大 类 大 类 大 类 大 大 大 类 大 类 大 大 大 大 大 类 大 大 大 类 大 大 类/ 


Ilo tee oe 
EGG "Jos eel. ia" 
include Tbsp lex. m" 


Hine lude "dos lee. m" 


Hine lude lS mie" 





" 


aelods "Seg wee sm" 





2 
n 
4 
5 finclude "bsp key.h" 
6 
E 
8 


Finclude "stdio.h" 











ee 





Om me le erkiga 


13 /* 背景 颜色 数组 */ 
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14 unsigned int backcolor[10] -» ( 
15 LCD BLUE, LCD GREEN, LCD RED, = LCD CYAN, LCD YELLOW, 
































16 LCD LIGHTBLUE, LCD DARKBLUE, LCD WHITE, LCD BLACK, LCD ORANGE 
17 









































18 p; 
119 
2. fes 
21 * description : main BK 
22 * Qparam : Xn 
23 * Qreturn 3 JE 
2A S 
25 int main(void) 
ls | 
2 unsigned char index = 0; 
28 unsigned char state - OFF; 
29 
30 int inith)? /* 初始 化 中 断 (一 定 要 最 先 调用 ! ) */ 
E imx6u clkinit(); /* 初始 化 系统 时 钟 A 
32 delay init(); /* 初始 化 延 时 
33 clk enable(); /* 使 能 所 有 的 时 钟 i 
24 Juexel twi (0) f /* 初始 化 leqd a 
25 beep init(); /* 初始 化 beep */ 
36 uart init (l)e /* 初始 化 串口 ， 波 特 率 115200 */ 
37 ieo imie) p /* 初始 化 LCD i 
38 
39 retsesitecilideveromee ol on aT DEREDE 
40 Fedishonis tring (LL) 1600) 1010) 721 7812: (ee ead Ies avs MSN 
ELnCD TEST"): 
41 lcd draw rectangle(10, 52, 1014, 290); /* tAWXEJE TE A 
42 lcd drawline(10, 52,1014, 290); 7* 绘制 线条 un 
43 lcd drawline(10, 29590,1014, 52); /* 绘制 线条 x 
44 ['ed'drawecircie(512) 17101. 119); /* 绘制 圆 形 x 
45 
46 while(!) 
47 { 
48 index-tt; 
49 if(index == 10) index = 0; 
50 legc ixii((U, 5005 1025, 5997 lemeckeole | metes) p 
5d lier] miümowy Ss Eve (500) p, O02 (nn V TENDRE) p 
52 led shownum(896,10, index, 2, 32); /* WoznZUE. Sm */ 
ES 
54 state = !state; 
55 ces ye (os sole 
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56 delayms (1000); /* SEB]—Tb */ 

57 ) 

58 return 0; 

S9 


第 37 行 调用 函数 lcd_init 初始 化 LCD. 

第 39 行 设置 前 景色 ， 也 就 是 画笔 颜色 为 红色 。 

第 40-44 行 都 是 调用 bsp ledapi.c 中 的 API 函数 在 LCD 上 绘制 各 种 图 形 和 显示 字符 串 。 

第 46 行 的 while 循环 中 每 隔 1S 中 就 调用 函数 lcd_fill 填充 指定 的 区 域 ， 并 且 显 示 index 
值 。 

main 函数 很 简单 ， 重 点 就 是 初始 化 LCD， 然 后 调用 LCD 的 API 函数 进行 一 些 常用 的 操 
作 ， 比 如 画 线 、 画 和 矩形、 显示 字符 串 和 数字 等 等 。 


24.4 编译 下 载 验证 
24.4.1 编写 Makefile 和 链接 脚本 


修改 Makefile 中 的 TARGET 为 lcd, 然后 在 在 INCDIRS 和 SRCDIRS 中 加 入 “bsp/lcd”， 修 
改 后 的 Makefile 如 下 : 















































示例 代码 19.4.1 Makefile 代码 








1 CROSS COMPILE ?- arm-linux-gnueabihf- 
2 TARGET Q3 «el 

m 

4 /省略 掉 其 它 代 码 。 E 

5 

6. INCDIRS :5 imx6ul y 

7 stdio/include Ñ 
8 bsp/clk y 

9 bsp/led WV 

10 bsp/delay \ 

下 于 bsp/beep \ 

下 多 BSR OPTION 

ls bsp/key \ 

14 bsp/exit \ 

1.5 bsp/int V 

16 bsp/epittimer V 
ileyi bsp/keyfilter \ 
18 bsp/uart \ 

19 bsp/lcd 

20 

21 SRCDIRS Be project \ 

22 Eee Ñ 

25 bao elk \ 

24 bsp/led \ 

25 bsp/delay \ 
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26 bsp/beep \ 

257 bsp/gpio NN 

28 bsp/key \ 

29 bsp/exit \ 

30 bsp/int WV 

Es bsp/epittimer \ 
2 bsp/keyfilter wN 
ES bsp/uart N 

34 bsp/lcd 

SD 

36 /* BEERE. oeo */ 

3m 

38 clean: 





39 rm -rf S(TARGET).elf S(TARGET).dis S(TARGET).bin $(COBJS) S$(SOBJS) 
第 2 行 修改 变量 TARGET 为 “lcd”， 也 就 是 目标 名 称 为 “lcd”。 
第 19 行 在 变量 INCDIRS 中 添加 RGB LCD 驱动 头 文件 (.I 路 径 。 
第 34 行 在 变量 SRCDIRS 中 添加 RGB LCD 驱动 驱动 文件 (.c) 路 径 。 
链接 脚本 保持 不 变 。 
































24.4.2 编译 下 载 


使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 lcd.bin 文件 
下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload // 给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

./imxdownload lcd.bin /dev/sdd / 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 。 程 序 开 始 运行 ，LED0 
每 阳 1S 闪烁 依次 ， 屏 幕 下 半 部 分 会 每 1S 刷新 依次 ， 并 且 在 屏幕 的 右上 角 显 示 索 引 值 ，LCD 
屏幕 显示 如 图 24.4.3 所 示 





























T 























































































































ERO-IMX6UL ELCD INDEX 




















图 24.4.3 LCD 显示 画面 























573 


LMX6U AR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


第 二 十 五 章 RTC 实时 时 钟 实验 














实时 时 钟 是 很 常用 的 一 个 外 设 ， 通 过 实时 时 钟 我 们 就 可 以 知道 年 、 月 、 日 和 时 间 等 信息 。 
因此 在 需要 记录 时 间 的 场合 就 需要 实时 时 钟 ， 可 以 使 用 专用 的 实时 时 钟 芯片 来 完成 此 功能 ， 但 
是 现在 大 多 数 的 MCU 或 者 MPU 内 部 就 已 经 自 带 了 实时 时 钟 外 设 模 块 。 比 如 IMX6U 内 部 的 
SNVS 就 提供 了 RTC 功能 ， 本 章 我 们 就 学 习 如 何 使 用 ILMX6U 内 部 的 RTC 来 完成 实时 时 钟 功 


eu 
KE o 
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25.1 I.MX6U RTC 简介 











如 果 学 习 过 STM32 的 话 应 该 知道 ，STM32 内 部 有 一 个 RTC 外 设 模块 ， 这 个 模块 需要 一 个 
32.768KHz 的 晶振 ， 对 这 个 RTC 模块 进行 初始 化 就 可 以 得 到 一 个 实时 时 钟 。LMX6U 内 部 也 有 
个 RTC 模块 , 但 是 不 叫 作 “RTC” 而 是 叫做 “SNVS” 这 一 点 要 注意 ! 本 章 我 们 参考 《I.MX6UL 
参考 手册 》， 而 不 是 《I.MX6ULL 参考 手册 》 因为 《LMX6ULL 参考 手册 》 很 多 SNVS 相关 的 
寄存 器 并 没有 给 出 来 ， 不 知道 是 为 何 ? 但 是 《I.MX6UL 参考 手册 》 里 面 是 完整 的 。 所 以 本 章 我 
们 使 用 《I.MX6UL 参考 手册 》， 如 果 直 接 在 《I.MX6UL 参考 手册 》 的 书签 里 面 找 “RTC” 相 关 
的 字眼 是 找 不 到 的 。LMX6U 系列 的 RTC 是 在 SNVS 里 面 ， 也 就 是 《LMX6UL 参考 手册 》 的 第 
46 章 “Chapter 46 Secure Non-Volatile Storage(SNVS) ". 

SNVS 直译 过 来 就 是 安全 的 非 易 性 存储 ，SNVS 里 面 主要 是 一 些 低 功 耗 的 外 设 ， 包 括 一 个 
安全 的 实时 计数 器 (RTC)、 一 个 单调 计数 器 (monotonic counter) 和 一 些 通用 的 寄存 器 ， 本 章 我 们 
肯定 只 使 用 实时 计数 器 (RTC)。 SNVS 里 面 的 外 设 在 芯片 掉 电 以 后 由 电池 供电 继续 运行 ,MX6U- 
ALPHA 开发 板 上 有 一 个 纽扣 电池 ， 这 个 纽扣 电池 就 是 在 主 电源 关闭 以 后 为 SNVS 供电 的 ， 如 
图 25.1.1 所 示 : 
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图 25.1.1 LMX6U-ALPHA 开发 板 纽扣 电池 
因为 纽扣 电池 在 掉 电 以 后 会 继续 给 SNVS 供电 ， 因 此 实时 计数 器 就 会 一 直 运行 ， 这 样 的 话 
时 间 信 息 就 不 会 丢失 ， 除 非 纽 扣 电 池 没 电 了 。 在 有 纽扣 电池 作为 后 备 电源 的 情况 下 ， 不 管 系统 
主 电 源 是 否 断 电 ，SNVS 都 正常 运行 。SNVS 有 两 部 分 : SNVS_HP 和 SNVS_LP， 系 统 主 电源 断 
电 以 后 SNVS HP 也 会 断 电 , 但 是 在 后 备 电 源 支 持 下 , SNVS_LP 是 不 会 断 电 的 , 而 且 SNVS LP 
是 和 芯片 复位 隔离 开 的 ， 因 此 SNVS LP 相关 的 寄存 器 的 值 会 一 直 保 存 着 。 
SNVS 分 为 两 个 子 模块 : SNVS_HP 和 SNVS LP， 也 就 是 高 功 耗 域 (SNVS_HP) 和 低 功 耗 域 
(SNVS_LP)， 这 两 个 域 的 电源 来 源 如 下 : 
SNVS_LP: 专用 的 always-powered-on 电源 域 ， 系 统 主 电 源 和 备用 电源 都 可 以 为 其 供电 。 
SNVS HP: 系统 (芯片 ) 电 源 。 
SNVS 的 这 两 个 子 模块 的 电源 如 图 25.1.2 所 示 ; 
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External 
Supply 


© 
VDD_HIGH_IN 


Programming 
Bodl 
Interrupt 


SNVS. HP 





ONOFF 
(button) 





图 25.1.2 SNVS 子 模块 电源 结构 图 

图 25.1.2 中 各 个 部 分 功能 如 下 : 

(D. VDD HIGH IN 是 系统 (芯片 ) 主 电源 , 这 个 电源 会 同时 供给 给 SNVS HP 和 SNVS_LP。 

©, VDD SNVS IN 是 纽扣 电池 供电 的 电源 ， 这 个 电源 只 会 供给 给 SNVS_LP， 保 证 在 系 
统 主 电源 VDD HIGH IN 掉 电 以 后 SNVS_LP 会 继续 运行 。 

(S). SNVS HP 部 分 。 

D, SNVS_LP 部 分 ， 此 部 分 有 个 SRTC， 这 个 就 是 我 们 本 章 要 使 用 的 RTC。 
其 实 不 管 是 SNVS_HP 还 是 SNVS_LP， 其 内 部 都 有 一 个 SRTC， 但 是 因为 SNVS HP 在 系 
统 电源 掉 电 以 后 就 会 关闭 ， 所 以 我 们 本 章 使 用 的 是 SNVS_LP 内 部 的 SRTC。 毕 竞 我 们 肯定 都 
不 想 开 发 板 或 者 设备 每 次 关闭 以 后 时 钟 都 被 清 零 ， 然 后 开机 以 后 先 设置 时 钟 。 
其 实 不 管 是 SNVS HP 里 面 的 RTC， 还 是 SNVS LP 里 面 的 SRTC， 其 本 质 就 是 一 个 定时 
器 ， 和 我 们 在 第 八 章 讲 的 EPIT 定时 器 一 样 ， 只 要 给 它 提供 时 钟 ， 它 就 会 一 直 运 行 。SRTC 需要 
外 界 提供 一 个 32.768KHz 的 时 钟 ，LMX6U-ALPHA 核心 板 上 的 32.768KHz 的 晶振 就 是 提供 这 
个 时 钟 的 。 寄 存 器 SNVS_LPSRTCMR 和 SNVS LPSRTCLR 保存 着 秒 数 ， 直 接 读 取 这 两 个 寄存 
器 的 值 就 知道 过 了 多 长 时 间 了 。 一 般 以 1970 年 1 月 1 日 为 起 点 , 加 上 经 过 的 秒 数 即 可 得 到 现在 
的 时 间 和 日 期 , 原理 还 是 很 简单 的 。 SRTC 也 是 带 有 闹钟 功能 的 , 可 以 在 寄存 器 SNVS_LPAR 中 
写 入 曾 钟 时 间 值 ， 当 时 钟 值 和 闹钟 值 匹配 的 时 候 就 会 产生 亲 钟 中 断 ， 要 使 用 时 钟 功能 的 话 还 需 
要 进行 一 些 设置 ， 本 章 我 们 就 不 使 用 闹钟 了 。 

接 下 来 我 们 看 一 下 本 章 要 用 到 的 与 SRTC 相关 的 部 分 寄存 器 ， 首 先是 SNVS_HPCOMR 4 
存 器 ， 这 个 寄存 器 我 们 只 用 到 了 位 : NPSWA_EN(bit1)， 这 个 位 是 非特 权 软 件 访问 控制 位 ， 如 
果 非 特权 软件 要 访问 SNVS 的 话 此 位 必须 为 1。 
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接 下 来 看 一 下 寄存 器 SNVS_LPCR 寄存 器 , 此 寄存 器 也 只 用 到 了 一 个 位 :SRTC_ENV(bit0)， 
此 位 为 1 的 话 就 使 能 STC 计数 器 。 

最 后 来 看 一 下 寄存 器 SNVS_SRTCMR 和 SNVS_SRTCLR， 这 两 个 寄存 器 保存 着 RTC 的 秒 
数 ， 按 照 NXP 官方 的 《6UL 参考 手册 》 中 的 说 法 ，SNVS_SRTCMR 保存 着 高 15 位 ， 
SNVS SRTCMR 保存 着 低 32 位 ， 因 此 SRTC 的 计数 器 一 共 是 47 位 。 

但 是 ! 我 在 编写 驱动 的 时 候 发 现 按照 手册 上 说 的 去 读 取 计数 器 值 是 错误 的 ! 具体 表现 就 是 
时 间 是 混乱 的 ,因此 我 在 查找 了 NXP 提供 的 SDK 包 中 的 fsl_snvs_hp.c 以 及 Linux 内 核 中 的 rte- 
snvs.c 这 两 个 驱动 文件 以 后 发 现 《6UL 参考 手册 》 上 对 SNVS_SRTCMR 和 SNVS SRTCLR 的 
解释 是 错误 的 ， 经 过 查阅 这 两 个 文件 ， 得 到 如 下 结论 : 

O, SRTC 计数 器 是 32 位 的 ， 不 是 47 位 ! 

Q). SNVS SRTCMR 的 bit14:0 这 15 位 是 SRTC 计数 器 的 高 15 位 。 

(8). SNVS SRTCLR 的 bit31:bit15 这 17 位 是 SRTC 计数 器 的 低 17 位 。 

按照 上 面 的 解释 去 读 取 这 两 个 寄存 器 就 可 以 得 到 正确 的 时 间 ， 如 果 要 调整 时 间 的 话 也 是 向 
这 两 个 寄存 器 写 入 要 设置 的 时 间 值 对 应 的 秒 数 就 可 以 了 ， 但 是 要 修改 这 两 个 寄存 器 的 话 要 先 关 
闭 SRTC。 

关于 SNVS 中 和 RTC 有 关 的 寄存 器 就 介绍 到 这 里 ， 关 于 这 些 寄存 器 详细 的 描述 ， 请 参考 

《I.MX6UL 参考 手册 》 第 2931 页 的 46.7 小 节 。 本 章 我 们 使 用 LMX6U 的 SNVS LP 的 SRTC， 

配置 步骤 如 下 : 

1、 初 始 化 SNVS SRTC 

初始 化 SNVS LP 中 的 SRTC. 

2、 设 置 RTC 时 间 

第 一 次 使 用 RTC 肯定 要 先 设置 时 间 。 

3、 使 能 RTC 

配置 好 RTC 并 设置 好 初始 时 间 以 后 就 可 以 开启 RTC 了 。 


25.2 硬件 原理 分 析 


本 试验 用 到 的 资源 如 下 : 

Q、 指 示 灯 LEDO. 

(2. RGB LCD 接口 。 

®©, SRTC. 

SRTC 需要 外 接 一 个 32.768KHz [Il] ds, 在 LMX6U-ALPHA 核心 板 上 就 有 这 个 32.768KHz 
的 晶振 ， 原 理 图 如 图 25.2.1 所 示 ; 


C2 










































































































































































RTC XTALI 
RTC XTALO 





GND || 


32.768KHz 
图 25.2.1 外 接 32.768KHz 晶振 





25.3 实验 程序 编写 
本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 17 rtc. 
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25.3.1 修改 文件 MCIMX6Y2.h 


在 第 十 三 章 移植 的 NXP 官方 SDK 包 是 针对 LMX6ULL 编写 的 ， 因 此 文件 MCIMX6Y2.h 
中 的 结构 体 SNVS_Type 里 面 的 寄存 器 是 不 全 的 ， 我 们 需要 在 其 中 加 入 本 章 实验 所 需要 的 寄存 
器 ， 修 改 SNVS_Type 为 如 下 所 示 : 

示例 代码 25.3.1.1 SNVS_Type 结构 体 








1 typedef struct { 

2 . .iHO ibat S)2 i5. HPLRS 
S TỌ usuEi € HPCOMRS 
4 . IO winto? © HECR? 
5 10 wint? EHE ICH. 
6 IO uint? è HPSVERS 
7 EN cnn M CIE SEU 

8 TORTEN C HPSVSRY 

















9 . IO mnt? t HPEACIVR? 
10 . HO uint? t HEHACR? 
ai Oe 3X7 c. BH TEILE 
12 — (9 winto? e IDEEN 
13 — HO mints? © MPIAMRA 
14 . IO Unts? E PTAR? 
J5 — . TO De © HAIR? 

16 . HO WIMES2 i6 LECRS 

IOF . HO wbebenES TENKER 
18 . IO Unto? x UPSVCR? 
19 En 人民 
20 OO 
2! 0 iwubaESZ 3E JUPE 

22 EN om E EE LDSRICMRS 
28 ORe MCN SES. 
25; —. A 

25 BETOR O rE MEME 
26 IO uint32 t LPSMCLR; 








2l TONYS TYDS 


25.3.2 编写 实验 程序 


本 章 实 验 在 上 一 章 例 程 的 基础 上 完成 ， 更 改 工 程 名 字 为 “rtc” 然后 在 bsp 文件 夹 下 创建 名 
为 “rtc” 的 文件 夹 ， 然 后 在 bsp/rte 中 新 建 bsp_rtc.c 和 bsp rtc.h 这 两 个 文件 。 在 bsp_rtc.h 中 输 
入 如 下 内 容 : 


























示例 代码 25.3.2.1 bsp. rtc.h 文件 代码 
#ifndef BSP RTC H 
#define BSP RTC H 


J[KCKCKCKCKCKCkCk kCkCk kCkCk kCkCk Ck KCkCk kCkCk kCkCK kk kCKCkCk kCkCk kCkCk k kc k Ck kc k Ck k ck k kck k k kc k kckck ck kck 


a Co 


Co ionmne Go 
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5 Niz & lero Tenere 

B MES : Jc 

7 版 本 :ANN 

8 描述 : RTE Jk xf. 

9 其 他 3 JE 

10 i&ix : www.openedv.com 

TD 旧址 : 初版 V1.0 2019/1/3 左 忠 凯 创建 


T2 KCKCKCKCKCKCkCkCkCk Ck k Ck k Ck k Ck k k kCk TA S a kCkCkCkCk Ck kCk kCkCk Ck kCkCk Ck k Ck k a k ck k 人 大 人 大 人 大 人 大人 大 人 大 人 大 人 大/ 


JESI- mne lude mn 























14 

15 JS JH AE */ 

16 $define SECONDS IN A DAY (86400) /* —K 86400 $ i 
17 4$define SECONDS IN A HOUR (3600) /* MN 360039 */ 
18 $define SECONDS IN A MINUTE (60) /* 一 分 钟 60 秒 rd 
19 4$define DAYS IN A YEAR (365) /* —Ég 365 K 22 
20 4define YEAR RANGE START (1970) /* 开始 年 份 1970 年 */ 
21 #define YEAR RANGE END (2099) /* 结束 年 份 2099 年 */ 
22 





23 /* 时 间 目 期 结构 体 */ 


24 Struct rte catertime 





25m 

26 unsigned short year; /* 范围 为 :1970 ~ 2099 Ki 

2 unsigned char month; /* 范围 为 :1 ~ 12 B 

28 unsigned char day; /* 范围 为 :1 ~ 31 (不 同 的 月 ， 天 数 不 同 ) .*/ 
2:9 unsigned char hour; /* Y&B7g:0 ~ 23 n 

30 unsigned char minute; /* 范围 为 :0 ~ 59 A 

E unsigned char second; /* 范围 为 :0 ~ 59 E 

32 y; 

BS 


34 /* 函数 声明 */ 

S5 volel rte imie (vorc) p 

Je Voi rte enable (wes) p 

37 sese! en (vorc) s 

3/5 unsignecl int rte Coverdate to seconde (Sue es re 
*datetime); 


$9) pumsohewwecl! Tnt rce gertsecondle (wes) z 





40. voici TEGE setdatestime(struct rte datetime lm) 








4L yolc pte getdatetima(struct rte datetime ln) 
42 
43 #endif 

第 16 到 21 行 定 义 了 一 些 宏 ， 比 如 一 天 多 少 秒 、 一 小 时 多 少 秒 等 等 ， 这 些 宏 将 用 于 将 秒 转 
换 为 时 间 ， 或 者 将 时 间 转 换 为 秒 。 第 24 行 定义 了 一 个 结构 体 rtc_datetime， 此 结构 体 用 于 描述 
日 期 和 时 间 参 数 。 剩 下 的 就 是 一 些 函数 声明 了 ， 很 简单 。 
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在 文件 bsp_rtc.c 中 输入 如 下 内 容 : 
示例 代码 25.3.2.2 bsp rtc.c 文件 代码 


/大 炎炎 炎炎 炎炎 火炎 炎炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大 大 炎炎 大 大 





Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
XT B IOS. iu 


作者 : 左 忠 凯 
版 本 IE 
描述 : RTC BEIC 
其 他 SC 
论坛 : www.openedv.com 
Hs : 初版 V1.0 2019/1/3 左 忠 凯 创建 


KCKCKCKCKCKCkCkCk ck k kk k kCk Ck kCk Ck kCk Ck k kk k kc k Ck kCk Ck kCk Ck k kc k k kk k kc k ck kck ck kck ck ckck ck ckckck kk ke ek / 


ee "leer stem 


ne eeele el, 

3 

-国人 

5 * Qdescription :初始 化 RTC 

6 */ 

9 VONC ere dgio (Oeh) 

$9 X 

9 f 

10 * 设置 HPCOMR 寄存 器 

11 * bit[31] 1 : 人 允许 访问 SNVS 寄存 器 ， 一 定 要 置 1 
12 S 

iS SNVS->HPCOMR |= (1 << 31); 

14 

S gels. 9 

16 SEESUGE rte datetime EE 

ay 

18 rtcdate.year = 2018U; 

HS rtcdate.month - 120; 

20 rtcdate.day = 13U; 

2 rtcdate.hour 2 140; 

2E rtcdate.minute = 52; 

25 iPiteleuEe.Seconmg = Up 

24 rtc setDatetime(&rtcdate);  /* 和 初始 化 时 间 和 日 期 */ 
25 yendi 

26 rtc enable(); /* 使 能 RTC suf 
27 ) 

28 

29 f 

30  * QGdescription  : J7f/H RTC 

3T 7 
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S2 Void rte enelsle (voici) 

SIS 

34 p 

35 * LPCR 寄存 器 bit0 置 1， 使 能 RTC 

36 wl 

S SNB IE ME E< 

38 while(!(SNVS-»LPCR & 0X01)); /* 等 待 使 能 完成 */ 
39 

40 } 

41 

AD fe 

43 * @description : 关闭 RTC 

44 x 

45 void rtc disable (vorei) 

46 { 

47 4* 

48 * LPCR 寄存 器 bito H 0, XH] RTC 

49 ii 

50 SNVS-»LPCR &- «(1 << 0); 

51 while(SNVS-»LPCR & 0X01);  /* 等 待 关闭 完成 */ 
EX 

59 

5AT 


55  * @description : 判断 指定 年 份 是 否 为 闽 年 ， 国 年 条 件 如 下 : 
56  * Qparam - year : 要 判断 的 年 份 


57 * Q return : 1 4élg4E, 0 Apek 

Ge y 

50 á unsignec emma (nme short year) 
uU 

61 unsigned char valuez0; 

62 

63 if(year $ 400 == 0) 

64 value = 1; 

65 else 

66 { 

67 if((year $ 4 == 0) && (year $ 100 != 0)) 
68 value = 1; 

69 else 

70 value 2 0; 

Tal } 

72 return value; 

75e 3) 

74 
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95. qe 

76  * Qdescription : 将 时 间 转 换 为 秒 数 

7]  * param - datetime : 要 转换 日 期 和 时 间 。 

78 * Qreturn : 转换 后 的 秒 数 

S) w 


$0. unsigned) int rte Coverdate to Seconds(st ue rte catetine vdatetine) 
81 ( 






































82 unsigned short i - 0; 

83 unsigned int seconds = 0; 

84 unsigned int days = 0; 

85 ms nee son Ee monecndayshi e (898 ig. Sur, 00200 Usi. 
ieuo Siu A 2 SUP NES ESSE 

86 

87 for(i = 1970; i < datetime-»year; i++) 

88 { 

89 days += DAYS IN A YEAR; /* 平年 ， 每 年 365 X */ 

90 if(rtc isleapyear(i)) days += 1; /* BJfEZEJE— wy 

91 } 

92 

93 days += monthdays[datetime-»month]; 

94 if(rtc isleapyear(i) && (datetime-»month »- 3)) days t2 1; 

OS 

96 days += datetime-»day - |; 

971 

98 second i- cy CONDS EN 

99 datetime-»hour * SECONDS IN A HOUR v 

100 datetime-»minute * SECONDS IN A MINUTE -* 

Tom datetime->second; 

102 

103 return seconds; 

104 ) 

dL US 

OG S 

107 * Qdescription : 设置 时 间 和 日 期 

108 * Qparam - datetime : 要 设置 的 日 期 和 时 间 

109 * Qreturn 3 JE 

UO 

Lli void rtE petdatetime(otruct rte Cetetime vdetetinme) 

i15 

JS) 

114 unsigned int seconds = 0; 

ialis; unsigned int tmp - SNVS-»LPCR; 

ALIE, 
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117 rtc disable(); ”/* 设置 寄存 器 HPRTCMR 和 HPRTCLR 前 要 先 关 闭 RTC */ 
118 /* 先 将 时 间 转 换 为 秒 5 

Tle seconds = rtc coverdate to seconds (datetime); 

1210) SNVS-»LPSRTCMR = (unsigned int) (seconds >> 17); /* 设置 高 16 位 */ 
12i SNVS->LPSRTCLR = (unsigned int) (seconds << 15); /* 设置 地 16 位 */ 
122 

TS /* 如 果 此 前 RTC 是 打开 的 在 设置 完 RTC 时 间 以 后 需要 重新 打开 RTC */ 

124 if (tmp & 0x1) 

125 rte enable l)? 

126 ) 

110220] 

A pu 

129 * description : 将 秒 数 转换 为 时 间 


130 * param - seconds : 要 转换 的 秒 数 

131 * Qparam - datetime : 转换 后 的 日 期 和 时 间 

L2 S re 3 

MSE E 

lsd void rte COonvertseconde tOo cats cesi emis eleme eS TEES C eel 


struct rte datetime vdatetime) 






































WIS N 

136 unsigned int x; 

1:317] unsigned int secondsRemaining, days; 

JI SS unsigned short daysInYear; 

1 SI 

140 /* S HB y 

141 unsigned char daysPerMonth[] S (0U, 31U, 28U, 31U, 30U, 31U, 
SON). Sg, Sp, NOS SUI), SXONU SURE 

142 

143 secondsRemaining = seconds; /* 剩余 秒 数 初始 化 */ 

144 days = secondsRemaining / SECONDE NEE 

145 secondsRemaining - secondsRemaining $ SECONDS IN A DAY; 

146 

147 /* 计算 时 、 分 、 秒 */ 

148 datetime->hour = secondsRemaining / SECONDS IN A HOUR; 

149 secondsRemaining = secondsRemaining % SECONDS IN A HOUR; 

150 datetime->minute = secondsRemaining / 60; 

Sal datetime-»second - secondsRemaining $ SECONDS IN A MINUTE; 

1,527 

155 /* 计算 年 */ 

154 daysInYear = DAYS IN A YEAR; 

WSS datetime->year = YEAR RANGE START; 

TSG while (days > daysInYear) 

11577) { 
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158 /* 根据 天 数 计 算 年 */ 

T59 days -= daysInYear; 

160 datetime->year++; 

161 

162 /* EHE */ 

163 if (!rtc isleapyear (datetime-»year)) 
164 daysInYear = DAYS IN A YEAR; 

165 else  。 /x* 半 年 ， 天 数 加 一 */ 

166 daysInYear - DAYS IN A YEAR * 1; 
167 } 

168 /* 根 据 剩余 的 天 数 计算 月 份 */ 

169 if(rtc isleapyear(datetime-»year)) /* 如 果 是 羡 年 的 话 2 月 加 一 天 */ 
170 daysPerMonth[2] = 29; 

JE for(x = 1; x <= 12; x++) 

13 { 

173 if (days <= daysPerMonth[x]) 

174 { 

1505 datetime-»month = x; 

176 break; 

15057 } 

Ime else 

179 { 

180 days -= daysPerMonth[x]:; 

181 } 

1802 } 

183 datetime-»day = days; 

184 ) 

185 

1G = 

187 * Qdescription : 获取 RTC 当前 秒 数 

188 * @param 8 UE 

1499) = Rekra : 当前 秒 数 

ION) 3 

ue ne rre Getseconde vierte) 

192 { 

193 unsigned int seconds = 0; 

194 

195; seconds = (SNVS-»LPSRTCMR «« 17) | (SNVS-»2LPSRTCLR »» 15); 
IG return seconds; 

197 } 

198 

1 

200 * @description : 获取 当前 时 间 
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201 * @param - datetime : 获取 到 的 时 间 ， 日 期 等 参数 


论坛 :Www.opendev.com 





202 * Greturn e 3E 

QS 

204 vord pte getdatetime (struct rte datetime vdartetime)) 
20Sa 

206 unsigned int seconds - 0; 

207 seconde = rte getescondes |) 

208 rtc convertseconds to datetime(seconds, datetime); 
ZONE) 


文件 bsp_rtc.c 里 面 一 共有 9 个 函数 ， 依 次 来 看 一 下 这 些 函 数 的 意义 。 函 数 rtc. init 明显 是 
初始 化 rtc 的 ,主要 是 使 能 RTC, 也 可 以 在 rtc_ init 函数 里 面 设置 时 间 。 函 数 rtc_enable 和 rtc_disable 
分 别 是 RTC 的 使 能 和 禁止 函数 。 函 数 rtc isleapyear 用 于 判断 某 一 年 是 否 为 国 年 。 函 数 
rtc coverdate to seconds 负责 将 给 定 的 日 期 和 时 间 信 息 转换 为 对 应 的 秒 数 。 函 数 rtc_setdatetime 
用 于 设置 时 间 ， 也 就 是 设置 寄存 器 SNVS LPSRTCMR 和 SNVS LPSRTCLR. P 
rtc convertseconds to datetime 用 于 将 给 定 的 秒 数 转换 为 对 应 的 时 间 值 。 函 数 rtc_getseconds 3X 
取 SRTC 当前 秒 数 ， 其 实 就 是 读 取 寄 存 器 SNVS_LPSRTCMR 和 SNVS_LPSRTCLR， 然 后 将 其 
结合 成 47 位 的 值 。 最 后 一 个 函数 rtc_getdatetime 是 获取 时 间 值 。 

我 们 在 main 函数 里 面 先 初始 化 RTC, 然后 进入 3S 倒计时 ， 如 果 这 3S 内 按 下 了 KEY0 fX 


键 , 那么 就 设置 SRTC 的 日 





时 间 的 话 就 




















入 如 下 所 示 内 容 : 







































































Hj. 如 果 3S 倒计时 结束 以 后 没有 按 下 KEY0, 也 就 是 没有 设置 SRTC 
入 while 循环 ， 然 后 读 取 RTC 的 时 间 值 并 且 显 示 在 LCD 上 ， 在 文件 main.c 中 输 








示例 代码 25.3.2.3 main.c 文件 代码 


/玉米 大火 火炎 类 火炎 火炎 类 大 类 类 类 大 类 类 类 大 类 大 大 类 类 大 大 大 类 大 类 大 类 大 大 大大 大 大 大大 大 大 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 大 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 


文件 名 
作者 
版 本 
描述 
其 他 


论坛 


日 志 


pimel 
#incl 
dincl 


#incl 


#incl 
Hime 
inel 


il 

2 

3 

4 

5 a piaci 
6 

E 

8 
Se 
1 


& Mi 

: 左 忠 凯 

-Vi 

: I.MX6U 开发 板 课 机 实验 17 RTC 实时 时 钟 实 验 

: 本 实验 学 习 如 何 编写 工 .MX6U 内 部 的 RTC 驱动 ， 使 用 内 部 RTC 可 以 实现 
一 个 实时 时 钟 。 

: wwwW.openedv.com 


: 初版 V1.0 2019/1/15 左 忠 凯 创 建 


类 大火 类 火炎 炎炎 火炎 火炎 类 大 类 类 类 大 类 类 大 大 类 类 大 类 类 类 大 大 类 大 大 大 类 大 大 大火 大大 大 类 大 大 大 类 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 


uce 
ude 
ude 
ude 
ude 
ude 
ude 


ude 





ude 


0 #include 





"doro Lg 


h" 


"Joysge: okeuseny nA 


po coEMC c 


os beep: 


oc 
KoSo 3L e 
ST lee 
loses 


h" 


h" 





Hosio leceo ea 


MSIE 


h" 
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nel Ee 

iA 

Ns fy 

14 * Qdescription : main 函数 

Pom (diro rs eT 3 JE 

16 * Qreturn s JE 

dg. w 

18 int main(vord) 

TOi 

20 unsigned char key = 0; 

gu dae "a = 0 

22 ine i a 3 /* E 3S */ 

273) emus lex ESOT 

24 struct rte datetime Eg 

25 unsigned char state = OFF; 

26 

27 SEPT) /* 初始 化 中 断 (一 定 要 最 先 调 用 ! ) */ 

28 imx6u clkinit(); /* 初始 化 系统 时 钟 5l 

29 delay init(); /* 初始 化 延 时 */ 

30 clik Snmaols() p /* 使 能 所 有 的 时 钟 */ 

31 Led init(); /* 初始 化 lea vui 

3 beep init(); /* 初始 化 beep x 

33 uart initl)g /* 初始 化 串口 ， 波 特 率 115200 x 

34 led imit H) p /* 初始 化 LCD m 

35 ze Simibt (D) p /* 初始 化 RTC */ 

36 

23 ee ereolenE re 

38 lcd show string(50, 10, 400, 24, 24, /* Wow */ 
(char*)"ALPHA-IMX6UL RTC TEST"); 

39 trece dev TOrecolor = CD BLUE, 

40 memset (buf, 0, sizeof (buf)); 

41 

42 while(!) 

43 { 

44 SEO LU) dose IHESU 

45 { 

46 七 =0 ; 

47 primer (ul ee runm noi fel eere eere Ve 

48 

49 lcd fill(50, 40,370, 70, tftlcd dev.backcolor); /* E */ 

50 Sprint ELUR Ev Texe nn Dogs) 

Sal, led show string(50, 40, 300, 24, 24, buf); 

52 i--; 
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DS TEGEL) 

54 break; 

55 } 

56 

57 key = key getvalue(); 

58 if (key == KEYO VALUE) 

59 { 

60 rtcdate.year - 2018; 

61 rtcdate.month = 1; 

62 rtcdate.day = 15; 

63 rtcdate.hour - 16; 

64 rtcdate.minute = 23; 

65 iibCOleEe.Secomed - Uf 

66 rtc setdatetime(&rtcdate); /* 初始 化 时 间 和 日 期 */ 

67 jowcsbewedE (Co Xae Nam, JEU, ane 3eddaL ede we ag 

68 break; 

69 ) 

70 

ak delayms (10); 

712 [T 

了 3 ) 

74 tiricleo! dev. ToOrecolor = INCID RED? 

75 lcd fill(50, 40,370, 70, tftlod dev.backcolor); /* wF */ 

76 eos lov suex3neg(i50, 49, 200.2 245 24. ((eusut) "Cusseemne Tues") 

75 Etetecmler forceoler MET TS NECS TER 

78 

79 while(!) 

80 { 

81 rtc getdatetime(&rtcdate); 

82 sprintf(buf,"$d/$d/$d $d:$d:$d",rtcdate.year, rtcdate.month, 
rtcdate.day, rtcdate.hour, rtcdate.minute, rtcdate.second); 

83 leg titi (Sp 500529454 titlecl dey backeolor) y 

84 led show string(50,70,250,24,24,(char*)buf); /* 显示 字符 串 */ 

85 

86 state = !state; 

SN lec! switen (LEDO State) 7 

88 delayms (1000); /* 延 时 一 秒 */ 

89 ) 

90 return 0; 

91 } 


第 35 行 调用 函数 rte. init 初始 化 RTC. 
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第 42 到 73 行 是 倒计时 3S, 如 果 在 这 3S AIX F T KEY0 按键 就 会 调用 函数 rtc_setdatetime 
设置 当前 的 时 间 。 如 果 3S 到 技术 结束 以 后 没有 按 下 KEY0 那 就 表示 不 需要 设置 时 间 ， 跳 出 循 
































环 ， 执 行 下 面 的 代码 。 
第 79 到 89 行 就 是 主 循环 ， 此 循环 每 隔 1S 调用 函数 rtc_getdatetime 获取 一 次 时 间 值 ， 并 且 
通过 串口 打印 给 SecureCRT 或 者 在 LCD 上 显示 。 


25.4 编译 下 载 验证 
25.4.1 编写 Makefile 和 链接 脚本 


修改 Makefile 中 的 TARGET 为 re， 然后 在 在 INCDIRS 和 SRCDIRS 中 加 入 “bsp/rtc”， 修 
改 后 的 Makefile 如 下 : 


























示例 代码 25.4.1 Makefile 代码 
1 CROSS COMPILE 2o arm-linux-gnueabihf- 











2 TARGET GE qe 

3 

4 pe WERE... af 

5 

6. INCDIRS :25 imx6ul y 

7 arcdio/inelvude NÑ 
8 bsp/clk y 

9 bsp/led \ 

10 bsp/delay \ 

al bsp/beep \ 

12 bsp/gpio \ 

13 bsp/key V 

14 bsp/exit 

IB bsp/ int \ 

16 bsp/epittimer 
iby bsp/keyfilter \ 
18 Bep uont 

19 bsp/lcd WV 

20 DSP CEG 

Zl 

22 SRCDIRS ses jgqexeyect y 

25 stdio/lib y 

24 bsp/clk y 

25 bsp/led \ 

26 bsp/delay \ 

2 bsp/beep \ 

28 bsp/gpio \ 

29 bsp/key WV 

30 bsp/exit N 

31 bap/ int Y 
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32 bsp/epittimer \ 

33 bsp/keyfilter N 

34 pop uart i 

35 bsp/lcd \ 

36 DSD TEE 

Sg 

38 /* ERRA EA a 

So 

40 clean: 


41 rm -rf S(TARGET).elf S(TARGET).dis S(TARGET).bin $(COBJS) S(SOBJS) 
第 2 行 修改 变量 TARGET X “rte”, 也 就 是 目标 名 称 为 “rtc”。 
第 20 行 在 变量 INCDIRS 中 添加 RTC 驱动 头 文件 (0 路径 。 
第 36 行 在 变量 SRCDIRS 中 添加 RTC 驱动 驱动 文件 (.c) 路 径 。 
链接 脚本 保持 不 变 。 


25.4.2 编译 下 载 


使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 rtc.bin 文件 
下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

.Jimxdownload rtc.bin /dev/sdd // 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中， 然后 复位 开发 板 。 程 序 一 开始 进入 3S 
倒计时 ， 如 图 25.4.2.1 所 示 : 





24.4.2.1 3 秒 钟 倒计时 
如 果 在 倒 计 数 结束 之 前 按 下 KEY0， 那 么 RTC 就 会 被 设置 为 我 们 代码 中 设置 的 时 间 和 日 期 
值 ，RTC 运行 如 图 24.4.2.2 所 示 : 
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图 24.4.2.2 设置 有 的 时 间 
我 们 在 main 函数 中 设置 的 时 间 是 2018 年 1 月 15 日 ，16 点 23 分 0 秒 , 在 倒 计 数 结束 之 前 
按 下 KEY0 按键 设置 RTC， 图 24.4.2.2 中 的 时 间 就 是 我 们 设置 以 后 的 时 间 。 
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第 二 十 六 章 IC 实验 


DC 是 最 常用 的 通信 接口 ， 众 多 的 传感器 都 会 提供 I2C 接口 来 和 主 控 相连 ， 比 如 陀螺 仪 、 
加 速度 计 、 触 摸 屏 等 等 。 所 以 DC 是 做 嵌入 式 开 发 必须 掌握 的 ，LMX6U 有 4 个 DC 接口 ， 可 
以 通过 这 4 个 DC 接口 来 连接 一 些 DC 外 设 。LMX6U-ALPHA 使 用 I2C1 接口 连接 了 一 个 距离 
传感器 AP3216C， 本 章 我 们 就 来 学 习 如 何 使 用 LMXeU 的 DC 接口 来 驱动 AP3216C， 读 取 
AP3216C 的 传感器 数据 。 
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26.1 I2C & AP3216C 简介 


26.1.1 I2C 简介 








DC 是 很 常见 的 一 种 总 线 协 议 ，I2C 是 NXP 公司 设计 的 ，I2C 使 用 两 条 线 在 主 控制 器 和 从 
机 之 间 进 行 数据 通信 。 一 条 是 SCL( 串 行 时 钟 线 )， 另 外 一 条 是 SDA( 串 行 数据 线 )， 这 两 条 数据 
线 需 要 接 上 拉 电 阻 ， 总 线 空闲 的 时 候 SCL 和 SDA 处 于 高 电 平 。I2C 总 线 标准 模式 下 速度 可 以 
达到 100Kb/S， 快速 模 式 下 可 以 达到 400Kb/S. DC 总 线 工 作 是 按照 一 定 的 协议 来 运行 的 ， 接 下 














来 就 看 一 下 I2C 协议 。 





RC 是 支持 多 从 机 的 ， 也 就 是 一 个 DC 控制 器 下 可 以 挂 多 个 I2C 从 设备 ， 这 些 不 同 的 PC 
从 设备 有 不 同 的 器 件 地 址 ， 这 样 DC 主 控制 器 就 可 以 通过 I2C 设备 的 器 件 地 址 访问 指定 的 Dc 


























设备 了 ， 一 个 I2C 总线 连 接 多 个 PC 设备 如 图 26.1.1.1 所 示 : 
VDD 




















R| IR 








SDA 
SCL 



































2C 器 件 1 I2C 器 件 2 2C 器 件 3 | eet eoo 


























图 26.1.1.1 I2C 多 个 设备 连接 结构 图 











图 26.1.1.1 中 SDA 和 SCL 这 两 根 线 必 须要 接 一 个 上 拉 电 阻 ， 一 般 是 4.7K。 其 余 的 DC 从 
器 件 都 挂 接 到 SDA 和 SCL 这 两 根 线 上 , 这 样 就 可 以 通过 SDA 和 SCL 这 两 根 线 来 访问 多 个 DC 











设备 。 
接 下 来 看 一 下 I2C 协议 有 关 的 术语 : 
1、 起 始 位 
顾名思义 ， 也 就 是 I2C 通信 起 始 标 志 ， 通 过 这 个 起 始 位 就 可 以 告诉 PC 从 机 ,“ 我 ” 












































ZU: 





图 26.1.1.2 PC 通信 起 始 位 




















2、 停 止 位 











BH 
进行 2C 通信 了 。 在 SCL 为 高 电 平 的 时 候 ，SDA 出 现下 降 沿 就 表示 为 起 始 位 ， 如 图 26.1.1.2 所 





Hi 


停止 位 就 是 停止 2C 通信 的 标志 位 ， 和 起 始 位 的 功能 相反 。 在 SCL 位 高 电 平 的 时 候 ，SDA 


出 现 上 升 沿 就 表示 为 停止 位 ， 如 图 26.1.1.3 所 示 : 
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SCL 








3、 数 据 传 输 


图 26.1.1.3 DC 通信 停止 位 














DC 总 线 在 数据 传输 的 时 候 要 保证 在 SCL 高 电 平 期 间 ，SDA 上 的 数据 稳定 ， 因 此 SDA 上 
的 数据 变化 只 能 在 SCL 低 电 平 期 间 发 生 ， 如 图 26.1.1.4 所 示 : 



























X 





4、 应 答 信号 





yY yY 
数据 稳定 人 允许 变化 数据 稳定 
图 26.1.1.4 I2C 数据 传输 





当 DC 主机 发 送 完 8 位 数据 以 后 会 将 SDA 设置 为 输入 状态 ， 等 待 DC 从 机 应 答 ， 也 就 是 
等 到 DC 从 机 告诉 主机 它 接收 到 数据 了 。 应 答 信 号 是 由 从 机 发 出 的 ， 主 机 需要 提供 应 答 信号 所 


























N 








需 的 时 钟 ， 主 机 发 送 完 8 位 数据 以 后 紧 跟 着 的 一 个 时 钟 信号 就 是 给 应 答 信号 使 用 的 。 从 机 通过 























将 SDA 拉 低 来 表示 发 出 应 答 信号 ， 表 示 通 信 成 功 ， 否 则 表示 通信 失败 。 


5. DC 写 时 序 








主机 通过 DC 总 线 与 从 机 
如 图 26.1.1.5 所 示 : 

















之 间 进 行 通信 不 外 乎 两 个 操作 : SUE. DC 总 线 单字 节 写 时 序 































































































S Y S 
T R T S 
RoS ume. GTI REG ADDRESS C C 0 
ho ADDRESS — B I & T K DATA K P 
SDA LINE * 
1 2 3 4 5 6 7 8 9 10 
图 26.1.1.5 I2C 写 时 序 


图 26.1.1.5 就 是 PC 写 时 序 ， 我 们 来 看 一 下 写 时 序 的 具体 步骤 : 





D、 开 始 信号 。 























2)、 发 送 DC 设备 地 址 ， 每 个 PC 器 件 都 有 一 个 设备 地 址 ， 通 过 发 送 具 体 的 设备 地 址 来 决 
定 访 问 哪 个 I2C 器 件 。 这 是 一 个 8 位 的 数据 ， 其 中 高 7 位 是 设备 地 址 ， 最 后 1 位 是 读 写 位 ， 为 
1 的 话 表 示 这 是 一 个 读 操 作 ， 为 0 的 话 表示 这 是 一 个 写 操作 。 

3. I2C 器 件 地 址 后 面 跟 着 一 个 读 写 位 ， 为 0 表示 写 操 作 ， 为 1 表示 读 操作 。 

4)、 从 机 发 送 的 ACK 应 答 信 号 。 




















5)、 重 新 发 送 开始 信号 。 





























6)、 发 送 要 写 写 入 数据 的 寄存 器 地 址 。 
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7)、 
8). 
9). 


10), 


从 机 发 送 的 ACK 应 答 信号 。 
发 送 要 写 入 寄存 器 的 数据 。 
从 机 发 送 的 ACK 应 答 信号 。 
停止 信号 。 


6. DC 读 时 序 
DC 总 线 单字 节 读 时 序 如 图 26.1.1.6 所 示 : 














论坛 :Www.opendev.com 





SDA LINE 

































































DEVICE ADDRESS REG ADDRESS DEVICE ADDRESS DATA 

P ^ A 
fs "NT y «i n. 
T R | T T IB 
i R y Pe t 1 人 | h REG ADDRESS à R y MAS 5 A 人 à | 0 
HE s ADDRESS B fii i à KE B ADDRESS B D E DATA KP 

| | | | | | | 
* 

| EQ | | | M | | — 
1 2 3.4 5 6 T 8 9 10 11 12 13 14 


DC 单字 节 读 时 序 比 写 时 序 要 复杂 一 


















































图 26.1.1.6 I2C 单字 节 读 时 序 























读 取 的 寄存 器 值 ， 我 们 具体 来 看 一 下 这 步 。 


1)、 
2)、 
3)、 
4)、 
5)、 
6)、 
7)、 
8)、 
9)、 


10)、 
11)、 
12)、 
13)、 
14)、 


主机 发 送 起 始 信 号 。 

主机 发 送 要 读 取 的 DPC 从 设备 地 址 。 

读 写 控 制 位 ， 因 为 是 向 DPC 从 设备 发 送 数 据 ， 因 此 是 写 信和 号。 
从 机 发 送 的 ACK 应 答 信号 。 

重新 发 送 START 信号 。 

主机 发 送 要 读 取 的 寄存 器 地 址 。 

从 机 发 送 的 ACK 应 答 信 号 。 

重新 发 送 START 信号 。 

重新 发 送 要 读 取 的 DC. 从 设备 地 址 。 


























点 ， 读 时 序 分 为 4 大 步 ， 第 一 步 是 发 送 设备 地 址 ， 第 
二 步 是 发 送 要 读 取 的 寄存 器 地 址 ， 第 三 步 重 新 发 送 设备 地 址 ， 最 后 一 步 就 是 DC 从 器 件 输出 要 





读 写 控制 位 ， 这 里 是 读 信 号 ， 表 示 接 下 来 是 从 I2C 从 设备 里 面 读 取 数 据 。 


从 机 发 送 的 ACK 应 答 信 号 。 
从 I2C 器 件 里 面 读 取 到 的 数据 。 




















主机 发 出 NO ACK 信号 ， 表 示 读 取 完 成 ， 不 需要 从 机 再 发 送 ACK 信号 了 。 


主机 发 出 STOP 信号 ， 停 止 PC 通信 。 


7. DC 多 字 节 读 写 时 序 
又 时 候 我 们 需要 读 写 多 个 字 节 ， 多 字 节 读 写 时 序 和 单字 节 的 基本 一 致 ， 
时 候 可 以 连续 发 送 多 个 自己 的 数据 ， 其 他 的 控制 时 序 都 是 和 单字 节 一 样 的 。 




















26.1.2 LMX6U I2C 简介 


只 


是 在 读 写 数据 的 








LMX6U 提供 了 4 个 DC 外 设 ， 通 过 这 四 个 I2C 外 设 即 可 完成 与 DC 从 器 件 进行 通信 ， 
ILMX6U 的 DC 外 设 特 性 如 下 : 


` 


& e &89uGoO 





与 标准 DC 总 线 兼 容 。 


、 多 主机 运行 

、 软 件 可 编程 的 64 中 不 同 的 串 行 时 钟 序列 。 
、 软 件 可 选择 的 应 答 位 。 

、 开 始 /结束 信号 生成 和 检测 。 

、 重 复 开 始 信 号 生成 。 
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@、 确 认 位 生成 。 

®©, ARIEI 

LMX6U 的 I2C 支持 两 种 模式 ;标准 模式 和 快速 模式 ， 标 准 模式 下 DC 数据 传输 速率 最 高 
是 100Kbits/s， 在 快速 模式 下 数据 传输 速率 最 高 为 400Kbits/s。 

我 们 接 下 来 看 一 下 DC 的 几 个 重要 的 寄存 器 ,首先 看 一 下 I2Cx_IADR(x=1~4) 寄 存 器 , 这 是 
DC 的 地 址 寄存 器 ， 此 寄存 器 结构 如 图 26.1.2.1 所 示 : 

















26.1.2.1 寄存 器 DCx IADR 结构 
寄存 器 DCx IADR 只 有 ADR(bit7:1) 位 有 效 ， 用 来 保存 DC 从 设备 地 址 数据 。 当 我 们 要 访 
问 某 个 DC 从 设备 的 时 候 就 需要 将 其 设备 地 址 写 入 到 ADR 里 面 。 接 下 来 看 一 下 寄存 器 
I2Cx_IFDR， 这 个 是 DC 的 分 频 寄 存 器 ， 寄 存 器 结构 如 图 26.1.2.2 所 示 : 
nd 


Write 
Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 


26.1.22 寄存 器 D2Cx IFDR 结构 
寄存 器 12Cx_IFDR 也 只 有 了 IC(bit5:0) 这 个 位 ， 用 来 设置 DC RS. DC 的 时 钟 源 可 以 选 
J% PG_CLK ROOT=66MHz， 通 过 设置 IC 位 既 可 以 得 到 想 要 的 DC 波 特 率 。IC 位 可 选 的 设置 
如 图 26.1.2.3 所 示 : 









































































































































IC Divider IC Divider IC Divider IC Divider 
0x00 30 0x10 0x20 22 160 
0x01 32 0x11 320 — | 0x21 24 x31 — | 192 
0x02 36 0x12 384 0x22 26 224 
0x03 42 0x13 480 0x23 28 256 
0x04 48 0x14 576 0x24 32 320 
0x05 52 0x15 0x25 36 384 
0x06 60 0x16 0x26 40 448 
0x07 72 0x17 0x27 44 512 
0x08 80 0x18 0x28 48 640 
0x09 88 0x19 0x29 56 68 
Ox0A 104 Ox1A 1536 Ox2A 64 Ox3A 896 
0x0B 128 0x1B 1920 Ox2B 72 1024 
Ox0C 144 Ox1C — |2304 | Ox2C 80 1280 
OxOD 160 Ox1D 2560 Ox2D 96 1536 
OxOE 192 Ox1E 3072 Ox2E 112 "a 1792 
OxOF 240 Ox1F Ox2F 128 2048 
26.1.2.3 IC 设置 
不 像 其 他 外 设 的 分 频 设 置 一 样 可 以 随意 设置 ， 图 26.1.2.3 中 列 出 了 IC 的 所 有 可 选 值 。 比 如 


现在 IC 的 时 钟 源 为 66MHz, 我 们 要 设置 12C 的 波 特 率 为 100KHz, 那 么 IC 就 可 以 设置 为 0X15， 
也 就 是 640 44i. 66000000/640-2103.125KHz ^ 100KHz 
接 下 来 看 一 下 寄存 器 I2Cx I2CR， 这 个 是 DC 控制 寄存 器 ， 此 寄存 器 结构 如 图 26.1.2.4 所 


ZN: 
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Read 
Write 
Reset 0 0 0 0 0 0 0 0 
图 26.1.2.4 寄存 器 DCx D2CR 结构 

寄存 器 DCx DCR 的 各 位 含义 如 下 : 

IEN(bit7: DC 使 能 位 ， 为 1 的 时 候 使 能 I2C， 为 0 的 时 候 关 闭 DC. 

IIEN(bit6): I2C 中 断 使 能 位 ， 为 1 的 时 候 使 能 I2C 中 断 ， 为 0 的 时 候 关 闭 DPC 中 断 。 

MSTA(bitS): 主 从 模式 选择 位 ， 设 置 IC 工作 在 主 模式 还 是 从 模式 ， 为 1 的 时 候 工 作 在 主 
模式 ， 为 0 的 时 候 工作 在 从 模式 。 

MTX(bit4): 传输 方向 选择 位 ， 用 来 设置 是 进行 发 送 还 是 接收 , 为 0 的 时 候 是 接收 , 为 1 的 
时 候 是 发 送 。 

TXAK(bit3): 传输 应 答 位 使 能 ， 为 0 的 话 发 送 ACK 信号 ， 为 1 的 话 发 送 NO ACK 信号 。 

RSTA(bit2): 重复 开始 信号 ， 为 1 的 话 产生 一 个 重新 开始 信号 。 

接 下 来 看 一 下 寄存 器 12Cx_I2SR， 这 个 是 DC 的 状态 寄存 器 ， 寄 存 器 结构 如 图 26.1.2.5 所 























Bit 15 14 13 12 | 11 10 9 8 
Read 0 
Write 
Reset 0 0 0 0 0 0 0 0 





26.1.2.5 寄存 器 DCx DSR 结构 
寄存 器 DCx DSR 的 各 位 含义 如 下 : 
ICF(bit7): 数据 传输 状态 位 ， 为 0 的 时 候 表示 数据 正在 传输 ， 为 1 的 时 候 表示 数据 传输 完 





成 。 
IAAS(bit6): 当 为 1 的 时 候 表示 2C 地 址 ， 也 就 是 DCx IADR 寄存 器 中 的 地 址 是 从 设备 地 
址 。 
IBB(bit5): DC 总 线 忙 标志 位 ， 当 为 0 的 时 候 表示 I2C ARTN, J1 的 时 候 表示 I2C 总 
线 忙 。 
IAL(bit4): 仲裁 丢失 位 ， 为 1 的 时 候 表示 发 生 仲裁 丢失 。 
SRW(bit3): 从 机 读 写 状 态 位 ， 当 DC 作为 从 机 的 时 候 使 用 ,此 位 用 来 表明 主机 发 送 给 从 机 
的 是 读 还 是 写 命令 。 为 0 的 时 候 表示 主机 要 向 从 机 写 数 据 ， 为 1 的 时 候 表示 主机 要 从 从 机 读 取 
数据 。 
IIF(bitl): 12C 中 断 挂 起 标志 位 ， 当 为 1 的 时 候 表示 有 中 断 挂 起 ， 此 位 需要 软件 清 零 。 
RXAK(bit0): 应 答 信号 标志 位 ， 为 0 的 时 候 表示 接收 到 ACK 应 答 信号 ， 为 1 的 话 表示 检 
测 到 NO ACK 信和 号。 
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最 后 一 个 寄存 器 就 是 DCx I2DR， 这 是 I2C 的 数据 寄存 器 ， 此 寄存 器 只 有 低 S 位 有 效 ， 当 
要 发 送 数据 的 时 候 将 要 发 送 的 数据 写 入 到 此 寄存 器 ， 如 果 要 接收 数据 的 话 直 接 读 取 此 寄存 器 即 
可 得 到 接收 到 的 数据 。 

关于 DC 的 寄存 器 就 介绍 到 这 里 ， 关 于 这 些 寄存 器 详细 的 描述 ， 请 参考 《LMX6ULL 参考 
手册 》 第 1462 页 的 31.7 小 节 。 








26.1.3 AP3216C 简介 








LMX6U-ALPHA 开发 板 上 通过 PC1 连接 了 一 个 三 合 一 环境 传感器 : AP3216C, AP3216C 
是 由 敦 南 可 以 推出 的 一 款 传 感 器 ， 其 支持 环境 光 强 度 (ALS)、 接 近 距 离 (PS) 和 红外 线 强 度 (IR) 这 
三 个 环境 参数 检测 。 该 芯片 可 以 通过 IIC 接口 与 主 控 制 相连 ， 并 且 支 持 中 断 ，AP3216C 的 特点 
如 下 : 





























. DC 接口 ， 快 速 模式 下 波 特 率 可 以 到 400Kbit/S 

、 多 种 工作 模式 选择 : ALS、PS+IR、ALS+PS+IR、PD 等 等 。 
内 建 温度 补偿 电路 。 

、 宽 工作 温度 范围 (-30”C~+80”C)。 

、 超 小 封装 ，4.1mm x 2.4mm x 1.35mm 

、 环 境 光 传感器 具有 16 为 分 辨 率 。 

、 接 近 传 感 器 和 红外 传感器 具有 10 为 分 辩 率 。 

AP3216C 常 被 用 于 手机 、 平 板 、 导 航 设备 等 ， 其 内 置 的 接近 传感器 可 以 用 于 检测 是 否 有 物 
体 接近 ， 比 如 手机 上 用 来 检测 耳 条 是 否 接触 听 简 ， 如 果 检 测 到 的 话 就 表示 正在 打 电 话 ， 手 机 就 
会 关闭 手机 屏幕 以 省 电 。 也 可 以 使 用 环境 光 传 感 器 检测 光照 强度 , 可 以 实现 自动 背光 亮度 调节 。 
AP3216C 结构 如 图 26.1.3.1 所 示 ; 


























900000 
































A 


Upper / lower 
Threshold 


ALS/PS Control logic DC 
ADC Interface 
Timming ctl 
IREF | FOSC 


图 26.1.3.1 AP3216C 结构 图 

AP3216 的 设备 地 址 为 0X1E, 同 几乎 所 有 的 12C 从 器 件 一 样 ，AP3216C 内 部 也 有 一 些 寄存 
器 ， 通 过 这 些 寄存 器 我 们 可 以 配置 AP3216C 的 工作 模式 ， 并 且 读 取 相 应 的 数据 。AP3216C 我 
们 用 的 寄存 器 如 表 26.1.3.1 所 示 : 


二 X Hk Lb LI 
f) 4H fiir AM HI 


Si 


| 
| PS 
| 
| 


Ke 


r— 














000: fiHBRCRU). 


0X00 2:0 系统 模 
系统 模式 001: 使 能 ALS。 
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010: 使 能 PSHR. 
011: 使 能 ALS+PS+IR 。 
100: 软 复 位 。 
101: ALS 单 次 模式 。 
110: PSHR 单 次 模式 。 
111: ALS+PSHR 单 次 模式 。 
7 IR 低位 数据 0: [Rem 数据 有 效 ， 1: 无 效 
1:0 IR 最 低 2 位 数据 。 
0X0B 7:0 IR 高 位 数据 ”| IR 高 8 位 数据 。 
0X0C 7:0 ALS 低位 数据 | ALS 低 8 位 数据 。 
0X0D 7:0 ALS 高 位 数据 | ALS 高 8 位 数据 。 
7 0， 物 体 在 远离 ;， 1， 物 体 在 接近 。 
OXOE 6 PS 低位 数据 ”| 0，IR&PS 数据 有 效 ; 1, IR&PS 数据 无 效 
3:0 PS 最 低 4 位 数据 。 
7 0， 物 体 在 远离 ，1， 物 体 在 接近 。 
OXOF 6 PS 高 位 数据 ”| 0，IR&PS 数据 有 效 ; 1，IR&PS 数据 无 效 
5:0 PS 最 低 6 位 数据 。 














5 








PS 


和 IR 的 读 取 间 隔 最 少 要 112.5ms， 




















表 26.1.3.1 本 章 使 


适 的 工作 模式 ， 比 如 设置 为 0X03， 人 也 就 是 了 
保存 着 ALS、PS 和 IR 这 三 个 传感器 获取 到 的 数 和 
因为 AP3216C 完成 一 次 转换 需要 112.5ms 关于 AP3216C 
其 数据 手册 。 




















的 AP3216C 寄存 器 表 


























在 表 26.1.3.1 中 ，0X00 这 个 寄存 器 是 模式 控制 寄存 器 ， 用 来 设置 AP3216C 的 工作 模式 ， 
一 般 开 始 先 将 其 设置 为 0X04， 也 就 是 先 软 件 复位 一 次 AP3216C。 接 下 来 根据 实际 使 ) 
^M 














情况 选 





于 启 ALS+PS+IR。 从 0X0A-0XO0F 这 6 个 寄存 
值 。 如 果 同 时 打开 ALS. 














的 介绍 就 到 这 里 ， 如 果 要 想 详 细 的 研究 此 芯片 的 话 ， 请 大 家 自行 查阅 
本 章 实 验 中 我 们 通过 LMX6U 的 DPC1 来 读 取 AP3216C 内 部 的 ALS、PS 和 IR 这 三 个 传 感 




















器 的 值 ， 并 且 在 LCD EER. J 
器 ， 通 过 读 取 ID 寄存 器 判断 ID 

















于 机 会 先 检 测 AP3216C 
是 否 正 确 就 可 以 检测 芯片 是 



































是 否 存在 ， 一 

















役 的 芯片 是 有 个 ID 寄存 














TEE. d 





日 是 AP3216C 没有 ID 4j 




















存 器 ， 所 以 我 们 就 通过 向 寄存 器 0X00 写 入 一 个 值 ， 然 后 再 读 取 0X00 寄存 器 ， 判 断 读 出 得 到 值 
和 写 入 的 是 否 相 等 ， 如 果 相 等 就 表示 AP3216C 存在 ， 否 则 的 话 AP3216C 就 不 存在 。 本 章 的 配 


置 步骤 如 下 : 


1、 初 始 化 相应 的 IO 
初始 化 PC1 相应 的 IO， 设置 其 复 用 功 


置 AP3216C 的 中 断 IO. 
2、 初 始 化 DC1 





初始 化 PC1 接口 ， 设 置 波 特 率 。 


3、 初 始 化 AP3216C 


eu 
He， 


初始 化 AP3216C， 读 取 AP3216C 的 数据 。 


26.2 硬件 原理 分 析 





本 试验 用 到 的 资源 如 下 : 


Q、 指 示 灯 LED0。 


598 





p 








如 果 要 使 用 AP3216C 中 断 功能 的 话 ， 还 需要 设 


LMX6U SA XR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教学 : www.yuanzige.com 论坛 :www.opendev.com 


Q. RGBLCD 屏幕 。 

®©, AP3216C 

D, mH 

AP3216C 是 在 L.MX6U-ALPHA 开发 板 底板 上 ， 原 理 图 如 图 26.2.1 所 示 : 
ENE J2 34 UART4 RXD 


2 J2 33 UART4 TXD DCI SCL 





























DCDC 3V3 U8 








SCL 
GND 
LEDA 


DE a e 


图 26.2.1 AP3216C 原理 图 
从 图 26.2.1 可 以 看 出 AP3216C 使 用 的 是 DZC1， 其 中 IC1 SCL 使 用 的 UART4 RXD 这 个 
IO. D2C1 SDA 使 用 的 是 UART4_TXD 这 个 IO. 


26.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 18 i2c. 

本 章 实验 在 上 一 章 例 程 的 基础 上 完成 ， 更 改 工 程 名 字 为 “ap3216c”， 然 后 在 bsp 文件 夹 下 
创建 名 为 “i2c” 和 “ap3216c” 的 文件 。 在 bsp/i2c 中 新 建 bsp_ i2c.c 和 bsp_i2c.h 这 两 个 文件 ,在 
bsp/ap3216c 中 新 建 bsp ap3216c.c fl bsp ap3216c.h 这 两 个 文件 bsp i2c.c 和 bsp i2c.h 是 ILMX6U 
的 PC 文件 ，bsp_ap3216c.c 和 bsp ap3216c.h 是 AP3216C 的 驱动 文件 。 在 bsp_i2c.h 中 输入 如 
下 内 容 : 




































































示例 代码 26.3.1 bsp_i2c.h 文件 代码 





1 4ifndef BSP I2C H 

2 $define BSP I2C H 

3 J[KCKCKCKCKCKCkCk KCkCk kCkCk kCKCKCkCKCkCk KC k KCKCK kk kk KCKCk kCkCkCkCkCk Ck kCk Ck k k ck kck k k k kc kckck ck kok 
4 Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
5 Xz : bsp i2c.h 

6 frt : 左 忠 凯 

7 版 本 I 

8 描述 ee 

o 其 他 IE 

10 论坛 : www.openedv.com 

11 Eb : WIR v1.0 2019/1/15 左 忠 凯 创建 

Qo KOKCK Kk ok K KK Kk oko K KK kk ok A KK KO KICK KOC Ko KOK Kee kk Kok k eee kei kx / 
dpa dc Memo 

14 

15 WW HOS qe 

le poetine JE2C STATUS (OEC (0) 
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17 #define I2C STATUS BUSY (1) 

18 4define I2C STATUS IDLE (2) 

19 #define I2C STATUS NAK (3) 

20 #define I2C STATUS ARBITRATIONLOST (4) 

21 #define I2C STATUS TIMEOUT (5) 

22 $define I2C STATUS ADDRNAK (6) 

23 

24 /* 

25 * I2C 方向 枚 举 类 型 

26. f 

27 enum 126 direction 

28 ( 

29 kI2C Write = 0x0, /* 主机 向 从 机 写 数据 */ 
30 kI2C Read = Ol, /* 主机 从 从 机 读数 据 */ 
Sal lip 

32 

N 

34 * 主机 传输 结构 体 

SE 

Je Seno İZE transter 

SI l 

38 unsigned char slaveAddress; /* 7 位 从 机 地 址 e 
219 enun 126 direction direction; /* 传输 方向 A 
40 unsigned int subaddress; /* 寄存 器 地 址 A 
41 unsigned char subaddressSize; /* 寄存 器 地 址 长 度 — */ 
42 unsigned char *volatile data; /* 数据 缓冲 区 ef 
43 volatile unsigned int dataSize; /* 数据 缓冲 区 长 度 */ 
aa g 

45 

46 /* 

47 *g EH 

48. w 

49) voici 12e imirt (I2C Type Dass) s 




















50 unsigned! Char i20 master start (12C Type lesse. 
unsigned char address, 
conum 12G direction Ciresction)) p 
Sues ehar i20 master repeats stert (I2C_ Type vbase, 
unsigned char address, 
cavum ab2( direction direction) 
52 unsignecl char i20 Check and cles error(I2C Type base; 
unsigned int status); 
Eumene Char i26 master stoolIzC Type base)? 


54 VOLC 12e mester write(Iz2C Tyga base, Const neionee enar fex, 
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unsigned int size); 


55 vorc i20 mester no are (HE? MT NET rs e ln TS Beamer Mia S MIO EF 

unsigned int size); 
Eogmsitem eile mai e mars relier are s (STEP e Type “oase, 

gtrüct 12e trensier wrer)? 

597 
58 #endif 
第 16 到 22 行 定义 了 一 些 I2C 状态 相关 的 宏 , 第 27 到 31 行 定义 了 一 个 枚 举 类 型 i2c_direction， 
此 枚 举 类 型 用 来 表示 DC. 主机 对 从 机 的 操作 ， 也 就 是 读数 据 还 是 写 数据 。 第 36 到 44 行 定义 了 
一 个 结构 体 i2c_transfer， 此 结构 体 用 于 DC 的 数据 传输 。 剩 下 的 就 是 一 些 函数 声明 了 ， 总 体 来 
说 bsp_i2c.h 文件 里 面 的 内 容 还 是 很 简单 的 。 接 下 来 在 文件 bsp_i2c.c 里 面 输入 如 下 内 容 : 

示例 代码 26.3.2 bsp. i2c.c 文件 代码 


/大 炎炎 火 大 火炎 大大 炎炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大大 火炎 大 大 























Geoy one eonek ee v uo EMI IBS ES TO ELO O M E ene Ma n a To n 
文件 名 -See 


作者 : 左 忠 凯 
版 本 E Wibs 
描述 : IIC BAUM. 
其 他 SEE 
论坛 : www.openedv.com 
RE : 初版 V1.0 2019/1/15 左 忠 凯 创建 


KCKCKCkCkCKCk kCk ck k kk k kCk Ck k Ck Ck kk k k kc k k kc k k kCk Ck kk k k kc k k kk kck ck kckck ck kckck ckck ck ckckck kk e ke kx / 


JL qraamelbwrke "Seg. 261. 


2 finclude "bsp delay.h" 

3  4include "stdio.h" 

4 

Gy eget: 

6 x Qdescription : 初始 化 I2C， 波 特 率 100KHZ 
7 * (param - base : 要 初始 化 的 IIC 设置 
8 * @return B ZB 

9 A) 

IO voici 12e imit(I2¢ Type ioese 

"BN 

12 TOT NETS. 


13 base-»I2CR &- «(1 «« 7); /* Xj r2C HJERAESS,. Bi^nm EA XH]I2C */ 


15 /* 设置 波 特 率 为 100K 


16 * I2C 的 时 钟 源 来 源 于 IPG CLK ROOT-66Mhz 
157 * IFDR 设置 为 0X15， 也 就 是 640 分 频 ， 

18 * 66000000/640=103.125KHzx100KHz。 
19 mu 

20 base-»IFDR = 0X15 << 0; 

21 
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22 /* 设置 寄存 器 I2CR， 开 启 I2C */ 

23 base-»I2CR |= (1««7); 

24 ) 

2:5, 

DIGNE ES 

27  * Qdescription : 发 送 重 新 开始 信号 
28  * Qparam - base : 要 使 用 的 IIC 

29  * Qparam - addrss : 设备 地 址 

30  * Qparam - direction : 方向 

31  * Qreturn : 0 正常 其 他 值 出 错 
S2 — wj 


J unsignec char 12e master repeatet! re HS (I2C_Type Hbase, 
unsigned char address, 


enum 12e chiste: ee em) 























34 ( 

35 /* I2C 忙 并 且 工 作 在 从 模式 ,跳出 */ 

36 if(base-»I2SR & (1 << 5) && (((base->I2CR) & (1 << 5)) == 0)) 

39] return |; 

38 

oo fs 

40 * 设置 寄存 器 I2CR 

41 Fb SI SE 

42 * bit[2]: 1 产生 重新 开始 信号 

43 A, 

44 base-»I2CR | (1««4) | (1 «« 2); 

45 

46 1E 

47 * 设置 寄存 器 I2DR，bit[7:0] : 要 发 送 的 数据 ， 这 里 写 入 从 设备 地 址 

48 

49 base->I2DR = ((unsigned int)address << 1) | 
((direction => kI2C Read)? 1 : 0); 

50 return 0; 

I a) 

52 

BS e 

54  * @description : 发 送 开 始 信和 号 

55  * (param - base : 要 使 用 的 IIC 

56  * Qparam - addrss : 设备 地 址 

57  * Qparam - direction : 方向 

58  * Qreturn : 0 正常 其 他 值 出 错 

59 e 


GONE SStenesliei mbi? e lmalsrs ona Start(I2C Tyoe “base, 


unsigned char address, 
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entum 126 ene ee ee em) 








61 { 

62 if (base->I2SR & (1 << 5)) pe eu wy 

63 return |; 

64 

65 Js 

66 * 设置 寄存 器 I2CR 

67 * bit[5]: 1 主 模式 

68 o bielas 1 发 送 

69 x 

70 base-»I2CR |= (1 << 5) | (1 «« 4); 

FA 

pe f 

73 * 设置 寄存 器 I2DR，bit[7:0] : 要 发 送 的 数据 ， 这 里 写 入 从 设备 地 址 

74 

J75 base->I2DR = ((unsigned int)address << 1) | 
((direction == kI2C Read)? 1 : 0); 

76 return 0; 

ME 

78 

WS. qne 

80  * Qdescription : 检查 并 清除 错误 

81  * Qparam - base : 要 使 用 的 IIC 

82 = bparam = status : 状态 

83  * Qreturn : 状态 结果 

94  */ 


95 ungigned Char 12e Check end clear error (2C Tygwe osse. 


unsigned int status) 





86 ( 

87 if(status & (1««4)) /* 检查 是 否 发 生 仲裁 丢失 错误 */ 
88 { 

89 base->I2SR &= «(1««4); /* 清除 仲裁 丢失 错误 位 E 
90 base-»I2CR &= «(1 << 7); J a] TZE */ 
91 base-»I2CR | (1 «« 7); /* 重新 打开 I2C */ 
92 return I2C STATUS ARBITRATIONLOST; 

93 } 

94 else if(status & (1 << 0)) /* 没有 接收 到 从 机 的 应 答 信 号 */ 
95 { 

96 return I2C STATUS NAK; /* 返回 NAK(No acknowledge) */ 
97 } 

98 return I2C STATUS OK; 

99 } 

100 
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OML S 

102 * Qdescription s lefe = 

103 * QGparam - base : 要 使 用 的 IIC 

104 * Qparam 8 3E 

105 * Greturn : 状态 结果 

OEC 

140 7 unsignec! cher 126 master SEOD(u2( Type Hbase) 

WOS N 

109 unsigned short timeout - OXFFFF; 

110 

Ii /* me I2CR HJ Lele a */ 

112 base->I2CR &= ~((1 << 5) | (1 << 4) | (1 << 3)); 
113 while((base-»12SR & (1 << 5))) /* 等 待 忙 结束  */ 
114 { 

IS timeout--; 

116 su2(üpimexO he Ex O) /* 超时 跳出 5f 
3 return I2C STATUS TIMEOUT; 

118 } 

TALS) return I2C STATUS OK; 

12023 

31240 

TAZ qus 

123 * Qdescription : 发 送 数据 

124 * SS : 要 使 用 的 IIC 
SWISS : 要 发 送 的 数据 

126 * (param - size : 要 发 送 的 数据 大 小 

127 * @param - flags : Pas 

125 è reruma 3 JE 

MAL me 


130 void 12e magter wreite(I2C_ Type vbase, COnst uncignet char Agut, 


unsigned int size) 


Ta 1 

132 while(!(base-»I2SR & (1 << 7))); /* 等 待 传输 完成 */ 
133 base-»I2SR &2 «(1 << 1); /* 清除 标志 位 */ 
134 base-»I2CR |= 1 << 4; /* 发 送 数据 m 
1L 355 while (size--) 

136 ( 

137 base-»I2DR = *buf-t; /* 将 buf 中 的 数据 写 入 到 I2DR 寄存 器 */ 
138 while(!(base-»I2SR & (1 << 1)));  /* 等 待 传输 完成 */ 
139 base->I2SR &= ~(1 << 1); /* 清除 标志 位 */ 
140 

141 /* 检查 ACK */ 

T42 ie (i2e Check anc) Clear Srror (oase; base->I28R)) ) 
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IS break; 

144 } 

145 base->I2SR &= ~(1 << 1); 

146 i2c master stop (base) 7 /* 发 送 停止 信号 */ 
147 } 

148 

TAST 

150 * Qdescription : 读 取 数 据 

151 * Qparam - base : 要 使 用 的 IIC 

192 w (Wesce = Itur : 读 取 到 数据 

153 * Gparam - size : 要 读 取 的 数据 大 小 

154 * Qreturn 3 JE 

SS 


lat void 12e master reac(I2C Type Vbag; wmsiicaeo! char wout, 


unsigned int size) 


dT o 

JUS volatile winte t dummy = 0; 

TSS 

160 dummy++; /* 防止 编译 报错 eh 
161 while (! (base->I2SR & (1 << 7)));  /* 等 待 传输 完成 vy 
162 base-»I2SR &= «(1 << 1); /* 清除 中 断 挂 起 位 。 */ 


163 base-»I2CR &= ~((1 << 4) | (1 << 3));  /* 接收 数据 */ 
164 if (size == 1) /* 如 果 只 接收 一 个 字 节 数据 的 话 发 送 NACK 信号 */ 


165 Hase >T2CR IS (1 «« 3); 

166 

167 dummy = base->I2DR; /* 假 读 x 
168 while (size--) 

169 { 

170 while(!(base-»128R & (1 << 1)));  /* 等 待 传输 完成 */ 
TRE base-»I2SR &2 «(i << 1); /* 清除 标志 位 */ 
2 

173 if (size == 0) 

174 12€ master eae /* 发 送 停止 信号 */ 
dS if(size == 1) 

176 base-»I2CR |» (1 «« 3); 

Abg s *buf++ = base-»2I2DR; 

178 } 

IINE) 

180 

Iei /S 

182 * @description  : I2C 数据 传输 ， 包 括 读 和 写 

183 * Qparam - base : 要 使 用 的 IIC 

184 * Qparam - xfer : 传输 结构 体 


605 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
185 * @return : 传输 结果 ,0 成 功 ， 其 他 值 失败 ; 
186 */ 


lal unsigned) Char 12E mester trenster (T20 Type oase, 


otruct i26 transter zier) 


188 ( 

189 unsigned char ret = 0; 

1S0 enum 126 cirection cdirscrtion — ster <U rection; 

dit 

192 base-»I128R &= «(( << 1) | (1 << 2)); /* mR  */ 

193 while(!((base-»I2SR >> 7) & 0X1)){}; /* 等 待 传输 完成 */ 

194 /* 如 果 是 读 的 话 ， 要 先 发 送 寄存 器 地 址 ， 所 以 要 先 将 方向 改 为 写 */ 

195 if ((xfer->subaddressSize > 0) && (xfer->direction == 

kI2C Read)) 

196 cdhirsction 3 kI2C Weite; 

197 ret = i269 mester start (base, zieu-cslewsBolhress, chireciuuiom) p 

198 if (ret) 

199 return ret; 

200 while (! (base->I2SR & (1 << 1))){}; /* 等 待 传输 完成 */ 

20m ret = 12e Check end clear error (base, Dase=->T2SR)) ? 

202 if (ret) 

208 { 

204 i2c master stop (base); /* /| */ 

205 return ret; 

206 } 

207 

208 /* 发 送 寄存 器 地 址 */ 

209 if(xfer-»subaddressSize) 

2O { 

Panl do 

2002 { 

DIS base-»I2SR &= «(1 << 1); /* 清除 标志 位 */ 

214 xfer-»subaddressSize--; /* 地 址 长 度 减 一 */ 

205 base->I2DR = ((xfer->subaddress) >> (8 * 
xfer-»subaddressSize)); 

216 while(!(base-»12S8R & (1 << 1)));  /* 等 待 传输 完成 */ 

28 /* 检查 是 否 有 错误 发 生 */ 

218 ret = 2e Check and clear error (oase, vsse--I258) 7 

219 if(ret) 

220 { 

Aail 12e master etap (oase)? /* side a */ 

2 return ret; 

209 } 

224 } while ((xfer->subaddressSize > 0) && (ret == 
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I2C STATUS OK)); 





215 

226 if(xfer-»direction = kI2C Read) /* 读 取 数 据 2 

228 { 

228 base-»I2SR &= ~(1 << 1); /* 清除 中 断 挂 起 位 */ 

207219] 120 master repeated stari (base, ter- >slaysNdidress, 
kI2C Read); 

230 while (! (base->I2SR & (1 << 1)))0(); /* 等 待 传输 完成 */ 

Zl 

232 /* 检查 是 否 有 错误 发 生 */ 

26B ret c 328 check and clear error (base, Base->129R) p 

234 if (ret) 

285 { 

29/6 ret — I2C STATUS ADDRNAK; 

PII i2c master stop(base); /* AX dls S */ 

298 return ret; 

289 } 

240 } 

241 } 

242 

243 /* 发 送 数据 */ 

244 if ((xfer-»direction == kI2C Write) && (xfer-»dataSize » 0)) 

245 12€ mester wuite(lssse, Xier-~data, xiez-deutssuime)? 

246 /* 读 取 数 据 */ 

247 if ((xfer-»direction = kI2C Read) && (xfer-»dataSize » 0)) 

248 12€ master read (base, ema 

249 return 0; 

2500) 


文件 bsp_i2c.c 中 一 共有 8 个 函数 ,我 们 依次 来 看 一 下 这 些 函 数 的 功能 , 首先 是 函数 i2c_init， 

函数 用 来 初始 化 DPC， 重点 是 设置 DC 的 波 特 率 ， 初 始 化 完成 以 后 开启 DC。 第 2 个 函数 是 
De meo pot su IMPER. 个 重复 开始 信号 , 发送 开 始 信号 的 时 候 也 会 顺带 发 
送 从 设备 地 址 。 第 3 个 函数 是 i2c master start， 此 函数 用 于 发 送 一 个 开始 信号 ， 发 送 开 始 信和 号 
的 时 候 也 顺带 发 送 从 设备 地 址 。 第 4 个 函数 是 i2c check and clear error， 此 函数 用 于 检查 并 清 
除 错误 。 第 5 个 函数 是 i2c_master_stop， 用 于 产生 一 个 停止 信号 。 第 6 和 第 7 个 函数 分 别 为 
i2c master write 和 i2c master read， 这 两 个 函数 分 别 用 于 完成 癌 PC 从 设备 写 数据 和 从 DPC 从 
设备 读数 据 。 最 后 一 个 函数 是 ic master transfer， 此 函数 就 是 用 户 最 终 调用 的 ， 用 于 完成 DC 
通信 的 函数 ， 此 函数 会 使 用 前 面 的 函数 拼凑 出 2C 读 / 写 时 序 。 此 函数 就 是 按照 26.1.1 小 节 讲 解 
的 I2C 读 写 时 序 来 编写 的 。 

DC 的 操作 函数 已 经 准备 好 了 , 接 下 来 就 是 使 用 前 面 编写 I2C 操作 函数 来 配置 AP3216C T, 
配置 完成 以 后 就 可 以 读 取 AP3216C 里 面 的 传感器 数据 ， 在 bsp_ap3216c.h 输入 如 下 所 示 内 容 : 

示例 代码 26.3.3 bsp_ap3216c.h 文件 代码 

1 #ifndef BSP AP3216C H 
2 #define BSP AP3216C H 
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3 J[KCKCKCKCKCKCkCk KCkCk kk kk kCKCkCk KC KC kCKCK kCKCK KC KCkCkC ECC k CC KC kCKCKC KC KC Ck kCkck kokck k kc kckckck ck kok 
4 Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
5 文件 名 : bsp ap3216c.h 

6 fr : 左 忠 凯 

7 版 本 8 Wl 

8 d : AP3216C PRAI 

o 其 他 TE 

10 i&dx : www.openedv.com 

131 Eis : 初版 V1.0 2019/3/26 左 忠 凯 创建 





1157 CKCKCKCKCKCkCkCkCk Ck k Ck k Ck k Ck k Ck k Ck k k Ck k Ck k Ck Ck kCk Ck k kCk Ck k Ck k k Ck Ck k k k ck k ck ck kck ck ck ckck kokckok X kx k f 


Se heel orm; es dn 








14 

15 #define AP3216C ADDR OXIE /* AP3216C 器 件 地 址  */ 
16 

17 /* AP3316C 寄存 器 */ 

18 4define AP3216C SYSTEMCONG 0x00 /* 配置 寄存 器 2 
19 4define AP3216C INTSTATUS 0x01 /* 中 断 状态 寄存 器 P 
20 4define AP3216C INTCLEAR 0x02 /* 中 断 清 除 寄存 器 E 
21 £&define AP3216C IRDATALOW ”0x0A /* IR 数据 低 字 节 ay 
22 #define AP3216C_IRDATAHIGH 0x0B /* IR 数 据 高 字 节 à 
23 #define AP3216C ALSDATALOW 0x0C è /* ALS 数据 低 字 节 xí 
24 4define AP3216C ALSDATAHIGH 0X0D /* ALS 数据 高 字 节 ui 
25 #define AP3216C PSDATALOW 0X0E /* PS 数据 低 字 节 ^u 
26 4define AP3216C PSDATAHIGH  OxOF /* PS 数据 高 字 节 = 
27 


28 /* RAAH */ 

200 usomee Char ee (Voie) 9 

30 unsigned char ap3216c readonebyte(unsigned char addr, 

unsigned char reg); 

31 unsigned char ap3216c writeonebyte (unsigned char acele, 
unsigned char reg, 
unsigned char data); 

32 VOLC lem cele us short wir, unsigned! SNOTE WIS 

unsigned short *als); 

58 

34 #endif 

第 45 到 26 行 定义 了 一 些 宏 ， 分 别 为 AP3216C 的 设备 地 址 和 寄存 器 地 址 ， 剩 下 的 就 是 函 

数 声明 。 接 下 来 在 bsp ap3216c.c 中 输入 如 下 所 示 内 容 : 

示例 代码 26.3.4 bsp. ap3216c.c 文件 代码 


J[ ECKCKCKCKCKCKCkCK Kk Ck kk kk Ck Kk k kk kCk Ck Ck k Ck k k Ck Ck k k Ck k K Ck k k Ck k Kk Ck k k ck ck k ck ck kkk kkk kk kk 





Copy ioNe (GO. zozneonore (Clero rom 3999220) 1: 6) ons eer eo 
文件 名 8 loe scug32l €. 
作者 : 左 忠 凯 
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版 本 a “Wad 

描述 : AP3216C 驱动 文件 。 

其 他 SUE 

论坛 : www.openedv.com 

目 志 : 初版 V1.0 2019/3/26 左 忠 凯 创建 

IL lll... :: :: ] 
i teamed tele es ee 

2 — /lel 

3  f£include "bsp delay.h" 

Aine lude Mec ni 

5  £$include "stdio.h" 

6 

Wo ge 

8 * QGdescription : 初始 化 AP3216C 

9 * (üparam s JE 

TO ARTETU : 0 成 功 ， 其 他 值 错误 代码 

ia ep 

>see mee char eus imie (roich 

ds. 

14 unsigned char data = 0; 

15 

16 /* 1. TOHIR, BOE 2C TO 属性 

L7 * T2CI SCL => VARTA TXD 

18 * I2C1 SDA -» UART4 RXD 

1L) v 

20 IOMUXC SetPinMux(IOMUXC UART4 TX DATA I2C1 SCL, 1); 
Pt IOMUXC SetPinMux(IOMUXC UART4 RX DATA I2C1 SDA, 1); 
27 IOMUXC SetPinConfig(IOMUXC UARTA TX DATA I2C1 SCL, 0x70B0) ; 
23 IOMUXC SetPinConfig(IOMUXC UART4 RX DATA I2C1 SDA, 0X70B0); 
24 

Db /* 2. ME I2C1 */ 

26 i2 amat (0521) p 

2 

28 /* 3、 初 始 化 AP3216C — */ 

29 /* 复位 AP3216C 27 

30 ap3216c writeonebyte(AP3216C ADDR, AP3216C SYSTEMCONG 
31 delayms(50); /* AP33216C 复位 至 少 10ms */ 

92 

35 /* 开启 ALS. PS+IR */ 

34 ap3216c writeonebyte(AP3216C ADDR, AP3216C SYSTEMCONG 
25 

36 /* 读 取 刚刚 写 进去 的 0x03 */ 

3i data = ap3216c readonebyte(AP3216C ADDR, AP3216C SYST 
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38 if(data == 0x03) 

39 return 0;  /* AP3216C 正常 */ 

40 else 

41 return 1;  /* AP3216C 失败 mul 

42 ) 

43 

44 * 

45  * Qdescription  : [Hj AP3216C 写 入 数据 


46  * Qparam - addr : 设备 地 址 

47 * (üiparam - reg : 要 写 入 的 寄存 器 

48 * Qparam - data : 要 写 入 的 数据 

Ao) a Eeri : 操作 结果 

50:7 

51 unsigned char ap3216c writeonebyte(unsigned char addr, 
unsigned char reg, 


unsigned char data) 








52 

59 unsigned char status=0; 

54 unsigned char writedata=data; 

55 otruct 126 transter masterxter; 

56 

59 /* 配置 I2C xfer 结构 体 */ 

58 masterxter slaveaddress = addre /* 设备 地 址 "d 
59 masterXfer.direction 2 kI2C Write; /* *5AJWdE Ey 
60 masterXfer.subaddress = reg; /* 要 写 入 的 寄存 器 地 址 e 
61 masterXfer.subaddressSize = 1; /* 地 址 长 度 一 个 字 节 a 
62 masterXfer.data = &writedata; /* 要 写 入 的 数据 pU 
63 üesterxter.datasigse = p /* 写 入 数据 长 度 1 个 字 节 */ 
64 

65 actin» ceamarerseltem mers era (H8? nal en en 

66 statuszi!; 

6m 

68 return status; 

$9 q 

70 

"ELS 

72  * (description : 从 AP3216C 读 取 一 个 字 节 的 数据 


73  * Qparam - addr : 设备 地 址 

74 * (üiparam - reg : 要 读 取 的 寄存 器 

75 * (üireturn : 读 取 到 的 数据 。 

SR 

77] unsigned char ap3216c readonebyte (unsigned char addr, 


unsigned char reg) 


610 


LMX6U S XR Linux 驱动 开发 指南 O ERAF 











原子 哥 在 线 教学 : www.yuanzige.com 论坛 :Www.opendev.com 
ze. d 
Jo unsigned char valz0; 
80 
81 otruct 312(8 transter wesitezXe 
82 masterXfer.slaveAddress = addr; /* 设备 地 址 
83 masterXfer.direction = kI2C Read; /* 读 取 数据 
84 masterXfer.subaddress = reg; /* 要 读 取 的 寄存 器 地 址 ay 
85 masterXfer.subaddressSize = |; /* 地 址 长 度 一 个 字 节 AU, 
86 masterXfer.data = &val; /* 接收 数据 缓冲 区 
87 前 二 SEESEXESE_ dataSize 5 |? /* 读 取 数据 长 度 1 个 字 节 */ 
88 12e mester transier(T2Cl, Cuumuteriuer)r 
89 
90 return val; 
Su 
92 
Sep fes 
94  * Qdescription  : 读 取 AP3216C 的 原始 数据 ， 包 括 ALS,PS 和 IR， 注 意 ! 如 果 
95 * :同时 打开 ALS, IR+PS 两 次 数据 读 取 的 时 间 间 隔 要 大 于 112. 5ms 
96  * Qparam - ir : ir Zt 
97  * (param - ps : ps 数据 
98  * (param - ps : als 数据 
99  * Qreturn ES 
io) sy 
1(01. yoicd ese ns ne wir, Ungignet! Short Ue 
unsigned short *als) 
WO2 
WOS unsigned char buf[6]; 
104 unsigned char i; 
105 
106 /* 循环 读 取 所 有 传感器 数据 */ 
107 for(i = 0; i < 6; i++) 
108 { 
109 buf[i] = ap3216c readonebyte(AP3216C ADDR, 
AP3216C IRDATALOW -* i 
TAO } 
Jal 
il if(buf[0] & 0X80) /* IR OF 位 为 1, 则 数据 无 效 */ 
TIS žin = 0 
qot else /* 读 取 IR 传感器 的 数据 27 
IAS *ir — ((unsigned short)buf[1] «« 2) | (buf[0] & 0x03); 
HIIS 
117 cale = ((unsigned short)buf[3] «« 8) | bu£[2];/* EALS Atii */ 


118 
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119 if(buf[4] & 0x40) /* IR OF 位 为 1, 则 数据 无 效 */ 

120 *ps = 0; 

121 else /* 读 取 PS 传感器 的 数据 = 

122 *ps = ((unsigned short) (buf[5] & 0X3F) << 4) | 


(buf[4] & OXOF); 


123 ) 

















文件 bsp_ap3216c.c 里 面 共 有 4 个 函数 ， 第 1 个 函数 是 ap3216c init， 顾 名 思 义 ， 此 函数 用 





于 初始 化 AP3216C， 初 始 化 成 功 的 话 返 回 0， 如 果 初 始 化 失败 就 返回 其 他 值 。 此 函数 先 初始 化 
所 使 用 到 的 IO， 比 如 初始 化 DCI 的 相关 IO, 并 设置 其 复 用 为 DC1. 然后 此 函数 会 调用 i2c_init 
来 初始 化 DC1， 最 后 初始 化 AP3216C。 第 2 个 和 第 3 个 函数 分 别 为 ap3216c_writeonebyte 和 
ap3216c readonebyte， 这 两 个 函数 分 别 是 向 AP3216C 写 入 数据 和 从 AP3216C 读 取 数据 。 这 两 
个 函数 都 通过 调用 bsp_i2c.c 中 的 函数 ic_master transfer 来 完成 对 AP3216C 的 读 写 。 最 后 一 个 
函数 就 是 ap3216c_readdata， 此 函数 用 于 读 取 AP3216C 中 的 ALS、PS 和 IR 传感器 数据 。 











最 后 在 main.c 中 输入 如 下 代码 : 
示例 代码 26.3.5 main.c 文件 代码 


J[ FCKCKCKCKCKCKCkCK Kk kk kk Ck Ck KCkCk kk kCk Ck kCk Ck ck k Ck Ck k k Ck k k Ck k Kk k k ck ck k ck ck k ck ckck ck kck ck kk kk 


Goby Ee OonoleET Cor Medni oe 0M ns ee seme 























文件 名 mian.c 

作者 : 左 忠 凯 

版 本 g WIL.) 

i 述 : I.MX6U 开发 板 裸 机 实验 18 IIC 实验 

其 他 : IIC 是 最 常用 的 接口 ，ALPHA 开发 板 上 有 多 个 IIC 外 设 ， 本 实验 就 
来 学 习 如 何 驱动 工 .MX6U 的 IIC 接口 ， 并 且 通 过 rrc 接口 读 取 板 载 
AP3216C 的 数据 值 。 

论坛 : www.openedv .com 

[isis : 初版 V1.0 2019/1/15 左 忠 凯 创建 


KCKCKCKCKCKCKCkCk kCkCk kCkCk Ck k kCk kCk ck k kc k k kc k Ck kc k Ck kCk Ck k kc k k kc k Ck kc k Ck kck ck kck ck ckck ck ckckck sk ck k kx f 


14 
ils 
16 


finclude "bsp clk.h" 
finclude "bsp delay.h" 
*include "bsp led.h" 
finclude "bsp beep.h" 
finclude "bsp key.h" 
finclude "bsp int.h" 
*include "bsp uart.h" 
finclude "bsp lcd.h" 





#include "bsp rtc.h" 


finclude "bsp ap3216c.h" 
finclude "stdio.h" 

/* 

* Qdescription : main 函数 
* Qparam S JE 

* Qreturn 8 JÈ 
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ID wy 
18 int main(void) 
dy i 
20 unsigned short ir, als, ps; 
zl unsigned char state - OFF; 
2g 
23 UTEM) /* 初始 化 中 断 (一 定 要 最 先 调用 ! ) */ 
24 imx6u clkinit(); /* 初始 化 系统 时 钟 wp 
25 delay init(); /* 初始 化 延 时 n 
26 clk enable(); /* 使 能 所 有 的 时 钟 i 
e led init(); /* 初始 化 led n 
28 beep init(); /* 初始 化 beep A 
29 ueart init (h) 8 /* 初始 化 串口 ， 波 特 率 115200 7 
30 leel imien) p /* 初始 化 LCD i 
Sul 
32 ieRedtedadeversoreeoltoT] e DESEE 
ES ille wal nee o (690 ESTO NEP OP MNT CMT CU 
(char*)"ALPHA-IMX6U IIC TEST"); 

34 le) ymo encsheg((s0, 705 200. i$, (ne) NSSZIGC SH p 
25 Hedis now see (5 OPEP EPIO (man TEOM CATENE 
36 Is 
37 
38 while(ap3216c init()) /* 检测 不 到 AP3216C d 
29 { 
40 iecdisnhovisteingiCOnRBO 0 195 ep 

(char*)"AP3216C Check Failed!"); 
41 delayms (500); 
42 lel soy enEx3ueg (305 190, 2005 JG, 165 

(char*)"Please Check! wyss 
43 delayms (500); 
44 } 
45 
46 Se 
47 lel simewy enexsineg((s 0, 1505 2005 i55 i5, (elec) ig yg 
48 lel mümey neresheg((s0 5 1/90 200, i5, i$, (emen) ES3")g 
49 lel sime sesneg((s5 20905 200, JG. l5, (emet) ss 
50 tftlcd dev.forecolor - LCD BLUE; 
SA while(!) 
52 { 
53 ap3216c readdata(&ir, &ps, &als); /* 读 取 数据 wi 
54 lcd shownum(30 + 32, 160, ir, 5, 16); /* 显示 IR 数据 */ 
55 led shownum(30 + 32, 180, ps, 5, 16); /* 显示 PS 数据 */ 
56 led shownum(30 + 32, 200, als, 5, 16); /* 显示 ALS 数据 */ 
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ST delayms (120); 

58 state = !state; 

59 led switch(LEDO0,state); 

60 } 

61 return 0; 

62 ) 


第 38 行 调用 ap3216c init 来 初始 化 AP3216C， 如 果 AP3216C 初始 化 失败 的 话 就 会 进入 循 
环 , 会 在 LCD 上 不 断 的 闪烁 字符 串 “AP3216C Check Failed!” 和 “Please Check!” 直到 AP3216C 
初始 化 成 功 。 

第 53 行 调用 函数 ap3216c readdata 来 获取 AP3216C 的 ALS, PS 和 IR 传感器 数据 值 ， 获 
取 完 成 以 后 就 会 在 LCD 上 显示 出 来 。 

文件 main.c 里 面 的 内 容 总 体 上 还 是 很 简单 的 ， 实 验 程 序 的 编写 就 到 这 里 。 


26.4 编译 下 载 验证 
26.4.1 编写 Makefile 和 链接 脚本 


修改 Makefile 中 的 TARGET 为 ap3216c, 然后 在 在 INCDIRS 和 SRCDIRS 中 加 入 “bsp/i2c” 
和 “bsp/ap3216c”， 修 改 后 的 Makefile 如 下 : 
示例 代码 26.4.1.1 Makefile 文件 代码 
























































1 CROSS COMPILE ?-2 arm-linux-gnueabihf- 
2 TARGET p= aps2l6e 

S 

4 /* ARMER ERE. ^ 

5j 

6. INCDIRS :2 imx6ul N 

7) stdio/include Y 
8 [Se 

9 bsp/led WV 

10 bsp/delay \ 

dtl bsp/beep \ 

112 bsp/gpio \ 

1L bsp/key V 

14 bsp/exit 

I bsp/int V 

16 bsp/epittimer 
jg bsp/keyfilter \ 
18 bsp/uart \ 

19 bsp/lcd V 

20 DEP TECEN 

21 BSP Tae NN 

22 bsp/ap3216c 

23 

24 SRCDIRS se jqexeyect \ 
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25 stdio/lib y 

26 bsp/clk V 

27 bsp/led \ 

28 bsp/delay N 

29 bsp/beep V 

30 bsp/gpio WV 

Sl bsp/key \ 

92 bsp/exit \ 

23 go/ int Y 

34 bsp/epittimer \ 
25 bsp/keyfilter \ 
36 bsp/uart \ 

E bsp/lcd WV 

38 loe rte Y 

39 loxegow/sb2e 

40 bsp/ap3216c 

41 

42 /* EM 2 

43 

44 clean: 


dm STARCE Me lre CARCER) dis I S CTARGET) E Hini S (COBUS) S (SOBIS) 
第 2 行 修改 变量 TARGET 为 “ap3216c”， 也 就 是 目标 名 称 为 “ap3216c”。 
第 21 和 22 行 在 变量 INCDIRS 中 添加 I2C 和 AP3216C 的 驱动 头 文件 (.h) 路 径 。 
第 39 和 40 行 在 变量 SRCDIRS 中 添加 I2C 和 AP3216C 驱动 文件 (.c) 路 径 。 
链接 脚本 保持 不 变 。 



































26.4.2 编译 下 载 


使 用 Make 命令 编译 代码 ， 编 译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 ap3216c.bin 
文件 下 载 到 SD 卡 中 ， 命 令 如 下 ; 












































chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 
./imxdownload ap3216c.bin /dev/sdd / 烧 写 到 SD 卡 中 
烧 写 成 功 以 后 将 SD 卡 揪 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 。 程 序 运 行 以 后 LCD 

















界面 如 图 26.4.2.1 所 示 : 
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图 26.4.2.1 LCD 显示 界面 
图 26.4.2.1 中 显示 出 了 AP3216C 的 三 个 传感器 的 数据 ， 大 家 可 以 用 手 遮 住 或 者 靠近 
AP3216C，LCD 上 的 三 个 数据 就 会 变化 。 
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第 二 十 七 章 SPI 实验 


同 I2C 一 样 ，SPI 是 很 常用 的 通信 接口 , 也 可 以 通过 SPI 来 连接 众多 的 传感器 。 相 比 DC 接 
口 ，SPI 接口 的 通信 速度 很 快 ，IC 最 多 400KHz， 但 是 SPI 可 以 到 达 几 十 MHz. LMX6U 也 有 
4 个 SPI 接 口 , 可 以 通过 这 4 个 SPI 接口 来 连接 一 些 PC 外 设 。LMX6U-ALPHA 使 用 SPI3 接口 
连接 了 一 个 六 轴 传 感 器 ICM-20608， 本 章 我 们 就 来 学 习 如 何 使 用 I.MX6U 的 SPI 接口 来 驱动 
ICM-20608， 读 取 ICM-20608 的 六 轴 数 据 。 
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27.1 SPI & ICM-20608 简介 


27.1.1 SPI 简介 


上 一 章 我 们 讲解 了 DC. I2C 是 串 行 通信 的 一 种 ， 只 需要 两 根 线 就 可 以 完成 主机 和 从 机 之 间 
的 通信 ， 但 是 DC 的 速度 最 高 只 能 到 400KHz， 如 果 对 于 访问 速度 要 求 比价 高 的 话 I2C 就 不 适 
合 了 。 本 章 我 们 就 来 学 习 一 下 另外 一 个 和 DC 一 样 广泛 使 用 的 串 行 通信 : SPI, SPI 全 称 是 Serial 
Perripheral Interface， 也 就 是 串 行 外 围 设 备 接口 。SPI 是 Motorola 公司 推出 的 一 种 同步 串 行 接口 
技术 ， 是 一 种 高 速 、 全 双 工 的 同步 通信 总 线 ，SPI 时 钟 频率 相 比 DC 要 高 很 多 ， 最 高 可 以 工作 
在 上 百 MHz. SPI 以 主 从 方式 工作 ， 通 常 是 有 一 个 主 设备 和 一 个 或 多 个 从 设备 ， 一 般 SPI 需要 
4 根 线 ， 但 是 也 可 以 使 用 三 根 线 ( 单 向 传输 )， 本 章 我 们 讲解 标准 的 4 线 SPI， 这 四 根 线 如 下 : 
QD)、CS/SS, Slave Select/Chip Select, 这 个 是 片 选 信号 线 , 用 于 选择 需要 进行 通信 的 从 设备 。 
I2C 主机 是 通过 发 送 从 机 设备 地 址 来 选择 需要 进行 通信 的 从 机 设备 的 , SPI 主机 不 需要 发 送 从 机 
设备 ， 直 接 将 相应 的 从 机 设备 片 选 信号 拉 低 即 可 。 
2). SCK, Serial Clock， 串 行 时 钟 ， 和 I2C 的 SCL 一 样 ， 为 SPI 通信 提供 时 钟 。 
(3. MOSI/SDO, Master Out Slave In/Serial Data Output， 简 称 主 出 从 入 信号 线 ， 这 根 数据 线 
只 能 用 于 主机 向 从 机 发 送 数据 ， 也 就 是 主机 输出 ， 从 机 输入 。 
由、MISO/SDI，Master In Slave Out/Serial Data Input， 简 称 主 入 从 出 信号 线 ， 这 根 数据 线 只 
能 用 户 从 机 向 主机 发 送 数据 ， 也 就 是 主机 输入 ， 从 机 输出 。 
SPI 通信 都 是 由 主机 发 起 的 ， 主 机 需要 提供 通信 的 时 钟 信 号 。 主 机 通过 SPI 线 连接 多 个 从 
设备 的 结构 如 图 27.1.1.1 所 示 : 
CS0 
CS1 
CS2 


CO 
SCLK 


SPI 器 件 1 SPI 器 件 2 SPI 器 件 3 










































































































































































































































































图 27.1.1.1 SPI 设备 连接 图 
SPI 有 四 种 工作 模式 , 通过 串 行 时 钟 极 性 (CPOL) 和 相位 (CPHA) 的 搭配 来 得 到 四 种 工作 模式 : 
GD、CPOL=0， 串 行 时 钟 空 闲 状态 为 低 电 平 。 

@、CPOL=1， 串 行 时 钟 空闲 状态 为 高 电 平 ， 此 时 可 以 通过 配置 时 钟 相 位 (CPHA) 来 选择 具 

体 的 传输 协议 。 
图 、CPHA=0， 串 行 时 钟 的 第 一 个 跳 变 沿 ( 上 升 沿 或 下 降 沿 ) 采 集 数 据 。 
四 、CPHA=1， 串 行 时 钟 的 第 二 个 跳 变 沿 ( 上 升 沿 或 下 降 沿 ) 采 集 数 据 。 
这 四 种 工作 模式 如 图 27.1.1.2 所 示 : 
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(CPOL-1, CPHA=1) SCLK 
(CPOL-1, CPHA-0) SCLK 
(CPOL-0, CPHA-1) SCLK 








(CPOL-0, CPHA-0) SCLK 


MISO MSB LSB 














MOST MSB LSB 














图 27.1.1.2 SPI 四 种 工作 模式 
根 DC 一 样 ，SPI 也 是 有 时 序 图 的 ， 以 CPOL=0，CPHA=0 这 个 工作 模式 为 例 ，SPI 进行 全 
双 工 通信 的 时 序 如 图 27.1.1.3 所 示 : 


























图 27.1.1.3 SPI 时 序 图 
从 图 27.1.1.3 可 以 看 出 ，SPI 的 时 序 图 很 简单 ,不 像 PC 那样 还 要 分 为 读 时 序 和 写 时 序 ， 因 
为 SPI 是 全 双 工 的 ， 所 以 读 写 时 序 可 以 一 起 完成 。 图 27.1.1.3 P, CS 片 选 信号 先 拉 低 ， 选 中 要 
通信 的 从 设备 ， 然 后 通过 MOSI 和 MISO 这 两 根 数据 线 进行 收发 数据 ，MOSI 数据 线 发 出 了 
0XD2 这 个 数据 给 从 设备 , 同时 从 设备 也 通过 MISO 线 给 主 设备 返回 了 0X66 这 个 数据 。 这 个 就 
是 SPI 时 序 图 。 
关于 SPI 就 讲解 到 这 里 ， 接 下 来 我 们 看 一 下 I.MX6U 自 带 的 SPI 外 设 : ECSPI。 
















































































27.1.2 L.MX6U ECSPI 简介 


LMX6U 自 带 的 SPI 外 设 叫 做 ECSPI, 全 称 是 Enhanced Configurable Serial Peripheral Interface; 

别 看 前 面 加 了 个 “EC” 就 以 为 和 标准 SPI 有 啥 不 同 的 ， 起 始 就 是 SPI。ECSPI 有 64x32 个 接收 
FIFO(RXFIFO) 和 64x32 个 发 送 FIFO(TXFIFO), ECSPI 特性 如 下 : 

QD、 全 双 工 同步 串 行 接口 。 
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、 可 配置 的 主 /从 模式 。 

、 四 个 片 选 信号 ， 支 持 多 从 机 。 

、 发 送 和 接收 都 有 一 个 32x64 的 FIFO. 

、 片 选 信号 SS/CS， 时 钟 信号 SCLK 极 性 可 配置 。 





s~ XF DMA. 

LMX6U 的 ECSPI 可 以 工作 在 主 模式 或 从 模式 ， 本 章 我 们 使 用 主 模式 ，LMX6U 有 4 个 
ECSPI， 每 个 ECSPI 支持 四 个 片 选 信号 ， 也 就 说 ， 如 果 你 要 使 用 ECSPI 的 硬件 片 选 信号 的 话 ， 
一 个 ECSPI 可 以 支持 4 个 外 设 。 如 果 不 使 用 硬件 的 片 选 信号 就 可 以 支持 无 数 个 外 设 ， 本 章 实验 
我 们 不 使 用 硬件 片 选 信号 ， 因 为 硬件 片 选 信号 只 能 使 用 指定 的 片 选 IJO， 软 件 片 选 的 话 可 以 使 用 
任意 的 IO。 

我 们 接 下 来 看 一 下 ECSPI 的 几 个 重要 的 寄存 器 , 首先 看 一 下 ECSPIx CONREG(x=1~4) 寄 存 器 ， 







































































这 是 ECSPI 的 配置 寄存 器 ， 此 寄存 器 结构 如 图 27.1.2.1 所 示 : 
Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
R 
CHANNEL . 
w BURST_LENGTH | SELECT | DRCTL | 
Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
E PRE DIVIDER POST DIVIDER CHANNEL MODE SMC | XCH EN 








Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
图 27.1.2.1 寄存 器 ECSPIx CONREG 结构 

寄存 器 ECSPIx CONREG 各 位 含义 如 下 : 

BURST LENGTH(bit31:24); REKE, WE SPI 的 突 发 传输 数据 长 度 ， 在 一 次 SPI 发 送 
中 最 大 可 以 发 送 2^12bit 数据 。 可 以 设置 0X000~0XFFF， 分 别 对 应 1~2^12bit。 我 们 一 般 设置 突 
发 长 度 为 一 个 字 节 ， 也 就 是 8bit，BURST_ LENGTH-7. 

CHANNEL SELECT(bit19:18): SPI 通道 选择 , 一 个 ECSPI 有 四 个 硬件 片 选 信号 ， 每 个 片 
选 信号 是 一 个 硬件 通道 ， 虽 然 我 们 本 章 实验 使 用 的 软件 片 选 ， 但 是 SPI 通道 还 是 要 选择 的 。 可 
设置 为 0-3， 分 别 对 应 通道 0-3. LMX6U-ALPHA 开发 板 上 的 ICM-20608 的 片 选 信号 接 的 是 
ECSPI3 SS0， 也 就 是 ECSPI3 的 通道 0， 所 以 本 章 实验 设置 为 0。 

DRCTL(bit17:16); SPI 的 SPI RDY 信号 空 制 位 ， 用 于 设置 SPI RDY 信号 , 为 0 的 话 不 关 
心 SPI RDY 信号 ; 为 1 的话 SPI RDY 信号 为 边沿 触发 ， 为 2 的 话 SPI DRY 是 电 平 触发 。 
PRE DIVIDER(bit15:12): SPI 预 分 频 , ECSPI 时 钟 频率 使 用 两 步 来 完成 分 频 ， 此 位 设置 的 

步 ， 可 设置 0~15， 分 别 对 应 1~16 分 频 。 
POST DIVIDER(bit11:8); SPI 分 频 值 ，ECSPI 时 钟 频 率 的 第 二 步 分 频 设置 ， 分 频 值 为 
2^POST DIVIDER. 

CHANNEL MODEX(bit7:4): SPI 通道 主 /从 模式 设置 , CHANNEL. MODE[3:0] 分 别 对 应 SPI 
通道 3~0, 为 0 的 话 就 是 设置 为 从 模式 ， 如 果 为 1 的 话 就 是 主 模式 。 比 如 设置 为 0X01 的 话 就 是 
设置 通道 0 为 主 模式 。 

SMC(bit3): 开始 模式 控制 , 此 位 只 能 在 主 模式 下 起 作用 , 为 0 的 话 通过 
突 发 访问 ， 为 1 的 话 只 要 向 TXFIFO 写 入 数据 就 开启 SPI 突 发 访问 。 

XCH(bit2):， 此 位 只 在 主 模式 下 起 作用 ， 当 SMC 为 0 的 话 此 位 用 来 控制 SPI 突 发 访问 的 开 
pa 
H. 

HT(bitl); HT 模式 是 能 位 ，LMX6ULL 不 支持 。 

EN(bit0): SPI 使 能 位 ， 为 0 的 话 关闭 SPI， 为 1 的 话 使 能 SPI 

接 下 来 看 一 下 寄存 器 ECSPIx CONFIGREG， 这 个 也 是 ECSPI 的 控 
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XCH 位 来 开启 SPI 



































制 寄 存 器 ， 此 寄存 器 结 
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构 如 图 27.1.2.2 所 示 : 

Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 | 15 14 13 12 11 109 8 7 6 5 4 3 2 1 0 
ke HT LENGTH | SCLK CTL | DATA CTL | SS POL SS CTL | SCLK POL | SCLK PHA 


Rst0.0.00000000000000j0000000000000000 


27.1.2.2 寄存 器 ECSPIx CONFIGREG 结构 

寄存 器 ECSPIx CONREG 用 到 的 重要 位 如 下 : 

HT LENGTH(bit28:24): HT 模式 下 的 消息 长 度 设置 ，I.MX6ULL 不 文 持 。 

SCLK CTL(bit23:20): 设置 SCLK 信号 线 空 闪 状态 电 平 ，SCLK_CTL[3:0] 分 别 对 应 通道 
3~0， 为 0 的 话 SCLK 空 闪 状态 为 低 电 平 ， 为 1 的 话 SCLK 空闲 状态 为 高 电 平 。 

DATA CTL(bit19:16): 设置 DATA 信号 线 空间 状态 电 平 ， DATA_CTL[3:0] 分 别 对 应 通道 
3~0， 为 0 的 话 DATA 空 闪 状态 为 高 电 平 ， 为 1 的 话 DATA. 空间 状态 为 低 电 平 。 

SS POL(bit15:12): WE SPI 片 选 信号 极 性 设置 ，SS_POL[3:0] 分 别 对 应 通道 3~0， 为 0 的 
话 片 选 信号 低 电 平 有 效 ， 为 1 的 话 片 选 信号 高 电 平 有 效 。 

SCLK POL(bit7:4): SPI 时 钟 信号 极 性 设置 ， 也 就 是 CPOL，SCLK_POL[3:0] 分 别 对 应 通 
道 3~0， 为 0 的 话 SCLK 高 电 平 有 效 (空闲 的 时 候 为 低 电 平 )， 为 1 的 话 SCLK 低 电 平 有 效 (空闲 
的 时 候 为 高 电 平 )。 

SCLK_PHA(bit3:0):SPI 时 钟 相位 设置 ,也 就 是 CPHA,SCLK_PHA[3:0] 分 别 对 应 通道 3~0， 
为 0 的 话 串 行 时 钟 的 第 一 个 跳 变 沿 ( 上 升 沿 或 下 降 沿 ) 采 集 数 据 ， 为 1 的 话 串 行 时 钟 的 第 二 个 跳 
变 沿 ( 上 升 沿 或 下 降 沿 ) 采 和 集 数据 。 

通过 SCLK POL 和 SCLK PHA 可 以 设置 SPI 的 工作 模式 。 

接 下 来 看 一 下 寄存 器 ECSPIx PERIODREG， 这 个 是 ECSPI 的 采样 周期 寄存 器 ， 此 寄存 器 
结构 如 图 27.1.2.3 所 示 : 
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Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 














27.1.2.3. 寄存 器 ECSPIx PERIODREG 结构 
寄存 器 ECSPIx PERIODREG 用 到 的 重要 位 如 下 : 
CSD_CTL(bit21:16): 片 选 信号 延 时 控制 位 ， 用 于 设置 片 选 信号 和 第 一 个 SPI 时 钟 信 号 之 
间 的 时 间 间 隔 ， 范 围 为 0~63。 
CSRC(bit15): SPI 时 钟 源 选择 ， 为 0 的 话 选 择 SPI CLK 为 SPI 的 时 钟 源 ， 为 1 的 话 选择 
32.768KHz 的 晶振 为 SPI 时 钟 源 。 我 们 一 般 选 择 SPI CLK 作为 SPI 时 钟 源 ，SPI CLK 时 钟 来 源 
如 图 27.1.2.4 所 示 : 
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PLL3_SW_CLK 


CSCMR2[CAN_CLK_PODF] i 





OSC CAN_CLK_ROOT ı FLEXCAN 
1 


n CSCDR2[ECSPI. CLK PODF] i 
© © 


27.1.2.4 SPI CLK 时 钟 源 

图 27.1.2.4 中 各 部 分 含义 如 下 : 

GD、 这 是 一 个 选择 器 ， 用 于 选择 根 时 钟 源 ， 由 寄存 器 CSCDR2 的 位 ECSPI CLK. SEL 来 控 
制 ， 为 0 的 话 选择 pll3 60m 作为 ECSPI 根 时 钟 源 。 为 1 的 话 选择 osc_clk 作为 ECSPI 时 钟 源 。 
本 章 我 们 选择 pll3 60m 作为 ECSPI 根 时 钟 源 。 

@、ECSPI 时 钟 分 频 值 ， 由 寄存 器 CSCDR2 的 位 ECSPI CLK PODF 开 控 制 ， 分 频 值 为 
2^ECSPI CLK_PODF 。 本 章 我 们 设置 为 0， 也 就 是 1 分 频 。 

(3). RHEA ECSPI 的 时 钟 ， 也 就 是 SPI CLK=60MHz。 

SAMPLE PERIO: 采样 周期 寄存 器 ， 可 设置 为 0~0X7FFF 分 别 对 应 0~32767 个 周期 。 

接 下 来 看 一 下 寄存 器 ECSPIx_STATREG, 这 个 是 ECSPI 的 状态 寄存 器 , 此 寄存 器 结构 如 
27.1.2.5 所 示 : 
































27.1.2.5 寄存 器 ECSPIx STATREG 寄存 器 

寄存 器 ECSPIx_STATREG 用 到 的 重要 位 如 下 : 

TC(bit7): 传输 完成 标志 位 ， 为 0 表示 正在 传输 ， 为 1 表示 传输 完成 。 

RO(bitó): RXFIFO 溢出 标志 位 ， 为 0 表示 RXFIFO 无 溢出 ， 为 1 表示 RXFIFO 溢出 。 

RF(bit5): RXFIFO 空 标志 位 ， 为 0 表示 RXFIFO 不 为 空 ， 为 1 表示 RXFIFO 为 空 。 

RDR(bit4): RXFIFO 数据 请 求 标 志 位 ， 此 位 为 0 表示 RXFIFO 里 面 的 数据 不 大 于 
RX THRESHOLD， 此 位 为 1 的 话 表示 RXFIFO 里 面 的 数据 大 于 RX_THRESHOLD。 

RR(bit3): RXFIFO 就 绪 标 志 位 ， 为 0 的 话 RXFIFO 没有 数据 ， 为 1 的 话 表示 RXFIFO 中 
至 少 有 一 个 字 的 数据 。 

TF(bit2): TXFIFO 满 标志 位 ， 为 0 的 话 表示 TXFIFO 不 为 满 ， 为 1 的 话 表 示 TXFIFO 为 











满 。 
TDR(bit1): TXFIFO 数据 请 求 标志 位 , 为 0 表示 TXFIFO 中 的 数据 大 于 TX_THRESHOLD， 
为 1 表示 TXFIFO 中 的 数据 不 大 于 TX_THRESHOLD。 
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TE(bit0): TXFIFO 空 标志 位 , 为 0 表示 TXFIFO 中 至 少 有 一 个 字 的 数据 , 为 1 表示 TXFIFO 











为 


Hi 








最 后 就 是 两 个 数据 寄存 器 ，ECSPIx_TXDATA 和 ECSPIx RXDATA， 这 两 个 寄存 器 都 是 32 
位 的 ， 如 果 要 发 送 数据 就 向 寄存 器 ECSPIx TXDATA 写 入 数据 ， 读 取 及 存 取 ECSPIx RXDATA 
里 面 的 数据 就 可 以 得 到 刚刚 接收 到 的 数据 。 

关于 ECSPI 的 寄存 器 就 介绍 到 这 里 ， 关 于 这 些 寄存 器 详细 的 描述 ， 请 参考 《LMX6ULL 参 
考 手 册 》 第 805 页 的 20.7 小 节 。 






































27.1.3 ICM-20608 简介 





ICM-20608 是 InvenSense 出 品 的 一 款 6 轴 MEMS 传感器 ， 包 括 3 轴 加 速度 和 3 轴 陀 螺 仪 。 
ICM-20608 尺寸 非常 小 , 只 有 3x3x0.75mm, 采用 16P 的 LGA 封装 。ICM-20608 内 部 有 一 个 512 
字 节 的 FIFO。 陀 螺 仪 的 量程 范围 可 以 编程 设置 ， 可 选择 士 230， 士 $S00， 士 1000 和 士 2000” /s, 
加 速度 的 量程 范围 也 可 以 编程 设置 ， 可 选择 士 2g， 士 4g， 士 4g， 士 gg 和 士 16g。 陀 螺 仪 和 加 速度 
计 都 是 16 位 的 ADC， 并 且 支 持 DC 和 SPI 两 种 协议 ， 使 用 DC 接口 的 话 通信 速度 最 高 可 以 达 
到 400KHz， 使 用 SPI 接口 的 话 通信 速度 最 高 可 达到 8MHz。I.MX6U-ALPHA 开发 板 上 的 ICM- 
20608 通过 SPI 接口 和 LMX6U 连接 在 一 起 。ICM-20608 特性 如 下 : 

Q@、 陀 螺 仪 支持 X,Y 和 Z 三 轴 输 出 ， 内 部 集成 16 位 ADC， 测 量 范围 可 设置 ， 土 250， 土 
500, +1000 和 士 2000” /s. 

人 @@、 加 速度 计 支 持 XY 4 Z 轴 输 出 , 内 部 集成 16 位 ADC, 测量 范围 可 设置 : 士 2g， 士 4g， 
土 4g， 土 8g 和 土 16g。 

、 用 户 可 编程 中 断 。 

、 内 部 包含 512 字 节 的 FIFO。 

、 内 部 包含 一 个 数字 温度 传感器 。 

、 耐 10000g 的 冲击 。 
、 支 持 快速 DZC， 速 度 可 达 400KHz。 

、 支 持 SPI， 速 度 可 达 SMHz. 
ICM-20608 的 3 轴 方 向 如 图 27.1.3.1 所 示 : 
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图 27.1.3.1 ICM-20608 检测 轴 方 向 和 极 性 
ICM-20608 的 结构 框图 如 图 27.1.3.2 所 示 : 
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字 节 的 话 )， 第 一 个 字 节 包含 要 读 写 





Temp Sensor 


Charge 
Pump 


Buiuonipuoj jeuis 


ICM-20608-G 







论坛 :Www.opendev.com 





Slave I2C and AD0/ SDO 
SPI Serial 
Interface (C) SCL / SCLK 








VDD GND REGOUT 


27.1.3.2 ICM-20608 框图 

如 果 使 用 IIC 接口 的 话 ICM-20608 的 AD0 引 脚 决定 DC 设备 从 地 址 的 最 后 一 位 , 如 果 ADO 
为 0 的话 ICM-20608 从 设备 地 址 是 0X68, WR ADO 为 1 的 话 ICM-20608 从 设备 地 址 为 0X69. 
本 章 我 们 使 用 SPI 接口 ， 跟 上 一 章 使 用 AP3216C 一 样 ，ICM-20608 也 是 通过 读 写 寄存 器 来 配置 
和 读 取 传 感 器 数据 ， 使 用 SPI 接口 读 写 寄存 器 需要 16 个 时 钟 或 者 更 多 (如 果 读 写 操作 包括 多 个 
的 寄存 器 地 址 ， 寄 存 器 地 址 最 高 位 是 读 写 标 志 位 ， 如 果 是 读 
的 话 寄 存 器 地 址 最 高 位 要 为 1, 如 果 是 写 的 话 寄 存 器 地 址 最 高 位 要 为 0, 剩 下 的 7 位 才 是 实际 的 


























寄存 器 地 址 ， 寄 存 器 地 址 后 面 跟着 的 就 是 读 写 的 数据 。 表 27.1.3.1 列 出 了 本 章 实验 用 到 的 一 些 





寄存 器 和 位 ， 关 于 ICM-20608 的 详细 寄存 器 和 位 的 介绍 请 参考 ICM-20608 的 寄存 器 手册 : 


















































设置 输出 速率 , 输出 速率 计算 公式 如 下 : 
0X19 SMLPRT DIV[7:0] 输出 速率 设置 | SAMPLE RATE-INTERNAL SAMPLE RATE/ 
(1 + SMPLRT DIV) 
0X1A DLPF CFG[2:0] 心 片 配置 设置 陀螺 仪 低 通 滤波 。 可 设置 0~7。 
CIRCE RET 0: +250dps; 1: +500dps; 2: +1000d 
0XIB FS SEL[1:0] BORED i di i 
E A 3: +2000dps 
加 速度 计量 程 
OXIC | ACC FS SEL[1:0] E 0: 士 2g; 1: 4g; 2: 8g; 3: +16g 
Da 
加 速度 计 低 通 | 、 T" T ; 
OXID | A DLPF CFG[2:0] duca 设置 加 速度 计 的 低 通 滤波 ， 可 设置 0~7。 
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GYRO CYCLE[7] 陀螺 仪 低 功 耗 | 0: 关闭 陀螺 仪 的 低 功 耗 功能 。 
一 使 能 1: 使 能 陀螺 仪 的 低 功 耗 功能 。 
ER 1: SEREIA E (I t FIFO. 
udi 0: 关闭 温度 传感器 FIFO. 
1: 使 能 陀螺 仪 X fill FIFO. 
XG FIFO EN[6] 0: 关闭 陀螺 仪 X 轴 FIFO。 
,wnt | 1: 使 能 陀螺 仪 Y 轴 FIFO。 
0X23 YG FIFO EN[5] FIFO 使 能 控制 0. SEMEARI Y fi FIFO. 
1: 使 能 陀螺 仪 Z 轴 FIFO。 
ZG FIFO-ENI4] 0: 关闭 陀螺 仪 Z 轴 FIFO。 
1: 使 能 加 速度 计 FIFO。 
| 0: 关闭 加 速度 计 FIFO。 
0X3B | ACCEL XOUT H[7:0] 加 速度 X 轴 数 据 高 8 位 
0X3C | ACCEL XOUT L[7:0] 加 速度 X 轴 数 据 低 8 位 
0X3D | ACCEL YOUT H[7:0] 加 速度 Y 轴 数 据 高 8 位 
OX3E | ACCEL YOUT LI7:0] 加 速度 Y 轴 数 据 低 8 位 
OX3F | ACCEL ZOUT H[7:0] 加 速度 Z 轴 数 据 高 8 位 
0X40 | ACCEL ZOUT L[7:0] 加 速度 乙 轴 数 据 低 8 位 
0X41 TEMP OUT H[7:0] 数据 寄存 器 高 8 位 
0X42 | TEMP OUT LI7:0] 温度 数据 低 8 位 
0X43 | GYRO XOUT H[7:0] 加 速度 计 X 轴 数 据 高 8 位 
0X44 | GYRO XOUT L[7:0] AIR EVE X 轴 数 据 低 8 位 
0X45 | GYRO YOUT H[7:0] IMEE Y 轴 数 据 高 8 位 
0X46 | GYRO YOUT L[7:0] 加 速度 计 立 轴 数 据 低 8 位 
0X47 | GYRO ZOUT H[7:0] 加 速度 计 乙 轴 数 据 高 8 位 
0X48 | GYRO ZOUT L[7:0] An BET Z 轴 数 据 低 8 位 
-— DEVICE RESET[7] 电源 管理 寄存 | 0: 复位 ICM-20608. 
SLEEP[6] 器 1 0: 退出 休眠 模式 ;， 1， 进入 休眠 模式 
STBY XAIS] 0: f 速度 计 X 4 A 
一 1: 关闭 加 速度 计 X 轴 。 
STBY YA4 0: f 速度 计 Y 4 3 
= 1: 关闭 加 速度 计 Y 轴 。 
STBY ZA[3] 本 Oe EEEE A 
sued 一 电源 管理 寄存 |1: SUL ILIA f 
STBY XGI2] 器 2 0: BEREBER X fü. 
E 1: 关闭 陀螺 仪 X 轴 。 
0: 使 能 陀螺 仪 fü. 
STAA KOU] 1. SEIREN Y fi. 
0: 使 能 陀螺 仪 Z fü. 
STBY ZG[0] 1: 关闭 陀螺 仪 轴 。 
— BOAMITAO! ID 寄存 器 , ICM-20608G 的 ID 为 OXAF, 
ICM-20608D 的 ID 为 0XAE。 
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表 27.1.3.1 ICM-20608 寄存 器 表 

ICM-20608 的 介绍 就 到 这 里 , 关于 ICM-20608 的 详细 介绍 请 参考 ICM-20608 的 数据 手册 和 
寄存 器 手册 。 











27.2 硬件 原理 分 析 


本 试验 用 到 的 资源 如 下 : 

Q、 指 示 灯 LED0。 

©, RGB LCD 屏幕 。 

(8. ICM20608 

Q. #0 

ICM-20608 是 在 LMX6U-ALPHA 开发 板 底 板 上 ， 原 理 图 如 图 27.2.1 所 示 : 


J2 42 UART2 TXD ECSPI3 SSO 
J2 41 UART2 RXD ECSPI3 SCLK 


J2 40 UART2 RTS CAN2 RX | ECSPI3 MISO 
12839 UART2 CIS CAN2 TX | ECSPI3 MOSI 


JTAG MOD 6D INT GBC LED? 22 25 




































DCDC 3V3 






















104 
U4 Pi |I GND 
GND || C VDDIO u 
7 
ECSPD SCLK2 RESV— 
ECSPI3 MOSI3 [S ASD REGOUT 
R17 [ECSPI3 sso 5 RESV— 
10K |ECSPD MISO4 a RESV T 
GND | FSYNC B W 
6D INT 6 9 
INT RESV |I GND 
^. ICM-20608 
图 27.2.1 ICM-20608 原理 图 
27.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 1、 裸 机 例 程 -> 19 spi. 

本 章 实 验 在 上 一 章 例 程 的 基础 上 完成 ， 更改 工程 名 字 为 “icm20608”， 然 后 在 bsp 文件 夹 下 
创建 名 为 “spi” 和 “icm20608” 的 文件 。 在 bsp/spi 中 新 建 bsp_spi.c 和 bsp_spi.h 这 两 个 文件 ， 
在 bsp/icm20608 中 新 建 bsp icm20608.c 和 bsp icm20608.h 这 两 个 文件 。bsp_spi.c 和 bsp spi.h 
是 ILMX6U 的 SPI 文件 ,bsp icm20608.c 和 bsp icm20608.h 是 ICM20608 的 驱动 文件 ,在 bsp_spi.h 
中 输入 如 下 内 容 : 





























示例 代码 27.3.1 bsp_spih 文件 代码 
Pe BSP SPI H 
&define BSP SPI H 
/大大 类 大 类 大 类 大 类 大 类 类 类 类 类 关 类 大 类 大 类 大 类 大 类 大 类 大 类 关 类 大 类 大 类 类 类 大 类 六 类 大 类 大 类 关 类 大 类 大 类 六 类 关 类 大大 大 类 大 类 大 大 
(yore le Zuoznendar Co Dee 19 2019 AL F160Mms ES Errea 
文件 名 g bap soitaa 


O1 4 T OTN B 
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G ET : ABL 

7 版 本 a Was 

8 描述 : SPI Ha Vee 





9 其 他 5 JE 
19 WESS : www.openedv.com 
Tu Biss : 初版 V1.0 2019/1/17 左 忠 凯 创建 





T2 大 火炎 大 大火 大 大 大火 大 大大 火炎 类 大火 大 大 大 类 大 类 大 类 大 类 类 类 大 类 类 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 类 类 大 大 大 类 大 大 大 大 大 / 


LS ee rne DULL c T 


15 /* 函数 声明 */ 
le yoic spi (le) 








17 unsigned char spich0 readwrite byte(ECSPI Type *base, 
unsigned char txdata); 
18 #endif 
文件 bsp_spih 内 容 很 简单 ， 就 是 函数 声明 。 在 文件 bsp_spi.c 中 输入 如 下 内 容 : 
示例 代码 27.3.2 bsp. spi.c 文件 代码 
J[ KCKCKCKCKCKCKCk KCkCk kCkCk kCKCKCkCKCkCk KCKCk kCkCK KOC Ck KCkCk kCk ck k kc k Ck kCk Ck kCk k k kc k k kc k kck ck ck kck ck ckck k 
Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 
文件 名 3M SEES OEC 
作者 : 左 忠 凯 


版 本 a Vs 

描述 : SPI UD f. 

其 他 SESS 

论坛 : www.openedv.com 


起 : 初版 V1.0 2019/1/17 左 忠 凯 创建 


KCKCKCKCKCKCkCkCk ck k kk k kk Ck kc k Ck kk k k kc k k kc k Ck kCk Ck kk k k kc k k kc k k kc kckckck ck kckck ckck ck ckokck kk e kk 


I include “bsp spi.h” 





2 include "osp gpio.b" 

Bee ee 

4 

SR 

6 * Qdescription : 初始 化 SPI 

7  * @param - base  : 要 初始 化 的 SPI 

8  * Qreturn & 25 

S9 Sa 

IO void! gpi imit (UMCSIPX "wee bass) 

EET 

12 /* 配置 CONREG 寄存 器 

ils x Di0 g 1  fERÉECSPI 

14 t bit £ 1 MH TXFIFO 写 入 数据 以 后 立即 开启 SPI 突 发 。 

ig * bit[7:4]: 0001 SPI 通道 0 主 模式 ， 根 据 实 际 情况 选择 ， 开 发 板 上 的 
16 * IcM-20608 接 在 SS0 上 ， 所 以 设置 通道 0 为 主 模式 
37 * bit[19:18]:00 选中 通道 0 (其 实 不 需要 ， 因 为 片 选 信号 我 们 我 们 自己 控制 ) 
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18 *Ubit[s1:20]5 027 SS BE A8. M Iit 

19 ny 

20 ase-»CONREG = 0; /* 先 清除 控制 寄存 器 */ 
21 ase-»CONREG = (1 «« O) (x3 (1 «« 4) | (7 «« 20); 
22 

29 Sa 

24 * ECSPI 通道 0 设置 , 即 设置 CONFIGREG 寄存 器 

25 * bit0: 0 通道 0 PHA 为 0 

26 * bit4: 0 通道 0 SCLK 高 电 平 有 效 

* bit8: 0 通道 0 片 选 信号 当 SNMC 为 1 的 时 候 此 位 无 效 

28 * bit12: 0 33$ 0 POL JO 

29 * bit16: 0 通道 0 Aide DNI a E F 

30 * bit20: 0 通道 0 时 钟 线 空 闲 时 低 电 平 

E MÀ 

32 base-»CONFIGREG = 0; /* 设置 通道 寄存 器 */ 

33 

34 JP 

35 * ECSPI 通道 0 设置 ， 设 置 采 样 周 期 

36 * bit[14:0] : 0x2000 采样 等 竺 周期， 比如 当 SPI 时 钟 为 10MHz 的 时 候 
e * 0x2000 mA- 1/10000 * 2000 = 0.8192ms, thu 
38 * 连续 读 取 数据 的 时 候 每 次 之 间 间 隔 0 . 8ms 

39 = bici g 0 采样 时 钟 源 为 SPI CLK 

40 * bit[21:16]: On mU EJ 0-63 

41 */ 

42 base-»PERIODREG s 0X2000; /* 设置 采样 周期 寄存 器 */ 

43 

44 /* 

45 * ECSPI 的 SPI 时 钟 配置 ，SPI 的 时 钟 源 来 源 于 Pp113 sw clk/8-480/8-60MHz 
46 = SBL CUK = ((SXomueemeI / PER DIVIDER) / (2^POST DIVEDER) 
47 * 比如 我 们 现在 要 设置 SPI 时 钟 为 6MHz， 那 么 设置 如 下 : 

48 A EATR DEVALD = 0X95 

49 io POSTI DIVIDERT- 0X0. 

50 * SPI CLK = 60000000/(0X9 + 1) = 60000000-6MHz 

Sal wf 

52 base-»CONREG &= ~((0XF << 12) | (0XF << 8)); /* 清除 以 前 的 设置 */ 
53 base->CONREG |= (0X9 << 12); /* 设置 SPI CLK = 6MHz */ 
54 } 

55 

56/2 

57 * Qdescription : SPI 通道 0 发 送 /接收 一 个 字 节 的 数据 

58 * Qparam - base  : 要 使 用 的 SPI 

59 * Qparam = txdata: 要 发 送 的 数据 

60 * Qreturn 8 JU 
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ul sw 





62 unsigned char spich0 readwrite byte(ECSPI Type *base, 


unsigned char txdata) 











GS 

64 minto b epirdeta = 0 

65 uint32 t spitxdata 5 txdata; 

66 

67 JE SCELERE 

68 base-»CONREG &- «(35 << 18); 

69 base-»CONREG |= (0 << 18); 

70 

71 while((base-»STATREG & (1 << 0)) == 0){} /* 等 待 发 送 FIFO 为 空 */ 
072 base-»TXDATA = spitxdata; 

08 

74 while((base-»STATREG & (1 << 3)) == 0){} /* 等 待 接收 riro 有 数据 */ 
WS spirxdata = base->RXDATA; 

76 return spirxdata; 

RU) 


文件 bsp_spi.c 中 有 两 个 函数 : spi init 和 spich0 readwrite byte， 函数 spi init 是 SPI 初始 
化 函数 ， 此 函数 会 初始 化 SPI 的 时 钟 ， 通 道 等 。 函 数 spichO readwrite byte 是 SPI 收发 函数 ， 
通过 此 函数 即 可 完成 SPI 的 全 双 工 数据 收发 。 
接 下 来 在 文件 bsp icm20608.h 中 输入 如 下 内 容 : 
示例 代码 27.3.3 bsp_icm20608.h 文件 代码 
*ifndef BSP ICM20608 H 
#define BSP ICM20608 H 
/玉米 类 类 炎炎 类 大 大火 类 大 类 火炎 大大 炎炎 大大 炎炎 大大 炎炎 大大 大大 炎炎 类 大 类 类 类 大 类 大大 大 类 类 类 大 类 类 类 大 类 类 类 大 类 类 大 大 类 大 类 大 
Copyright 9 zuozhongkar Co., Ltd. 1998-2079. Ad rights reserved. 
: bsp icm20608.h 
作者 : 左 忠 凯 





c -1 O0 OU 4 Q NM HP 
d 
F 
I 














版 本 a Vibe 
描述 : ICM20608 驱动 文件 。 
9 Eh SE 
10 i&jdx : www.openedv.com 
iss pan : WIR v1.0 2019/3/26 左 忠 凯 创建 
12! KOKCKCKCKCkCkCkCk kCkCk k kk Ck k Ck Ck kCkCk k kk k k Ck Ck kc k Ck k kk k kc k k kc k Ck k k Ck kck ck kck ck ckck ck ckck ck kck ck kk x f 
13 £$include "imxó6ul.h" 
14 finclude "bsp gpio.h" 
3L 
16 /* SPI JH XB */ 
17 $define ICM20608 CSN (n) (um '€ goo jesbawgeibbe ((EEPIQLn. 205 y 
gpio pinwrite(GPIOl1, 20, 0)) 
18 
19 #define ICM20608G ID OXAF /* ID 值 */ 
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20 $define ICM20608D ID OXAE /* IDÍH */ 
ZI 


22 /* ICM20608 寄存 器 
23 * 复 位 后 所 有 寄存 器 地 址 都 为 0， 除 了 


24 *Register 107(0X6B) Power Management 1 





0x40 
OxAF 或 者 OxAI 


25  *Eeguieneess db (02575) WEO AM 1 





ial 




































































2G TA 

27 /* 陀螺 仪 和 加 速度 自 测 (出 产 时 设置 ， 用 于 与 用 户 的 自 检 输 出 值 比较 ) */ 
28 *define TCM? 0 SELF TEOT X GYRO 0x00 

29 #define ICM20 SELF TEST Y GYRO 0x01 

30 4define ICM20 SELF TEST Z GYRO 0x02 

31 4define ICM20 SELF TEST X ACCEL  0x0D 

32 #define ICM20 SELF TEST Y ACCEL Ox0E 

33 £$define ICM20 SELF TEST Z ACCEL OxOF 

34 Do EID cu 

35 4define ICM20 ZA OFFSET H 0x7D 

36 define ICM20 ZA OFFSET L Ox7E 

3) 

BON S 

39 * ICM20608 结构 体 

40 */ 

dil gtruct icm20606 dey strug 

42 { 

43 signed int gyro x adc; /* KERRIN x 轴 原 始 值 s 
44 signed int gyro_y adc; /* BER Y 轴 原 始 值 ay 
45 Signed int gyro z adc; /* 陀螺 仪 2 轴 原 始 值 
46 signed int accel x adc; /* 加 速度 计 X 轴 原始 值 */ 
47 signed int accel y adc; /* 加 速度 计 YY 轴 原 始 值  */ 
48 Signed int accel z adc; /* 加 速度 计 z 轴 原 始 值  */ 
49 signed int temp adc; /* 温度 原始 值 £ 
50 

51 /* 下 面 是 计算 得 到 的 实际 值 ， 扩 大 100 倍 */ 

52 signed int gyro x act; /* 陀螺 仪 x 轴 实 际 值 iA 
DE signed int gyro y act; /* BEER Y 轴 实 际 值 */ 
54 Signed int gyro z act; /* 陀螺 仪 z 轴 实 际 值 nd 
55 signed int accel x act; /* 加 速度 计 Xx 轴 实 际 值 */ 
56 signed int accel y act; /* 加 速度 计 Y HüSEPM */ 
577 signed int accel z act; /* 加 速度 计 z KE */ 
58 signed int temp act; /* 温度 实际 值 5 
S PR 

60 


61 struct icm20608 dev struc icm20608 dev; /* icm20608 设备 */ 
62 
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63 /* BUS e 


64 unsigned char icm20608 init (void); 


论坛 :www.opendev.com 


See em mo (sme en C er Mom eit opm ele eerie e) g 


66 unsigned char icm20608 read reg(unsigned char reg); 


67 void icm20608 read len(unsigned char reg, 


unsigned char *buf, 


unsigned char len); 


68 void icm20608 getdata (void); 
69 pendit 


文件 bsp icm20608.h 里 面 先 定义 了 一 个 宏 ICM20608. CSN， 这 个 是 ICM20608 的 SPI 片 选 


引 脚 。 接 下 来 定义 了 一 些 ICM20608 的 ID 和 寄存 器 





也 址 。 第 41 行 定 义 了 一 个 结构 体 





icm20608 dev_struc， 这 个 结构 体 是 ICM20608 的 设备 结构 体 ， 里 面 的 成 员 变 量 用 来 保存 





ICM20608 的 原始 数据 值 和 经 过 转换 得 到 的 实际 值 。 实际 值 


是 有 小 数 的 , 本 章 例 程 取 两 位 小 数 ， 



































为 了 方便 计算 ， 实 际 值 扩 大 了 100 倍 ， 这 样 实际 值 就 是 整数 了 ， 但 是 在 使 用 的 时 候 要 除 100 重 








新 得 到 小 数 部 分 。 最 后 就 是 一 些 函 数 声明 , 接 下 来 在 文件 bsp_icm20608.c 中 输入 如 下 所 示 内 容 : 
示例 代码 27.3.4 bsp_icm20608.c 文件 代码 


J[ ECKCKCKCKCKCKCkCK Kk Ck kk CkC Kk C KCkCk kk kCk Ck kCk Ck Ck k Ck ck k k Ck k k Ck k k Ck k k Ck k k ck ck k ck ck k ck kk kkk kkk 


Cen rione © viov exeMsshL (Clos bee 1.99(—2/0)1 9). 

















文件 名 JUiospEirem20/60/9fe 
作者 : 左 忠 凯 
版 本 IO 
DAR : ICM20608 驱动 文件 。 
其 他 mn 
论坛 : www.openedv .com 
目 志 : 初版 V1.0 2019/3/26 左 忠 凯 创建 


All rights reserved. 


KOKCKCKCKCKCKCkCk kCkCk kCk k Ck kCkCk k kk k kc k k kc k Ck kc k Ck kCk Ck k kc k k kc k Ck kc k Ck kck ck kck ck ckck ck ckckck kc ke kk f 


qoem vede MIS Sont m 21019 0/6 nn 
finclude "bsp delay.h" 
inele "ssp: Seu. m" 
finclude "stdio.h" 


struct icm20608 dev struc icm20608 dev; / 


CO = CS 


/ * 


«o 
* 


(description  : 初始 化 ICM20608 
Qparam er 


HBe pe 
N 所 o 
+ 


x 
unsigned char icm20608 init(void) 


{ 


e He he 
(Ox e O 


unsigned char regvalue; 


e 
OY 


goio pin contig t (GS nEO7 


~] 


yn 


Ex 
co 





* icm20608 设备 */ 


* Qreturn : 0 初始 化 成 功 ， 其 他 值 初始 化 失败 
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19 * ECSPI3 SCLK -> UART2 RXD 

20 ** JE(CISJeILS) PULSIO) > IUNSUPAS jus 

2b AREE SEIS NEMO SH UART ELS 

212 rA 

25 IOMUXC SetPinMux(IOMUXC UART2 RX DATA ECSPI3 SCLK, 0); 

24 IOMUXC SetPinMux(IOMUXC UART2 CTS B ECSPI3 MOSI, 0); 

25 IOMUXC SetPinMux(IOMUXC UART2 RTS B ECSPI3 MISO, 0); 

26 IOMUXC SetPinConfig(IOMUXC UART2 RX DATA ECSPI3 SCLK, 0x10B1); 
2n IOMUXC SetPinConfig(IOMUXC UART2 CTS B ECSPI3 MOSI, O0x10B1); 

28 IOMUXC SetPinConfig(IOMUXC UART2 RTS B ECSPI3 MTSO, Ox10B1); 

29 

30 /* ”初始 化 片 选 引 脚 */ 

Sl IOMUXC SetPinMux (IOMUXC UART2 TX DATA GPIO1 IO20 P OR 

32 IOMUXC SetPinConfig (IOMUXC UART2 TX DATA GPIO1 IO20 220:007:8180) 00) 

ES cs config.direction = kGPIO DigitalOutput; 

34 cs config.outputLogic = 0; 

25 golo imit (GIPIO , 20, Ces Cui) 

36 

2 /* 2. TUB SPI */ 

38 spi init (ECSPIS); 

ES 

40 icm20608 write reg(ICM20 PWR MGMT 1, 0x80); /* 复位 E 

41 delayms (50); 

42 icm20608 write reg(ICM20 PWR MGMT 1, 0x01); /* 关闭 睡眠 =*/ 

43 delayms (50); 

44 

45 regvalue = icm20608 read reg(ICM20 WHO AM I); 

46 printf("icm20608 id - $4XXrMn", regvalue); 

47 if(regvalue != ICM20608G ID && regvalue != ICM20608D ID) 

48 return |; 

49 

50 icm20608 write reg(ICM20 SMPLRT DIV, 0x00);  /* 输出 速率 设置 d 
Sil icm20608 write reg(ICM20 GYRO CONFIG, 0x18); /* 陀螺 仪 上 2000dps */ 
52 icm20608 write reg(ICM20 ACCEL CONFIG, 0x18); /* 加 速度 计 +16G —*/ 
53 icm20608 write reg(ICM20 CONFIG, 0x04); /* 陀螺 BW=20Hz  */ 
54 icm20608 write reg(ICM20 ACCEL CONFIG2, 0x04); 

55 icm20608 write reg(ICM20 PWR MGMT 2, 0x00);  /* 打开 所 有 轴 su 
56 icm20608 write reg(ICM20 LP MODE CFG, 0x00); /* 关闭 低 功 耗 m 
57 icm20608 write reg(ICM20 FIFO EN, 0x00); /* RE FIFO a 
58 return 0; 

SINE 

60 

61 /* 
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62  * edescription  : 写 ICM20608 指定 寄存 器 

63 * (üiparam - reg : 要 读 取 的 寄存 器 地 址 

64  * Qparam - value : 要 写 入 的 值 

65  * Qreturn 8 B 

66 y 

67 void icm20608 write reg(unsigned char reg, unsigned char value) 
68 ( 

69 /* ICM20608 在 使 用 SPI 接口 的 时 候 寄 存 器 地 址 只 有 低 7 位 有 效 ， 

70 * 寄存 器 地 址 最 高 位 是 读 / 写 标 志 位 ， 读 的 时 候 要 为 1， 写 的 时 候 要 为 0。 

gi a 

122 reg &= «0X80; 

7/8) 

74 ICM20608 CSN(0); /* 使 能 SPI 传输 i 

75 spich0 readwrite byte(ECSPI3, reg); /* 发 送 寄存 器 地 址 —*/ 

76 Spich0 readwrite byte(ECSPI3, value); /* 发 送 要 写 入 的 值 a 

77 ICM20608 CSN(1); /* 禁止 SPI 传输 */ 

po. 

35, 

Gu) qe 

81  * QGdescription  : 读 取 ICM20608 寄存 器 值 

82 * (üiparam - reg : 要 读 取 的 寄存 器 地 址 

83 * Qreturn : 读 取 到 的 寄存 器 值 

84 ay 

85 unsigned char icm20608 read reg(unsigned char reg) 

Sof 

87 unsigned char reg val; 

88 

89 /* ICM20608 在 使 用 SPI 接口 的 时 候 寄 存 器 地 址 只 有 低 7 位 有 效 ， 

90 * 寄存 器 地 址 最 高 位 是 读 / 写 标志 位 ， 读 的 时 候 要 为 1， 写 的 时 候 要 为 0。 

91 本 网 

92 reg |= 0x80; 

93 

94 ICM20608 CSN(0); /* 使 能 SPI 传输 2 
95 spich readwrite loye (UC SPIS, Teg); /* 发 送 寄 存 器 地 址 ii 
96 reg val = spich0 readwrite byte(ECSPI3, OXFF);/* 读 取 寄存 器 的 值 */ 
97 ICM20608 CSN(1); /* 禁止 SPI 传输 */ 
98 return(reg val); /* 返回 读 取 到 的 寄存 器 值 */ 
o9 P 

100 

OE mss 

102 * Qdescription  : 读 取 ICM20608 连续 多 个 寄存 器 

103 * Qparam - reg  : 要 读 取 的 寄存 器 地 址 

104 * Qreturn : 读 取 到 的 寄存 器 值 
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JH = / 


Ioe void ena me mm (mem Cher re, Unsignal! Char Aruk, 


unsigned char len) 
10991 
108 unsigned char i; 
109 
110 /* ICM20608 在 使 用 ser 接口 的 时 候 寄 存 器 地 址 ， 只 有 低 7 位 有 效 ， 
Ta * 寄存 器 地 址 最 高 位 是 读 / 写 标志 位 读 的 时 候 要 为 1， 写 的 时 候 要 为 0。 
36102] e 








dL) reg |» 0x80; 

114 

MS ICM20608 CSN(0); /* 使 能 SPI 传输 a 
116 Spich0 readwrite byte(ECSPI3, reg);/* 发 送 寄 存 器 地 址 */ 
Jpn for(i = 0; i < len; i++) /* 顺序 读 取 寄存 器 的 值 */ 
S { 

TO buf[i] 2 spich0 readwrite byte(ECSPI3, OXFF); 

120 } 

12] ICM20608 CSN(!); /* 禁止 SPI 传输 */ 
1220) 

123 

124 /> 

125 * @description : 获取 陀螺 仪 的 分 辩 率 

126 * Gparam 3 JE 

1 = Ree : 获取 到 的 分 辨 率 

128 o 

129 float icm20608 gyro scaleget (void) 

TSOR 

Veni unsigned char data; 

3512 float gyroscale; 

193 

134 data = (icm20608 read reg(ICM20 GYRO CONFIG) »» 2) & 0X3; 
T35 switch (data) { 

1S6 case 0: 

Toy gyroscale = 131; 

MS break; 

ESI case 1|: 

140 gyroscale = 65.5; 

141 break; 

142 case 2: 

143 gyroscale - 32.8; 

144 break; 

145 case 3: 

146 gyroscale = 16.4; 
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147 break; 

148 ) 

149 return gyroscale; 

1500) 

iL Sut 

152 f* 

153 * Qdescription : 获取 加 速度 计 的 分 辩 率 
154 * Qparam 8 JE 

Jm. = Cretti : 获取 到 的 分 辨 率 

do. suf 

157 unsigned short icm20608 accel scaleget (void) 
T52 

i59 unsigned char data; 

160 unsigned short accelscale; 

ie 

162 data = (icm20608 read reg(ICM20 ACCEL CONFIG) »» 3) & 0X3; 
163 switch(data) ( 

164 case 0: 

JG) accelscale = 16384; 

166 break; 

dE) case 1|: 

168 accelscale = 8192; 

169 break; 

170 case 2: 

3E T3 accelscale - 4096; 

LZ break; 

dE 353] case 3: 

174 accelscale = 2048; 

dL break; 

HE } 

ET return accelscale; 

eny 

1579 

Te S 

181 * @description : 读 取 ICM20608 的 加 速度 、 陀 螺 仪 和 温度 原始 值 
52 8 3 

183 = Greturn 8 XB 

Mea y 

185 void icm20608 getdata (void) 

186 ( 

de float gyroscale; 

188 unsigned short accescale; 

189 unsigned char data[14]; 
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1.91 icm20608 read len(ICM20 ACCEL XOUT H, data, 14); 

T92 

T93 gyroscale — icm20608 gyro scaleget(); 

194 accescale = icm20608 accel scaleget(); 

195 

196 icm20608 dev.accel x adc - (signed short) ((data[0] «« 8) | 
data[1]); 

S icm20608 dev.accel y adc = (signed short) ((data[2] «« 8) | 
data[3]); 

198 icm20608 dev.accel z adc - (signed short) ((data[4] «« 8) | 
data[5]); 

199 icm20608 dev.temp adc = (signed short) ((data[6] << 8) | 
data[/]); 

200 icm20608 dev.gyro x adc - (signed short) ((data[8] «« 8) | 
data[9]); 

2X0 icm20608 dev.gyro y adc = (signed short) ((data[10] «« 8) | 
datar T 8 

202 icm20608 dev.gyro z adc = (signed short) ((data[12] «« 8) | 
data[13]); 

208 

204 /* 计算 实际 值 */ 

205 icm20608 dev.gyro x act = ((float) (icm20608 dev.gyro x adc) / 
gyroscale) * 100; 

206 icm20608 dev.gyro y act = ((float) (icm20608 dev.gyro y adc) / 
gyroscale) * 100; 

207 icm20608 dev.gyro z act = ((float) (icm20608 dev.gyro z adc) / 
gyroscale) * 100; 

208 icm20608 dev.accel x act = ((float) (icm20608 dev.accel x adc) / 
accescale) * 100; 

209 icm20608 dev.accel y act = ((float) (icm20608 dev.accel y adc) / 
accescale) * 100; 

210 icm20608 dev.accel z act = ((float) (icm20608 dev.accel z adc) / 
accescale) * 100; 

ZEE icm20608 dev.temp act = (((float) (icm20608 dev.temp adc) - 25) / 
SIC L AS MENTO 

2302 





文件 bsp imc20608.c 是 ICM20608 的 驱动 文件 ， 里 面 有 7 个 函数 ， 我 们 依次 来 看 一 下 。 第 
1 个 函数 是 icm20608_init， 这 个 是 ICM20608 的 初始 化 函数 ， 此 函数 先 初始 化 ICM20608 所 使 











片 选 引 脚 设置 成 了 普通 的 输出 模式 。 设 置 完 


























用 的 SPI 引 脚 ， 将 其 复 用 为 ECSPI3 。 因 为 我 们 本 章 的 SPI 片 选 采用 软件 控制 的 方式 ， 所 以 SPI 




















SPI 所 使 用 的 引 脚 以 后 就 是 调用 函数 spi, init 来 初 














始 化 SPI3， 最 后 初始 化 ICM20608， 就 是 配置 ICM20608 的 寄存 器 。 第 2 个 和 第 3 个 函数 分 别 
是 icm20608 write reg fll icm20608 read reg, 这 两 个 函数 分 别 用 于 写 / 读 ICM20608 的 指定 寄存 
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器 。 第 4 个 函数 是 icm20608_read len， 此 函数 也 是 读 取 ICM20608 的 寄存 器 值 ， 但 是 此 函数 可 
以 读 取 连续 多 个 寄存 器 的 值 ， 一 般 用 于 读 取 ICM20608 传感器 数据 。 第 5 和 第 6 个 函数 分 别 是 
icm20608 gyro scaleget 和 icm20608_accel_scaleget， 这 两 个 水 数 分 别 用 于 获取 陀螺 仪 和 加 速度 











计 的 分 辩 紊 ， 因 为 陀螺 仪 和 加 速度 的 测量 范围 设置 的 不 同 ， 其 分 辨 率 就 不 同 ， 所 以 在 计算 实际 
值 的 时 候 要 根据 实际 的 量程 范围 来 得 到 对 应 的 分 辨 率 。 最 后 一 个 函数 是 icm20608_getdata， 此 
函数 就 是 用 于 获取 ICM20608 的 加 速度 计 、 陀 螺 仪 和 温度 计 的 数据 ， 并 且 会 根据 设置 的 测量 范 
围 计算 出 实际 的 值 ， 比 如 加 速度 的 g 值 、 陀 螺 仪 的 角速度 值 和 温度 计 的 温度 值 。 
最 后 在 main.c 中 输入 如 下 内 容 : 
示例 代码 27.3.5 main.c 文件 代码 


/大 大 大 大 炎炎 炎炎 火炎 炎炎 炎炎 炎炎 火炎 大 大火 火炎 火炎 大 大 大 大 火炎 大火 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 炎炎 大 大 大 大 大 大 大 大 大 大 大 大 






































Copyright o uoZongleadw COn ree gie 20 OASIS gites Ee Sc Ted. 
文件 名 8 MLAN E 

















作者 : 左 忠 凯 
版 本 AD 
DAR : I.MX6U 开发 板 裸 机 实验 19 SPI 实验 
其 他 : SPI 也 是 最 常用 的 接口 ，ALPHR 开发 板 上 有 一 个 6 轴 传 感 器 TCM20608， 





这 个 六 轴 传 感 器 就 是 SPI 接口 的 ， 本 实验 就 来 学 习 如 何 驱动 .MX6U 
的 SPI 接口 ， 并 且 通 过 ser 接口 读 取 ICM20608 的 数据 值 。 
论坛 : www.openedv.com 


spi : 初版 V1.0 2019/1/17 左 忠 凯 创建 


类 炎炎 火炎 大火 类 类 大 类 类 类 大 类 类 类 大 类 类 类 大 类 类 类 大 类 类 大 大 类 大 大 大 类 大 大 大大 大 类 大 类 大 大 大 类 大 类 大 类 大 大 大 大 大 类 大 大 大 大 大 f 





ne ee 
2 #include "bsp delay.h" 

3  4include "bsp led.h" 

4  dinclude "bsp beep.h" 

5  dinclude "bsp key.h" 

5 TLnelunoe “bsp sume sms 

1  aaumel(eke "eee veiei -Ini 

9. ieee Hosp lee ln 

DEME cdd "os en 

10) me lel lem Oe 
i neem ss 
L2H "stdio.h" 








ls 

d Ax 

15  * Qdescription  : 指定 的 位 置 显示 整数 数据 
16 parami 2 : X 轴 位 置 

jb nam = : Y 轴 位 置 

18 * Qparam - size : FAN 

1.6) “~ [Caanran = mwi : 要 显示 的 数据 

20 = Qreturn 3 JE 

2d mr 


one es (saemee en use en 
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unsigned char size, signed int num) 


ZEE 

24 char dextri O29)01] 

25 

26 lee Fill( yy x v S05 y xe Size, titled olew.losclhcolos) 
2 

28 memset(buf, 0, sizeof(buf)); 

29 if (num < 0) 

30 Soreang (dowudt, "cg". campum) P 

Syl else 

22 Sloane ue (o0 "UTD". saw) p 

233 lel show stringlz, y; S0, Size, Size, Dut) ; 

34 } 

35 

Sie que 

37  * Q(description  : 指定 的 位 置 显示 小 数 数据 , 比如 5123， 显 示 为 51.23 
38 ** eparami FX : X 轴 位 置 

99 Separa mim : Y 轴 位 置 





40  * @param - size : 字体 大 小 

41  * Qparam - num  : 要 显示 的 数据 ， 实 际 小 数 扩大 100 fi. 

42  * Qreturn 8 b 

dS A 

44 void decimals display(unsigned short x, unsigned short y, 


unsigned char size, signed int num) 





45 { 

46 signed int integ;  /* EUN */ 

47 signed int fract;  /* Ahania */ 

48 signed int uncomptemp - num; 

49 char buf [200]; 

50 

Sal, if(num « 0) 

52 uncomptemp = -uncomptemp; 

53 integ = uncomptemp / 100; 

54 fract = uncomptemp $ 100; 

55 

56 memset(buf, 0, sizeof(buf)); 

7 if(num « 0) 

58 Boe (Moup le mee ite) P 
59 else 

60 spein (OUR Vel. ol", ee Ire) 

61 lee TALL, yy x v 60,5 y v Size, titled clew.oseleolox) ? 
62 leel show strings, Yy CGU, Size, Silke, DUT); 
5B) 
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64 

GE ghe 

66  * QGdescription  : 使 能 I.MX6U 的 硬件 NEON 和 FPU 

67 * (üiparam 3 JE 

68  * Qreturn 8 XB 

69 s 

70 | void imx6ul hardfpu enable (void) 

qu 

72 uint? i Gacr? 

ES i92 1. PERCE 

74 

75 /* 使 能 NEON 和 FPU */ 

76 Gee c Get CIZXCOR() 2 

gy cpacr — (cpacr & «(CPACR ASEDIS Msk | CPACR D32DIS Msk)) 
78 | (Su ««s CPACR EPLO Pos) | (su «s CACR coll Pos? 
79 SSE ebrei ouem 

80 fpexc = get FPEXC(); 

ll fpexc |= 0x40000000UL; 

82 . Set IPIEXC(upesse p 

S3. 

84 

9. Jes 

86  * Qdescription : main 函数 

87 * (üiparam 下 

88  * Qreturn a E 

99  *f 

90 int main(void) 

9T 

07 unsigned char state - OFF; 

9S 

94 imx6ul hardfpu enable(); /* 使 能 工 .Mx6U 的 硬件 浮 点 a 
95 int init() e /* 初始 化 中 断 (一 定 要 最 先 调用 ! ) */ 
96 imx6u clkinit(); /* 初始 化 系统 时 钟 ey 
2 delay init(); /* 初始 化 延 时 ne 
98 cIkcensblet); /* 使 能 所 有 的 时 钟 m 
99 lea imit) p /* 初始 化 leqd s 
100 ^ beep init(); /* 初始 化 beep 2 
101 vart imit) p /* 初始 化 串口 ， 波 特 率 115200 */ 
102 led init () p /* 初始 化 LCD */ 
103 

104 IEEELLEG cle vase oreco lori METER GT REDS 

105 recle wars eg (O9 OP 0 AT OP EDU rU 


(char*) iA S10 SM IS I2 IS S UICE LUN P 
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106 ite ch owes ed (5 OP MEO O00 MI GMT ea) TeS) E 
ION le oslo ee (SO 0200 i$ (emet) RNIBORAGUAME NR 
108 luere] sime senes (0, SU, 200, li&, i&, (het V2019/3/2]9)g 
109 
110 while(icm20608 init()) /* 初始 化 ICM20608 */ 
aLa { 
112 ecl wil, eani cy (es OP RENT OP) P MNT CU MENTI 
(char*)"ICM20608 Check Failed!"); 
dL 8 delayms (500); 
TA ecms how Sen 1/907 2005 i95 i$ 
(char*)"Please Check! Um) 
Ss delayms (500); 
mig } 
LIL eee ow se O200 6 6 (na a CRUZ IXexsrohy 9 P 
118 Ael ev teing (90, i 300, 200, i15 l&, (emet ec) 
119 lexel sue muEe3ae (50, lis, Z0, lio, lom (ele) "eaceel ws» 
120 lel sey &neeshe (30, 1705 200,5 i16, l6; (nest) "eweeel zs"»g 
12a se els noes ee (505 1905, 290. l6, Jc, ((eluev) ewueo cx" 
122 Jer show siemens ZU, Z0, i6, lo, (emet) esso eA 
123 leol saow Strings, 290, 290, kep 6 (Eaa Wyo za" 
124 J.eel symewy Sese (50, 250,5 2005 i6, l6 (einst) "eme MES 
125 Jiexel simo se «» dp I5, 90 ear) 
126 dier] sume Sese: (90 «» i90, d 50,5 2005 JG, l5 (na "gg 
15287 lexel sues Exsinex (5 «s i9dlo IJ 4905 2005, l5 I$, (ieu) "gy 
1152/8] lee gimey enexsseg (50 s» i835 i99, 200; 1$. IG. (emet) os") 
129 lod show ətriag(50 + 181, 210, 200, 16, 16, (char*)"o/32"); 
130 lel] eumewy menexsueg (0 ol 259, 200. 1, 16, (lesu "oss 
T31 le os hewn ne (SO S200 Car) 
1532. 
193 tftlcd dev.forecolor - LCD BLUE; 
134 
T35 while(1) 
TSE { 
137 icm20608 getdata(); /* 获取 数据 值 */ 
138 /* 在 LCD 上 显示 原始 值 */ 
139 integer display (>39 © 10; 130; Le, Len20608 dev accel x ace); 
140 integer display (s0 > TU, 150, 16; 1em20608 cer accel y ade), 
141 integer chisplew(50 x» V0; iU, i55 aeu20608 cev accel z ecl); 
HT integer Cisplay(50 x» VO, 190, $5 L120608 dev- -gyro x ade)? 
143 integer display (30 © vU, 2105 Le, aeu20608 cev gyro y ace) p 
144 aumiegese ohbepellenvy((5(0U d» wUr 25405 i5, en OOE) 
145 integer display(50 * 70, 250, 16, icm20608 dev.temp adc); 
146 


640 


I.MX6U HX Linux 驱动 开发 指南 e» 1E za [m T 

















原子 哥 在 线 教学 : www.yuanzige.com 论坛 :Www.opendev.com 

147 /* 在 ICD 上 显示 计算 得 到 的 原始 值 */ 

148 Glecsbmedis gohispdhes (50 «s» UU s» 55 I305 1 
nemo accel x act) p 

149 Gleceunsdis Mons dey (OO 0 
em cev- accel ye 

IEO) Glecials ohiegdhes (S000 
icemu200608 dey- accel z ecu); 

151 eleeiuasdls ens ede (50 « OO 
icm20608 dev.gyro x act); 

T52 Glec:wals ohiepdhes (SO O00 
icm20608 dev.gyro y act); 

153 Glee3uasdis ghispeuheug (50 O00 
icm20608 dev.gyro z act); 

TSA Gleeials ohiepubew(s0 «» /U s» 595 2505 1$, 
icm20608 dev.temp act); 

155 delayms (120); 

T56 state = !state; 

157 led switch(LED0,state); 

158 } 

1,819) return 0; 

d 608) 














文件 main.c 一 开始 有 两 个 函数 integer. display 和 decimals display, 这 两 个 函数 用 于 在 LCD 
上 显示 获取 到 的 ICM20608 数据 值 , 函数 integer. display 用 于 显示 原始 数据 值 , 也 就 是 整数 值 。 
函数 decimals display 用 于 显示 实际 值 , 实际 值 扩大 了 100 倍 ,此 函数 会 提取 出 实际 值 的 整数 部 
分 和 小 数 部 分 并 显示 在 LCD 上 。 另 一 个 重要 的 函数 是 imx6ul_ hardfpu_enable， 这 个 函数 用 于 开 
启 LMX6U 的 NEON 和 硬件 FPU( 浮 点 运算 单元 )， 因 为 本 章 使 用 到 了 浮 点 运算 ， 而 LMX6U 的 
Cortex-A7 是 支持 NEON 和 了 FPU(VFPV4_D32) 的 ， 但 是 在 使 用 LMX6U 的 硬件 FPU 之 前 是 先 要 
开启 的 。 

第 110 行 调用 了 函数 icm20608 _init 来 初始 化 ICM20608， 如 果 初 始 化 失败 的 话 就 会 在 LCD 
上 闪烁 提示 语句 。 最 后 在 main 函数 的 while 循环 中 不 断 的 调用 函数 icm20608_getdata 获取 
ICM20608 的 传感器 数据 ， 并 且 显 示 在 LCD 上 。 实 验 程序 编写 就 到 这 里 结束 了 ， 接 下 来 就 是 编 
译 、 下 载 和 验证 了 。 


27.4 编译 下 载 验证 
27.4.1 编写 Makefile 和 链接 脚本 


修改 Makefile 中 的 TARGET 为 icm20608, 然后 在 在 INCDIRS 和 SRCDIRS 中 加 入 “bsp/spi” 
和 “bsp/icm20608” 修改 后 的 Makefile 如 下 : 
示例 代码 27.4.1.1 Makefile 文件 代码 


































































































1 CROSS COMPILE ?-2 arm-linux-gnueabihf- 
2 TARGET ?2 icm20608 

B 

4 /7* 省 略 掉 其 它 代 码 ...... m 
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5 

5 LINODIRS -=n 

Y stdio/include \ 
8 bsp/clk y 

9 bsp/led \ 

10 bsp/delay y 

al bsp/beep \ 

12 bsp/gpio \ 

T3 bsp/key \ 

14 bsp/exit \ 

15 bsp/int WV 

16 bsp/epittimer \ 
17 bsp/keyfilter \ 
18 bsp/uart N 

19 bsp/lcd WV 

20 bao rte y 

21 bsp/i2c wN 

2 bsp/ap3216c \ 
23 bsp/spi \ 

24 bsp/icm20608 

25 

26 SRCDIRS se SEE 

gu stdio/lib y 

28 bsp/clk y 

29 bsp/led \ 

30 bsp/delay \ 

31 bsp/beep V 

E bsp/gpio \ 

8S bsp/key V 

34 bsp/exit \ 

35 bsgp/inmt \ 

36 bsp/epittimer \ 
37 bsp/keyfilter \ 
38 bsp/uart N 

39 bsp/lcd WV 

40 bsp/rtc V 

41 bsp/i2ec N 

42 bsp/ap3216c \ 
43 bsp/spi WN 

44 bsp/icm20608 

45 

46 /* 省 上 略 掉 其 它 代码 ...... 3d 

47 
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as SCOBJS) 2 ej/5.9 B we 


49 $(CC) -Wall -marchzarmv7-a -mfpu-neon-vfpv4 -mfloat-abi-hard -Wa, 
= ee En une neoslEeon mol 
-c -02 $(INCLUDE) -o $@ $< 





50 
Sir elean: 
57 mM cc S TUBAE BITES ine (ARGETA SEES ETARGET ONES (COBUS S COBISS) 
第 2 行 修改 变量 TARGET 为 “icm20608” 也 就 是 目标 名 称 为 “ap3216c”。 
第 23 和 24 行 在 变量 INCDIRS 中 添加 SPI 和 ICM20608 的 驱动 头 文件 (.h) 路 径 。 
第 43 和 44 行 在 变量 SRCDIRS 中 添加 SPI 和 ICM20608 驱动 文件 (.c) 路 径 。 
第 49 行 加 入 了 “-march=armv7-a -mfpu-neon-vfpv4 -mfloat-abi=hard” 指 令 ， 这 些 指令 ) 

































































j 于 



































指定 编译 浮 点 运算 的 时 候 使 用 硬件 FPU。 因 为 本 章 使 用 到 了 浮 点 运算 ， 而 LMX6U 是 支持 硬件 
FPU 的 ， 虽 然 我 们 在 main 函数 中 已 经 打开 了 NEON 和 FPU， 但 是 在 编译 相应 C 文件 的 时 候 也 
























































要 指定 使 用 硬件 FPU 来 编译 浮 点 运算 。 
链接 脚本 保持 不 变 。 








27.4.2 编译 下 载 



































使 用 Make 命令 编译 代码 , 编译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 icm20608.bin 











文件 下 载 到 SD 卡 中 ， 命 令 如 下 : 
chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 
Jimxdownload icm20608.bin /dev/sdd / 烧 写 到 SD 卡 中 























烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 。 如 果 ICM20608 工作 











正常 的 话 就 会 在 LCD 上 显示 获取 到 的 传感器 数据 ， 如 图 27.4.2.1 所 示 : 

















图 27.4.2.1 LCD Af 


























在 图 27.4.2.1 中 可 以 看 到 加 速度 计 Z 轴 在 静止 状态 下 是 0.98g. 这 不 正 是 重力 加 速度 。 温 
传感器 测量 到 的 温度 是 31.39”C， 这 个 是 芯片 内 部 的 温度 ， 并 不 是 室温 ! 芯片 内 部 温度 一 般 
比 室温 高 。 如 果 动 一 下 开发 板 的 话 加 速度 计 和 陀螺 仪 的 数据 就 会 变化 。 
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第 二 十 八 章 多 点 电容 触摸 屏 实 验 





随 着 智能 手机 的 发 展 ， 电 容 触摸 屏 也 得 到 了 飞速 的 发 展 。 相 比 电阻 触摸 屏 ， 电 容 触摸 屏 有 
很 多 的 优势 ， 比 如 支持 多 点 触 控 、 不 需要 按压 ， 只 需要 轻 轻 触摸 就 有 反应 。ALIENTEK 的 三 款 
RGB LCD 屏幕 都 支持 多 点 电容 触摸 ， 本 章 就 以 ATK7016 iXX RGB LCD 屏幕 为 例 讲解 一 下 如 
何 驱 动 电容 触摸 屏 ， 并 获取 对 应 的 触摸 坐标 值 。 
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28.1 多 点 电容 触摸 简介 
触摸 屏 很 早 就 有 了 ， 一 开始 是 电阻 触摸 屏 ， 





功能 机 时 代 被 广泛 使 用 。2007 年 1 月 9 日 苹果 发 


























论坛 :Www.opendev.com 





电阻 触摸 屏 只 能 单 点 触摸 ， 在 以 前 的 学 习 机 、 
布 了 划时代 的 第 一 代 Iphone， 也 就 是 Iphone 


2G, Iphone 2G 上 使 用 了 多 点 电容 触摸 屏 ， 而 当时 的 手机 基本 都 是 使 用 的 电阻 触摸 屏 。 电 容 触 
摸 屏 优秀 的 触摸 品质 和 手感 瞬间 征服 了 消费 者 ， 带 来 了 手机 触摸 屏 的 大 变革 ， 后 面 新 出 的 手机 











也 都 采用 了 多 





E - 
y 3 FH 











用 ， 手机、 平板 、 电 脑 
不 可 能 绕 过 去 的 。 所 以 本 章 我 们 就 来 学 习 一 下 如 何 使 月 
关于 电容 屏 的 物 到 
我 们 只 需要 关注 如 何 使 用 电容 屏 ， 如 何 得 到 其 多 点 触 
LCD 屏幕 都 是 支持 5 点 电容 触摸 屏 的 ， 本 章 我 们 同村 
用 多 点 电容 触摸 屏 。 

ATK-7016 这 款 屏幕 其 实 是 由 TFT LCD+ 触 摸 屏 组 合 起 来 的 。 底 下 是 LCD 
摸 面板 ， 将 两 个 封装 到 一 起 就 成 了 带 有 触摸 屏 
驱动 IC 一 般 会 提供 一 个 DC 接口 























的 ， 

















容 触 
的 电阻 屏 也 支持 多 点 触 
给 予 一 定 的 压力 才 有 反应 ， 而 且 电容 房 
































摸 屏 。 和 电阻 触 






































摸 屏 相 比 ， 电 容 触摸 屏 最 大 的 优点 是 支持 多 点 触摸 (后 面 





摸 ， 但 是 为 时 已 晚 )， 电 容 屏 只 需要 手指 轻 触 即 可 ， 而 电阻 屏 是 需要 手指 

















、 广 告 机 等 等 ， 






































以 ATK-7016 这 款 屏幕 为 








不 需要 校准 。 如 今 多 点 电容 触摸 屏 已 经 得 到 了 广泛 的 应 
如 果 要 做 人 机 交互 设备 的 开发 ， 多 点 电容 触摸 屏 基 本 是 
日 多 点 触摸 屏 ， 如 何 获取 到 多 点 触摸 值 。 
原理 我 们 就 不 去 研究 了 , 毕竟 我 们 不 是 开发 电容 屏 的 , 而 是 电容 屏 的 使 用 者 ， 
摸 坐 标 值 即 可 。ALIENTEK 的 三 款 RGB 











列 来 讲解 如 何 使 











用 板 ， 上 面 是 触 


























给 主 控 制 器 ， 主 控制 器 可 以 通过 I2C 接 





的 LCD 屏幕 。 电 容 触摸 屏 也 是 需要 一 个 驱动 IC 











口 来 读 取 驱动 IC 





里 面 的 触摸 坐标 数据 。ATK-7016、ATK-7084 这 两 款 屏 幕 使 用 的 触摸 控制 IC 是 FT5426，ATK- 
4342 使 用 的 驱动 IC 是 GT9147。 这 三 个 电容 屏 触摸 IC 都 是 I2C 接口 的 ， 使 用 方法 基本 一 样 。 





FT5426 这 款 驱 动 IC 采用 15*28 的 驱动 结构 ， 也 就 是 15 个 感应 通道 ，28 个 驱动 通道 ， 
多 支持 5 点 电容 触摸 。ATK-7016 的 上 
RST Ñ INT, SCL Ñ SDA 是 DC 引 脚 ，RST 是 复位 引 脚 ， 


脚 来 通知 主 控 


























三 


E 























电容 触摸 屏 部 分 有 4 个 IO 用 于 连接 主 控制 器 : SCL SDA, 











INT 是 中 断 引 脚 。 一 般 通 过 INT 引 





出 器 有 触摸 点 按 下 ， 然 后 在 INT 中 断 服务 函数 中 读 取 触摸 数据 。 也 可 以 不 使 用 中 














断 功 能 ， 采 用 轮 询 的 方式 不 断 查 询 是 否 有 触摸 点 按 下 ， 本 章 实验 我 们 使 用 中 断 方 式 来 获取 触摸 


数据 。 


根 所 有 的 DC 器 件 一 样 ，FT5426 
的 ，LMX6U 的 DC 我 们 





到 了 





r2 s LUB T 





0X00 


其 中 的 一 部 分 


[6:4] 




















模式 寄存 器 


已 经 在 第 二 十 六 章 做 了 详细 的 读 








也 是 通过 读 写 寄存 器 来 完成 初始 化 和 触摸 坐标 数据 读 取 
} 解 ， 所 以 本 章 的 主要 工作 就 是 读 写 
FT5426 的 寄存 器 。FT5426 的 I2C 设备 地 址 为 0X38，FT5426 的 寄存 器 有 很 多 ， 本 章 我 们 只 用 
， 如 表 28.1.1 所 示 : 














设置 FT5426 的 工作 模式 : 
000: 正常 模式 。 

001: 系统 信息 模式 
100: 测试 模式 。 











0X02 


[3:0] 


触摸 状态 寄存 器 


记录 有 多 少 个 触摸 点 ， 
有 效 值 为 1~5。 





0X03 





[7:6] 


第 一 个 触摸 点 X 坐标 高 位 数据 











[3:0] 








事件 标志 : 
00: 按 下 。 
01: 抬 起 
10: 接触 
11: 保留 











X 轴 华 标 值 高 4 位 。 
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0X04 [7:0] | 第 一 个 触摸 点 和 坐标 低位 数据 | 和 X 轴 坐标 值 低 8 位 
0x05 Eo AM Y 坐标 高 位 数据 me - HS 
0X06 [7:0] | 第 一 个 触摸 点 Y 坐标 低位 数据 | Y ebbe 8 位 
0X09 i6] 第 二 个 触摸 点 X 坐标 高 位 数据 | 与 寄存 器 0X03 含义 相同 。 
0X0A [0] | 第 二 个 触摸 点 X 坐标 低位 数据 | 与 寄存 器 0X04 含义 相同 。 
0X0B ies 第 二 个 触摸 点 Y 坐标 高 位 数据 | 与 寄存 器 0X05 含义 相同 。 
0X0C [7:0] | 第 三 个 触摸 点 Y 坐标 低位 数据 | 与 寄存 器 0X06 含义 相同 
OXOF 第 三 个 触摸 点 X 坐标 高 位 数据 | 与 寄存 器 0X03 含义 相同 。 
0X10 [7:0] | 第 三 个 触摸 点 X 坐标 低位 数据 | 与 寄存 器 0X04 含义 相同 。 
0x11 i 第 三 个 触摸 点 Y 坐标 高 位 数据 | 与 寄存 器 0X05 含义 相同 。 
0X12 [0] | 第 三 个 触摸 点 Y 坐标 低位 数据 | 与 寄存 器 0X06 含义 相同 
0X15 i 第 四 个 触摸 点 X 坐标 高 位 数据 | 与 寄存 器 0X03 含义 相同 。 
0X16 [7:0] | 第 四 个 触摸 点 X 坐标 低位 数据 | 与 寄存 器 0X04 含义 相同 。 
0X17 En 第 四 个 触摸 点 Y 坐标 高 位 数据 | 与 寄存 器 0X05 含义 相同 。 
0X18 [7:0] | 第 四 个 触摸 点 Y 坐标 低位 数据 | 与 寄存 器 0X06 含义 相同 
OXIB n 第 五 个 触摸 点 X 坐标 高 位 数据 | 与 寄存 器 0X03 含义 相同 。 
0XIC [50] | 第 五 个 触摸 点 X 坐标 低位 数据 | 与 寄存 器 0X04 含义 相同 。 
OXID ad 第 五 个 触摸 点 Y 坐标 高 位 数据 | 与 寄存 器 0X05 含义 相同 。 
OX1E [7:0] | 第 五 个 触摸 点 Y 坐标 低位 数据 | 与 寄存 器 0X06 含义 相同 
ms | eem [ERIS 
REFERT: 
0X44 [7:0] 中 断 模式 寄存 器 0: 轮 询 模式 
1， 触 发 模式 


























表 28.1.1.1 FT5426 使 用 到 的 寄存 器 表 
表 28.1.1.1 中 就 是 本 章 实 验 我 们 会 使 用 到 的 寄存 器 。 关 于 触摸 屏 和 FT5426 的 知识 就 讲解 到 
这 里 。 


28.2 硬件 原理 分 析 


本 试验 用 到 的 资源 如 下 : 
Q、 指 示 灯 LEDO. 

2. RGB LCD 屏幕 。 
(3)、 触 摸 屏 
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D, mH 

和 触摸屏 是 和 RGB LCD 屏幕 做 在 一 起 的 ， 所 以 触摸 屏 也 在 RGB LCD 接口 上 ， 都 是 连接 在 
LMX6U-ALPHA 开发 板 底板 上 ， 原 理 图 如 图 28.2.1 所 示 : 


32 J2 32 UARTS RXD 122 SDA 
31 J2 31 UARTS TXD LO? SCL 


p JI 48 SNVS TAMPER9 | CT RST 


48 
GPIO 9 CT INT PER n 
GND GND 
































33 732LCD VSYNC Ro 





图 28.2.1 触摸 屏 原 理 图 

从 图 28.2.1 可 以 看 出 ， 触 摸 屏 连 接 这 IMX6U 的 I2C2, INT 引 脚 连接 着 IMX6U 的 
SNVS TAMPERO, RST 引 脚 连接 着 LMX6U 的 GPIO1 I09。 在 本 章 实验 中 使 用 中 断 方式 读 取 
触摸 点 个 数 和 触摸 点 坐标 数据 ， 并 且 将 其 显示 在 LCD E. 


28.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 :， 开发 板 光盘 -> 1、 裸 机 例 程 -> 20_touchscreen。 
本 章 实验 在 上 一 章 例 程 的 基础 上 完成 ， 更 改 工 程 名 字 为 “touchscreen”， 然 后 在 bsp 文件 夹 
下 创建 名 为 “touchscreen” 的 文件 。 在 bsp/touchscreen 中 新 建 bsp_ft5xx6.c 和 bsp. ft5xx6.h 这 两 
个 文件 ， 在 bsp_ft5xx6.h 中 输入 如 下 内 容 : 
示例 代码 28.3.1 bsp_ft5xx6.h 文件 代码 






























































*ifndef  FT5XX6 H 

#define  FT5XX6 H 

J[ KCKCKCKCk kk kk kk kk kk kk ckckck kk kckckckckck ckck ckck ck ck ck ck ck ck ckck ck ck ckck ck ck ckck ck ck ck k ck ck ck ck ck ck ck ck kk 
Copyright el zuneono er eo mae T1998 2H OPE ASINI ToS esee 
文件 名 8. bejo es 

作者 : 左 忠 凯 


CY ET Nm 
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7 版 本 -al 

8 ”描述 : 触摸 屏 驱 动 头 文件 ,触摸 芯片 为 FT5xx6, 

9 包括 FT5426 fll FT5406. 

10 其 他 8 JE 

i vaz : www.openedv.com 

iners : 初版 V1.0 2019/1/21 左 忠 凯 创建 





"S KCKCKCKCKCKCk kCkk kCkck k kk Ck kCk Ck k kk k kc k k kc k Ck k Ck Ck kCk Ck k kc k k kk Ck kc k Ck kck ck kck ck ckck ck ckckck sk ck e k kx f 


14 £4$include "imxó6ul.h" 
LS 






































16 

ANT XR E ACA 

18 $define FT5426 ADDR 0x38  /* FT5426 设备 地 址 */ 

19 

20 4define FT5426 DEVICE MODE 0X00  /* 模式 寄存 器 x 

21 #define FT5426 IDGLIB VERSION  O0XA1 /* 固件 版 本 寄存 器  */ 

22 #define FT5426 IDG MODE 0xA4  /* 中 断 模 式 a 

23 $&define FT5426 TD STATUS oxo2  /* 触摸 状态 寄存 器 */ 

24 #define FT5426 TOUCH1 XH 0x03  /* 触摸 点 坐标 寄存 器 ， 

2 * 一 个 触摸 点 用 4 个 寄存 器 */ 
26 

27 #define FT5426 XYCOORDREG NUM 30 /* 触摸 点 坐标 寄存 器 数量 */ 
28 4define FT5426 INIT FINISHED 1 /* 触摸 屏 初始 化 完成 et 
29 #define FT5426 INIT NOTFINISHED 0 /* 触摸 屏 初 始 化 未 完成 */ 
30 

31 $define FT5426 TOUCH EVENT DOWN 0x00. /4* $E ya 

32 4$define FT5426 TOUCH EVENT UP 0x01  /* 释放 wy 

33 4$define FT5426 TOUCH EVENT ON 0x02  /* 接触 x 

34 4$define FT5426 TOUCH EVENT RESERVED 0x03  /* 没有 事件 */ 




















36 /* 触摸 屏 结构 体 */ 


37 SELEUeE ES420 CEV Scr ue 


28 

39 unsigned char initfalg; /* 触摸 屏 初始 化 状态 e 
40 unsigned char intflag; 7* 标记 中 断 有 没有 发 生  */ 
41 unsigned char point num; /* 触摸 点 
42 unsigned short x[5]; /* Xs */ 
43 unsigned shore yisi; /* Y 轴 坐标 
ae yp 

45 

EEC F426 Cey SEEUB T5426 devy 

47 


48 /* 函数 声明 */ 
4/9) wee ibl (oe 


648 


LMX6U HAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
50 
51 void gpiol io9 irqhandler (void); 


b2gsstemecliel em byte roms me eerta Ma adere, 

unsigned char reg, 

unsigned char data); 
53 unsigned char ft5426 read byte(unsigned char addr, 

unsigned char reg); 
Sb VOLCI TtSAZE real len(unsicnmec char adele one Char iex; 
unsigned char len,unsigned char *buf); 
55 void ft5426 read tpnum(void); 
56 void ft5426 read tpcoord (void); 
57 #endif 

文件 bsp ft5xx6.h 文件 中 先是 定义 了 FT5426 的 设备 地 址 、 寄 存 器 地 址 和 一 些 触摸 点 状态 
宏 ， 然 后 在 第 37 行 定义 了 一 个 结构 体 ft5426_dev_struc， 此 结构 体 用 来 保存 触摸 信息 ， 最 后 就 
是 一 些 函 数 声 明 。 接 下 来 在 bsp_ft5xx6.c 中 输入 如 下 所 示 内 容 : 
示例 代码 28.3.2 bsp_ft5xx6.c 文件 代码 


/大 炎炎 大大 炎炎 火 大 火炎 火 大 火炎 火 大 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 大大 火炎 大大 火炎 大大 火炎 大 大 























Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 


文件 名 SECRe 
作者 : 左 忠 凯 
版 本 a Vi- 0 
描述 : 触摸 屏 驱 动 文 件 , 触摸 芯片 为 FT5xx6， 
包括 FT5426 fll FT5406. 
其 他 e J 
论坛 : www.openedv.com 
às : WI v1.0 2019/1/21 左 忠 凯 创建 


类 类 火炎 火炎 火炎 火炎 火炎 火炎 火炎 类 大 火炎 火炎 火炎 火炎 类 大 类 大 火炎 火炎 火炎 火炎 类 大 火炎 类 大 类 大 类 大 大大 类 大 类 大 类 大 大 大 大 大 类 大 大/ 
i nelute Hosp ire SEES s Iq 

2  sawelwele "log i2. m" 

3. spiele Wosa aaie ini 

4 #include "bsp delay.h" 

5 include "enuohio. m 
6 
7 
8 


grruet EE5426 Cey Struc TES4260 dev? 


ONE 

10 * (description : 初始 化 触摸 屏 ， 其 实 就 是 初始 化 FT5426 
ial * (üiparam e Jb 

12  ** (etus 3 JE 

die yf 

14 void ft5426 init(void) 

dr 

16 unsigned char reg value[2]; 
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307) 

18 ft5426 dev.initfalg — FT5426 INIT NOTFINISHED; 

19 

20 /* 1. 初始 化 TIC2 IO 

21 2 T2CZ Sci > VARIS TD 

22 * I2C2 SDA -» UART5 RXD 

23 z 

24 IOMUXC SetPinMux(IOMUXC UART5 TX DATA I2C2 SCL, 1); 

25 IOMUXC SetPinMux(IOMUXC UART5 RX DATA I2C2 SDA, 1); 

26 IOMUXC SetPinConfig(IOMUXC UART5 TX DATA I2C2 SCL, 0x70B0) ; 

2 IOMUXC Se [Pam onfaq (IOMUXC UART5 RX DATA I2C2 SDA, 0X70B0) ; 

28 

29 /* 2、 初 始 化 触摸 屏 中 断 To 和 复位 IO */ 

30 geio pin Contig t Ctintpin Contig? 

31 IOMUXC SetPinMux(IOMUXC GPIO1 IO09 GPIO1 I0O09,0); 

32 IOMUXC SetPinMux(IOMUXC SNVS SNVS TAMPER9 GPIO5 I0O09,0); 

BS] IOMUXC SetPinConfig(IOMUXC EPIOL IO09 GPIO1 IO09,0xF080); 

34 IOMUXC SetPinConfig (IOMUXC SNVS SNVS TAMPER9 GPIO5 IO09 ,0X10B0); 

35 

36 /* 中 断 IO 初始 化 */ 

27) Etintoln Contig- CAirection = rkEPIO DigitalTnput, 

38 ctintpin config.interruptMode = kGPIO IntRisingOrFallingEdge; 

319 goio imit (GPIOL, C, CEtintpin Contig) f 

40 

41 GIC EnableIRQ(GPIO1 Combined 0 15 IROn); /* 使 能 GIC 中 对 应 的 中 断 */ 

42 system register irqhandler(GPIOl1 Combined 0 15 IROn, 
(system irg handler t)gpiol io9 irghandler, 
NULL); /* 注册 中 断 服务 函数 */ 

43 gpio enableint(GPIOl1, 9); /* 使 能 GPIO1 IO18 的 中 断 功能 */ 

44 

45 /* 复位 IO 初始 化 */ 

46 ctintpin config.direction-kGPIO DigitalOutput; 

47] ctintpin config.interruptMode-kGPIO NoIntmode; 

48 ctintpin config.outputLogiczi; 

49 gopio sbaub ((GIPIQ S, ©, CCtintpin Contig) f 

50 

5il /* 3s WE 12€ */ 

512, i2 imit (05262) 5 

ES 

54 /* 4、 初 始 化 FT5426 */ 

55 gpio pinwrite(GPIO5, 9, 0); /* 复位 ET5426 ef 

56 delayms (20); 

5) 7] Goo pinawrite(CPIToOn, 9, pg Jf fEiE*FT5426 */ 
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58 delayms (20); 

59 ft5426 write byte(FT5426 ADDR, FT5426 DEVICE MODE, 0); 
60 ft5426 write byte(FT5426 ADDR, FT5426 IDG MODE, 1); 

61 ft5426 read len(FT5426 ADDR, FT5426 IDGLIB VERSION, 2, 














reg value); 
62 printf (“rouch Frimware Version:$fXNrWn", 


((asigaso shori) reg rore OE) v reg valuvuefiii) e 








63 ft5426 dev.initfalg = FT5426 INIT FINISHED; /* 标记 初始 化 完成 */ 
64 ft5426 dev.intflag = 0; 

65 ) 

66 

B70/ 

68 * @description  : GPIO1 I09 最 终 的 中 断 处 理 函 数 

69  * Qparam S JE 

Q0 — en 3 JE 

JEU Sy 

72 void gpioli io9 irghandler (void) 

qe di 

74 eus (r2 dey imitirale == FT5426 INIT FINISHED) 
9s; { 

EG J 358 5/42/5, dev.intilag = 1; 

am ft5426 read tpcoord(); 

78 ) 

79 gpio clearintflags(GPIO1, 9); /* 清除 中 断 标 志 位 */ 
80 ) 

81 

euo ge 

83  * Qdescription : 向 FT5426 写 入 数据 


84  * @param - addr : 设备 地 址 

85  * (iparam - reg : 要 写 入 的 寄存 器 

86 * Qparam - data : 要 写 入 的 数据 

87 * Qreturn : 操作 结果 

88 < 

89 unsigned char ft5426 write byte(unsigned char addr, 
unsigned char reg, 


unsigned char data) 


DONE 

EI unsigned char statusz0; 

92 unsigned char writedata=data; 

SB struct 126 transier masterxter, 

94 

95 /* 配置 I2C xfer 结构 体 */ 

96 masterXfer.slaveAddress = addr; /* 设备 地 址 iy 
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e 

98 

Q9 

100 
LON 
102 
103 
104 
10S 
106 
TO 
108 
109 
110 
TAAl 
JE 
MILS) 
114 
TaS 


ACIE 
3.300 
118 
BS 
120 
JL 
12» 
1.275) 
124 
12/5) 
126 
1,279) 
128 
1,258] 
dS) 
1L Syd 
1,312 
133 
134 
135 
1S6 
ILS 


masterXfer 


masterXfer 


masterXfer 


masterXfer 


masterXfer 


.direction = kI2C Write; fs 
.subaddress = reg; s 
.subaddressSize = |; p 
.data = &writedata; JE 
.dataSize = 1; f 


e3i1E B B 


论坛 :www.opendev.com 
写 入 数据 

要 写 入 的 寄存 器 地 址 
地 址 长 度 一 个 字 节 

要 写 入 的 数据 

写 入 数据 长 度 1 个 字 节 


aeg ceamorsrs ml transgter(I2C2, CmasterXier)))) 


statuszi!; 


return status; 


* Qdescription  : 从 FT5426 读 取 一 个 字 节 的 数据 
* Qparam - addr : 设备 地 址 
* Qparam - reg  : 要 读 取 的 寄存 器 


* Qreturn 


E 


: 读 取 到 的 数据 。 


unsigned char ft5426 read byte(unsigned char addr, 


unsigned char reg) 


unsigned char valz0; 


otruct 126 transter nasterXtier, 


m 
m 
m 
m 
m 
m 





12€ mester 


asterXfer. 


as 


asterXfer. 


as 


asterXfer. 


as 


terxfer. 


terXfer. 





terxfer. 


SlaveAddress = addr; PES 
direction = kI2C Read; ipo 
subaddress 2 reg; js 
subaddressSize = 1; JS 
data = &val; f 
datasize = 1; fii 


transfer(I2C2, &masterXfer); 


return val; 


* Qdescription  : 从 ET5429 读 取 多 个 字 节 的 数据 
* Qparam - addr : 设备 地 址 

* Qparam - reg  : 要 读 取 的 开始 寄存 器 地 址 

* (üiparam - len : 要 读 取 的 数据 长 度 . 

* Qparam - buf  : 读 取 到 的 数据 缓冲 区 


* Qreturn 


S 


SE 


设备 地 址 

读 取 数据 

要 读 取 的 寄存 器 地 址 
Raab Ee 
接收 数据 缓冲 区 

读 取 数 据 长 度 1 个 字 节 


sevont ea meam en (ve Char acele ne chai reg, 
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unsigned char len,unsigned char *buf) 











Ton 

140 struct 12e trengter mastarXier,; 

141 

142 masterXfer.slaveAddress = addr; /* 设备 地 址 a 

143 masterXfer.direction = kI2C Read; /* 读 取 数据 ud 

144 masterxfer.subaddress = reg; /* 要 读 取 的 寄存 器 地 址 */ 

145 masterXfer.subaddressSize = 1; /* 地 址 长 度 一 个 字 节 E 

146 masterXfer.data = buf; /* 接收 数据 缓冲 区 */ 

147 masterXfer.dataSize = len; /* 读 取 数据 长 度 1 个 字 节 */ 

148 12e mester trenster(IT202, CmasterXier) e 

149 } 

150 

ME 

152 * Qdescription : 读 取 当 前 触摸 点 个 数 

153 * param 3 JE 

154 * Qreturn 3 JE 

dis, se 

156 void ft5426 read tpnum(void) 

1S7) xl 

158 ft5426 dev.point num = ft5426 read byte(FT5426 ADDR, 
FT5426 TD STATUS); 

155/98) 

160 

Jed. vss 

162 * Qdescription : 读 取 当前 所 有 触摸 点 的 坐标 

163 * Qparam 8 JE 

164 * Qreturn 3 JE 

qo 

166 void ft5426 read tpcoord(void) 

167 ( 

168 unsigned char i - 0; 

S9 unsigned char type = 0; 

170 //unsigned char id = 0; 

3E IE unsigned char pointbuf[FT5426 XYCOORDREG NUM]; 

12 

IS ft5426 dev.point num = ft5426 read byte(FT5426 ADDR, 
FT5426 TD STATUS); 

174 

d TES) VER 


176 * 从 寄存 器 FT5426 TOUCH1 XH 开始 ， 连 续 读 取 30 个 寄存 器 的 值 ， 
iie) * 这 30 个 寄存 器 保存 着 5 个 点 的 触摸 值 ， 每 个 点 占用 6 个 寄存 器 。 
178 =l 
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179 ft5426 read len(FT5426 ADDR, FT5426 TOUCH1 XH, 
FT5426 XYCOORDREG NUM, pointbuf); 
180 SR MET) 
181 ( 
182 unsigned char *buf - &pointbuf[i * 6]; 
183 116541216 Cevo ex (swur[[2] «Ss 5) oul Gi e 
184 ft5426 dev.y[i] =S ((buf[0] «« 8) | buf[1]) & OxOfff; 
185 type = buf[0] >> 6; /* 获取 触摸 类 型 */ 
186 Vo ns: 
187 if(type == FT5426 TOUCH EVENT DOWN || type == 
FT5426 TOUCH EVENT ON )/* 按 下 */ 
188 { 
35/9) 
190 } else (  /* FOX */ 
TOi 
192 } 
19S } 
194 ) 


文件 bsp_ft5xx6.c 中 有 7 个 函数 ,我 们 依次 来 看 一 下 这 7 个 函数 。 第 1 个 是 函数 E5426. init, 
此 函数 是 ft5426 的 初始 化 函数 ， 此 函数 先 初始 化 FT5426 所 使 用 的 1202 接口 引 脚 、 复 位 引 脚 和 
中 断 引 脚 。 接 下 来 使 能 了 FT5426 所 使 用 的 中 断 , 并 且 注 册 了 中 断 处 理 函 数 , 最 后 初始 化 了 DC2 
和 FT5426。 第 2 个 函数 是 gpiol io9 irqhandler， 这 个 是 FT5426 的 中 断 引 脚 中 断 处 理 函 数 ， 在 
此 函数 中 会 读 取 FTS426 内 部 的 触摸 数据 。 第 3 和 第 4 个 函数 分 别 为 ft5426_write byte 和 
ft5426 read byte, PA žr f15426 write byte 用 于 向 FT5426 的 寄存 器 写 入 指定 的 值 ， 函 数 
ft5426 read byte 用 于 读 取 FT5426 指定 寄存 器 的 值 。 第 5 个 函数 是 f,5426 read len, JE PR itis 
是 从 FT5426 的 指定 寄存 器 读 取 数据 ， 但 是 此 函数 是 读 取 数 个 连续 的 寄存 器 。 第 6 个 函数 是 
ft5426 read tpnum， 此 函数 用 于 获取 FT5426 当前 有 几 个 触摸 点 有 效 ， 也 就 是 触摸 点 个 数 。 最 后 
一 个 函数 是 ft5426 read tpcoord， 此 函数 就 是 读 取 FTS426 各 个 触摸 点 坐标 值 的 。 

最 后 在 main.c 中 输入 如 下 内 容 : 

示例 代码 28.3.3 main.c 文件 代码 


/玉米 矿业 火炎 类 类 炎炎 类 大 炎炎 类 大 火炎 类 大 火炎 类 大 类 类 类 大 类 类 大 大 类 类 类 大 类 类 大 大 类 类 大 大 类 类 大 大 大大 大 大 大大 大 大 类 类 大 大 类 大 









































Copy r ghe eo zozneonore ee ro oe. 20M Ann ese or 
文件 名 mese 












































作者 : 左 忠 凯 
版 本 ER NES 
i 述 : I.MX6U 开发 板 裸 机 实验 20 触摸 屏 实验 
其 他 : I.MX6U-ALPHAL 推荐 使 用 正点 原子 -7 F LCD, IEI LCD 支持 5 点 电容 触摸 ， 
本 节 我 们 就 来 学 习 如 何 驱动 CCD 上 的 5 点 电容 触摸 屏 。 
iex : www.openedv.com 
E s : 初版 V1.0 2019/1/21 左 忠 凯 创建 


KOKCKCKCKCkCKCkCk kCkCk k kk Ck kCk Ck kCk Ck k kc k k kk Ck kc k Ck kc kc k k kk k k k k kc k kckck ck kck ck kck ck ckckck kk kk 


i  4pxueedbwwele Wosa c.m" 
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2 tfinclude "bsp delay.h" 

3 4include "bsp led.h" 

4 4include "bsp beep.h" 

5 4include "bsp key.h" 

6 tinclude "bsp int.h” 

7 #include "bsp uart.h" 

8 #include "bsp lcd.h" 

9 4$include "bsp lcdapi.h" 

10 finclude "bsp rtc.h" 

11 f£include "bsp ft5xx6.h" 

damit stein er 

15 

das 

15 * Qdescription : 使 能 工 .MX6U 的 硬件 NEON 和 FPU 
16 * QGparam s JE 

TIU s S EESTI 3 JE 

ig s 

19 void imx6ul hardfpu enable (void) 

20 ( 

Zl Nt 1 Cacr? 

22 unto? i Teze? 

23 

24 /* 使 能 NEON 和 FPU */ 

25 Gjpsex a gat CPACR()S 

26 cpacr = (cpacr & ~(CPACR ASEDIS Mek | CPACR D32DIS Msk)) 
n | (3UL «« CPACR cpl0 Pos) | (3UL «« CPACR cpll Pos); 
28 . Bet CIACE(epeei) 2 

29 ijoesxe —2 get FPEXC()) 7 

30 fpexc |= 0x40000000UL; 

SHl . Set PPEXC (EPERE) ? 

S2 

O9 

34 ~ 

35 * @description : main 函数 

36 * Qparam s Jb 

37 * Qreturn 3 Jb 

Ser o S 

39 int main (void) 

40 ( 

41 unsigned char i = 0; 

42 unsigned char state - OFF; 

43 

44 imx6ul hardfpu enable(); /* 使 能 工 .MX60U 的 硬件 浮 点 
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45 int ade (Ng /* 初始 化 中 断 (一 定 要 最 先 调 用 ! ) */ 
46 imx6u clkinit(); /* 初始 化 系统 时 钟 */ 
zu delay init(); /* 初始 化 延 时 n 
48 clk enable(); /* 使 能 所 有 的 时 钟 */ 
49 led init(); /* 初始 化 1ea */ 
50 beep init(); /* 初始 化 beep x 
51 uere inith)e /* 初始 化 串口 ， 波 特 率 115200 xy 
52 Lecl imie (0) /* 初始 化 LCD */ 
53 SES426 init) y /* 初始 化 触摸 屏 a 
54 
55 证 是 EGG cle vaso ere GE 人 
56 Hedis horis timg (Oo P NT MEER M MET 

(char*)"ALPHA-IMX6U TOUCH SCREEN TEST"); 
59 lcd show string(50, 40, 200, 16, 16, 

(Char) "3IOIUXCISL SICTROSENINI EERS ILU) B 
58 lec ow eo OP QE? P METEO MET E MM (c rers MN 
59 lee gine; sexes (305 90,5 2005; Ie, I&, (iet "2019/3/2]9»g 
60 lel soy sen (50, i105 205 i$ i1 (Chara) EER NUME AD YE 
61 leclio wil resi cn (E50 MES OP MED OP le le (ette Xy onmEe0 
62 edis horis rimo (50, i50, 2005 l&,5 165 (Lean) Wiexsatiae()) Nee W)yp 
63 Jer] Siüswowy gSuEsesbeg (505 1.90 200, 1S5 185 (emer ) isoine oa wg 
64 lel siwoxy se 19075 2005 i95 1$ (nen 
65 Fedisnhonistring (0L 2107 2005, e (redes nm 
66 sees ow sx: (50, 2905, 2005 lG,5 165 (Charn) WiexsatiE 2. Nee) 
67 leche wal oen o (50 P 2S OPEP LO Ge. (Charna NPON ESE AEN) 
68 lel soy mensum (S02 7000 LS/ (Leaves Roinnt el) 
69 lel mios Gnesobeg((»0L 250. 2005. iG G5 (Chara) peste xd) 
70 lel sihwoe sium (50, S105, 2005 lO, 1&5 (etos se Pm d NT 
pal tftlcd dev.forecolor - LCD BLUE; 
712; while(!) 
Tj { 
74 eos lev (0 el 
38 Ed Son S0) sr 72, JLS/0. Eje ceras n Sp 14595 
76 lel simowsewn((59 «x» 725 1505 ix5426 cewowllp 5j i599 
pu le mie d» V2, 170, i5426 eewssx['l; 55 16) 
78 lel simowamm(5) a 725 Il90, zc5426 cews.wlll, 55 1695 
79 lie] simowswR((50) e» Ve 2005 i59426 Cea ly 9p 1599 
80 lel Se «d» 725 2505 ix5426 cewswlzl» 5p i695 
81 lel mimoxswn((540 sr 72, 250, EDA cease 9j 1595 
82 Hedis norminio d 725 270, zw5426 dewswlilo 95 1695 
83 Jiexel misxowsuEMR( S0) sr 02, 2900. 3E 426 ckN/axUI S5 S595 
84 iedishowmumn(o «» 745 S05 ii5426 cleweowlsln 95 i695 
85 
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86 delayms (10); 

87 itt; 

88 

89 if (i == 50) 

90 { 

9) i = 0; 

92 state = !state; 

93 led switch(LED0,state); 
94 } 

95 } 

96 return 0; 

DUNS 


文件 main.c 只 第 53 行 调用 函数 ft5426 init 初始 化 触摸 屏 ， 也 就 是 FTS426 这 个 触摸 驱动 
IC。 最 后 在 main 函数 的 while 循环 中 不 断 的 显示 获取 到 的 触摸 点 数 以 及 对 应 的 触摸 坐标 值 。 因 
为 本 章 实验 我 们 采用 中 断 方式 读 取 FT5426 的 触摸 数据 ， 因 此 main 函数 中 并 没有 读 取 FT5426 
的 操作 ， 只 是 显示 触摸 值 。 本 章 实验 程序 编写 就 到 这 里 ， 接 下 来 就 是 编译 、 下 载 和 验证 


28.4 编译 下 载 验证 
28.4.1 编写 Makefile 和 链接 脚本 


修改 Makefile 中 的 TARGET 为 touchscreen， 然 后 在 INCDIRS 和 SRCDIRS 中 加 入 
“bsp/touchscreen”， 修 改 后 的 Makefile 如 下 : 
示例 代码 28.4.1.1 Makefile 文件 代码 



































o 








1 CROSS COMPILE ?-2 arm-linux-gnueabihf- 
2 TARGET ?= touchscreen 

3 

4 /* 省 略 掉 其 它 代码 ...... ^ 

5 

GERENDIS :2 imx6ul y 

7) stdio/include '^ 
8 bsp/clk N 

9 bsp/led WV 

10 bsp/delay \ 

w bsp/beep \ 

12 bsp/gpio 

13 bsp/key V 

14 bsp/exit \ 

i5 bsp/int V 

JG bsp/epittimer Ñ 
jg bsp/keyfilter \ 
18 bsp/uart \ 

19 loeo le Y 

20 bsp/rtc WV 
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Zl bsp/i2e N 

29 bsp/ap3216c y 
23 bsp/spi NA 

24 bsp/icm20608 \ 
25 bsp/touchscreen 
26 

27 SRCDIRS RES project \ 

28 stdio/lib Ñ 

29 Dsp eiki 

30 bsp/led V 

31 bsp/delay N 

3g bsp/beep V 

33 bsp/gpio AN 

34 bsp/key V 

35 bsp/exit 

36 bap/ int \ 

2) bsp/epittimer 从 
38 bsp/keyfilter \ 
39 bsp/uart \ 

40 bsp/lcd V 

41 bsp/rtc WV 

42 bsp/i2e N 

43 bsp/ap3216c \ 
44 bsp/spi AN 

45 bsp/icm20608 \ 
46 bsp/touchscreen 
47 


48 /* 省 略 掉 其 它 代码 .... 
49 


50 clean: 


51 rm -rf S(TARGET).elf S$(TARGET).dis S(TARGET).bin $(COBJS) $(SOBJS) 
第 2 行 修 改变 量 TARGET 7j "touchscreen", Eik HEREA “touchscreen”. 
第 25 行 在 变量 INCDIRS 中 添加 触摸 屏 的 驱动 头 文件 (路径 。 
第 46 行 在 变量 SRCDIRS 中 添加 触摸 屏 的 驱动 文件 (.c) 路 径 。 








链接 脚本 保持 不 变 。 


28.4.2 编译 下 载 











使 用 Make 命令 编译 人 代码， 编译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 
touchscreen.bin 文件 下 载 到 SD 卡 中 ， 命 令 如 下 : 

































































chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

J/imxdownload touchscreen.bin /dev/sdd / 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 。 默 认 情 况 下 LCD 界 
面 如 图 28.4.2.1 所 示 : 
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ZERO-IMXO6U TOUCH SCREEN TESI 
TOUCH SCREEN TEST 
ATONBALIENTEK 








图 28.4.2.1 默认 LCD 显示 
当 我 们 用 手指 触摸 屏幕 的 时 候 就 会 在 LCD 上 显示 出 当前 的 触摸 点 和 对 应 的 触摸 值 ， 如 图 
28.4.2.2 所 示 : 
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Pointd X: 454 
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Point4d 








图 28.4.2.2 
图 28.4.2.2 中 有 5 个 触摸 点 ， 每 个 触摸 点 的 坐标 全 部 显示 到 了 LCD 屏幕 上 。 如 果 移 动手 指 
的 话 LCD 上 的 触摸 点 坐标 数据 就 会 相应 的 变化 。 
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第 二 十 九 章 LCD 背光 调节 实验 





不 管 是 使 用 显示 器 还 是 手机 ， 其 屏幕 背光 都 是 可 以 调节 的 ， 通 过 调节 背光 就 可 以 控制 屏幕 
的 亮度 。 在 户外 阳光 强烈 的 时 候 可 以 通过 调 高 背光 来 看 清 屏 幕 ， 在 光线 比较 暗 的 地 方 可 以 调 低 
背光 ， 防 止 伤 眼睛 并 且 省 电 。 正 点 原子 的 三 款 RGB LCD 也 支持 背光 调节 ， 本 章 我 们 就 来 学 习 
如 何 调节 LCD 背光 。 
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29.1LCD 背光 调节 简介 
正点 原子 的 三 个 RGB LCD 都 有 一 个 背光 控制 引 脚 ， 给 这 个 背光 控制 引 脚 输入 高 电 平 就 会 

















点 亮 背 光 ， 输 入 低 电 和 平 就 会 关闭 背光 。 a 和 关闭 背光 ， 当 速度 足够 快 的 时 候 
就 不 会 感觉 到 背光 关闭 这 个 过 程 了 。 这 个 正好 可 以 使 用 PWM 来 完成 , PWM 全 称 是 Pulse Width 
Modulation， 也 就 是 脉冲 宽度 调制 ，PWM 信和 号 如 图 29.1.1 所 示 : 
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图 29.1.1 PWM 信和 号 

PWM 信号 有 两 个 关键 的 术语 : 频率 和 占 空 比 , 频率 就 是 开关 速度 , 把 一 次 开关 算 作 一 个 周 
期 ， 那 么 频率 就 是 1 秒 内 进行 了 多 少 次 开关 。 占 空 比 就 是 一 个 周期 内 高 电 平时 间 和 低 电 平时 间 
的 比例 , 一 个 周期 内 高 电 平时 间 越 长 占 空 比 就 越 大 , 反之 占 空 比 就 越 小 。 占 空 比 用 百 分 之 表 示 ， 
如 果 一 个 周期 内 全 是 低 电 平 那么 占 空 比 就 是 0%， 如 果 一 个 周期 内 全 是 高 电 平 那么 占 空 比 就 是 
10095. 

我 们 给 LCD 的 背光 引 脚 输入 一 个 PWM 信和 号， 这样 就 可 以 通过 调整 占 空 比 的 方式 来 调整 
LCD 背光 亮度 了 。 提 高 占 空 比 就 会 提高 背光 亮度 ， 降 低 占 空 比 就 会 降低 背光 亮度 。 重 点 就 在 于 
PWM 信号 的 产生 和 占 空 比 的 控制 ， 很 幸运 的 是 ，I.MX6U 提供 了 PWM 外 设 ， 因 此 我 们 可 以 配 
置 PWM 外 设 来 产生 PWM 信和 号 
打开 《LMX6ULL 参考 手册 》 的 第 40 3^ Chapter 40 Pulse Width Modulation(PWM) ", I.MX6U 
一 共有 8 路 PWM 信和 号, 每 个 PWM 包含 一 个 16 位 的 计数 器 和 一 个 4x 16 的 数据 FIFO,I.MX6U 
的 PWM 外 设 结构 如 图 29.1.2 所 示 ; 
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Clock Off 












ipg_clk —————— 
12-bit Prescaler 
ipg_clk highfreq ——————— — — — ——3» Prescaler Clock 


ipg. clk 32k ~ Output (PCLK) 


CLKSRC 


System Peripheral Bus 


4 
1| 
"1 | | 
«—— ROVIE | | 
I n 4x16 bit FIFO | | | 
-一 一 一 
ie —————— i Uu l 
———— Ton E 
“—IRQEN | 一 一 一 一 一 了 一- 9 所 


图 29.1.2 LMX6U PWM 结构 框图 

图 29.1.2 中 的 各 部 分 功能 如 下 : 

Q@、 此 部 分 是 一 个 选择 器 ， 用 于 选择 PWM 信号 的 时 钟 源 ， 一 共有 三 种 时 钟 源 : ipg elk, 
ipg clk highfreq 和 ipg_clk 32k. 

@、 这 是 一 个 12 位 的 分 频 器 ， 可 以 对 @ 中 选择 的 时 钟 源 进行 分 频 。 
、 这 是 PWM 的 16 位 计数 器 寄存 器 ， 保 存 着 PWM 的 计数 值 。 

这 是 PWM 的 16 位 周期 寄存 器 ， 此 寄存 器 用 来 控制 PWM 的 频率 。 

、 这 是 PWM 的 16 位 采样 寄存 器 ， 此 寄存 器 用 来 控制 PWM 的 占 空 比 。 
、 此 部 分 是 PWM 的 中 断 信号 ，PWM 是 提供 中 断 功 能 的 ， 如果 使 能 了 相应 的 中 断 的 话 就 
会 产生 中 断 。 

@、 此 部 分 是 PWM 对 应 的 输出 IO, 产生 的 PWM 信和 号 就 会 从 对 应 的 IO 中 输出 ，LMX6U- 
ALPHA 开发 板 的 LCD 背光 控制 引 脚 连接 在 LIMX6U 的 GPIO1 IO8 上 ，GPIO1 IO8 可 以 复 用 
为 PWM1_ OUT. 

可 以 通过 配置 相应 的 寄存 器 来 设置 PWM 信和 号 的 频率 和 占 空 比 ，PWM 的 16 位 计数 器 是 
向 上 计数 器 ， 此 计数 器 会 从 0X0000 开始 计数 ， 直 到 计数 值 等 于 寄存 器 PWMx PWMPR(x-1- 
+1， 然 后 计数 器 就 会 重新 从 0x0000 开始 计数 ， 如 此 往复 。 所 以 寄存 器 PWMx PWMPR 可 以 设 
A PWM 的 频率 。 
在 一 个 周期 内 ，PWM 从 0X0000 开始 计数 的 时 候 ，PWM 引 脚 先 输出 高 电 平 (默认 情况 下 ， 
可 以 通过 配置 输出 低 电 平 )。 采 样 FIFO 中 保存 的 采样 值 会 在 每 个 时 钟 和 计数 器 值 进行 比较 ， 当 
采样 值 和 计数 器 相等 的 话 PWM 引 脚 就 会 改 为 输出 低 电 平 (默认 情况 下 , 同样 可 以 通过 配置 输出 
高 电 平 )。 计 数 器 会 持续 计数 ， 直 到 和 周期 寄存 器 PWMx_PWMPR(x=1~8) + 1 的 值 相等 ， 这 样 
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一 个 周期 就 完成 了 。 所 以 , 采样 FIFO 控制 着 占 空 比 ， 而 采样 FIFO 里 面 的 值 来 源 于 采样 寄存 器 
PWMx PWMSAR, 因此 相当 于 PWMx PWMSAR 控制 着 占 空 比 。 至此, PWM 信号 的 频率 和 占 
空 比 设置 我 们 就 直到 该 如 何 去 做 了 。 

PWM 开启 以 后 会 按照 默认 值 运行 ,并 产生 PWM 波形 ， 而 这 个 默认 的 PWM 一 般 并 不 是 我 
们 需要 的 波形 。 如 果 这 个 PWM 波形 控制 着 设备 的 话 就 会 导致 设备 因为 接收 到 错误 的 PWM 信 
号 而 运行 错误 ， 严 重 情况 下 可 能 会 损坏 设备 ， 甚 至 人 身 安全 。 因 此 ， 在 开启 PWM 之 前 最 好 设 
Ef PWMx PWMPR 和 PVMx PWMSAR 这 两 个 寄存 器 ， 也 就 是 设置 好 PWM 的 频率 和 占 空 
Ls 

当 我 们 向 PWMx PWMSAR 寄存 器 写 入 采样 值 的 时 候 ， 如 果 FIFO 没 满 的 话 其 值 会 被 存储 
到 FIFO 中 。 如 果 FIFO 满 的 时 候 写 入 采样 值 就 会 导致 寄存 器 PWMXx_ PWMSR 的 位 FWE(bit6) 置 
1， 表 示 FIFO 写 错误 ，FIFO 里 面 的 值 也 并 不 会 改变 。FIFO 可 以 在 任何 时 候 写 入 ， 但 是 只 有 在 
PWM 使 能 的 情况 下 读 取 。 寄 存 器 PWMx SR 的 位 FIFOAV(bit2:0) 记 录 着 当前 FIFO 中 有 多 少 个 
数据 。 从 采样 寄存 器 PWMx_PWMSAR 读 取 一 次 数据 , FIFO 里 面 的 数据 就 会 减 一 , 每 产生 一 个 
周期 的 PWM fii, FIFO 里 面 的 数据 就 会 减 一 ， 相 当 于 被 用 掉 了 。PWM 有 个 FIFO 空中 断 ， 当 
FIFO 为 空 的 时 候 就 会 触发 此 中 断 ， 可 以 在 此 中 断 处 理 函 数 中 向 FIFO 写 入 数据 。 

关于 LMX6U 的 PWM 的 原理 知识 就 讲解 到 这 里 ， 接 下 来 看 一 下 PWM 的 几 个 重要 的 寄存 
器 ， 本 章 我 们 使 用 的 是 PWM1， 首 先 看 一 下 寄存 器 PWMI PWMCR 寄存 器 ， 此 寄存 器 结构 如 
图 29.1.2 所 示 : 
























































































































































Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
R 0 z 
ulgiis& E 
FWM S | N|&k|9 lecm 5 | POUTC | crksRc 
w 5b i8alsila r 
Rese 0 0 0 0 0 0 0 olo o o 0 0 0 0 0 
Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
R 
PRESCALER SWR| REPEAT | EN 
w 

















Reset 0 0 0 0 0 0 0 0 | 0 0 0 0 0 0 0 0 
图 29.1.2 寄存 器 PWM1_ PWMCR 寄存 器 结构 
寄存 器 PWM1 PWMCR 用 到 的 重要 位 如 下 : 
FWMnQ(bit27:26): FIFO 水 位 线 ， 用 来 设置 FIFO 空余 位 置 为 多 少 的 时 候 表示 FIFO 为 空 。 设 
置 为 0 的 时 候 表示 FIFO 空余 位 置 大 于 等 于 1 的 时 候 FIFO 为 空 ， 设 置 为 1 的 时 候 表示 FIFO 空 
余 位 置 大 于 等 于 2 的 时 候 FIFO 为 空 ， 设 置 为 2 的 时 候 表示 FIFO 空余 位 置 大 于 等 于 3 的 时 候 
FFO 为 空 ， 设置 为 3 的 时 候 表示 FIFO 口语 位 置 大 于 等 于 4 的 时 候 FIFO 为 空 。 
STOPEN(bit25): 此 位 用 来 设置 停止 模式 下 PWM 是 否 工 作 ， 为 0 的 话 表示 在 停止 模式 下 
PWM 继续 工作 ， 为 1 的 话 表 示 停 止 模式 下 关闭 PWM. 
DOZEN(bit24): 此 位 用 来 设置 休眠 模式 下 PWM 是 否 工 作 ， 为 0 的 话 表示 在 休 卢 模式 下 
PWM 继续 工作 ， 为 1 的 话 表 示 休 眠 模式 下 关闭 PWM. 
WAITEN(bit23): 此 位 用 来 设置 等 待 模式 下 PWM 是 否 工 作 ， 为 0 的 话 表示 在 等 待 模式 下 
PWM 继续 工作 ， 为 1 的 话 表示 等 待 模式 下 关闭 PWM. 
DEGEN(bit22): 此 位 用 来 设置 调试 模式 下 PWM 是 否 工 作 ， 为 0 的 话 表 示 在 调试 模式 下 
PWM 继续 工作 ， 为 1 的 话 表 示 调 试 模式 下 关闭 PWM. 
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BCTR(bit21): 字 节 交换 控制 位 ， 用 来 控制 16 位 的 数据 进入 FIFO 的 字 节 顺序 。 为 0 的 时 
候 不 进行 字 节 交换 ， 为 1 的 时 候 进 行 字 节 交 换 。 











HCRT(bit20): 半 字 交换 控制 位 ， 用 来 决定 从 32 位 IP 总 线 接口 传输 来 的 哪个 半 字 数据 写 
入 采样 寄存 器 的 低 16 位 中 。 

POUTC(bit19:18): PWM 输出 控制 控制 位 ， 用 来 设置 PWM 输出 模式 ， 为 0 的 时 候 表 示 
PWM 先 输出 高 电 平 ， 当 计数 器 值 和 采样 值 相等 的 话 就 输出 低 电 平 。 为 1 的 时 候 相 反 ,， 当 为 2 或 
者 3 的 时 候 PWM 信号 不 输出 。 本 章 我 们 设置 为 0， 也 就 是 一 开始 输出 高 电 平 ， 当 计数 器 值 和 
采样 值 相等 的 话 就 改 为 低 电 平 ， 这 样 采样 值 越 大 高 电 平时 间 就 越 长 ， 占 空 比 就 越 大 。 

CLKSRC(bit17:16): PWM 时 钟 源 选择 ， 为 0 的 话 关 闭 ; 为 1 的话 选择 ipg clk 为 时 钟 源 ; 
为 2 的 话 选择 ipg_clk highfreq 为 时 钟 源 ; 为 3 的 话 选择 ipg_clk 32k 为 时 钟 源 。 本 章 我 们 设置 
为 1， 也 就 是 选择 ipg_clk 为 PWM 的 时 钟 源 ， 因 此 PWM 时 钟 源 频 率 为 66MHz。 

PRESCALER(bit15:4): 分 频 值 ， 可 设置 为 0~4095， 对 应 着 1-4096 分 频 。 

SWR(bit3): 软件 复位 ， 向 此 位 写 1 就 复位 PWM， 此 位 是 自 清 零 的 ， 当 复位 完成 以 后 此 位 
会 自动 清 零 。 

REPEAT (bit2:1): 重复 采样 设置 , 此 位 用 来 设置 FIFO 中 的 每 个 数据 能 用 几 次 。 可 设置 0~3， 
分 别 表示 FIFO 中 的 每 个 数据 能 用 1-4 次 。 本 章 我 们 设置 为 0， 即 FIFO 只 的 每 个 数据 只 能 用 一 
次 。 

EN(bit0): PWM 使 能 位 ， 为 1 的 时 候 使 能 PWM， 为 0 的 时 候 关 闭 PWM. 

接 下 来 看 一 下 寄存 器 PWM1_PWMIR 寄存 器 ， 这 个 是 PWM 的 中 断 控制 寄存 器 ， 此 寄存 器 
结构 如 图 29.1.3 所 示 : 
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29.1.3. 寄存 器 PWMI PWMIR 结构 
寄存 器 PWM1_PWMIR 只 有 三 个 位 ， 这 三 个 位 的 含义 如 下 : 











CIE(bi2): 比较 中 断 使 能 位 ， 为 1 的 时 候 使 能 比较 中 断 ， 为 0 的 时 候 关 闭 比 较 中 断 。 

RIE(bit1): 翻转 中 断 使 能 位 ， 当 计数 器 值 等 于 采样 值 并 回 深 到 0X0000 的 时 候 就 会 产生 此 
中 断 ， 为 1 的 时 候 使 能 翻转 中 断 ， 为 0 的 时 候 关 闭 翻转 中 断 。 

FIE(bit0): FIFO 空中 断 ， 为 1 的 时 候 使 能 ， 为 0 的 时 候 关 闭 。 

再 来 看 一 下 状态 寄存 器 PWM1 PWMSR， 此 寄存 器 结构 如 图 29.1.4 所 示 : 








15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
eo rel rrow | 
[me | we we | we | 

0 0 0 1 


图 29.1.4 寄存 器 PWM1 PWMSR 结构 
寄存 器 PWM1 PWMSR 各 个 位 的 含义 如 下 : 
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FWE(bit6): FIFO 写 错误 事件 ， 为 1 的 时 候 表示 发 生 了 FIFO 写 错误 。 

CMP(bit5): FIFO 比较 事件 发 标志 位 ， 为 1 的 时 候 表示 发 生 FIFO 比较 事件 。 

ROV(bit4): 翻转 事件 标志 位 ， 为 1 的 话 表 示 翻 转 事件 发 生 。 

FE(bit3): FIFO 空 标志 位 ， 为 1 的 时 候 表示 FIFO 位 空 。 

FIFOAV(bit2:1): 此 位 记录 FIFO 中 的 有 效 数据 个 数 ， 有 效 值 为 0~4， 分 别 表 示 FIFO 中 有 
0~4 个 有 效 数 据 。 

接 下 来 是 寄存 器 PWMI PWMPR 寄存 器 ,这 个 是 PWM 周期 寄存 器 ,可 以 通过 此 寄存 器 来 
设置 PWM 的 频率 ， 此 寄存 器 结构 如 图 29.1.5 PTR: 
























































Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 | 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
R 0 PERIOD 
W 








Re«*0. 000000000000000/|1 1 11111 11 111 111 0 
图 29.1.5 寄存 器 PWMI PWMPR 寄存 器 

从 图 29.1.5 可 以 看 出 ， 寄 存 器 PWMI PWMPR 只 有 低 16 位 有 效 ， 当 PWM 计数 器 的 值 等 
于 PERIOD+1 的 时 候 就 会 从 0X0000 重新 开始 计数 ， 开 启 另 一 个 周期 。PWM 的 频率 计算 公式 
如 下 : 

















PWMO(Hz) = PCLK(Hz) / (PERIOD + 2) 

其 中 PCLK 是 最 终 进 入 PWM 的 时 钟 频率 ， 假 如 PCLK 的 频率 为 MHz， 现 在 我 们 要 产生 
一 个 频率 为 1KHz 的 PWM 信号 ， 那 么 就 可 以 设置 PERIOD = 1000000 / 1000 — 2 = 998。 

最 后 来 看 一 下 寄存 器 PWM1 PWMSAR， 这 是 采样 寄存 器 ， 用 于 设置 占 空 比 的 ， 此 寄存 器 
结构 如 图 29.1.6 所 示 : 
Bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16|15 14 13 12 11 10 9 8 7 6 6 4 3 2 1 0 
: 0 SAMPLE 
Rst 0 0.0 0000000000000j0000000000000000 
图 29.1.6 寄存 器 PWMI PWMSAR 结构 

此 寄存 器 也 是 只 有 低 16 位 有 效 ， 为 采样 值 。 通 过 这 个 采样 值 即 可 调整 占 空 比 ， 当 计数 器 的 
值 小 于 SAMPLE 的 时 候 输 出 高 电 平 (或 低 电 平 )。 当 计数 器 值 大 于 等 于 SAMPLE， 小 于 寄存 器 
PWM1_PWMPR 的 PERIO 的 时 候 输 出 低 电 平 (或 高 电 平 )。 同样 在 上 面 的 例子 中 , 假如 我 们 要 设 
置 PWM 信号 的 占 空 比 为 50%, 那么 就 可 以 将 SAMPLE 设置 为 (PERIOD +2)/2= 1000/2=500。 

关于 PWM 有 关 的 寄存 器 就 介绍 到 这 里 ， 关 于 这 些 寄存 器 详细 的 描述 , 请 参考 《I.MX6ULL 
参考 手册 》 第 2480 页 的 40.7 小 节 。 本 章 我 们 使 用 LMX6U 的 PWMI, PWMI 的 输出 引 脚 为 
GPIO1 IO8， 配 置 步 骤 如 下 : 

1、 配 置 引 脚 GPIO1 IOS 

配置 GPIO1_IO08 的 复 用 功能 ， 将 其 复 用 为 PWM1_OUT 信和 号 线 。 

2、 初 始 化 PWMI 

初始 化 PWM1， 配 置 所 需 的 PWM 信和 号 的 频率 和 默认 占 空 比 。 

3、 设 置 中 断 

因为 FIFO 中 的 采样 值 每 个 周期 都 会 少 一 个 ， 所 以 需要 不 断 的 向 FIFO 中 写 入 采样 值 ， 防 止 
其 为 空 。 我们 可 以 使 能 FIFO 空中 断 ， 这 样 当 FIFO 为 空 的 时 候 就 会 触发 相应 的 中 断 ， 然 后 在 中 
断 处 理 函 数 中 向 FIFO 写 入 采样 值 。 

4、 使 能 PWMI 

配置 好 PWM1 以 后 就 可 以 开启 了 。 
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29.2 硬件 原理 分 析 


本 试验 用 到 的 资源 如 下 : 

Q(、 指 示 灯 LEDO. 

2. RGB LCD 接口 。 

©, Tisi KEYO 

本 实验 用 到 的 硬件 原理 图 参考 第 二 十 四 章 ， 本 章 实验 我 们 一 开始 设置 RGB LCD 的 背光 亮 
E PWM 信号 频率 为 1KHz, 占 空 比 为 10%， 这 样 屏幕 亮度 就 很 低 。 然 后 通过 按键 KEY0 逐步 的 
提升 PWM 信和 号 的 占 空 比 ， 按 照 10% 步 进 。 当 达到 100% 以 后 再 次 按 下 KEY0，PWM 信号 占 空 
比 回 到 10% 重 新 开始 。LED0 不 断 的 闪烁 ， 提 示 系 统 正在 运行 。 


29.3 实验 程序 编写 


本 章 实验 在 上 一 章 例 程 的 基础 上 完成 ， 更 改 工 程 名 字 为 “backlight”， 然 后 在 bsp 文件 夹 下 创建 
名 为 “backlight” 的 文件 来， 然后 在 bsp/backlight 中 新 建 bsp_backlight.c 和 bsp_backlight.h 这 两 
个 文件 。 在 bsp_backlight.h 中 输入 如 下 内 容 : 

示例 代码 29.3.1 bsp_backlight.h 文件 代码 
#ifndef BACKLIGHT H 
#define BACKLIGHT H 


[x xkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkxk 














— 












































Copyeene © enon eo Lech 1996-20163 ALL xe Egarec 
文件 名 oss celsi ime 

作者 : 左 忠 凯 

版 本 g VaL O 

描述 : LCD 背光 PWM 驱动 头 文件 。 

其 他 EE 

ied : www.openedv.com 


Elas : 初版 V1.0 2019/1/22 左 忠 凯 创建 


KCKCKCKCKCkCkCk Ck k Ck kCk k Ck kCk Ck Ck kCk kCk Ck kCk Ck k kCkCk Ck kCk Ck Ck k Ck k Ck k Ck k Ck k Ck k ck k ck ck 人 大 人 大 kok ck kk ke x k f 


COSE A o Cn E E IE 


a dye) 
(=) 














e KEE 
w N H| 


dinclude "imxó6ul.h" 


[En 
心 


/* 背光 PWM 结构 体 */ 
struct Jomwelklingimi: dey Scie 
( 


E e BaB 
Ba SIE ey CHI 


unsigned char pwm duty; p ae i 


p 
1O 


Dg 


N 
[e 


/* 函数 声明 */ 
void backlight init (void); 


NO N N 
w N e 


void pwml enable (void); 


N 
心 


void pwml setsample value(unsigned int value); 


N 
C 


void pwml setperiod value(unsigned int value); 


N 
Os 


void pwml setduty(unsigned char duty); 


N 
~1 


void pwml irghandler (void); 
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28 

29 $£endif 





文件 bsp backlight.h 文件 内 容 很 简单 ， 在 第 16 行 定义 了 一 个 背光 PWM 结构 体 ， 剩 下 的 





就 是 函数 声明 。 在 文件 





f KR k ke k e ke e k e k e x 


Copyright O zuozh 

















Fbsp backlight.c 中 输入 如 下 内 容 : 
示例 代码 29.3.2 bsp_backlight.c 文件 代码 


KRR RA dt ee te hh ck ck ck ck ck ck ck ck ck ck kck ck ck kk k k k kk kk 


mue cor t OO) oO mm ee srveon 


文件 名 sper e 
从 者 : 左 忠 凯 
版 本 人 

DAR : LCD 背光 PWM 驱动 文件 。 
其 他 DELE 
论坛 : www.openedv.com 

志 : 初版 V1.0 2019/1/22 左 忠 凯 创建 


CkCkck kckck ck k ck k ck k k kk 


KCKCKCkCkCk Ck k Ck k Ck k Ck k ck k Ck k ck k ck k kck ck k ck k ck k ck k ck ck ckck ck ck ckck ck ck kk kk f 


dl i Le "oro loxxeliilate)me cdi 


ijabmelboroke: "iss: ibm e 
aelwwele "suh. m" 


/ * 


2 
3 
4 
5 struct backlight dev struc backlight dev; /* T$6W& */ 
6 
Ji 
8 


* Qdescription : pwml 中 断 处 理 函 数 


9 * (üiparam 
10 * (ireturn 
ibat */ 


SE 
sb 


12 void pwml irghandler (void) 


J9p. 

14 if(PWM1-»PWMSR & (1 << 3)) /* FIFO 为 空中 断 x 
WS { 

16 /* 将 占 空 比 信息 写 入 到 FIFO 中 ,其实 就 是 设置 占 空 比 */ 

17] pwml setduty(backlight dev.pwm duty); 

18 PWM1->PWMSR |= (1 << 3); /* 写 1 清除 中 断 标志 位 。 */ 
19 } 

e. 

Z3 

Q2 ye 

23  * Qdescription  : 初始 化 背光 PWM 

24 * (üiparam s JE 

25  * Qreturn TE 


2e 


2 vorc backlight onmch 


2e 
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29 unsigned char i = 0; 

30 

31 /* 1、 背 光 PWM IO 初始 化 , 复 用 为 PWM1 OUT */ 

32 IOMUXC SetPinMux(IOMUXC GPIO1 IO08 PWM1 OUT, 0); 

33 IOMUXC SetPinConfig(IOMUXC GPIO1 IO08 PWM1 OUT, 0XB090); 

34 

35 /* 2、 初 始 化 PWM1 

36 * 初始 化 寄存 器 PWMCR 

37 * bit[27:26] : 01 当 FIFO 中 空余 位 置 大 于 等 于 2 的 时 候 FIFO 空 标 志 值 位 

38 * bit[25] : 0 停止 模式 下 PWM 不 工作 

39 * bit[24] 0 “休眠 模式 下 PWM 不 工作 

40 = piel2si : 0 等 待 模式 下 PWM 不 工作 

41 * bit[22] : 0 ”调试 模式 下 PWM 不 工作 

42 * bit[21] 0 ”关闭 字 节 交换 

43 > bit[20] : 0 关闭 半 字 数据 交换 

44 * bit[19:18] : 00 PWM 输出 引 脚 在 计数 器 重新 计数 的 时 候 输 出 高 电 平 

45 在 计数 器 计数 值 达到 比较 值 以 后 输出 低 电 平 

46 * bit[17:16] : 01 PWM 时 钟 源 选 择 IPG CLK = 66MHz 

47 * bit[15:4] : 65 分 频 系数 为 65+1=66，PWM 时 钟 源 = 66MHZ/66=1MHz 

48 * iela] : 0 PWM 不 复位 

49 * a Eod : 00 FIFO 中 的 sample 数据 每 个 只 能 使 用 一 次 。 

50 * pit[0] : 0 ” 先 关闭 PWM， 后 面 再 使 能 

51 E 

52 PWM1-»PWMCR = 0; /* 寄存 器 先 清 零 */ 

53 PWM1-»-PWMCR |= (1 << 26) | (1 << 16) | (65 << 4); 

54 

55 /* 设置 PWM 周期 为 1000, 那 么 PWM 频率 就 是 1M/1000 = 1KHze */ 

56 pwml setperiod value (1000); 

57 

58 /* WEE, Su sos IG WU 4 FIFO */ 

59 backlight dev.pwm duty = 50; 

60 for(i = 0; i < 4; i++) 

61 { 

62 pwml setduty(backlight dev.pwm duty); 

63 } 

64 

65 /* 使 能 FIFO 空中 断 ， 设 置 寄存 器 PWMIR 寄存 器 的 bit0 为 1 */ 

66 PWM1->PWMIR |= 1 << 0; 

67 system register irghandler(PWM1 IROn, /* 注册 中 断 服务 函数 iiA 
(system irq handler t)pwml irqghandler, NULL); 

68 GIC EnableIRQ(PWMl1 IROn); /* 使 能 GIC 中 对 应 的 中 断 */ 

69 PWM1-»-PWMSR = 0; /* PWM 中 断 状态 寄存 器 清 零 */ 

70 pwml enable(); /* 使 能 PWMI */ 


668 


LMX6U RAR Linux 驱动 开发 指南 O ERAF 








原子 哥 在 线 教学 : www.yuanzige.com 论坛 :www.opendev.com 

ga 

12 

S its 

74 GES Crippe LON : 使 能 PWM 

ES * (üiparam 3 JE 

76  * Qreturn NES 

ad m, 

78 void pwml enable (void) 

y NET 

80 PWM1->PWMCR |= 1 << 90; 

81 ) 

82 

SS 

84  * Qdescription : 设置 Sample 寄存 器 ，Sample 数据 会 写 入 到 FIFO 中 ， 所 谓 的 
85 * Sample 寄存 器 ， 就 相当 于 比较 寄存 器 ， 假 如 PWMCR 中 的 POUTC 
86 * 设置 为 00 的 时 候 。 当 PWM 计数 器 中 的 计数 值 小 于 Sample 的 时 候 
Bes 就 会 输出 高 电 平 ， 当 PWM 计数 器 值 大 于 Sample 的 时 候 输 出 底 电 
88  * 平 , 因此 可 以 通过 设置 Sample 寄存 器 来 设置 占 空 比 。 

89  * eparam - value: 寄存 器 值 ， 范 围 0~0XFFFF 

90  * Qreturn E JE 

DUM A 

92 void pml setsample value(unsigned int value) 

S wi 

94 PWM1--PWMSAR = (value & OXFFFF); 

SS 

96 

SE re 

98  * QGdescription : 设置 PWM 周期， 就 是 设置 寄存 器 PWMPR, PWM 周期 公式 如 下 
99  * PWM FRE = PWM CLK / (PERIOD + 2), 比如 当前 PWM CLK-1MHz 
100 * 要 产生 1KHz ĤJ PWM, JA PERIOD = 1000000/1K - 2 = 998 
101 * Gparam - value : 周期 值 ， 范 围 O-OXFFFF 

102 * Qreturn B 2E 

MOS 3e 

104 void pimi setperiod value(unsigned int value) 

105 ( 

106 unsigned int regvalue = 0; 

LOT 

108 if(value « 2) 

IOS) regvalue = 2; 

110 else 

INTE regvalue = value - 2; 

T2 PWM1->PWMPR = (regvalue & OXFFFF); 

Jas 
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114 

Jp, yrs 

116 * Qdescription : 设置 PWM 占 空 比 

117 è @param = value : dE 0-100, XI 05-1005 

118 * GQreturn 3 JE 

318). 

120 void pwml setduty(unsigned char duty) 

Ian h 

1122 unsigned short preiod; 

123 unsigned short sample; 

124 

T25 backlight dev.pwm duty = duty; 

126 preiod = PWM1->PWMPR + 2; 

1273] sample = preiod * backlight dev.pwm duty / 100; 
JS pwml setsample value (sample); 

129m} 





文件 bsp_blacklight.c 一 共有 6 个 函数 ， 首 先是 函数 pwml_irqhandler， 这 个 是 PWMI 的 中 
断 处 理 函 数 。 需 要 在 此 函数 中 处 理 FIFO 空中 断 ， 当 FIFO 空中 断 发 生 以 后 需要 向 采样 寄存 器 
PWM1 PWMSAR 写 入 采样 数据 ， 也 就 是 占 空 比值 ， 最 后 要 清除 相应 的 中 断 标志 位 。 第 2 个 函 
数 是 backlight init， 这 个 是 背光 初始 化 函数 ,在 此 函数 里 面 会 初始 化 背光 引 脚 GPIO1 IO08， 将 
其 复 用 为 PWM1_OUT。 然 后 此 函数 初始 化 PWM1， 设 置 要 产生 的 PWM 信和 号 频率 和 默认 占 空 


















































比 ， 接 下 来 使 能 FIFO 空中 断 ， 注 册 相应 的 中 断 处 理 函 数 ， 最 后 使 能 PWMI. 58 3 
pwml_enable， 用 于 使 能 PWM1。 第 4 个 函数 是 pwml_setsample value, HIT VE EK 














F 值 ， 也 就 





个 函数 是 





是 寄存 器 PWMI PWMSAR 的 值 。 第 5 个 函数 是 pwml_setperiod_value， 用 于 设置 PWM 信和 号 
的 频率 。 第 6 个 函数 是 pwml_setduty, 用 于 设置 PWM 的 占 空 比 , 这 个 函数 只 有 一 个 参数 duty, 
也 就 是 占 空 比值 ， 单 位 为 %， 函 数 内 部 会 根据 百 分 值 计算 出 寄存 器 PWMI PWMSAR 应 该 设置 

















的 值 。 
最 后 在 main.c 文件 中 输入 如 下 所 示 内 容 : 
示例 代码 29.3.3 main.c 文件 代码 


/大 大 大 大 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 大火 炎炎 大 大 大大 大 炎炎 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 


Copyright O zuozhongkai Co., Ltd. 1998-2019. All rights reserved. 


文件 名 HEBR Tee 
































作者 : ABL 
版 本 Ec AVES, 
D : I.MX6U 开发 板 裸 机 实验 21 背光 PWM 实验 
其 他 : 我 们 使 用 手机 的 时 候 背 光 都 是 可 以 调节 的 ， 同 样 的 工 .MX6U-ALPHA 


开发 板 的 LCD 背光 也 是 可 以 调节 ，LCD 背光 就 相当 于 一 个 IED 灯 。 

LED 灯 的 亮 灭 可 以 通过 PWM 来 控制 ， 本 实验 我 们 就 来 学 习 一 下 如 何 
通过 PWM 来 控制 LCD 的 背光 。 

论坛 : www.openedv.com 


Las : 初版 V1.0 2019/1/21 左 忠 凯 创建 


类 火炎 类 大 火炎 类 大 大火 类 大 炎炎 类 大 炎炎 类 大 炎炎 类 大 类 类 类 大 类 类 大 大 类 类 大 大 类 类 类 大 类 类 大 大 类 大 大 大 类 大 大 大 类 类 类 大 类 类 类 大 大 / 
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2 #include "bsp delay.h" 

3 4include "bsp led.h" 

4 #include "bsp beep.h" 

5 4include "bsp key.h" 

6 tinclude “bsp int.h” 

7 include "bsp uart.h" 

8 include "bsp lcd.h" 

9 #include "bsp lcdapi.h" 

WO estu d cM SENEC 

11 £include "bsp backlight.h" 

有 ES 

We 

RR 

15 * @description : main BK 

16 * Qparam 8 JE 

I Urs SUIS s JE 

ig s 

19 int main(void) 

20 ( 

zl unsigned char keyvalue = 0; 

22 unsigned char i = 0; 

29 unsigned char state - OFF; 

24 unsigned char duty = 0; 

25 

26 PERLE /* 初始 化 中 断 (一 定 要 最 先 调用 ! ) */ 

2 imx6u clkinit(); /* 初始 化 系统 时 钟 */ 

28 delay init(); /* 初始 化 延 时 n 

29 clk enable(); /* 使 能 所 有 的 时 钟 */ 

30 led init(); /* 初始 化 led */ 

S beep init(); /* 初始 化 beep x 

32 uar init()g /* 初始 化 串口 ， 波 特 率 115200 * f 

33 leel imie) /* 初始 化 LCD */ 

34 backlight init(); /* 初始 化 背光 PWM */ 

35 

36 eee e vase om ere STE TOME = LED REDE 

Su edis how See (00 002 
(char*)"ALPHA-IMX6U BACKLIGHT PWM TEST"); 

38 lcd show string(50, 40, 400, 24, 24, (char*)"PWM Duty: GU E 

39 tftlcd dev.forecolor = LCD BLUE; 

40 

41 /* WESS 10$ */ 

42 duty = 10; 

43 lel simewswenmm((s5, 40. dh, 53, 2395 
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44 owal setduty (duty); 

45 

46 while(!) 

47] { 

48 keyvalue = key getvalue(); 

49 if(keyvalue == KEYO VALUE) 

50 { 

51 duty “= 10; /* H*BBUi10$ */ 
52 if(duty » 100) /* 如 果 占 空 比 超过 100%8， 重 新 从 10% 开 始 */ 
53 duty = 10; 

54 lcd shownum(158, 40, duty, 3, 24); 

55 pwml setduty(duty); /* WAGTE  */ 
56 } 

57 

58 delayms (10); 

59 itt; 

60 if(i == 50) 

61 { 

62 i = 0; 

63 state = !state; 

64 led switch(LEDO0,state); 

65 } 

66 } 

67 return 0; 

68 ] 





第 34 行 调用 函数 backlight init 初始 化 屏幕 背光 PWM. 58 44 行 设置 背光 PWM 默认 占 空 
比 为 10%。 在 main 函数 中 读 取 按键 值 ， 如 果 KEYO 按 下 的 话 就 将 PWM 信号 的 占 空 比 增加 
10%， 当 占 空 比 超过 100% 的 时 候 就 重 回 到 10%， 重 新 开始 。 总 的 来 说 ，main.c 的 内 容 还 是 很 
简单 的 。 


29.4 编译 下 载 验 证 
29.4.1 编写 Makefile 和 链接 脚本 


修改 Makefile 中 的 TARGET 为 backlight， 然 后 在 在 INCDIRS 和 SRCDIRS 中 加 入 
“bsp/rte”, 修改 后 的 Makefile 如 下 : 
示例 代码 29.4.1 Makefile 代码 


























1 CROSS COMPTE 2o arm-linux-gnueabuhf- 
2 TARGET ?2 backlight 

g 

4 /* 省 略 掉 其 它 代码 ...... */ 

5 

6. INCDIRS :25 imx6ul y 

7 stdio/include \ 
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8 leerp/ells Y 

9 bsp/led WV 

10 bsp/delay \ 

Wal bsp/beep \ 

1g bsp/gpio 

TA bsp/key \ 

14 bsp/exit \ 

15 bap/ int \ 

16 bsp/epittimer N 
Jy) bsp/keyfilter 
18 bsp/uart \ 

19 bsp/lcd V 

20 loe ATCEN 

2a bsp/i2c WN 

22 bsp/ap3216c \ 
23 bsp/spi AN 

24 bsp/icm20608 \ 
25 bsp/touchscreen N 
26 bsp/backlight 
AN 

28 SRCDIRS s= proOJect \ 

29 本 EGG lie W 

30 bsp/clk N 

31 bsp/led WV 

32 bsp/delay \ 

33 bsp/beep \ 

34 bsp/gpio ^ 

25 bsp/key \ 

36 DEPENEN 

39 bsp/int V 

38 bsp/epittimer \ 
39 bsp/keyfilter NV 
40 bsp/uart N 

41 bsp/lcd WV 

42 loeo ie 

43 bsp/i2e N 

44 bsp/ap3216c \ 
45 bsp/spi * 

46 bsp/icm20608 \ 
47 bsp/touchscreen N 
48 bsp/backlight 
49 

50 /* dE EERERIRB...... a 
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Si 
52 clean: 
SSe RAR ORE TARGED SION CARCER Ioue (COBUS) S (COBISS) 
第 2 行 修改 变量 TARGET 为 “backlight”， 也 就 是 目标 名 称 为 “backlight”。 
第 26 行 在 变量 INCDIRS 中 添加 背光 PWM 驱动 头 文件 (.h) 路 径 。 
第 48 行 在 变量 SRCDIRS 中 添加 背光 PWM 驱动 驱动 文件 (.c) 路 径 。 
链接 脚本 保持 不 变 。 







































































29.4.2 编译 下 载 


使 用 Make 命令 编译 代码 , 编译 成 功 以 后 使 用 软件 imxdownload 将 编译 完成 的 backlight.bin 
文件 下 载 到 SD 卡 中 ， 命 令 如 下 : 

chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 

/imxdownload backlight.bin /dev/sdd // 烧 写 到 SD 卡 中 

烧 写 成 功 以 后 将 SD 卡 插 到 开发 板 的 SD 卡 槽 中 ， 然 后 复位 开发 板 ， 默 认 背 光 PWM 是 
10%, PWM 信号 波形 如 图 29.4.2.1 所 示 : 











































































































H 200us 


新 建 目 录 





图 29.4.2.1 10% 占 空 比 PWM 信和 号 
从 图 29.4.2.1 可 以 看 出 ， 此 时 背光 PWM 信和 号 的 频率 为 1.00KHz， 占 空 比 是 10.02%， 和 我 















































们 代码 中 配置 的 一 致 ， 此 时 LCD 的 屏幕 显示 如 图 29.4.2.2 所 示 : 
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图 29.4.2.2 10% 占 空 比 屏幕 亮度 
图 29.4.2.2 就 是 PWM 占 空 比 为 10% 的 LCD 屏幕 显示 ， 可 以 看 出 屏幕 亮度 很 低 ， 甚 至 可 
以 看 到 屏幕 上 拍照 人 的 倒影 。 因 为 拍照 的 原因 ， 实 际 亮 度 跟 实 际 情况 可 能 会 有 少许 差别 。 
我 们 将 PWM 的 占 空 比 调节 到 90%， 此 时 的 LCD 屏幕 亮度 肯定 会 很 亮 ， 如 图 29.4.2.3 所 
ZN: 












































ACRLIGHT PWM TESI 





图 29.4.2.3 90% 占 空 比 屏幕 亮度 
图 29.4.2.3 的 屏幕 亮度 相 比 图 29.4.2.2 就 要 高 很 多 ， 这 个 就 是 LCD 背光 调节 的 原理 ， 采 用 




















PWM 波形 来 完成 ， 通 过 调整 占 空 比 即 可 完成 亮度 调节 。 

至 此 ，LMX6U-ALPHA 开发 板 的 所 有 裸 机 例 程 已 经 全 部 完成 了 ， 通 过 这 几 十 个 裸 机 例 
程 ， 我 们 对 LMX6UL/ULL 这 款 世 片 的 外 设 有 了 一 个 基本 的 了 解 ， 为 我 们 以 后 学 习 Uboot 和 
Linux 驱动 打下 了 坚实 的 基础 。 
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第 三 篇 系统 移植 篇 





在 上 一 篇 中 我 们 学 习 了 如 何 进行 LMX6U 的 裸 机 开发 ， 通 过 21 个 裸 机 例 程 我 们 掌握 了 
IMX6U 的 常用 外 设 。 通过 裸 机 的 学 习 我 们 掌握 了 外 设 的 底层 原理 , 这 样 在 以 后 进行 Linux 驱动 
开发 的 时 候 就 只 需要 将 精力 放 到 Linux 驱动 框架 上 ， 在 进行 Linux 驱动 开发 之 前 肯定 需要 先 将 
Linux 系统 移植 到 开发 板 上 去 。 如 果 学 习 过 UCOS/FreeRTOS 应 该 知道 ，UCOS/FreeRTOS 移植 
就 是 在 官方 的 SDK 包 里 面 找 一 个 和 自己 所 使 用 的 芯片 一 样 的 工程 编译 一 下 ， 然 后 下 载 到 开发 
板 就 可 以 了 。 那 么 Linux 的 移植 是 不 是 也 是 这 样 的 ， 下 载 Linux 源码 ， 然 后 找 个 和 我 们 所 使 用 
的 芯片 一 样 的 工程 编译 一 下 就 可 以 了 ? 很 明显 不 是 的 ! Linux 的 移植 要 复杂 的 多 ， 在 移植 Linux 
之 前 我 们 需要 先 移 植 一 个 bootloader 代码 , 这 个 bootloader 代码 用 于 启动 Linux 内 核 , bootloader 
有 很 多 ， 常 用 的 就 是 U-Boot. ER U-Boot 以 后 在 移植 Linux 内 核 ， 移 植 完 Linux 内 核 以 后 
Linux 还 不 能 正常 启动 ， 还 需要 再 移植 一 个 根 文件 系统 (rootfs)， 根 文件 系统 里 面包 含 了 一 些 最 
常用 的 命令 和 文件 。 所 以 U-Boot、Linux kernel 和 rootfs 这 三 者 一 起 构成 了 一 个 完整 的 Linux 系 
统 ， 一 个 可 以 正常 使 用 、 功 能 完善 的 Linuxx 系统 。 在 本 篇 我 们 就 来 讲解 U-Boot, Linux Kernel 
和 rootfs 的 移植 ， 与 其 说 是 “移植 ”， 倒 不 如 说 是 “ 适 配 ” 因为 大 部 分 的 移植 工作 都 由 NXP 完 
成 了 ， 我 们 这 里 所 谓 的 “移植 ”主要 是 使 其 能 够 在 IMX6U-ALPHA 开发 板 上 跑 起 来 。 








































































































676 


LMX6U AR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


第 三 十 章 U-Boot 使 用 实验 


在 移植 U-Boot 之前, 我们 肯定 要 先 使 用 一 下 U-Boot, 得 先 体验 一 下 U-Boot 是 个 什么 东西 。 




















LMX6U-ALPHA 开发 板 光盘 资料 里 面 已 经 提供 了 一 个 正点 原子 团队 已 经 移植 好 的 U-Boot， 本 
章 我 们 就 直接 编译 这 个 移植 好 的 U-Boot， 然 后 烧 写 到 SD 卡 里 面 启动 ， 启 动 U-Boot 以 后 就 可 
以 学 习 使 用 U-Boot 的 命令 。 
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30.1 U-Boot 简介 


Linux 系统 要 启动 就 必须 需要 一 个 bootloader 程序 ， 也 就 说 芯片 上 电 以 后 先 运行 一 段 
bootloader f£ FF . iX Fx bootloader 程序 会 先 初始 化 DDR 等 外 设 , 然后 将 Linux 内 核 从 flash(NAND， 
NOR FLASH, SD. MMC 5551 NA] DDR 中 ， 最 后 启动 Linux 内 核 。 当 然 了 ，bootloader 的 实 
际 工作 要 复杂 的 多 , 但 是 它 最 主要 的 工作 就 是 启动 Linux 内 核 ，bootloader 和 Linux 内 核 的 关系 
就 跟 PC 上 的 BIOS 和 Windows 的 关系 一 样 ，bootloader 就 相当 于 BIOS。 所 以 我 们 要 先 搞定 
bootloader， 很 庆幸 ， 有 很 多 现成 的 bootloader 软件 可 以 使 用 ， 比 如 U-Boot、vivi、RedBoot 等 
等 ， 其 中 以 U-Boot 使 用 最 为 广泛 ， 为 了 方便 书写 ， 本 书 会 将 U-Boot 写 为 uboot。 

uboot 的 全 称 是 Universal Boot Loader, uboot 是 一 个 遵循 GPL 协议 的 开源 软件 ，uboott 是 
一 个 裸 机 代码 ， 可 以 看 作 是 一 个 裸 机 综合 例 程 。 现 在 的 uboot 已 经 支持 液晶 屏 、 网 络 、USB 等 
高 级 功能 。uboot 官网 为 http://www.denx.de/wiki/U-Boot/， 如 图 30.1.1 所 示 : 

OREXGUE: -— 


© http//www.denx.de/wiki/U-Boot ef al. g- Hk go5-- 


DENX > U-Boot > Edit | Attach | Raw | Ref-By | Printable | More 























DENX Home | DULG | ELDK-5 | Know | Training | U-Boot | U-Bootdoc 


























y Patent Free z 
CT Das U-Boot -- the Universal Boot Loader 
'@， 
hp 
Topics Welcome to the Wiki area for cooperating on U-Boot development. 
U-Boot Home 全 Note: Documentation on how to use U-Boot belongs into the DULG Manual. 
Documentation s 
General Information 
Source Code 
* Documentation 
The Custodians * Licensing 
* Source Code 
Custodian Repositories * Release Cycle and Release Schedule 
* List of custodians and their zit repositories 
Development Process : Pee 
* Workflow for custodian zit repositories 
Release Cycle * Development Process 
* Coding Style 
Coding Style * Patches 
* Tasks 
ums - Mailing List 
Tasks . Mailing List Archive: . | 
十 http://lists.denx.de/pipermail/u-boot, - 











G tss 回 热 点 资讯 © g V ME P É 可 dq Q100% 4 


30.1.1 uboot 官网 
我 们 可 以 在 uboot 官网 下 载 uboot 源码 ， 点 击 图 30.1.1 中 左 侧 Topics 中 的 “Source Code”, 
打开 如 图 30.1.2 所 示 界 面 : 
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é ZI 


&w.denx.de/wiki/U-Boot/: & 4 王者 某 奏 封面 限时 免费 &-» [5--z- 


< »C A Q QOhtp//w 


DENX > U-Boot > Edit | Attach | Raw | Ref-By | Printable | More 








DENX Home | DULG | ELDK-5 | Know | Training | U-Boot | U-Bootdoc 


(o) 
图 WV Patent Free 


Topics * The current source code is available through the git repository at git.denx.de. 


* Released Versions (and some special snapshots) are available from the Amazon Cloud Drive and 
Manda from the DE U-Boot FTP 服 务 器 


Documentation * Snapshots are available using the clever "snapshot" feature of the git server (see the "snapshot" 

link after all commit entries). 

Source Code Â NOTE: even though the download will be a bzip2 compressed tarball, and the file on your disk 
will be named ^x. tar. bz2", you may find that it's actually not compressed at all. This is a "feature" 
of your web browser, and we cannot do anything to help it. 

* www.denx.de also hosts the Custodian git trees 

* An attempt to collect a list of all U-Boot authors can be found here. 


U-Boot Source Code 





The Custodians 





Custodian Repositories 





i Develonment prnress * CVS is no lonaer supported. x 
Giss (eie O g V FE FP É Uu Qd Q10% ; 
30.1.2 uboot 源码 界面 
点 击 图 30.1.2 中 的 “FTP Server”, HAF FTP 服务 器 即 可 看 到 uboot 源码 ， 如 图 30.1.3 所 
示 : 


是 /pub/u-boot/ 的 索引 是 -0x 


D 





< C Ú Ofp//fp.denxde/pub/u- 4 江湖 最 接地 Q o > [] 5- 三 

u-DUUL-ZUI?. UL-r'CZ. LAT. DZZ 1Z.U RD ZULO LZ 10 1 -5.Z0.UU T 
[] u-boot-2019. 01-rc2. tar. bz2. sig 543 B 2018/12/18 43:26:00 
[Ì u-boot-2019. 01-rc3. tar. bz2 12.7 MB 2019/1/8 上 午 6:01:00 
|] u-boot-2019. 01-rc3. tar. bz2. sig 543 B 2019/1/8 上 午 6:01:00 
国 D u-boot-2019. 01. tar. bz2 12.7 NB 2019/1/15 上 午 12:03:00 
[] u-boot-2019. 01. tar. bz2. sig 543 B 2019/1/15 E4 12:04:00 
|] u-boot-2019. 04-rcl. tar. bz2 12. 9 MB 2019/2/8 44:33:00 
|] u-boot-2019. 04-rcl. tar. bz2. sig 543 B 2019/2/8 44:33:00 
(Qi; 口 u-boot-2019. 04-rc2. tar. bz2 12. 9 MB 2019/2/19 上 午 4:37:00 
'--4 |] u-boot-2019. 04-rc2. tar. bz2. sig 543 B 2019/2/19 上 午 4:37:00 
|] u-boot-2019. 04-rc3. tar. bz2 13.0 MB 2019/3/5 上 午 4:47:00 
|] u-boot-2019. 04-rc3. tar. bz2. sig 543 B 2019/3/5 上 午 4:47:00 
|] u-boot-2019. 04-rc4. tar. bz2 13.0 MB 2019/3/19 上 午 3:14:00 

+ [Ì u-boot-2019. 04-rc4. tar. bz2. sig 543 B 2019/3/19 上 午 3:15:00 m 

Hess Hamm O g vP É m d) a100% 











30.1.3 uboot 源码 

30.1.3 中 就 是 uboot 原 汗 原味 的 源码 文件 ， 目 前 最 新 的 版 本 是 2019.04。 但 是 我 们 一 般 不 
会 直接 用 uboot 官方 的 U-Boot 源码 的 。uboott 官方 的 uboot 源码 是 给 半导体 厂商 准备 的 ， 半 导 
体 厂 商会 下 载 uboot 官方 的 uboot 源码 ， 然 后 将 自家 相应 的 芯片 移植 进去 。 也 就 是 说 半导体 厂 
商会 自己 维护 一 个 版 本 的 uboot， 这 个 版 本 的 uboot 相当 于 是 他 们 定制 的 。 既 然 是 定制 的 ， 那 么 
背 定 对 自家 的 芯片 支持 会 很 全 ， 虽 然 uboott 官网 的 源码 中 一 般 也 会 支持 他 们 的 芯片 ， 但 是 绝对 
是 没有 半导体 厂商 自己 维护 的 uboot 全 面 。 

NXP 就 维护 的 2016.03 这 个 版 本 的 uboott ， 下 载 地 址 为 
http://git.freescale.com/git/cgit.cgi/imx/uboot-imx.git/tag/?h-imx v2016.03 4.1.15 2.0.0 ga&id- 
rel imx 4.1.15 2.1.0 ga， 下载 界面 如 图 30.1.4 所 示 : 
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E uboot-imx.git - Freescale i.lv L 2 -o0x 
< C «à io fre 4 淮 把 仙剑 iQ | 器 ~ » | 日 9- 三 
bee 1 » E- 1 ^ 
E psc index . uboot 1mx. git imx v2016.03 4.1.15 200 ga — v || 
P d Freescale i.MX u-boot Tree X 
summary refs log tree commit diff logmsg v search 
'a. tag name rel imx 4.1.15 2.1.0 za 
, , * ' 
TP Tagged objec ommit asbrbl2b94 
download 
"Lu » 
http:;//git.freescale.com/git/cgit.cgi/imx [>] 2585 fe] 热点 咨讯 Ø X; VE € pl Q 10096 . 


图 30.1.4 NXP 官方 uboot 下 载 界 面 

30.1.4 中 的 uboot-imx rel imx4.1.15 2.1.0 ga.xx(xx J zip, tar.gz 或 tarbz2) 就 是 NXP 官 
方 维 护 的 uboott， 后 面 我 们 学 习 uboot 移植 的 时 候 就 是 使 用 的 图 30.1.4 中 的 uboot， 下 载 uboot- 
imx-rel imx 4.1.15 2.1.0_gatarbz2。 我 们 已 经 放 到 了 开发 板 光盘 中 ， 路 径 为 : 开发 板 光盘 ->1、 
程序 源码 ->4、NXP 官方 原版 Uboot 和 Linux->uboot-imx-rel imx 4.1.15 2.1.0_ga.tar.bz2。 图 30.1.4 
中 的 uboot 基本 支持 了 NXP 当前 所 有 可 以 跑 Linux 的 芯片 ,而 且 支 持 各 种 启动 方式 ,比如 EMMC、 
NAND, NORFLASH 等 等 ， 这 些 都 是 uboot 官方 所 不 支持 的 。 但 是 图 30.1.4 中 的 uboot 是 针对 
NXP 自家 评估 板 的 ， 如 果 是 我 们 自己 做 的 板子 就 需要 修改 NXP 官方 的 uboot， 使 其 支持 我 们 自 
己 做 的 板子 , 正点 原子 的 ILMX6U 开发 板 就 是 自己 做 的 板子 , 虽然 大 部 分 都 参考 了 NXP 官方 的 
LMXGULL EVK 开发 板 ,但 是 还 是 有 很 多 不 同 的 地 方 ， 所 以 需要 修改 NXP 官方 的 uboot， 使 其 
适 配 正点 原子 的 LMX6U 开发 板 ,所 以 当 我 们 拿 到 开发 板 以 后 , 是 有 三 种 uboot 的 , 这 三 种 uboot 
的 区 别 如 表 30.1.1 所 示 : 






























































由 uboot 官方 维护 开发 的 uboot 版 本 ， 版 本 更 新 快 ， 基 本 包含 所 
AO HRS. 
半导体 厂商 维护 的 一 个 uboot， 专 门 针 对 自家 的 芯片 ， 在 对 自家 
i Hr CREE EG uboot 官方 的 好 。 
开发 板 厂商 在 半导体 厂商 提供 的 uboot 基础 上 加 入 了 对 自家 开发 
板 的 支持 。 

表 30.1.1 三 种 uboot 的 区 别 
那么 这 三 种 uboot 该 如 何 选择 呢 ? 首先 uboot 官方 的 基本 是 不 会 用 的 ， 因 为 支持 太 弱 了 。 
最 常用 的 就 是 半导体 厂商 或 者 开发 板 厂 商 的 uboot, 如 果 你 用 的 半导体 厂商 的 评估 板 , 那么 就 使 
用 半导体 厂商 的 uboot， 如 果 你 是 购买 的 第 三 方 开发 板 ， 比 如 正点 原子 的 IMX6ULL 开发 板 ， 
那么 就 使 用 正点 原子 提供 的 uboot 源码 (也 是 在 半导体 厂商 的 uboot 上 修改 的 )。 当 然 了 ， 你 也 
可 以 在 购买 了 第 三 方 开发 板 以 后 使 用 半导体 厂商 提供 的 uboot， 只 不 过 有 些 外 设 驱 动 可 能 不 文 
持 ， 需 要 自己 移植 ， 这 个 就 是 我 们 常 说 的 uboot 移植 。 

本 节 是 uboot 的 使 用 ， 所 以 就 直接 使 用 正点 原子 已 经 移植 好 的 uboot， 这 个 已 经 放 到 了 开发 
板 光 盘 中 了 ,路 径 为 : 开发 板 光盘 ->1、 程 序 源码 ->3、 正 点 原子 修改 后 的 Uboot 和 Linux->uboot- 
imx-rel imx 4.1.15 2.1.0 ga alientek.tar.bz2. 





uboot 官方 的 uboot 代码 








半导体 厂商 的 uboot 代码 




















FEW) HH uboot 代码 
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30.2 U-Boot 初次 编译 





在 Ubuntu 中 创建 存放 uboot 的 目录 ， 比 如 我 的 是 /home/$USER/linux/uboot， 然 后 在 此 目录 
下 新 建 一 个 名 为 “alientek_uboot ”的 文件 夹 用 于 存放 正点 原子 提供 的 uboot 源码 。alientek_uboot 
文件 夹 创建 成 功 以 后 使 用 FileZilla 软件 将 正点 原子 提供 的 uboot 源码 拷贝 到 此 目录 中 ， 正 点 原 
子 提供 的 uboot 源码 已 经 放 到 了 开发 板 光盘 中 ， 路 径 为 : 开发 板 光盘 ->1、 例 程 源 码 ->3、 正 点 原 
子 修改 后 的 Uboot 和 Linux-> uboot-imx-2016.03-2.1.0-g8b546e4.tar.bz2。 将 其 拷贝 到 Ubuntu 中 
新 建 的 alientek_uboot 文件 夹 下 ， 完 成 以 后 如 图 30.2.1 所 示 : 



















































































$ ls 


$ 





图 30.2.1 将 uboot 15 I | Ubuntu 中 
使 用 如 下 命令 对 其 进行 解压 缩 : 
tar -vxjf uboot-imx-2016.03-2.1.0-g8b546e4.tar.bz2 
解压 完成 以 后 alientek uboot 文件 夹 内 容 如 图 30.2.2 所 示 : 


= SLS 
config.mk Kconfig Makefile snapshot.commit 


























MAINTAINERS README 





Kbuild 


图 30.2.2 解压 后 的 uboot 
图 30.2.2 中 除了 uboot-imx-2016.03-2.1.0-g8b546e4.tar.bz2 这 个 正点 原子 提供 的 uboot 源码 
压缩 包 以 外 ， 其 他 的 文件 和 文件 夹 都 是 解压 出 来 的 uboot 源码 。 


1、512MB(DDR3)+8GB(EMMCOC) 核 心 板 


如 果 使 用 的 是 512MB+8G 的 EMMC 核心 板 ， 使 用 如 下 命令 来 编译 对 应 的 uboot: 

make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- distclean 

make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- 

mx6ull 14x14 ddr512 emmce defconfig 

make V-1 ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- -j12 

这 三 条 命令 中 ARCH-arm 设置 目标 为 arm #8, CROSS. COMPILE 指定 所 使 用 的 交叉 编 
译 器 。 第 一 条 命令 相当 于 “make distclean ”， 目 的 是 清除 工程 ， 一 般 在 第 一 次 编译 的 时 候 最 好 清 
理 一 下 工程 。 第 二 条 指令 相当 于 “make mx6ull 14x14. ddr512 emmc defconfig” 用 于 配置 uboot， 
配置 文件 为 mx6ull 14x14 ddr512 emmc defconfig。 最 后 一 条 指令 想 打 昂 与 “make -j12” 也 就 是 
使 用 12 核 来 编译 uboot。 当 这 三 条 命令 执行 完 以 后 uboot 也 就 编译 成 功 了 ， 如 图 30.2.3 所 示 : 






























































/mx6ul levk/imximage-ddr512.cfg.cfgtmp board/freescale/mx6ullevk/imximage-ddr512.cfg 
./tools/mkimage -n board/freescale/mx6ullevk/imximage-ddr512.cfg.cfgtmp -T imximage -e 0x87 

800000 -d u-boot.bin u-boot.imx 

Image Type: Freescale IMX Boot Image 

Image Ver: 2 (i.MX53/6/7 compatible) 


Mode : DCD 

Data Size: 425984 Bytes = 416.00 kB = 0.41 MB 
Load Address: 877ff420 

Entry Point: 87800000 








图 30.2.3 编译 完成 
编译 完成 以 后 的 alentek_uboot 文件 夹 内 容 如 图 30.2.4 所 示 : 
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STES 
-boot.imx 








snapshot .commit 
MAINTAINERS System.map -boot.lds 
-boot.map 
Makefile -boot-nodtb.bin 
config.mk -boot.srec 
Kbuild u-boot.bin -boot.sym 
Kconfig README U-boot .cfg 
图 30.2.4 编译 后 的 uboot 源码 
可 以 看 出 ， 编 译 完成 以 后 uboot 源码 多 了 一 些 文件 ， 其 中 u-boot.bin 就 是 编译 出 来 的 uboot 
二 进 制 文件 -uboot 是 个 裸 机 程序 , 因此 需要 在 其 前 面 加 上 头 部 TVT、DCD 等 数据 ) 才 能 在 LMX6U 
上 执行 ， 图 302.4 中 的 u-boot.imx 文件 就 是 添加 头 部 以 后 的 u-boot.bin，u-boot.imx 就 是 我 们 最 
终 要 烧 写 到 开发 板 中 的 uboot 镜像 文件 。 
每 次 编译 uboot 都 要 输入 一 长 串 命令 ， 为 了 简单 起 见 ， 我 们 可 以 新 建 一 个 shell 脚本 文件 ， 
将 这 些 命令 写 到 shell 脚本 文件 里 面 ， 然 后 每 次 只 需要 执行 shell 脚本 即 可 完成 编译 工作 。 新 建 
名 为 mx6ull alientek emmc.sh 的 shell 脚本 文件 ， 然 后 在 里 面 输入 如 下 内 容 : 
示例 代码 30.2.1 mx6ull_alientek_emmc.sh 文件 代码 































































































1 $!/bin/bash 
2 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- distclean 








3 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- 
ui oLIL Lála (lohe912 emme GE com 
4 make V=1 ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- -j12 

第 1 行 是 shell HEERA, ^E "SUbin/bash" RE "SU/bin/sh". 

第 2 行使 用 了 make 命令 ， 用 于 清理 工程 ， 也 就 是 每 次 在 编译 uboot 之 前 都 清理 一 下 工程 。 
这 里 的 make 命令 带 有 三 个 参数 ， 第 一 个 是 ARCH， 也 就 是 指定 架构 ， 这 里 肯定 是 arm; 第 二 个 
参数 CROSS COMPILE 用 于 指定 编译 器 ， 只 需要 指明 编译 器 前 缀 就 行 了 ， 比 如 arm-linux- 
gnueabihf-gcc 编译 器 的 前 级 就 是 <arm-linux-gnueabihf-”; 最 后 一 个 参数 distclean 就 是 清除 工程 。 

第 3 行 也 使 用 了 make 命令 ， 用 于 配置 uboot。 同 样 有 三 个 参数 ， 不 同 的 是 ， 最 后 一 个 参数 
是 mx6ull alientek emmc defconfig。 前 面 说 了 uboot 是 bootloader 的 一 种 ,可 以 用 来 引导 Linux, 
但 是 uboot 除了 引导 Linux 以 外 还 可 以 引导 其 它 的 系统 ， 而 且 uboot 还 支持 其 它 的 架构 和 外 设 ， 
比如 USB、 网 络 、SD 卡 等 。 这 些 都 是 可 以 配置 的 , 需要 什么 功能 就 使 能 什么 功能 。 所 以 在 编译 
uboot 之 前 ,一定 要 根据 自己 的 需求 配置 uboot。mx6ull alientek emmc defconfig 就 是 正点 原子 
针对 LMX6U-ALPHA 的 EMMC 核心 板 编 写 的 配置 文件 ， 这 个 配置 文件 在 uboot-imx- 
rel imx 4.1.15 2.1.0 ga alientek /configs 目录 中 。 在 uboot 中 ， 通 过 “make xxx_defconfig” 来 配 
H uboot, xxx defconfig 就 是 不 同 板 子 的 配置 文件 ， 这 些 配置 文件 都 在 uboot/configs 目录 中 。 

第 4 行 有 4 个 参数 ， 用 于 编译 uboot， 通过 第 3 行 配置 好 uboot 以 后 就 可 以 直接 “make” 编 
译 uboot 了 。 其 中 vel 用 于 设置 编译 过 程 的 信息 输出 级 别 ，-j 用 于 设置 主机 使 用 多 少 个 核 编译 
uboot， 设 置 的 核 越 多 ， 编 译 速度 越 快 。-j16 表示 使 用 16 个 核 编译 uboot， 有 具体 设置 多 少 个 要 根 
据 自 己 的 虚拟 机 或 者 电脑 配置 ， 如 果 你 给 VMware 分 配 了 4 个 核 ， 那 么 最 多 只 能 使 用 -j4。 

使 用 chmod 命令 给 予 mx6ull alientek emmc.sh 文件 可 执行 权限 , 然后 就 可 以 使 用 这 个 shell 
脚本 文件 来 重新 编译 uboot， 命 令 如 下 : 

./mx6ull alientek emmc.sh 


1, 256MB(DDR3)4256MB/512M B(NAND) i0 


如 果 用 的 256MB4256MB/512MB 的 NAND 核心 板 ， 新 建 名 为 mx6ull alientek nand.sh 的 
shell 脚本 文件 ， 然 后 在 里 面 输入 如 下 内 容 : 
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示例 代码 30.2.2 mx6ull alientek_nand.sh 文件 代码 


1 $!/bin/bash 
2 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- distclean 








3 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- 
mx6ull 14x14 ddr256 nand defconfig 
4 make V=1 ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- -j12 
完成 以 后 同样 使 用 chmod 指令 给 予 mx6ull alientek nand.sh 可 执行 权限 ， 然 后 输入 如 下 命 
令 即 可 编译 NAND 版 本 的 uboot: 

./mx6ull alientek nand.sh 

mx6ull alientek nand.sh 和 mx6ull alientek emmc.sh 类 似 ， 只 是 uboot 配置 文件 不 同 ， 这 里 
就 不 详细 介绍 了 。 


30.3 U-Boot 烧 写 与 启动 


uboot 编译 好 以 后 就 可 以 烧 写 到 板子 上 使 用 了 ， 这 里 我 们 跟前 面 裸 机 例 程 一 样 ， 将 uboot 
烧 写 到 SD 卡 中 ， 然 后 通过 SD 卡 来 启动 来 运行 uboot。 使 用 imxdownload 软件 烧 写 ， 命 令 如 
下 : 
chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 ， 一 次 即 可 
.imxdownload u-boot.bin /dev/sdd 

等 待 烧 写 完 成 ， 完 成 以 后 将 SD 卡 查 到 IMX6U-ALPHA FRIE, BOOT 设置 从 SD 卡 启 
动 ， 使 用 USB 线 将 USB TTL 和 电脑 连接 ， 也 就 是 将 开发 板 的 串口 1 连接 到 电脑 上 。 打 开 
SecureCRT， 设 置 好 串口 参数 并 打开 ， 最 后 复位 开发 板 。 在 SecureCRT 上 出 现 “Hit any key to 
stop autoboot: ”倒计时 的 时 候 按 下 键盘 上 的 回 车 键 ， 默 认 是 3 秒 倒计时 ， 在 3 秒 倒 计时 结束 以 
后 如 果 没 有 按 下 回 车 键 的 话 uboot 就 会 使 用 默认 参数 来 启动 Linux 内 核 了 。 如 果 在 3 秒 倒计时 
结束 之 前 按 下 回 车 键 ， 那 么 就 会 进入 uboot 的 命令 行 模式 ， 如 图 30.3.1 所 示 : 


serial-com13 - SecureCRT = x 














i 




























































































File Edit View Options Transfer Script Tools Window Help 
faz Sig d) Enter host <Alt+ leu 221 0 F E 
** serial-com13 x 4 ! 


di 93 xu, i 





U-Boot 2016.03 (Sep 02 2019 - 21:44:40 +0800) 


3- 国 Sessions 
A serial-com13 
A serial-com3 
A serial-com4 
A serial-com6 
二 serial-com8 


CPU: Freescale i.MX6ULL revl.1 69 MHz (running at 396 MHz) 
CPU: Industrial temperature grade (-40C to 1080) at 54C 
Reset cause: POR 

Board: MX6ULL 14x14 EVK 

I2C: ready 


MMC: FSL_SDHC: 0, FSL_SDHC: 
Display: ATK-LCD-7-1024x600 (1024x600) 
Video: 1024x600x24 

** Unrecognized filesystem type ** 
In: serial 

Out: serial 

Err: serial 

switch to partitions £0, OK 

mmcO is current device 

Net: FEC1 

Normal Boot 

Hit any key to stop autoboot: 0 
=o 








Serial: COM13, 115200 23, 4 24 Rows, 71 Cols  VT100 CAP NUM 


图 30.3.1 uboot 启动 过 程 
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从 图 30.3.1 可 以 看 出 ， 当 ; 











入 到 uboot 的 命令 行 模式 以 后 ， 左 侧 会 出 现 一 个 “=>” 标 志 。 


论坛 :www.opendev.com 


























uboot 启动 的 时 候 会 输出 一 些 信 息 ， 这 些 信息 如 下 所 示 : 
示例 代码 30.3.1 uboot 输出 信息 
i U-Boot 2016,05 (Aor 12 2019 = 02235800 409800) 
2 
3- CPU; Freescale i.MX6ULL rev1.1 69 MHz (running at 396 MHz) 
4 CPU: Industrial temperature grade (-40C to 105C) at 46C 
5 Reset Cause: POR 
6 Board: MX6ULL 14x14 EVK 
METZ; ready 
8 DRAM: 512 MiB 
9 MMC3 PSL SDHC 0, reb SDHC: ll 
10 Display: ATK-LCD-7-1024x600 (1024x600) 
11 Video: 1024x600x24 
12 ** Unrecognized filesystem type ** 
4,5) Tine serial 
MEOT serial 
I ee serial 
16 switch to partitions 40, OK 
17 mmcO0 is current device 
18 Net: FECI 
19 Normal Boot 
20 Hit any key to stop autoboot: O 
21 -» 





间 是 2019 4E 4 H 12 
上 工作 到 凌晨 两 三 点 ! 看 到 这 里 一 定 要 记得 到 论 ] 











第 1 行 是 uboot 版 本 号 和 编译 时 间 ， 可 以 看 出 ， 当 前 的 uboot 版 本 号 是 2016.03， 编 译 时 
凌晨 2 点 33( 没 错 ! 为 了 赶 教程 和 例 程 ， 我 这 一 年 多 以 来 基本 每 天 晚 
RERS TFD. 

， 可 以 看 出 当前 使 用 的 CPU 是 飞 思 卡尔 的 LMX6ULL C(LMX 以 

































































第 3 和 第 4 行 是 CPU 信息 











前 属于 飞 思 卡尔 ， 然 而 飞 思 卡尔 
示 主 频 为 S28MHz。 但 是 如 果 使 





内 前 


个 号 









































《被 NXP 收购 了 )， 如 果 使 用 528MHz 的 ILMX6ULL， 此 处 会 显 
用 800MHz 的 LMX6ULL 的 话 此 处 会 显示 69MHz, 这 个 是 

















uboot 








了 主 频 读 取 错误 , 但 是 不 影响 运行 ,可 以 不 用 管 。 不 管 是 $28MHz 还 是 800MHz 的 ILMX6ULL， 
此 时 都 运行 在 396MHz。 这 颗 芯片 是 工 、 





此 级 的 ， 可 以 工作 在 -40”C~105”C。 
因 是 POR. LMX6ULL 芯片 上 有 个 POR. B 引 脚 ， 将 这 














第 5 行 是 复位 原因 ， 当 前 的 复位 原 
| 脚 拉 低 即 可 复位 IMX6ULL。 

第 6 行 是 板子 名 字 ， 当 前 的 板子 名 字 为 “MX6ULL 14x14 EVK”. 

第 7 行 提示 I2C 准备 就 绪 。 

第 8 行 提示 当前 板子 的 DRAM( 内 存 ) 为 512MB, 如 果 是 NAND 版 本 的 话 内 存 为 256MB. 
第 9 行 提示 当前 有 两 个 MMC/SD 卡 控 制 器 : FSL SDHC(0) 和 FSL SDHC(1). LMX6ULL 





























支持 两 个 MMC/SD， 正 点 原子 的 LMX6ULL EMMC 核心 板 上 FSL SDHC(0) 接 的 EMMC, 
FSL_SDHC(1) 接 的 SD(TF) E. 





第 10 和 第 11 行 是 LCD 型 号 ， 当 前 的 LCD 型 号 是 ATK-LCD-7-1024x600 (1024x600)， 分 





辩 率 为 1024x600， 格 式 为 RGB888(24 位 )。 
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第 13~15 是 标准 输入 、 标 准 输出 和 标准 错误 所 使 用 的 终端 ， 这 里 都 使 用 串口 人 serial) 作 为 终 





端 。 

第 16 和 17 行 是 切换 到 emme 的 第 0 个 分 区 上 ， 因 为 当前 的 uboot 是 emme 版 本 的 ， 也 就 
是 从 emmc 启动 的 。 我 们 只 是 为 了 方便 将 其 烧 写 到 了 SD 卡 上 ， 但 是 它 的 “内 心 ” 还 是 EMMC 
的 。 所 以 uboot 启动 以 后 会 将 emme 作为 默认 存储 器 ， 当 然 了 ， 你 也 可 以 将 SD 卡 作为 uboot 的 
存储 器 ， 这 个 我 们 后 面 会 讲解 怎么 做 。 

第 18 行 是 网 口 信 息 ， 提 示 我 们 当前 使 用 的 FEC1 这 个 网 口 ，LMX6ULL 支持 两 个 网 口 。 

第 19 行 提 示 正 常 启 动 ,也 就 是 说 uboot 要 从 emmc 里 面 读 取 环 境 变 量 和 参数 信息 启动 Linux 
内 核 了 。 

第 20 行 是 倒计时 提示 ， 默 认 倒计时 3 秒 , 倒计时 结束 之 前 按 下 回 车 键 就 会 进入 Linux 命 信 
行 模式 。 如 果 在 倒计时 结束 以 后 没有 按 下 回 车 键 , 那么 Linux 内 核 就 会 启动 ，Linux 内 核 一 旦 
动 ，uboot 就 会 寿终正寝 。 

这 个 就 是 uboot 默认 输出 信息 的 含义 ，NAND 版 本 的 uboot 也 是 类 似 的 ， 只 是 NAND 版 本 
的 就 没有 EMMC/SD 相关 信息 了 , 取而代之 的 就 是 NAND 的 信息 , 比如 NAND 容量 大 小 信息 。 

uboot 是 来 干 活 的 ， 我们 现在 已 经 进入 uboot 的 命令 行 模式 了 ,进入 命令 行 模式 以 后 就 可 以 
给 uboot 发 号 施 令 了 。 当 然 了 ,不 能 随便 发 号 施 令 ， 得 看 看 uboot 文 持 哪些 命令 ,然后 使 用 这 些 
uboot 所 文 持 的 命令 来 做 一 些 工 作 。 下 一 节 就 讲解 uboot 命令 的 使 用 。 


30.4 U-Boot 命令 使 用 


进入 uboot 的 命令 行 模式 以 后 输入 “help” 或 者 “? ” 然后 按 下 回 车 即 可 查看 当前 uboot 所 
支持 的 命令 ， 如 图 30.4.1 所 示 : 
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serial-com1 - SecureCRT 一 口 x 
File Edit View Options Transfer Script Tools Window Help 
CIT Ener host at T Vet TE CE: 
|| serial-com1 x 4 b 


4. [2.59.1633 jäit any key to "MA "help" RE?” 





Filter by session name : X uboot 命 令 列 表 
a- Sessions 7 T ETP 
A) serial-com1 - print or set address offset 
i - print Board Info structure 
- sdi|sd2|qspii|normal|usb|satalecspii:O|ecspii:i1|ecspili:2]|e 

cspii:3|esdhci|esdhc2|esdhc3|esdhc4 [noreset] 

bmp - manipulate BMP image data 
boot default, i.e., run 'bootcmd' 
boot default, i.e., run 'bootcmd' 
Boot from an ELF image in memory 
boot application image from memory 
boot image via network using BOOTP/TFTP protocol 
Boot vxworks from an ELF image 
boot Linux zImage image from memory 
disptay clocks 
fill the boot logo area with black 
memory compare 
print console devices and information 
memory copy 
checksum calculation 
enable or disable data cache 
boot image via network using DHCP/TFTP protocol 
Driver model low level access 
echo args to console 


Serial: COM1, 115200 27, 4 27 Rows, 68 Cols Linux CAP NUM 





图 30.4.1 uboot 命令 列表 
图 30.4.1 中 只 是 uboot 的 一 部 分 命令 ， 有 具体 的 命令 列表 以 实际 为 准 。 图 30.4.1 中 的 命令 并 
不 是 uboot 所 支持 的 所 有 命令 ,前面 说 过 uboot 是 可 配置 的 , 需要 什么 命令 就 使 能 什么 命令 。 所 
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以 图 30.4.1 中 的 命令 是 正点 原子 提供 的 uboot 中 使 能 的 命令 ，uboot 支持 的 命令 还 有 很 多 ,而且 
























































也 可 以 在 uboot 中 自 定义 命令 。 这 些 命令 后 面 都 跟 有 命令 说 明 ， 用 于 描述 此 命令 的 作用 ， 但 是 
命令 具体 怎么 用 呢 ? 我 们 输入 “help( 或 ?) 命令 名 ” 既 可 以 查看 命令 的 详细 用 法 ， 以 “bootz” 这 
个 命令 为 例 ， 我 们 输入 如 下 命令 即 可 查看 “bootz” 这 个 命令 的 用 法 : 
? bootz 或 help bootz 
结果 如 图 30.4.2 所 示 : 
=> ? bootz 
bootz - boot Linux zImage image from memory 
Usage: 
bootz [addr [initrd[:size]] [fdt]] 
- boot Linux zImage stored in memory 
The argument ‘initrd’ is optional and specifies the address 
of the initrd in memory. e optional argument ':size' allows 
x usc E di the size of RAW initrd. 
when booting a Linux kernel which requires a flat device-tree 
a third argument is required which is the address of the 
device-tree blob. To boot that kernel without an initrd image, 
use a '-' for the second argument. If you do not pass a third 
a bd info struct will be passed instead 
=> gH v 
Serial: COM1, 115200 36, 4 36Rows,72 Cols Linux CAP NUM 





30.4.2 bootz 命令 使 用 说 明 
图 30.4.2 中 就 详细 的 列 出 了 “bootz” 这 个 命令 的 详细 ， 其 它 的 命令 也 可 以 使 用 此 方法 查询 
具体 的 使 用 方法 。 接 下 来 我 们 学 习 一 下 一 些 常 用 的 uboot 命令 。 























30.4.1 信息 查询 命令 


常用 的 和 信息 查询 有 关 的 命令 有 3 个 : bdinfo、printenv 和 version。 先 来 看 一 下 bdinfo íi 
令 ， 此 命令 用 于 查看 板子 信息 ， 直 接 输入 “bdinfo” 即 可 ， 结 果 如 图 30.4.1.1 所 示 : 

















=> bdinfo 

arch number = 0x00000000 
boot params = 0x80000100 
DRAM bank = 0x00000000 
-> start = 0x80000000 
-> size = 0x20000000 
ethOname = FEC1 
ethaddr - (not set) 
current eth = FEC1 
ip.addr = <NULL> 
baudrate = 115200 bps 
TLB addr = 0x9FFF0000 
relocaddr = Ox9FF47000 
reloc off = 0x18747000 
irq sp = Ox9EFA4EAO 
sp start = Ox9EF44E90 
FB base - 0x00000000 
=> 


图 30.4.1.1 bdinfo 命令 
从 图 30.4.1.1 中 可 以 得 出 DRAM 的 其 实地 址 和 大 小 、 启 动 参数 保存 起 始 地 址 、 波 特 率 、 
sp( 推 栈 指针 ) 起 始 地 址 等 信息 。 
命令 “printenv” 用 于 输出 环境 变量 信息 , uboot 也 支持 TAB 键 自动 补 全 功能 , 输入 “print” 
然后 按 下 TAB 键 就 会 自动 补 全 命令 , 直接 输入 “print” 也 可 以 。 输入 “print”, 然后 按 下 回 车 键 ， 
环境 变量 如 图 30.4.1.2 所 示 : 
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=> print 

baudrate-115200 

board name-EVK 

board rev-14x14 

boot fdt-try 

bootcmd-run findfdt;mmc dev $ímmcdevj;mmc dev $[mmcdevj; if mmc rescan; then if run loadbootscript; 

Hane - bootscript; else if run loadimage; then run mmcboot; else run netboot; fi; fi; else run net 
oot; fi 

bootcmd mfg-run mfgtool args;bootz ${loadaddr} $iinitrd addrj Sífdt addrj; 

bootdelay-3 

bootscript-echo Running bootscript from mmc ...; source 

console-ttymxcO 

ethact-FECl 

ethprime-FEC 

fdt. addr-0x83000000 

fdt file-undefined 

fdt high-Oxffffffff 

findfdt-if test Sfdt file - undefined; then if test $board name - EVK && test $board rev - 9x9; then 
setenv fdt file imx6ull-9x9-evk.dtb; fi; if test Sboard name EVK && test $board rev - 14X14; then 
setenv fdt file imx6ull-14xl4-evk.dtb; fi; if test $fdt file = undefined; then echo WARNING: Could 

not determine dtb to use; fi; fi; 

image-zimage 

initrd addr-0x83800000 

initrd high-Oxffffffff 


ip .dyn-zyes 

loadaddr-0x80800000 

loadbootscript-fatload mmc $ímmcdevji:$i(mmcpartj $iloadaddrj $íscripti; 

loadfdt-fatload mmc ${mmcdev}:${mmcpart} $ifdt addrj $ífdt file] 

loadimage-fatload mmc ${mmcdev}:${mmcpart} $íloadaddrj ${image} 

mfgtool args-setenv bootargs console-$í(consolej,$íbaudratej rdinit-/linuxrc g mass storage.stall-0 g 
-mass storage.removable-l g mass storage.file-/fat g mass storage.ro-1l g mass storage. idvendor-0x066 


F g.mass storage. idProduct-0x37FF g. mass storage. iserialNumber-"" clk ignore unused 

mmcargs-setenv bootargs console-$í[consolej,$í[baudratej root-$(mmcrootj 

mmcautodetect-yes 

mmcboot-echo Booting from mmc ...; run mmcargs; if test $í[boot fdtj = yes || test $í[boot fdtj = try; 


then if run loadfdt; then bootz $íloadaddrj - $ífdt addrj; else if test $íboot fdtj = try; then boo 
tz; else echo WARN: Cannot load the DT; fi; fi; else bootz; fi; 
mmcdev-1 
mmcpart-i 
mmcroot-/dev/mmcblkip2 rootwait rw 
near g Seta bootargs console=${console},${baudrate} root=/dev/nfs ip=dhcp nfsroot=${serverip}:${n 
srootj,v3,tcp 
netboot-echo Booting from net ...; run netargs; if test ${ip_dyn} = yes; then setenv get cmd dhcp; e 
lse setenv geremd tftp; fi; ${get_cmd} ${image}; if test Sibon fat = yes |] test sTboot fdt] = tr 
Ü then if $í[get cmdj $ifdt addrj $ífdt filej; then bootz $íloadaddrji - $ífdt addrj; else if test $i 
oot fdtj - try; then bootz; else echo wARN: Cannot load the DT; fi; fi; else bootz; fi; 
panel-TFT43AB 
script-boot.scr 





Environment size: 2431/8188 bytes 


2 v 





30.4.1.2 printenv 命令 结果 
在 图 30.4.1.2 中 有 很 多 的 环境 变量 , 比如 baudrate, board name. board rec. boot fdt,bootcmd 
等 等 。uboot 中 的 环境 变量 都 是 字符 串 ， 既 然 叫做 环境 变量 ， 那 么 它 的 作用 就 和 和 “变量” 一样。 
比如 bootdelay 这 个 环境 变量 就 表示 uboot 启动 延 时 时 间 ， 默 认 bootdelay=3， 也 就 默认 延 时 3 
秒 。 前 面 说 的 3 秒 倒计时 就 是 由 bootdelay 定义 的 ， 如 果 将 bootdelay 改 为 5 的 话 就 会 倒计时 5s 
了 。uboot 中 的 环境 变量 是 可 以 修改 的 ， 有 专门 的 命令 来 修改 环境 变量 的 值 ， 稍 后 我 们 会 讲解 。 
命令 version 用 于 查看 uboot 的 版 本 号 ， 输 入 “version”，uboot 版 本 号 如 图 30.4.1.3 所 示 ; 


=> version 


























U-Boot 2016.03 (Apr 12 2019 - 02:33:00 +0800) 
arm-linux-gnueabihf-gcc (Linaro GCC 4.9-2017.01) 4.9.4 
GNU ld (Linaro Binutils-2017.01) 2.24.0.20141017 Linaro 2014 11-3-git 
= 
图 30.4.1.3 version 命令 结果 
从 图 30.4.1.3 可 以 看 出 ， 当 前 uboot 版 本 号 为 2016.03，2019 年 4 月 12 日 编译 的 ， 编 译 器 


为 arm-linux-gnueabihf-gcc 等 信息 。 





30.4.2 环境 变量 操作 命令 


1、 修 改 环境 变量 
环境 变量 的 操作 涉及 到 两 个 命令 : setenv 和 saveenv. 命令 setenv 用 于 设置 或 者 修改 环境 变 
量 的 值 。 命 令 saveenv 用 于 保存 修改 后 的 环境 变量 ， 一 般 环境 变量 是 存放 在 外 部 flash 中 的 ， 
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uboot 启动 的 时 候 会 将 环境 变量 从 flash 读 取 到 DRAM 中 。 所 以 使 用 命令 setenv 修改 的 是 DRAM 
中 的 环境 变量 值 ， 修 改 以 后 要 使 用 saveenv 命令 将 修改 后 的 环境 变量 保存 到 flash 中 ， 否 则 的 话 




















uboot 下 一 次 重启 会 继续 使 用 以 前 的 环境 变量 值 。 
命令 saveenv 使 用 起 来 很 简单 ， 格 式 为 : 


saveenv 命令 值 








saveenv 命令 “ 值 1 值 2 值 3? 
比如 我 们 要 将 环境 变量 bootdelay 该 为 5， 就 可 以 使 用 如 下 所 示 命 令 : 


setenv bootdelay 5 








Saveenv 
上 述 命令 执行 过 程 如 图 30.4.2.1 所 示 : 


=> setenv bootdelay 5 

=> Saveenv 

Saving Environment to MMC... 
Writing to MMC(1)... done 
=> 





图 30.4.2.1 环境 变量 修改 
在 图 30.4.2.1 中 ， 当 我 们 使 用 命令 saveenv 保存 修改 后 的 环境 变量 的 话 会 有 保存 过 程 提示 
RE, 根据 提示 可 以 看 出 环境 变量 保存 到 了 MMC(1) 中 , 也 就 是 EMMC 中 。 因 为 我 用 的 EMMC 
版 本 的 核心 板 , 所 以 会 保存 到 MMC(1) 中 ,如 果 是 NAND 版 本 核心 板 的 话 就 会 提示 保存 到 NAND 
中 。 









































修改 bootdelay 以 后 ， 重 启 开发 板 ，uboot 就 是 变 为 5 秒 倒计时 ， 如 图 30.4.2.2 所 示 : 
| U-Boot 2016.03 (Apr 12 2019 - 02:33:00 +0800) 


||CPU: Freescale i.MX6ULL revi.1 528 MHz (running at 396 MHz) 
CPU: Industrial temperature grade (-40C to 105C) at 52C 
|Reset cause: WDOG 

Board: MX6ULL ALIENTEK EMMC 

I2C: ready 

DRAM: 512 MiB 

MMC : FSL SDHC: 0, FSL SDHC: 1 

unsupported pes TFT43AB 

In: seria 

Out: serial 

Err: serial 

switch to partitions #0, OK 

mmcl(part 0) is current device 

Net : FEC1 

Error: FEC1 address not set. 


Normal Boot 
Hit any key to stop autoboot: 5 


图 30.4.2.2 5 秒 倒计时 

有 时 候 我 们 修改 的 环境 变量 值 可 能 会 有 空格 ， 比 如 bootcmd、bootargs 等 ， 这 个 时 候 环境 变 
量 值 就 得 用 单 引 号 括 起 来 ， 比 如 下 面 修 改 环境 变量 bootcmd 的 值 : 

setenv bootcmd 'console-ttymxc0,115200 root-/dev/mmcbIk1p2 rootwait rw' 

saveenv 

上 面 命令 设置 bootcmd 的 值 为 “console=ttymxc0,115200 root-/dev/mmcblk1p2 rootwait rw”, 
df *console-ttymxc0,115200 ", *root-/dev/mmcbIk1p2 ", *rootwait" 4I “rw " 4H24-T- VU£H “18”, 
这 四 组 “ 值 ” 之 间 用 空格 隔 开 ， 所 以 需要 使 用 单 引号 “” 将 其 括 起 来 ， 表 示 这 四 组 “ 值 ” 都 属 
于 环境 变量 bootcmd。 


2、 新 建 环境 变量 
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命令 setenv 也 可 以 用 于 新 建 命令 ， 用 法 就 是 修改 环境 变量 一 样 ， 比 如 我 们 新 建 一 个 环境 变 
量 author, author 的 值 为 我 的 名 字 拼 音 ; zuozhongkai， 那 么 就 可 以 使 用 如 下 命令 : 














setenv author zuozhongkai 

saveenv 

新 建 命令 author 完成 以 后 重启 uboot， 然 后 使 用 命令 printenv 查看 当前 环境 变量 ， 如 图 
30.4.2.3 所 示 : 




















=> print 
author-zuozhongkai 
baudrate-115200 
board name-EVK 
board rev-14x14 
boot fdt-try 


图 30.4.2.3 环境 变量 
从 图 30.4.2.3 可 以 看 到 新 建 的 环境 变量 : author， 其 值 为 : zuozhongkai。 


3、 删 除 环境 变量 




















既然 可 以 新 建 环境 变量 ， 那 么 就 可 以 删除 环境 变量 ， 删 除 环 境 变 量 也 是 使 用 命令 setenv, 
要 删除 一 个 环境 变量 只 要 给 这 个 环境 变量 赋 空 值 即 可 ， 比 如 我 们 删除 掉 上 面 新 建 的 author 这 个 


























FI 
环境 变量 ， 命 令 如 下 : 
setenv author 








saveenv 
上 面 命令 中 通过 setenv 给 author 赋 空 值 ， 也 就 是 什么 都 不 写 来 删除 环境 变量 author. 
uboot 就 会 发 现 环境 变量 author 没有 了 。 





limi 
Hp 
hil; 

















30.4.3 内 存 操作 命令 

内 存 操作 命令 就 是 用 于 直接 对 DRAM 进行 读 写 操 作 的 ， 常 用 的 内 存 操作 命令 有 md, nm, 
mm、mw、cp 和 cmp。 我 们 依次 来 看 一 下 这 些 命令 都 是 做 什么 的 。 

1、md 命令 


md 命令 用 于 显示 内 存 值 ， 格 式 如 下 : 

md[.b, .w, .1| address [# of objects] 

命令 中 的 [.b .w .] 对 应 byte, word 和 long， 也 就 是 分 别 以 1 个 字 节 、2 个 字 节 、4 个 字 节 
来 显示 内 存 值 。address 就 是 要 查看 的 内 存 起 始 地 址 ，[# of objects] 表 示 要 查看 的 数据 长 度 ， 这 
个 数据 长 度 单位 不 是 字 节 ， 而 是 跟 你 所 选择 的 显示 格式 有 关 。 比 如 你 设置 要 查看 的 内 存 长 度 问 
为 20( 十 六 进 制 为 0x14)， 如 果 显 示 格 式 为 .b 的 话 那 就 表示 20 个 字 节 ;， 如 果 显示 格式 为 .w 的 话 
就 表示 20 个 word， 也 就 是 20*2=40 个 字 节 ;如 果 显 示 格 式 为 .1 的 话 就 表示 20 个 long， 也 就 
是 20*4-80 个 字 节 。 另 外 要 注意 : 

uboot 命令 中 的 数字 都 是 十 六 进 制 的 ! 不 是 十 进 制 的 ! 

uboot 命令 中 的 数字 都 是 十 六 进 制 的 ! 不 是 十 进 制 的 ! 

uboot 命令 中 的 数字 都 是 十 六 进 制 的 ! 不 是 十 进 制 的 ! 

比如 你 想 查 看 以 0X80000000 开始 的 20 个 字 节 的 内 存 值 ， 显 示 格 式 为 .pb 的话， 应 该 使 用 
如 下 所 示 命 令 : 

md.b 80000000 14 

而 不 是 : 

md.b 80000000 20 
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上 面 说 了 ，uboot 命令 里 面 的 数字 都 是 十 六 进 制 的 ， 所 以 可 以 不 用 写 “0x” 前 级 ， 十 进 制 






































的 20 其 十 六 进 制 为 0x14， 所 以 命令 md 后 面 的 个 数 应 该 是 14， 如 果 写 成 20 的 话 就 表示 查看 
32( 十 六 进 制 为 0x20) 个 字 节 的 数据 。 分 析 下 面 三 个 命令 的 区 别 : 
md.b 80000000 10 
md.w 80000000 10 
md.] 80000000 10 
上 面 这 三 个 命令 都 是 查看 以 0x80000000 为 起 始 地 址 的 内 存 数据 ， 第 一 个 命令 以 .b 格式 显 
示 , 长 度 为 0x10, 也 就 是 16 个 字 节 ; 第 二 个 命令 以 .w 格式 显示 , KEX 0x10, 也 就 是 16*2=32 
个 字 节 ; 最 后 一 个 命令 以 1 格式 显示 ， 长 度 也 是 0x10， 也 就 是 16*4=64 个 字 节 。 这 三 个 命令 的 
执行 结果 如 图 30.4.3.1 所 示 : 
|i|=> md.b 80000000 10 
80000000: Tf ff ff TT Tf af fF fF TF TT T9 TT fF fe bf TT 12... RS 
=> md.w 80000000 10 
180000000: ffff ffff afff FEEF ffff fff9 feff ffbf ................ 
80000010: feef ffff ffff 3fff ffff fbff ffff fbfb ....... P assu»s 
|||» md.1 80000000 10 
80000000: ffffffff ffffafff fff9ffff ffbffeff ................ 
180000010: fffffeef 3fffffff fbffffff fbfbffff ....... p RT PEMES 
80000020: ff7fffff fdfffdff efffffff fff7ff7ze ............ ~ 
80000030: effbfbff ff7fffd7 fffdffff fefbffff ........ 


=> 


















































图 30.4.3.1 md 命令 使 用 示例 
2、nm 命令 
nm 命令 用 于 修改 指定 地 址 的 内 存 值 ， 命 令 格式 如 下 : 
nm [.b, .w, .|] address 
nm 命令 同样 可 以 以 .b、.w 和 .1 来 指定 操作 格式 ， 比 如 现在 以 .1 格式 修改 0x80000000 地 址 
的 数据 为 0x12345678。 输 入 命令 : 
nm.] 80000000 
输入 上 述 命 令 以 后 如 图 30.4.3.2 所 示 : 
=> nm.1 80000000 
80000000: ffffff00 ? J 
图 30.4.3.2 nm 命令 
在 图 30.4.3.2 中 ，80000000 表示 现在 要 修改 的 内 存 地 址 ，fffff00 表示 地 址 0x80000000 现 
在 的 数据 ，? 后 面 就 可 以 输入 要 修改 后 的 数据 0x12345678， 输 入 完成 以 后 按 下 回 车 ， 然 后 再 输 
入 “q” 即 可 退出 ， 如 图 30.4.3.3 所 示 : 


=> nm.1 80000000 

|80000000: ffffffOO ? 12345678 
|80000000: 12345678 ? q 

Es 

















图 30.4.3.3 修改 内 存 数据 


修改 完成 以 后 在 使 用 命令 md 来 查看 一 下 有 没有 修改 成 功 ， 如 图 30.4.3.4 所 示 : 
=> md.1 80000000 1 f 
80000000: 12345678 xv4. 


=> 
图 30.4.3.4 查看 修改 后 的 值 
从 图 30.4.3.4 可 以 看 出 ， 此 时 地 址 0X80000000 的 值 变 为 了 0x12345678。 


3、mm 命令 
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mm 命令 也 是 修改 指定 地 址 内 存 值 的 ， 使 用 mm 修改 内 存 值 的 时 候 地 址 会 自 增 ， 而 使 用 命 
令 nm 的 话 地 址 不 会 自 增 。 比 如 以 1 格式 修改 从 地 址 0x80000000 开始 的 连续 3 个 内 存 块 (3*4=12 


个 字 节 ) 的 数据 为 0X05050505， 操 作 如 图 30.4.3.5 所 示 ; 


||2» mm. 1 80000000 

80000000: 12345678 ? 05050505 
80000004: ffffafff ? 05050505 
80000008: fff9ffff ? 05050505 
8000000c: ffbffeff ? q 

=> 














图 30.4.3.5 命令 mm 
从 图 30.4.3.5 可 以 看 出 ， 修 改 了 地 址 0X80000000、0X80000004 和 0X8000000C 的 内 容 为 


0x05050505。 使 用 命令 md 查看 修改 后 的 值 ， 结 果 如 图 30.4.3.6 所 示 : 


=> md.1 80000000 3 
80000000: 05050505 05050505 05050505 |. | ............ 


=> 
图 30.4.3.6 查看 修改 后 的 内 存 数 据 

从 图 30.4.3.6 可 以 看 出 内 存 数 据 修改 成 功 。 

4. mw 命令 

命令 mw 用 于 使 用 一 个 指定 的 数据 填充 一 段 内 存 ， 命 令 格式 如 下 : 

mw [.b, .w, .1] address value [count] 

mw 命令 同样 可 以 以 .b、.w 和 .1 来 指定 操作 格式 , address 表示 要 填充 的 内 存 起 始 地 址 , value 
为 要 填充 的 数据 ，count 是 填充 的 长 度 。 比 如 使 用 .1 格式 将 以 0X80000000 为 起 始 地 址 的 0x10 个 
内 存 块 (0x10 * 4=64 字 节 ) 填 充 为 0X0A0A0A0A， 命 令 如 下 : 

mw. 80000000 0AOAOAOA 10 

然后 使 用 命令 md 来 查看 ， 如 图 30.4.7 Brzn: 


=> mw. 1 80000000 0A0A0AOA 10 

=> md.1 80000000 10 

80000000: 0a0a0a0a 0a0a0a0a 0a0a0a0a Oa0a0a0a — ................ 
80000010: 0a0a0a0a 0a0a0a0a Oa0a0a0a Oa0a0a0a — ................ 
80000020: 0a0a0a0a 0a0a0a0a Oa0a0a0a Oa0a0a0a — ................ 
80000030: 0a0a0a0a 0a0a0a0a 0a0a0a0a Oa0a0a0a — ................ 
=> 





























图 30.4.3.7 查看 修改 后 的 内 存 数据 

从 图 30.4.3.7 可 以 看 出 内 存 数 据 修改 成 功 。 

5. cp 命令 

cp 是 数据 拷贝 命令 , 用 于 将 DRAM 中 的 数据 从 一 段 内 存 找 贝 到 另 一 段 内 存 中 , 或 者 把 Nor 
Flash 中 的 数据 拷贝 到 DRAM 中 。 命 令 格 式 如 下 : 

cp [.b, .w, .1] source target count 

cp 命令 同样 可 以 以 .bp、.w 和 .1 来 指定 操作 格式 ，source 为 源 地 址 ，target 为 目的 地 址 ，count 
为 拷贝 的 长 度 。 我们 使 用 .1 格式 将 0x80000000 处 的 地 址 拷贝 到 0X80000100 处 ,长 度 为 0x10 个 
内 存 块 (0x10 * 4=64 个 字 节 )， 命 令 如 下 所 示 : 

cp.180000000 80000100 10 
结果 如 图 30.4.3.8 所 示 : 
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=> md.1 80000000 10 

80000000: 0a0a0a0a 0a0a0a0a 0a0a0a0a Oa0a0a0a  ...............-. 
80000010: 0a0a0a0a 0a0a0a0a 0a0a0a0a Oa0a0a0a — ................ 
80000020: 0a0a0a0a 0a0a0a0a 0a0a0a0a Oa0a0a0a — ................ 
80000030: 0a0a0a0a 0a0a0a0a Oa0a0a0a Oa0a0a0a — ................ 
=> md.1 80000100 10 

80000100: ffff7fff ffffffdf fbffffff ffffffdf  J................ 
80000110: 7fffefff fdffffff ffeff7ff fbzdd7ff — .............. T. 
80000120: bfffedff efdff7ed efbf7fff ffffffff  J|................ 
80000130: fffffffb fbffffff dfdefcff fffbffdf ................ 
=> cp.1 80000000 80000100 10 

=> md.1 80000100 10 

80000100: 0a0a0a0a 0a0a0a0a Oa0a0a0a Oa0a0a0a — ................ 
80000110: 0a0a0a0a 0a0a0a0a Oa0a0a0a Oa0a0a0a — ................ 
80000120: 0a0a0a0a 0a0a0a0a Oa0a0a0a Oa0a0a0a — ................ 
80000130: 0a0a0a0a 0a0a0a0a Oa0a0a0a Oa0a0a0a — ................ 
=> 








图 30.4.3.8 cp 命令 操作 结果 

在 图 30.4.3.8 中 ， 先 使 用 md.l 命令 打印 出 地 址 0x80000000 和 0x80000100 处 的 数据 ， 然 后 
使 用 命令 cp.1 将 0x80000100 处 的 数据 拷贝 到 0x80000100 处 。 最 后 使 用 命令 md.1 查 看 0x80000100 
处 的 数据 有 没有 变化 ， 检 查找 贝 是 否 成 功 。 

6、cmp 命令 

cmp 是 比较 命令 ， 用 于 比较 两 段 内 存 的 数据 是 否 相 等 ， 命 令 格式 如 下 : 

cmp [.b, .w, .1] addrl addr2 count 

emp 命令 同样 可 以 以 b、.w 和 .1 来 指定 操作 格式 ，addrl 为 第 一 段 内 存 首 地 址 ，addr2 为 第 
二 段 内 存 首 地 址 ，count 为 要 比较 的 长 度 。 我 们 使 用 .1 格式 来 比较 0x80000000 和 0X80000100 这 
两 个 地 址 数据 是 否 相 等 ， 比 较 长 度 为 0x10 个 内 存 块 (16* 4-64 个 字 节 )， 命 令 如 下 所 示 : 

cmp.1 80000000 80000100 10 


结果 如 图 30.4.3.9 所 示 : 

=> cmp.1 80000000 80000100 10 
Du of 16 word(s) were the same 
=> 











Ei 
































图 30.4.3.9 cmp 命令 比较 结 
从 图 30.4.3.9 可 以 看 出 两 段 内 存 的 数据 相等 。 我 们 再 随便 挑 两 段 内 存 比较 一 下 ， 比 如 地 址 
0x80002000 和 0x800003000， 长 度 为 0X10， 比 较 结果 如 图 30.4.3.10 所 示 : 


=> cmp.1 80002000 80003000 10 

word at Ox80002000 (Oxffff7ff7) != word at 0x80003000 (Oxfffff7ff) 
Total of 0 word(s) were the same 

=> 














图 30.4.3.10 cmp 命令 比较 结果 
从 图 30.4.3.10 可 以 看 出 ，0x80002000 处 的 数据 和 0x80003000 处 的 数据 就 不 一 样 。 


30.4.4 网 络 操作 命令 


uboot 是 支持 网 络 的 ， 我 们 在 移植 uboot 的 时 候 一 般 都 要 调 通 网 络 功能 ， 因 为 在 移植 linux 
kernel 的 时 候 需 要 使 用 到 uboot 的 网 络 功能 做 调试 uboot 支持 大 量 的 网 络 相 关 命 令 ,比如 dhep, 
ping. nfs 和 tttpboot， 我 们 接 下 来 依次 学 习 一 下 这 几 个 和 网 络 有 关 的 命令 。 
在 使 用 uboot 的 网 络 功能 之 前 先 用 网 线 将 开发 板 的 ENET2 接口 和 电脑 或 者 路 由 器 连接 起 
来 ,， LMX6U-ALPHA 开发 板 有 两 个 网 口 : ENETI 和 ENET2， 一 定 要 连接 ENET2， 不 能 连接 错 
了 ，ENET2 接口 如 图 30.4.4.1 所 示 。 
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图 30. 44. 1 ENET2 网 络 接口 
建议 开发 板 和 主机 PC 都 连接 到 同一 个 路 由 器 上 ! 最 后 设置 表 30.4.4.1 中 所 示 的 几 个 环境 


















































ipaddr 开发 板 ip 地 址 ， 可 以 不 设置 ， 使 用 dhep 命令 来 从 路 由 器 获取 人 Pp 地 址 。 
ethaddr 开发 板 的 MAC 地址， 一定 要 设置 。 
gatewayip 网 关 地 址 。 
netmask 子 网 掩 码 。 
serverip 服务 器 IP 地址 ， 也 就 是 Ubunut 主机 IP 地 址 ， 用 于 调试 代码 。 
表 30.4.4.1 网 络 相关 环境 变量 
X 30.4.4.1 中 环境 变量 设置 命令 如 下 所 示 : 
setenv ipaddr 192.168.1.50 
setenv ethaddr 00:04:9£04:d2:35 
setenv gatewayip 192.168.1.1 
setenv netmask 255.255.255.0 
setenv serverip 192.168.1.250 
saveenv 
注意 ， 网 络 地 址 环境 变量 的 设置 要 根据 自己 的 实际 情况 ， 确 保 Ubunut 主机 和 开发 板 的 IP 
地 址 在 同一 个 网 段 内 ， 比 如 我 现在 的 开发 板 和 电脑 都 在 192.168.1.0 这 个 网 段 内 ， 所 以 设置 开 
发 板 的 IP 地 址 为 192.168.1.50， 我 的 Ubunut 主机 的 地 址 为 192.168.1.250， 因 此 serverip 就 是 
192.168.1.250. ethaddr 为 网 络 MAC 地 址 ， 是 一 个 48bit 的 地 址 ， 如 果 在 同一 个 网 段 内 有 多 个 
开发 板 的 话 一 定 要 保证 每 个 开发 板 的 ethaddr 是 不 同 的， 否则 通信 会 有 问题 ! 设置 好 网 络 相关 
的 环境 变量 以 后 就 可 以 使 用 网 络 相 关 命令 了 。 
1. ping 命令 
开发 板 的 网 络 能 否 使 用 ， 是 否 可 以 和 服务 器 (Ubunut 主机 ) 进 行 通信 ， 通 过 ping 命令 就 可 
以 验证 ， 直 接 ping 服务 器 的 IP 地 址 即 可 ， 比 如 我 的 服务 器 IP 地 址 为 192.168.1.250， 命 令 如 
F: 
ping 192.168.1.250 
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结果 如 图 30.4.4.2 所 示 : 





=> ping 192.168.1.250 

Using FEC1 device 

host 192.168.1.250 is alive 
=> 


图 30.4.4.2 ping 命令 
从 图 30.4.4.2 可 以 看 出 ，192.168.1.250 这 个 主机 存在 ， 说 明 ping 成 功 ，uboot 的 网 络 工 作 正 
常 。 
2, dhep 命令 


dhcp 用 于 从 路 由 器 获取 IP 地 址 ， 前 提 得 开发 板 连接 到 路 由 器 上 的 ， 如 果 开 发 板 是 和 电脑 
直 连 的 ， 那 么 dhcp 命令 就 会 失效 。 直 接 输入 dhep 命令 即 可 通过 路 由 器 获取 到 IP 地 址 ， 如 图 


30.4.4.3 所 示 : 

=> dyg d 

BOOTP broadcast 1 

*** Unhandled DHCP Option in OFFER/ACK: 50 

*** Unhandled DHCP Option in OFFER/ACK: 50 

DHCP client bound to address 192.168.1.50 (10 ms) 
*** warning: no boot file name; using 'C0A80132. img' 
Using FEC1 device 

TFTP from server 192.168.1.1; our IP address is 192.168.1.50 
Filename 'C0A80132.img'. 

Load address: 0x80800000 

Loading: TTTTT T 



































30.4.4.3 dhcp 命令 
从 图 30.4.4.3 可 以 看 出 ， 开 发 板 通过 dhep 获取 到 的 IP 地 址 为 192.168.1.50， 和 我 们 手动 设 
置 的 一 样 ， 这 很 正常 。 同 时 在 图 30.4.4.3 中 可 以 看 到 “warning: no boot file name;". “TFTP from 
server 192.168.1.1” 这 样 的 字样 。 这 是 因为 DHCP 不 单单 是 获取 卫 地 址 ， 其 还 会 通过 TFTP 来 


启动 linux 内 核 ， 输 入 “? dhcp” 即 可 查看 dhep 命令 详细 的 信息 ， 如 图 30.4.4.4 所 示 : 
=> ? dhcp | j : 
dhcp - boot image via network using DHCP/TFTP protocol 


























Usage: 
dhcp [loadAddress] [[hostiPaddr:]bootfilename] 
= 





图 30.4.4.4 dhep 命令 使 用 查询 





3. nfs 命令 

nfs 也 就 是 网 络 文件 系统 ， 通 过 nfs 可 以 在 计算 机 之 间 通 过 网 络 来 分 享 资源 ， 比 如 我 们 将 
linux. 镜像 和 设备 树 文件 放 到 Ubuntu 中 ， 然 后 在 uboot 中 使 用 nfs 命令 将 Ubunut 中 的 linux. 镜 
像 和 设备 树 下 载 到 开发 板 的 DRAM 中 。 这 样 做 的 目的 是 为 了 方便 调试 linux 镜像 和 设备 树 ， 也 
就 是 网 络 调试 , 通过 网 络 调试 是 Linux 开发 中 最 常用 的 调试 方法 。 原因 是 租 入 式 linux. 开发 不 像 
单片机 开发 , 可 以 直接 通过 JLINK 或 STLink 等 仿真 器 将 代码 直接 烧 写 到 单片机 内 部 的 flash 中 ， 
RAR Linux 通常 是 烧 写 到 EMMC、NAND Flash, SPI Flash 等 外 置 flash H, 但 是 嵌入 式 Linux 
开发 也 没有 MDK, IAR 这 样 的 IDE， 更 没有 烧 写 算法 ， 因 此 不 可 能 通过 点 击 一 个 “download” 
按钮 就 将 固件 烧 写 到 外 部 flash Po 虽然 半导体 厂商 一 般 都 会 提供 一 个 烧 写 固件 的 软件 , 但 是 这 
个 软件 使 用 起 来 比较 复杂 ， 这 个 烧 写 软 件 一 般 用 于 量 产 的 。 其 远 没 有 MDK, ILAR 的 一 键 下 载 方 
便 ， 在 Linux 内 核 调试 阶段 ， 如 果 用 这 个 烧 写 软件 的 话 将 会 非常 浪费 时 间 ， 而 这 个 时 候 网 络 调 
试 的 优势 就 显现 出 来 了 ， 可 以 通过 网 络 将 编译 好 的 linux. 镜像 和 设备 树 文 件 下 载 到 DRAM F, 
然后 既 可 以 直接 运行 。 
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我 们 一 般 使 用 uboot 中 的 nfs 命令 将 Ubunut 中 的 文件 下 载 到 开发 板 的 DRAM 中 ， 在 使 用 
之 前 需要 开启 Ubunut 主机 的 NFS 服务 ， 并 且 要 新 建 一 个 NFS 使 用 的 目录 ， 以 后 所 有 要 通过 
NFS 访问 的 文件 都 需要 放 到 这 个 NFS 目录 中 。Ubuntu 的 NFS 服务 开启 我 们 在 4.2.1 小 节 已 经 
详细 讲解 过 了 ， 包 括 NFS 文件 目录 的 创建 ， 如 果 忘 记 的 话 可 以 去 查看 一 下 4.2.1 小 节 。 我 设置 
的 /home/zuozhongkai/linux/nfs 这 个 目录 为 我 的 NFS 文件 目录 。uboot 中 的 nfs 命令 格式 如 下 所 
ZR: 

nfs [loadAddress] [[hostIPaddr: ]bootfilename] 

loadAddress 是 要 保存 的 DRAM 地 址 ，[[hostIPaddr:]bootfilename] 是 要 下 载 的 文件 地 址 。 这 
里 我 们 将 正点 原子 官方 编译 出 来 的 Linux 镜像 文件 zImage 下 载 到 开发 板 DRAM 的 0x80800000 

这 个 地 址 处 。 正 点 原子 编译 出 来 的 zImage 文件 已 经 放 到 了 开发 板 光盘 中 ， 路 径 为 : 8、 开 发 板 

系统 镜像 ->zImage。 将 文件 zImage 通过 FileZilla 发 送 到 Ubunut FHI NFS 目录 下 ， 比 如 我 的 就 
是 放 到 /home/zuozhongkai/linux/nfs 这 个 目录 下 ， 完 成 以 后 的 NFS 目录 如 图 30.4.4.5 所 示 : 


$ ls l 































































































总 用 量 3598528 
drwxr-xr-x 20 zuozhongkai zuozhongkai 4096 
rw-r--r-- zuozhongkai zuozhongkai 37162 - imx6ul-14x14-evk.dtb 
-rw-r--r-- zuozhongkai zuozhongkai 36626 : imx6ull-14x14-evk.dtb 
drwxr-xr-x 30 zuozhongkai zuozhongkai 4096 
drwxr-xr-x 3 zuozhongkai zuozhongkai 4096 
zuozhongkai zuozhongkai 526147441 
zuozhongkai zuozhongkai 529069027 
zuozhongkai zuozhongkai 625374408 
zuozhongkai zuozhongkai 4096 
zuozhongkai zuozhongkai 1986363826 
zuozhongkai zuozhongkai 4096 
zuozhongkai zuozhongkai 6071136 - ZImage 
zuozhongkai zuozhongkai 6071136 
zuozhongkai zuozhongkai 5662880 


图 30.4.4.5 NFS 目录 中 的 zImage 文件 
bw 以 后 就 可 以 使 用 nfs 命令 来 将 zImage 下 载 到 开发 板 DRAM 的 0X80800000 地 址 处 ， 











nfs 80800000 192.168.1.250:/home/zuozhongkai/linux/nfs/zImage 

fm 4 中 的 “ 80800000 ”表示 zmage h F 地 H ， 
“192.168.1.250:/home/zuozhongkai/linux/nfs/zImage ”表示 zImage 在 192.168.1.250 这 个 主机 中 ， 
路 径 为 /home/zuozhongkai/linux/nfs/zImage。 下 载 过 程 如 图 30.4.4.6 所 示 : 
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=> nts 80800000 192.168.1.250:/home/zuozhongkai / l'inux/nts/zimage 

Using FEC1 device 

File transfer via NFS from server 192.168.1.250; our IP address is 192.168.1.5 

Filename '/home/zuozhongkai /linux/nfs/zimage'. 

Load address: 0x80800000 

Loading: &ss5858555SESSEESEEEEEESEHSEEEEEEEEEEEESEEEEEEEEEHEHSEEEEEEEEEESEEEEEEESN 
BSESSSSEESSSESESESEESSSSSSEBSBSEBBBBBSSBBSSSSESSESSSSESESUSESESSESSESESS 
BESSSESESESESESSSSESSEESSSSEESHESSESSESSESESESSSESSSSSSESHSUUHESHSESSEHESEEHSM 
EBSESSSESSESESSEESSESEESSSSESESEEBSSEBBSSBBSBSSSESSSSSSSESSSSESESSESSEESEEE 
BESSSSSSESSSESSESSESSESSSSESESESEEESSSSESSSSSESSESSSSESSSSESESSESESSESSEE 
EBSEBESEBEBESEEBBSSEEESESEBESSEBSESSEESSSERBSESSEEBSSSESSSEBSSSEBSSSEBSBSSS 
EÉSBESSSESEBESSESESESSESESSSESESESEESESESEESESSEEEESSEEEESSSSEPSESSSESESEESE 
EÉSBESESEEESESSESESESSEESESESSESESSSESEEESESESSESSSESESEESSSEESESSSSEEBSEE 
BSSSSSSESSSSESESSEESEESSHSEEHHEBESESSSSESESSESSESSSSSESESUHESHESSSSEESEESE 
BSSSSSSESSSSESSSSEESESSSEBESBHSEBBSSBBSSSBEBBSSSSSESBSSSESSESUHSESESSESEESESSE 
BSSSSSSSESESEESESSESESSSSESESESSEESSSSESESSESSSSSSSSSSSESSSHESESSESEESEESE 
BSSSSSESESSSEESESSESESSSEBSSESSEBBBBBSSEBSSBSSSESSESSSSESSSSESESSSSESESE 
BSSSSSSESSSSESESESESSESSSEESSSSESSEESSSESESESSSSSESSSSSSSSSESESSESESSESE 
BESESESESSESSSSSSESSESSSSSSESESESSEESSSSEESESSSESSESESSESESSSSEESEESSESEEESEEE 
BEBBESESEEBSSSEESESESESEEESEESESEEESESESEESSESESESEESSSSEESSSSEPSESSSSEPEEEES 
BESESSSESSSSEESEESSEESESSHSEEBBENBBEBBBBBBSSBBBSSSBSÉSSHSSHSSESSHSSHSESSSSESESESESESE 
A A A R A A A R R R A R RR RRR RR RRRA RRR RRR RRRA RR RRRA ERRERA RRR 
A A A A A A A A A A A A A A R RARR 
BSSESESESSSSESES 

done 

Bytes transferred - 6071136 (5ca360 hex) 

= 


30.4.4.6 nfs 命令 下 载 zImage 过 程 
在 图 30.4.4.6 中 会 以 “#” 提 示 下 载 过 程 ， 下 载 完成 以 后 会 提示 下 载 的 数据 大 小 ， 这 里 下 载 
的 6071136 字 节 ， 而 zImage 的 大 小 就 是 6071136 字 节 ， 如 图 30.4.4.7 所 示 : 
$ ls zImage -l 


-rw------- 1 zuozhongkai zuozhongkai 6071136 Apr 18 12:18 zImage 
: $s 


图 30.4.4.7 zImage 大 小 
下 载 完成 以 后 查看 0x80800000 地 址 处 的 数据 ,使 用 命令 md.b 来 查看 前 100 个 字 节 的 数据 ， 


如 图 30.4.4.8 所 示 : 


=> md.b 100 

80800000 : 00 a0 el 00 OO a0 el 00 OO a0 el 00 00 a0 el  ...............。 
80800010 : 00 00 a0 el 00 OO a0 el 00 OO a0 el 0000a0e1 ................ 
80800020: 03 00 00 ea 18 28 6f 01 00 00 00 OO 60 a3 5c OO  ..... f. see "a Ns 
80800030: 01 02 03 04 00 90 Of el e8 O4 OO eb O1 70 a0 el  J ............. D. a 
80800040: 02 80 a0 el 00 20 Of e1 03 0012 e3 01 00000 1a ..... .......... 
80800050: 17 00 a0 e3 56 34 12 ef 00 00 Of el 1a 00 20 e2 人 
80800060: 1f 00 10 e3 1f 00 cO e3 d3 00 80 e3 04 00 001a  ................ 
80800070: 01 Oc 80 e3 Oc eO 8f e2 00 fO 6f el Oe f3 2e el .......... n; Ee 
80800080: 6e 00 60 e1 00 fO 21 e1 09 fO 6f e1 00 00 00 00 ,pe PA 
80800090: 00 00 OO OO OO OO OO OO OO OO OO OO OO 00 00 00O  ...............。 
808000a0: Of 40 a0 el 3e 43 04 e2 02 49 84 e2 Of 00 a0 el S, e ceo. Mun 
808000b0: 04 00 50 el ac O1 9f 35 Of 00 80 30 00 00 54 31 ve unadaxe a a 
808000cO0: O1 40 84 33 6d 00 00 2b 5e Of 8f e2 4e 1c 90 e8 .6. 3m. c^... N... 
808000d0: 1c dO 90 e5 01 00 40 eO OO 60 86 eO 00 a0 8a eO — ...... , Heg at 
808000e0: 00 90 da e5 01 eO da e5 Oe 94 89 el 02 e0 dae5  . ................ 
808000f0: 03 a0 da e5 Oe 98 89 el Oa 9c 89 el 00 dO 8d eO . ................ 


30.4.4448 下 载 的 数据 
在 使 用 winhex 软件 来 查看 zImage, 检查 一 下 前 面 的 数据 是 否 和 图 30.4.4.8 只 的 一 致 ， 结果 
如 图 30.4.4.9 所 示 : 


zimage | 
Offset 0 1 2 3.4 5 €9 1 8 9 AB C D E F 10111213 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F | 
00000000 00 00 AO E1 00 00 AO E1 00 00 AO E1 00 00 AO E1 00 00 AO El 00 00 A0 E1 00 00 AO El 00 00 AO El 
00000020 03 00 00 EA 18 28 6F 01 00 00 00 00 60 A3 5C 00 01 02 03 04 00 90 OF El] E8 04 00 EB 01 70 AO El 
00000040 02 80 A0 El 00 20 OF EL 03 00 12 E3 01 00 00 lA 17 00 A0 E3 56 34 12 EF 00 00 OF El 1A 00 20 E2 
00000060 1F 00 10 E3 1F 00 CO E3 D3 00 80 E3 04 00 00 lA 01 OC 80 E3 OC EO 8F E2 00 FO 6F El OE F3 2E El 
00000080 6E 00 60 El 00 FO 21 E1 09 FO 6F EL 00 00 00 00 00 00 00 00 00 00 00 00 200 00 00 00 00 00 00 00 
000000A0 OF 40 A0 EL 3E 43 04 E2 02 49 84 E2 OF 00 A0 E1 04 00 50 El AC 01 9F 35 OF 00 80 30 00 00 54 31 
000000CO0 01 40 84 33 6D 00 00 2B 5E OF 8F E2 4E 1C 90 E8 1C DO 90 E5 01 00 40 EO 00 60 86 EO 00 AO 8A EO 
000000E0 00 90 DA E5 01 EO DA E5 OE 94 89 El 02 EO DA E5 03 AO DA E5 OE 98 89 E1 OA 9C 89 E1 00 DO 8D EO 
00000100 01 A8 8D E2 00 50 A0 E3 01 A9 8A E2 OA 00 54 E1 1E 00 00 2A 09 AO 84 EO 70 90 8F E2 09 00 5A El 
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图 30.4.4.9 winhex 查看 zImage 
可 以 看 出 图 30.4.4.8 和 图 30.4.4.9 中 的 前 100 个 字 节 的 数据 一 致 ， 说 明 nfs 命令 下 载 到 的 














zImage 是 正确 的 。 

4、tftp 命令 

tftp 命令 的 作用 和 nfs 命令 一 样 ， 都 是 用 于 通过 网 络 下 载 东 西 到 DRAM 中 ， 只 是 tftp 命令 
使 用 的 TFTP 协议 ，Ubunut 主机 作为 TFTP 服务 器 。 因 此 需要 在 Ubuntu 上 搭建 TFTP 服务 器 ， 
需要 安装 tftp-hpa 和 tftpd-hpa， 命 令 如 下 : 

sudo apt-get install tftp-hpa tftpd-hpa 

和 NFS 一 样 ，TFTP 也 需要 一 个 文件 夹 来 存放 文件 ， 在 用 户 目录 下 新 建 一 个 目录 ， 命 令 如 






































mkdir /home/zuozhongkai/linux/tftpboot 
chmod 777 /home/zuozhongkai/linux/tftpboot 
这 样 我 就 在 我 的 电脑 上 创建 了 一 个 名 为 tftpboot 的 目录 (文件 夹 )， 路 径 为 
/home/zuozhongkai/linux/tftpboot。 注 意 ! 我 们 要 给 tftpboot 文件 夹 权限 ， 否 则 的 话 uboot 不 能 从 
tftpboot 文件 夹 里 面 下 载 文件 。 
最 后 配置 tftp, 打开 文件 安装 完成 以 后 新 建文 件 /etc/xinetd.d/tftp, 然后 在 里 面 输入 如 下 内 容 : 
示例 代码 30.4.4.1 /etc/xinetd.d/tftp 文件 内 容 
























































1 server tftp 

2 

E Socket type = dgram 

4 jpieortoxeo1 = udp 

5 wait = yes 

6 user = root 

y server = /usr/sbin/in.tftpd 
8 server args = -s /home/zuozhongkai/linux/tftpboot/ 
9 disable = no 

10 per source = 11 

SA cps = 100 2 

站 之 flags = IPv4 


Ls} 
完了 以 后 启动 tftp 服务 ， 命 令 如 下 : 
sudo service tftpd-hpa start 
打开 /etc/default/tftpd-hpa 文件 ， 将 其 修改 为 如 下 所 示 内 容 : 
示例 代码 30.4.4.2 / etc/ default/tftpd-hpa 文件 内 容 
# /etc/default/tftpd-hpa 




















TFTP USERNAME-"tftp" 
TFTP DIRECTORYz"/home/zuozhongkai/linux/tftpboot" 
TFTP ADDRESSz-":69" 
Te" ORNS = -—(& -8" 
TFTP DIRECTORY 就 是 我 们 上 面 创建 的 tftp 文件 夹 目录 ， 以 后 我 们 就 将 所 有 需要 通过 
TFTP 传输 的 文件 都 放 到 这 个 文件 夹 里 面 ， 并 且 要 给 予 这 些 文件 相应 的 权限 。 
最 后 输入 如 下 命令 ， 重启 tftp 服务 器 : 














SC Ny 
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sudo service tftpd-hpa restart 

tftp 服务 器 已 经 搭建 好 了 ， 接 下 来 就 是 使 用 了 。 将 zImage 镜像 文件 拷贝 到 tftpboot 文件 夹 
中 ， 并 且 给 予 zImage 相应 的 权限 ， 命 令 如 下 : 

cp zImage /home/zuozhongkai/linux/tftpboot/ 

cd /home/zuozhongkai/linux/tftpboot/ 

chmod 777 es 

万 事 俱 备 ， 只 剩 验证 了 ，uboot 中 的 tftp 命令 格式 如 下 : 

tftpboot [loadAddress] [[hostIPaddr:]bootfilename] 

看 起 来 和 nfs 命令 格式 一 样 的 ，loadAddress 是 文件 在 DRAM 中 的 存放 地 址 ， 
[[hostIPaddr:]bootfilename] 是 要 从 Ubunut 中 下 载 的 文件 。 但 是 和 nfs 命令 的 区 别 在 于 ，tftp 命令 
不 需要 输入 文件 在 Ubuntu 中 的 完整 路 径 ， 只 需要 输入 文件 名 即 可 。 比 如 我 们 现在 将 tftpboot X 
件 夹 里 面 的 zImage 文件 下 载 到 开发 板 DRAM 的 0X80800000 地 址 处 ， 命 令 如 下 : 

tftp 80800000 zImage 

下 载 过 程 如 图 30.4.4.10 所 示 : 
=> tftp 80800000 zimage 
Using FEC1 device 
TFTP from server ,192.168.1.250; our IP address is 192.168.1.50 
Filename 'zimage 
Load address: 0x80800000 
Loading: HHHHHHHEHEHEHHHARHEHEEEREEHEEHEHEHHHHEEEREEEEEEHEHHHHEEE REEL 

BEREEEEESEESERRREEEEDESESESERREEEEEEEESEEEEREEEEEEEESEEEEREEEEEEE 
BHESSESEHSESEHEEHSHESHEHEEHHEHUHSHSEHEEEEHHEHHEHUEHEHEEHEEHEHHEEHHHHHHPEE 
BERREEESEEEEREREEESEÉESESESEREREESEÉESESEEEERRESEEÉESEEEEREEESSEEE 
RHHHHEHEREREEEEHEEHEHEHEHHHHEEEEEEEEHHEHEHHHHEEEEEAEEEHEHHHHHEEREEE EHE EE 
AHHEEEREREEEHEHHHAHHHHHHHEHHHHEHEEEEEEEEEEEEEHEHALAHHHHHHHEHHHHHEEE 


BEEBEBBESSESSUSESBEESSESSSESEESBSN 
1.4 MiB/s 












































done 
Bytes transferred - 6071136 (5ca360 hex) 
=o 


30.4.4.10 tftp 命令 下 载 过 程 
从 图 30.4.4.10 可 以 看 出 ，zImage 下 载 成 功 了 ， 网 速 为 1.4MibB/s， 文 件 大 小 为 6071136 字 
节 。 同 样 的 ， 可 以 使 用 md.b 命令 来 查看 前 100 个 字 节 的 数据 是 否 和 图 30.4.4.9 中 的 相等 。 有 时 
候 使 用 fttp 命令 从 Ubuntu 中 下 载 文件 的 时 候 会 出 现 如 图 30.4.4.11 所 示 的 错误 提示 : 

















=> tftp 80800000 zimage 

Using FEC1 device 

TFTP from server 192.168.1.250; our IP address is 192.168.1.50 
Filename 'zimage'. 

Load address: 0x80800000 

Loading: 

TFTP error: 'Permission denied' (0) 

Starting again 





图 30.4.4.11 ttp 下 载 出 错 

在 图 30.4.4.11 中 可 以 看 到 “TFTP error: 'Permission denied' (0)” 这 样 的 错误 提示 ， 提 示 没 有 
权限 ， 出 现 这 个 错误 一 般 有 两 个 原因 : 

©, Æ Ubunut 中 创建 tftpboot 目录 的 时 候 没 有 给 予 tftboot 相应 的 权限 。 

©, tfipboot 目录 中 要 下 载 的 文件 没有 给 予 相 应 的 权限 。 

针对 上 述 两 个 问题 ， 使 用 命令 “chmod 777 xxx” 来 给 予 权限 ， 其 中 “xxx” 就 是 要 给 予 权限 
的 文件 或 文件 夹 。 
好 了 ，uboot 中 关于 网 络 的 命令 就 讲解 到 这 里 ， 我 们 最 常用 的 就 是 ping. nfs 和 tftp 这 三 个 
。 使 用 ping 命令 来 查看 网 络 的 连接 状态 ， 使 用 nfs 和 tftp 命令 来 从 Ubunut 主机 中 下 载 文 
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30.4.5 EMMC 和 SD 卡 操作 命令 


uboot 支持 EMMC 和 SD F, 因此 也 要 提供 EMMC 和 SD 卡 的 操作 命令 。 一般 认为 EMMC 
和 SD 卡 是 同一 个 东西 ， 所 以 没有 特殊 说 明 ， 本 教程 统一 使 用 MMC 来 代 指 EMMC 和 SD 卡 。 
uboot 中 常用 于 操作 MMC 设备 的 命令 为 “mmc”。 

mmc 是 一 系列 的 命令 ， 其 后 可 以 跟 不 同 的 参数 ， 输 入 “? mmc” 即 可 查看 mmc 有 关 的 命 
令 ， 如 图 30.4.5.1 所 示 : 


-» ? mmc 
mmc - MMC sub system 








Usage: 
mc Tiu - ze info of the current MMC device 
mmc read addr blk# cnt 
mmc write addr blk# cnt 
mmc erase blk# cnt 
mmc rescan 
mmc part - lists available partition on current mmc device 
mmc Dd [dev] [part] - show or set current mmc device [partition] 
mmc list - lists available devices 
mmc hwpartition [args...] - does hardware partitioning 

arguments (sizes in 512- -byte blocks): 

fuser [enh start cnt] [wrrel (onjoffj]] - sets user data area attributes 
tap lgp21gp31gp4 cnt [enh] [wrrel {onloff}]] - general purpose partition 
|set|complete] - mode, complete set partitioning completed 

ME Partitioning is a write-once setting once it is set to complete. 

Power cycling is required to initialize p after set to complete. 
mmc bootbus dev boot bus width reset boot. bus width boot. mode 

- Set the BOOT. BUS WIDTH field of the specified device 
mmc bootpart-resize «dev» «boot part size MB» «RPMB part size MB» 

= — sizes of boot and RPMB partitions of specified device 

gei mokiga d dev boot_ack boot_partition partition_access 
ange the bits of the PARTITION_CONFIG field of the specified device 

mmc rst- ae elea p dev value 

- Change the RST n FUNCTION field of the specified device 

WARNING: This is a write-once field and O / 1 / 2 are the only valid values. 

mmc setdsr «value» - set DSR register value 


=> 
30.4.5.1 mmc 命令 


从 图 30.4.5.1 可 以 看 出 , mme 后 面 跟 不 同 的 参数 可 以 实现 不 同 的 功能 , 如 表 30.4.5.1 所 示 : 

































































mmc info 输出 MMC 设备 信息 

mmc read 读 取 MMC 中 的 数据 。 

mmc wirte 向 MMC 设备 写 入 数据 。 

mmc rescan 扫描 MMC 设备 。 

mmc part 列 出 MMC 设备 的 分 区 。 

mmc dev 切换 MMC 设备 。 

mmc list 列 出 当前 有 效 的 所 有 MMC 设备 。 

mmc hwpartition 设置 MMC 设备 的 分 区 。 

mmc bootbus...... 设置 指定 MMC 设备 的 BOOT BUS WIDTH 域 的 值 。 
mmc bootpart. ..... 设置 指定 MMC 设备 的 boot 和 RPMB 分 区 的 大 小 。 
mmc partconf ..... 设置 指定 MMC 设备 的 PARTITION_CONEFG 域 的 值 。 
mmc rst 复位 MMC 设备 

mmc setdsr 设置 DSR 寄存 器 的 值 。 














K 30.4.5.1 mmc 命令 
1. mmc info 命令 
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mmc info 命令 用 于 输出 当前 选中 的 mme info 设备 的 信息 ， 输 入 命令 “mmc info” 即 可 ， 如 
图 30.4.5.2 所 示 : 


=> mmc info 

Device: FSL_SDHC 
Manufacturer ID: 45 
OEM: 100 
Name: SEMO4 
Tran Speed: 52000000 

Rd Block Len: 512 

MMC version 4.5 

High Capacity: ves 

Capacity: 3.7 GiB 

Bus width: 8-bit 

Erase Group Size: 256 KiB 

HC WP Group Size: 8 MiB 

User Capacity: 3.7 GiB WRREL 
Boot Capacity: 2 MiB 

RPMB Capacity: 2 MiB 

=> 


图 30.4.5.2 mmc info 命令 
从 图 30.4.5.2 可 以 看 出 ,当前 选中 的 MMC 设备 是 EMMC ,版 本 为 4.5, 容量 为 3.7GiB(EMMC 
为 4GB)， 速 度 为 52000000Hz-52MHz, 8 位 宽 的 总 线 。 还 有 一 个 与 mmc info 命令 相同 功能 的 
命令 ;mmcinfo,“mmc” 和 “info” 之 间 没有 空格 。 











2、mme rescan 命令 


mmc rescan 命令 用 于 扫描 当前 开发 板 上 所 有 的 MMC 设备 ， 包 括 EMMC 和 SD 卡 ， 输 入 


“mmc rescan” 即 可 。 
3、mmc list 命令 


mmc list 命令 用 于 来 查看 当前 开发 板 一 共有 几 个 MMC 设备 ， 输 入 “mmc list”, 结果 如 图 
30.4.5.3 所 示 : 
=> mmc list 
FSL. SDHC: O 


FSL SDHC: 1 (eMMC) 
=> 
































图 30.4.5.3 扫描 MMC 设备 
可 以 看 出 当前 开发 板 有 两 个 MMC 设备 : FSL SDHC:0 和 FSL SDHC:1 (eMMC)， 这 是 因 
为 我 现在 用 的 是 EMMC 版 本 的 核心 板 , 加 上 SD 卡 一 共有 两 个 MMSC 设备 , FSL_ SDHC:0 是 SD 
卡 ，FSL SDHC:I(eMMC) 是 EMMC, 。 默 认 会 将 EMMC 设置 为 当前 MMC 设备 ,这 就 是 为 什么 
输入 “mmc info” 查 询 到 的 是 EMMC 设备 信息 ， 而 不 是 SD 卡 。 要 想 查 看 SD 卡 信 息 ， 就 要 使 
用 命令 “mmc dev” 来 将 SD 卡 设置 为 当前 的 MMC 设备 。 


4, mme dev 命令 


mmc dev 命令 用 于 切换 当前 MMC 设备 ， 命 令 格式 如 下 : 
mmc dev [dev] [part] 
[dev] 用 来 设置 要 切换 的 MMC. 设备 号 , [part 是 分 区 号 .如 果 不 写 分 区 号 的 话 默认 为 分 区 0。 
使 用 如 下 命令 切换 到 SD F: 
mmc dev 0 /切换 到 SD -E, 079 SD-E, 173 eMMC 
结果 如 图 30.4.5.4 所 示 : 
=> mmC dev 0 


switch to partitions #0, OK 
mmcO is current device 
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图 30.4.5.4 切换 到 SD E 
从 图 30.4.5.4 可 以 看 出 ， 切 换 到 SD 卡 成 功 ，mmc0 为 当前 的 MMC 设备 ， 输 入 命令 “mmc 
info” 即 可 查看 SD 卡 的 信息 ， 结 果 如 图 30.4.5.5 所 示 : 











=> mmc info 

Device: FSL_SDHC 
Manufacturer ID: 3 
OEM: 5344 

Name: SC16G 

Tran Speed: 50000000 
Rd Block Len: 512 

SD version 3.0 

High Capacity: Yes 
Capacity: 14.8 GiB 
Bus width: 4-bit 
Erase Group Size: 512 Bytes 
三 


图 30.4.5.5 SD 信息 


从 图 30.4.5.5 可 以 看 出 当前 SD 卡 为 3.0 版 本 的 ， 容 量 为 14.8GiB(16GB 的 SD 卡 )，4 位 宽 
的 总 线 。 

5. mmc part 命令 

有 时 候 SD 卡 或 者 EMMC 会 有 多 个 分 区 ， 可 以 使 用 命令 “mmc part” 来 查看 其 分 区 ， 比 如 
查看 EMMC 的 分 区 情况 ， 输 入 如 下 命令 : 

mmc dev 1 /切换 到 EMMC 

mmc part // 查 看 EMMC 分 区 


结果 如 图 30.4.5.6 所 示 : 


=> mmc dev 1 

switch to partitions #0, OK 
mmcl(part 0) is current device 
-» mmc part 


lim] 























Partition Map for MMC device 1 -- Partition Type: DOS 
Part Start Sector Num Sectors UUID Type 
1 20480 1024000 488db264-01 Oc 
2 1228800 6504448 488db264-02 83 


30.4.5.6 查看 EMMC 分 

从 图 30.4.5.6 中 可 以 看 出 ， 此 时 EMMC PIA AX, X 20480-1024000 为 第 一 个 分 区 ， 
扇 区 1228800~6504448 为 第 二 个 分 区 。 如 果 EMMC 里 面 烧 写 了 Linux 系统 的 话 ，EMMC 是 有 
3 个 分 区 的 ， 第 0 个 分 区 存放 uboot， 第 1 个 分 区 存放 Linux 镜像 文件 和 设备 树 ， 第 2 个 分 区 存 
放 根 文件 系统 。 但 是 在 图 30.4.5.6 中 只 有 两 个 分 区 ， 那 是 因为 第 0 个 分 区 没有 格式 化 ， 所 以 识 
别 不 出 来 ， 实 际 上 第 0 个 分 区 是 存在 的 。 一 个 新 的 SD 卡 默 认 只 有 一 个 分 区 ， 那 就 是 分 区 0， 所 
以 前 面 讲解 的 uboot 烧 写 到 SD 卡 ， 其 实 就 是 将 u-boot.bin 烧 写 到 了 SD 卡 的 分 区 0 里 面 。 后 面 
学 习 Linux 内 核 移 植 的 时 候 再 讲解 怎么 在 SD 卡 中 创建 并 格式 化 第 二 个 分 区 ， 并 将 Linux 镜像 
文件 和 设备 树 文 件 存放 到 第 二 个 分 区 中 。 
如 果 要 将 EMMC 的 分 区 2 设置 为 当前 MMC 设置 ， 可 以 使 用 如 下 命令 : 
mmc dev 12 


结果 如 图 30.4.5.7 所 示 : 


=> mmc dev 1 2 

switch to partitions #2, OK 
mmcl(part 2) is current device 
=> 


ixl 
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30.4.5.7 设置 EMMC 分 区 2 为 当前 设备 





6. mmc read 命令 


mmc read 命令 用 于 读 取 mme 设备 的 数据 ， 命 令 格 式 如 下 : 

mmc read addr blk# cnt 

addr 是 数据 读 取 到 DRAM 中 的 地 址 , blk 是 要 读 取 的 块 起 始 地 址 (十 六 进 制 ), 一 个 块 是 512 
字 节 , 这 里 的 块 和 扇 区 是 一 个 意思 , 在 MMC 设备 中 我 们 通常 说 肩 区 , ent 是 要 读 取 的 块 数量 (十 
六 进 制 )。 比 如 从 EMMC 的 第 1536(0x600) 个 块 开始 ， 读 取 16(0x10) 个 块 的 数据 到 DRAM 的 
0X80800000 地 址 处 ， 命 令 如 下 : 

mmc dev10 // 切 换 到 MMC 分 区 0 

mmc read 80800000 600 10 // 读 取 数 据 
结果 如 图 30.4.5.8 所 示 : 


-» mmc dev 1 0 

switch to partitions #0, OK 
mmcl(part 0) is current device 
-» mmc read 80800000 600 10 





























MMC read: dev # 1, block # 1536, count 16 ... 16 blocks read: OK 
=> 
30.4.5.8 mmc read 命令 
这 里 我 们 还 看 不 出 来 读 取 是 否 正 确 ， 通 过 md.b 命令 查看 0x80800000 处 的 数据 就 行 了 ， 查 
看 16*512=8192(0x2000) 个 字 节 的 数据 ， 命 令 如 下 : 
md.b 80800000 2000 


结果 如 图 30.4.5.9 所 示 : 
=> mmc read 80800000 600 10 





MMC read: dev & 1, block & 1536, count 16 ... 16 blocks read: OK 

-» md.b 80800000 2000 

80800000: 44 24 ec 88 62 61 75 64 72 61 74 65 3d 31 31 35 D$..baudrate-115 
80800010: 32 30 30 00 62 6f 61 72 64 5f 6e 61 6d 65 3d 45 200. board name-E 
80800020: 56 4b 00 62 6f 61 72 64 5f 72 65 76 3d 31 34 58 VK. board rev-14x 
80800030: 31 34 00 62 6f 6f 74 5f 66 64 74 3d 74 72 79 00 14.boot fdt-try. 
80800040: 62 6f 6f 74 61 72 67 73 3d 63 6f 6e 73 6f 6c 65 bootargs-console 


80800050: 3d 74 74 79 6d 78 63 30 2c 31 31 35 32 30 30 20 -ttymxc0,115200 

80800060: 72 6f 6f 74 3d 2f 64 65 76 2f 6e 66 73 20 72 77 root-/dev/nfs rw 
80800070: 20 6e 66 73 3d 2f 64 65 76 2f 6e 66 73 20 72 77 nfs-/dev/nfs rw 
80800080: 20 6e 66 73 72 6f 6f 74 3d 31 39 32 2e 31 36 38 nfsroot-192.168 
80800090: 2e 31 2e 32 35 30 3a 2f 68 6f 6d 65 2f 7a 75 6f .1.250: /home/zuo 


808000a0: 7a 68 6f 6e 67 6b 61 69 2f 6c 69 6e 75 78 2f 6e zhongkai /linux/n 
808000b0: 66 73 2f 69 6d 78 5f 72 6f 6f 74 66 73 20 69 70 fs/imx rootfs ip 
808000c0: 3d 31 39 32 2e 31 36 38 2e 31 2e 35 35 3a 31 39 -192.168.1.55:19 
808000d0: 32 2e 31 36 38 2e 31 2e 32 35 30 3a 31 39 32 2e 2.168.1.250:192. 
808000e0: 31 36 38 2e 31 2e 31 3a 32 35 35 2e 32 35 35 2e 168.1.1:255. 255. 
808000f0: 32 35 35 2e 30 3a 3a 65 74 68 30 3a 6f 66 66 00 255.0: :eth0:off. 
80800100: 62 6f 6f 74 63 6d 64 3d 6e 66 73 20 38 30 38 30 bootcmd-nfs 8080 
80800110: 30 30 30 30 20 31 39 32 2e 31 36 38 2e 31 2e 32 0000 192.168.1.2 
80800120: 35 30 3a 2f 68 6f 6d 65 2f 7a 75 6f 7a 68 6f 6e 50: /home/zuozhon 
80800130: 67 6b 61 69 2f 6c 69 6e 75 78 2f 6e 66 73 2f 7a gkai /linux/nfs/z 
80800140: 49 6d 61 67 65 5f 69 6d 78 36 75 6c 3b 6e 66 73 Image imx6ul;nfs 
80800150: 20 38 33 30 30 30 30 30 30 20 31 39 32 2e 31 36 83000000 192.16 


30.4.5.9 读 取 到 的 数据 (部 分 截图 ) 
从 图 30.4.5.9 可 以 看 到 “DS$..baudrate=115200.board name-EVK.board rev=14X14.” 等 字 
样 ， 这 个 就 是 uboot 中 的 环境 变量 。EMMC 核心 板 uboot 环境 变量 的 存储 起 始 地 址 就 是 
1536*512=786432。 
7、mmc write 命令 


要 将 数据 写 到 MMC 设备 里 面 ， 可 以 使 用 命令 “mmc write”, RU F: 
mmc write addr blk# cnt 
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addr 是 要 写 入 MMC 中 的 数据 在 DRAM 中 的 起 始 地 址 ，blk 是 要 写 入 MMC 的 块 起 始 地 址 
(十 六 进 制 )，cnt 是 要 写 入 的 块 大 小 ， 一 个 块 为 512 字 节 。 我们 可 以 使 用 命令 “mmc write” 来 升 








级 uboot， 也 就 是 在 uboot 中 更 新 uboot。 这 里 要 用 到 nfs 或 者 tftp 命令 ， 通 过 nfs 或 者 tftp 命令 
将 新 的 u-boot.bin 下 载 到 开发 板 的 DRAM 中 ， 然 后 再 使 用 命令 “mmc write” 将 其 写 入 到 MMC 
设备 中 。 我 们 就 来 更 新 一 下 SD 中 的 uboot， 先 查看 一 下 SD 卡 中 的 uboot 版 本 号 ， 注 意 编译 时 
间 ， 输 入 命令 : 

mmc dev0 ”// 切 换 到 SD F 

version /查看 版 本 号 

结果 如 图 30.4.5.10 所 示 : 


=> mmc dev 1 

switch to partitions #0, OK 
mmcl(part 0) is current device 
-» version 

















U-Boot 2016.03 ope 15 2019 - 12:52:04 +0800) 
arm-linux-gnueabihf-gcc (Linaro GCC 4.9-2017.01) 4.9.4 
GNU ld (Linaro Binutils-2017.01) 2.24.0.20141017 Linaro 2014 11-3-git 


=> 


图 30.4.5.10 uboot 版 本 查询 
可 以 看 出 当前 SD 卡 中 的 uboot 是 2019 Æ 4 H 15 H 12:52:04 编译 的 。 我 们 现在 重新 编译 
一 下 uboot， 然 后 将 编译 出 来 的 u-boot.imx(u-boot.bin 前 面 加 了 一 些 头 文件 ) 找 贝 到 Ubuntu 中 的 
tftpboot 目录 下 。 最 后 使 用 tftp 命令 将 其 下 载 到 0x80800000 地 址 处 ， 命 令 如 下 : 
tftp 80800000 u-boot.imx 
下 载 过 程 如 图 30.4.5.11 所 示 : 
=> tftp 80800000 u-boot. imx 
Using FEC1 device 
TFTP from server 192.168.1.250; our IP address is 192.168.1.50 
Filename 'u-boot.imx'. 
Load address: O0x80800000 


Loading: $ssss555S5HEESEEESSESEHEEE EE NEN 
2.2 MiB/s 



































done 
Bytes transferred - 416768 (65c00 hex) 
=> 


图 30.4.5.11 u-boot.imx 下 载 过 程 
可 以 看 出 ，u-boot.imx 大 小 为 416768 字 节 ，416768/512=814， 所 以 我 们 要 向 SD 卡 中 写 入 
814 个 块 ， 如 果 有 小 数 的 话 就 要 加 1 个 块 。 使 用 命令 “mmc write” A SD 卡 分 区 0 28 2 个 块 (局 
区 ) 开 始 烧 写 ， 一 共 烧 写 814(0x32E) 个 块 ， 命 令 如 下 : 
mmc dev00 
mmc write 80800000 2 32bE 
烧 写 过 程 如 图 30.4.5.12 所 示 : 


=> mmc dev 0 0 

switch to partitions #0, OK 
mmcO is current device 

-» mmc write 80800000 2 32E 











MMC write: dev # 0, block # 2, count 814 ... 814 blocks written: OK 
=> 
图 30.4.5.12 烧 写 过 程 
烧 写 成 功 ， 重 启 开 发 板 ( 从 SD 卡 启 动 )， 重 启 以 后 再 输入 version 来 查看 版 本 号 ， 结 果 如 图 
30.4.5.13 所 示 : 
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=> Version 


U-Boot 2016.03 ae 21 2019 - 18:05:59 +0800) 
arm-linux-gnueabihf-gcc (Linaro GCC 4.9-2017.01) 4.9.4 
GNU ld (Linaro Binutils-2017.01) 2.24.0.20141017 Linaro 2014 11-3-git 


图 30.4.5.13 uboot 版 本 号 
从 图 30.4.5.13 可 以 看 出 ， 此 时 的 uboot 是 2019 Æ 4 H 21 ^ 18:05:59 编译 的 ， 这 个 时 间 就 
是 我 刚刚 编译 uboot 的 时 间 , 说 明 uboot 更 新 成 功 。 这 里 我 们 就 学 会 了 如 何在 uboot 中 更 新 uboot 
了 ， 如 果 要 更 新 EMMC 中 的 uboot 也 是 一 样 的 。 























FADES SD 卡 或 者 EMMC 的 前 两 个 块 ( 扇 区 )， 里 面 保 存 着 分 区 表 ! 
TADES SD 卡 或 者 EMMC 的 前 两 个 块 ( 扇 区 )， 里 面 保存 着 分 区 表 ! 
TOUT X SD 卡 或 者 EMMC 的 前 两 个 块 ( 扇 区 )， 里 面 保 存 着 分 区 表 ! 


8. mmc erase 命令 

如 果 要 擦 除 MMC 设备 的 指定 块 就 是 用 命令 “mmc erase”， 命 令 格式 如 下 : 

mmc erase blk# cnt 

blk 为 要 擦 除 的 起 始 块 , cnt 是 要 探 除 的 数量 。 没事 不 要 用 mmc erase 来 擦 除 MMC 设备 !!1! 
XT MMC 设备 相关 的 命令 就 讲解 到 这 里 ， 表 30.4.5.1 中 还 有 一 些 跟 MMC 设备 操作 有 关 






































的 命令 ， 但 是 很 少 用 到 ， 这 里 就 不 讲解 了 ， 感 兴趣 的 可 以 上 网 查 一 下 ， 或 者 在 uboot 中 查看 这 
些 命令 的 使 用 方法 。 
30.4.6 FAT 格式 文件 系统 操作 命令 





有 时 候 需要 在 uboot 中 对 SD 卡 或 者 EMMC 中 存储 的 文件 进行 操作 ， 这 时 候 就 要 用 到 文件 
操作 命令 ， 跟 文件 操作 相关 的 命令 有 : fatinfo. fatls. fstype, fatload 和 fatwrite， 但 是 这 些 文 件 
操作 命令 只 支持 FAT 格式 的 文件 系统 !! 

1、fatinfo 命令 

fatinfo 命令 用 于 查询 指定 MMC 设置 指定 分 区 的 文件 系统 信息 ， 格 式 如 下 : 

fatinfo «interface» [<dev[:part]>] 

interface 表示 接口 ， 比 如 mme, deyv 是 查询 的 设备 号 ，part 是 要 查询 的 分 区 。 比 如 我 们 要 查 
询 EMMC 分 区 1 的 文件 系统 信息 ， 命 令 如 下 : 

fatinfo mmc 1:1 
结果 如 图 30.4.6.1 Bron: 


=> fatinfo mmc 1:1 
Interface: MMC 
Device 1: Vendor: Man 000045 snr 91ef8153 Rev: 3.10 Prod: SEM04G 
Type: Removable Hard Disk 
Capacity: 3776.0 MB = 3.6 GB (7733248 x 512) 
Filesystem: FAT16 "NO NAME ü 
= 























x 














图 30.4.6.1 emmc 分 区 1 文件 系统 信息 
从 上 图 可 以 看 出 ，EMMC 分 区 1 的 问 价 系 统 为 FAT16 格式 的 。 
2、fatls 命令 
fatis 命令 用 于 查询 FAT 格式 设备 的 目录 和 文件 信息 ， 命 令 格 式 如 下 : 
fatls <interface> [<dev[:part]>] [directory] 
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interface 是 要 查询 的 接口 ,比如 mme; dev 是 要 查询 的 设备 号 ,part 是 要 查询 的 分 区 ,directory 
是 要 查询 的 目录 。 比 如 查询 EMMC 分 区 1 中 的 所 有 的 目录 和 文件 ， 输 入 命令 : 

fatls mmc 1:1 


结果 如 图 30.4.6.2 所 示 : 





























=> fatls mmc 1:1 
6071136 zimage 
37099 imx6u11-14x14-evk. dtb 


2 file(s), O dir(s) 
=> 
图 30.4.6.2 EMMC 分 区 1 文件 查询 
从 上 图 可 以 看 出 ，emmc 的 分 区 1 中 存放 着 两 个 文件 :zimage 和 imx6ull-14x14-evk.dtb, 3X 
两 个 文件 分 别 是 linux 镜像 文件 和 设备 树 。 并 且 在 emme 的 分 区 1 中 有 两 个 文件 ， 没 有 目录 
3、fstype 命令 
fstype 用 于 查看 MMC 设备 某 个 分 区 的 文件 系统 格式 ， 命 令 格式 如 下 : 


fstype <interface> <dev>:<part> 

正点 原子 EMMC 核心 板 上 的 EMMC 默认 有 3 个 分 区 ， 我 们 来 查看 一 下 这 三 个 分 区 的 文件 
系统 格式 ， 输 入 命令 : 

fstype mmc 1:0 
































fstype mmc 1:1 
fstype mmc 1:2 
结果 如 图 30.4.6.3 所 示 : 


=> fstype mmc 1:0 
Failed to mount ext2 filesystem.. 
** Unrecognized filesystem type 2 
2 fstype mmc 1:1 
at 








-» fstype mmc 1:2 
ext4 
=> 





图 30.4.6.3 fstype 命令 

从 上 图 可 以 看 出 ， 分 区 0 格式 未 知 ， 因 为 分 区 0 存放 的 uboot， 并 且 分 区 0 没有 格式 化 ， 
所 以 文件 系统 格式 未 知 。 分 区 1 的 格式 为 fat， 分 区 1 用 于 存放 linux. 镜像 和 设备 树 。 分 区 2 的 
格式 为 ext4， 用 于 存放 Linux 的 跟 文 件 系统 。 

4. fatload 命令 


fatload 命令 用 于 将 指定 的 文件 读 取 到 DRAM 中 ， 命 令 格式 如 下 : 

fatload <interface> [<dev[:part]> [<addr> [<filename> [bytes [pos]]]]] 

interface 为 接口 ， 比 如 mmc, dev 是 设备 号 ，part 是 分 区 ，addr 是 保存 在 DRAM 中 的 起 始 
地 址 ，filename 是 要 读 取 的 文件 名 字 。bytes 表示 读 取 多 少 字 节 的 数据 ， 如 果 bytes 为 0 或 者 省 
略 的 话 表 示 读 取 整 个 文件 。pos 是 要 读 的 文件 相对 于 文件 首 地 址 的 偏 移 ， 如 果 为 0 或 者 省 略 的 
话 表示 从 文件 首 地 址 开始 读 取 。 我 们 将 EMMC 分 区 1 中 的 zImage 文件 读 取 到 DRAM 中 的 
0X80800000 地 址 处 ， 命 令 如 下 : 

fatload mmc 1:1 80800000 zImage 

操作 过 程 如 图 30.4.6.4 所 示 : 
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=> fatload mmc 1:1 80800000 zImage 
reading zimage 
6071136 bytes read in 153 ms (37.8 MiB/s) 


= 


图 30.4.6.4 读 取 过 程 
从 上 图 可 以 看 出 在 153ms 内 读 取 了 6071136 个 字 节 的 数据 ， 速 度 为 37.8MiB/s， 速 度 是 非 
常 快 的 ， 因 为 这 是 从 EMMC 里 面 读 取 的 ， 而 EMMC 是 8 位 的 ， 速 度 肯 定 会 很 快 的 。 


5. fatwrite 命令 
fatwirte 命令 用 于 将 DRAM 中 的 数据 写 入 到 MMC 设备 中 ， 命 令 格 式 如 下 : 


fatwrite <interface> «dev[:part|» <addr> «filename» <bytes> 

interface 为 接口 ， 比 如 mme, dev 是 设备 号 ，part 是 分 区 ，addr 是 要 写 入 的 数据 在 DRAM 
中 的 起 始 地 址 ，filename 是 写 入 的 数据 文件 名 字 ，bytes 表示 要 写 入 多 少 自己 的 数据 。 我 们 可 以 
通过 fatwrite 命令 在 uboot 中 更 新 linux 镜像 文件 和 设备 树 。 我 们 以 更 新 linux. 镜像 文件 zImage 
为 例 ， 首 先 将 正点 原子 LIMX6U-ALPHA 开发 板 提供 的 zImage 镜像 文件 拷贝 到 Ubunut 中 的 
tftpboot 目录 下 ，zImage 镜像 文件 放 到 了 开发 板 光盘 中 ， 路 径 为 : 开发 板 光盘 ->8、 开 发 板 系统 
镜像 ->zImage。 拷 贝 完成 以 后 的 tftpboot 目录 如 图 30.4.6.5 所 示 ; 


















































图 30.4.6.5 zImage 放 到 tftpboot 目录 中 。 
使 用 命令 tftp 将 zImage 下 载 到 DRAM 的 0X80800000 地 址 处 ， 命 令 如 下 : 


tftp 80800000 zImage 
下 载 过 程 如 图 30.4.6.6 所 示 : 


=> tftp 80800000 zImage 

Using FEC1 device 

TFTP from server 192.168.1.250; our IP address is 192.168.1.50 

Filename 'zimage 

Load address: 0x80800000 

Loading: BESESEBEBSSESESESEESSSSESSSEESBESSSUSSUSEBESBSUSSSEESESSEBSESESESSSEPSSSESESN 
ddd dd dd dd dd 
EEEE EEEE EEEE EEEE EEEE EEEE EEEE EEEE EEEE EEEE EEEE EEEE EEE E E EEE EEE EE EE E 
dd dd dd dd EEE EEEE EEEE EEE E EEEE EEE dd EEE EEE E E dd 
EEEE EEEE EEEE EEEE EEE EEEE E EEEE EEE EE EE E E EE E EEE E EEE E E EE EEEE E EE E E EEE E 
BSSEESBEBEESSESSSHEESSESEESESEHEESESEESHHESEHEHHEEESSHESPEHESEHEHSSEHEESEHES 
BEBSEBSBSBSBSSESSSESER 
2.2 MiB/s 





done 
Bytes transferred - 6039328 (5c2720 hex) 
=> 


图 30.4.6.6 zImage 下 载 过 程 
zImage 大 小 为 6039328(0X5C2720) 个 字 节 ， 接 下 来 使 用 命令 fatwrite 将 其 写 入 到 EMMC 的 
分 区 1 中 ， 文 件 名 字 为 zlimage， 命 令 如 下 : 
fatwrite mmc 1:1 80800000 zImage 0x5c2720 
结果 如 图 30.4.6.7 所 示 : 
=> fatwrite mmc 1:1 80800000 zImage 0x5c2720 
writing zImage 
6039328 bytes written 


=> 




















图 30.4.6.7 将 zImage 烧 写 到 EMMC Jgi[X 1 中 
完成 以 后 使 用 “fatls” 命 令 查 看 一 下 EMMC 分 区 1 里 面 的 文件 ， 结 果 如 图 30.4.6.8 所 示 : 
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=> fatls mmc 1:1 


6039328 
37099 


2 file(s), O dir(s) 


zimage 
imx6ull-14x14-evk.dtb 


=> 


图 30.4.6.8 EMMC 分 区 1 


30.4.7EXT 格式 文件 系统 操作 命令 


论坛 :Www.opendev.com 


里 面 的 文件 





uboot 有 ext2 和 ext4 这 两 种 格式 的 文件 系统 的 操作 命令 ， 常 用 的 就 四 个 命令 ,分别 为 : 
ext2load、ext21s、ext4load、ext4ls 和 ext4write。 这 些 命令 的 含义 和 使 用 与 fatload、fatls 和 fatwrit 





一 样 ， 只 是 ext2 和 ext4 都 是 针对 ext 文件 


系统 的 。 比 如 ext4ls 命令 ，EMMC 的 分 区 2 就 是 ext4 


格式 的 ， 使 用 ext4ls 就 可 以 查询 EMMC 的 分 区 2 中 的 文件 和 目录 ， 输 入 命令 : 


ext4ls mmc 1:2 








图 30.4.7.1 ext4ls 命令 





结果 如 图 30.4.7.1 所 示 ; 
=> ext4ls mmc 1:2 
«DIR» 4096 
«DIR» 4096 .. 
«DIR» 16384 lost«found 
«DIR» 4096 photos 

6147 .ash history 
«DIR» 4096 sbin 
«DIR» 4096 tmp 
<DIR> 4096 unit_tests 
<DIR> 4096 lib 
22 test.txt 

<DIR> 4096 opt 
<DIR> 4096 mnt 
<DIR> 4096 dev 
<DIR> 4096 usr 
<DIR> 4096 etc 
<DIR> 4096 .mplayer 
<DIR> 4096 .cache 
<DIR> 4096 picture 
<DIR> 4096 root 
<DIR> 4096 .config 
<DIR> 4096 qt_demo 
<DIR> 4096 media 
<DIR> 4096 drivers 
<DIR> 4096 proc 
<DIR> 4096 sys 
<DIR> 4096 var 
<DIR> 4096 share 
<SYM> 11 linuxrc 
«DIR» 4096 bin 
«DIR» 4096 music 
«DIR» 4096 . local 
«DIR» 4096 £ft € 
«DIR» 4096 include 
«DIR» 4096 mjpg-streamer 
=> 

关于 ext 格式 文件 





系统 其 他 命令 的 操作 参考 30.4.6 小 节 的 即 可 ， 
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30.4.8 NAND 操作 命令 


uboot 是 支持 NAND Flash 的 , 所 以 也 有 NAND Flash 的 操作 命令 , 前 提 是 使 用 的 NAND 版 
本 的 核心 板 , 并 且 编 译 NAND 核心 板 对 应 的 uboot, 然后 使 用 imxdownload 软件 将 u-boot.bin 烧 
写 到 SD 卡 中 ， 最 后 通过 SD 卡 启动 。 一 般 情况 下 NAND 版 本 的 核心 板 已 经 烧 写 好 了 uboot、 
linux kernel 和 rootfs 这 些 文 件 ， 所 以 可 以 将 BOOT 拨 到 NAND， 然 后 直接 从 NAND Flash 启动 
即 可 。 

NAND 版 核心 板 启动 信息 如 图 30.4.8.1 所 示 : 
U-Boot 2016.03 (May 24 2019 - 10:31:09 +0800) 











CPU: Freescale i.MX6ULL revl1.1 528 MHz (running at 396 MHz) 
CPU: Industrial temperature grade (-40C to 105C) at 52C 
Reset cause: POR 

Board: MX6ULL ALIENTEK NAND 

EC: ready 

DRAM: 512 MiB 

NAND: 512 MiB 

MMC: FSL SDHC: 0, FSL SDHC: 1 

*** warning - bad CRC, using default environment 


Display: TFT7016 (1024x600) 
Video: 1024x600x24 


In: serial 
Out: serial 
Err: serial 


Net: FECI 
Error: FEC1 address not set. 


Normal Boot 
Hit any key to stop autoboot: 0 
=> 


30.4.8.1 NAND 核心 板 启动 信息 
从 图 30.4.8.1 可 以 看 出 ， 当 前 开发 板 的 NAND 容量 为 S12MiB 。 输 入 “? nand” 即 可 查看 所 
有 有 关 NAND 令 ， 如 图 30.4.8.2 所 示 : 


-» ? nand 
nand - NAND sub-system 


Usage: 

nand info - show available NAND devices 

nand device [dev] - show or set current device 

nand read - addr off|partition size 

nand write - addr off|partition size 
read/write 'size' bytes starting at offset 'off' 
to/from memory address 'addr', skipping bad blocks. 

nand read.raw - addr off|partition [count] 

nand write.raw - addr off|partition [count] 
Use read.raw/write.raw to avoid ECC and access the flash as-is. 

nand write.trimffs - addr off|partition size 
write 'size' bytes starting at offset 'off' from memory address 
'addr', skipping bad blocks and dropping any pages at the end 
of eraseblocks that contain only OxFF 

nand erase[. spread] [clean] off size - erase 'size' bytes from offset 'off"' 
with .-Spread' , erase enough for given file size, otherwise, 
'size' includes skipped bad blocks. 

nand erase.part [clean] partition - erase entire mtd partition" 

nand erase.chip [clean] - erase entire chip' 

nand bad - show bad blocks 

nand dump[.oob] off - dump page 

nand scrub [-y] off size | scrub.part partition | scrub.chip 
really clean NAND erasing bad blocks (UNSAFE) 

nand rk off [...] - mark bad block(s) at offset (UNSAFE) 

nand biterr off - make a bit error at offset (UNSAFE) 

=> 


30.4.8.2 NAND 相关 操作 命令 
可 以 看 出 ，NAND 相关 的 操作 命令 少 ， 本 节 我 们 讲解 一 些 常用 的 命令 。 


1、nand info 命令 
上 命令 用 户 打 印 NAND Flash 信息 ， 输 入 “nand info", 结果 如 图 30.4.8.3 所 示 : 
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=> nand info 


Device 0: nand0, sector size 128 KiB 
Page size 2048 b 


OOB size 128 b 
Erase size 131072 b 
subpagesize 2048 b 
options 0x40000200 


bbt options Ox 8000 


图 30.4.8.3 nand 信息 


图 30.4.8.3 中 给 出 了 NAND 的 页 大 小 、OOB 域 大 小 , 擦 除 大 小 等 信息 。 可 以 对 照 着 所 使 用 

















的 NAND Flash 数据 手册 来 查看 一 下 这 些 信息 是 否 正确 。 
2、nand device 命令 


nand device 用 于 切换 NAND Flash， 如 果 你 的 板子 支持 多 片 NAND 的 话 就 可 以 使 用 此 命 
来 设置 当前 所 使 用 的 NAND。 这 个 需要 你 的 CPU AWA NAND 控制 器 , 并 且 两 个 NAND 






























































b 














4 





Xm 


器 各 接 一 片 NAND Flash. 就 跟 LMX6U 有 两 个 SDIO 接口 , 这 两 个 SDIO 接口 可 以 接 两 个 MMC 














设备 一 样 。 不 过 一 般 情 况 下 CPU 只 有 一 个 NAND 接口 ， 而 且 在 使 用 中 只 接 一 片 NAND。 
3. nand erase 命令 




















nand erase 命令 用 于 擦 除 NAND Flash, NAND Flash 的 特性 决定 了 在 向 NAND Flash 写 数据 

















之 前 一 定 要 先 对 要 写 入 的 区 域 进行 擦 除 。“nand erase ”命令 有 三 种 形式 : 











nand erase[.spread] [clean] off size /从 指定 地 址 开始 (o 提 开始 ， 的 除 指定 大 小 (size) 的 区 域 。 
nand erase.part [clean] partition ”// 擦 除 指定 的 分 区 

nand erase.chip [clean] /全 篇 探 除 

NAND 的 探 除 命令 一 般 是 配合 写 命令 的 ， 后 面 讲解 NAND 令 的 时 候 在 演示 如 何 使 用 








“nand erase”。 


4, nand write 命令 

















此 命令 用 于 向 NAND 指定 地 址 写 入 指定 的 数据 , 一 般 和 “nand erase” 命 令 配 置 使 用 来 更 新 





NAND 中 的 uboot、linux kernel 或 设备 树 等 文件 ， 命 令 格 式 如 下 : 
nand write addr off size 


addr 是 要 写 入 的 数据 首 地 址 ，off 是 NAND 中 的 目的 地 址 ，size 是 要 写 入 的 数据 大 小 。 
























































以 更 新 NAND 中 的 uboot 为 例 ， 讲 解 一 下 如 何 使 用 此 命令 。 先 编译 出 来 NAND 版 本 的 u- 
boot.imx 文件 ， 在 烧 写 之 前 要 先 对 NAND 进行 分 区 ， 也 就 是 规划 好 uboot、linux kernel、 设 备 树 











和 根 文件 系统 的 存储 区 域 ，LMX6U-ALPHA 开发 板 的 NAND 分 区 如 下 : 
0x000000000000-0x000004000000 : "boot" 
0x000004000000-0x000006000000 : "kernel" 
0x000006000000-0x000007000000 : "dtb" 
0x000007000000-0x000020000000 : "rootfs" 
一 共有 四 个 分 区 ， 第 一 个 分 区 存放 uboot， 地 址 范围 为 0x0~0x4000000( 共 64MB); 第 二 人 





























分 区 存放 kerel( 也 就 是 linux kernel))， 地 址 范围 为 0x4000000~0x6000000( 共 32MB); 第 三 个 分 
区 存放 dtb( 设 备 树 ), 地 址 范围 为 0x6000000~0x7000000( 共 16MB); 剩 下 的 所 有 存储 空间 全 部 作 




















为 最 后 一 个 分 区 ， 存 放 rootfs( 根 文件 系统 )。 








uboot 是 从 地 址 0 开始 存放 的 , 其 实用 不 了 这 么 大 的 区 域 , 但 是 为 了 好 管理 才 分 配 了 这 么 大 














HJ, 将 NAND 版 本 的 u-boot.imx 文件 放 到 Ubuntu 中 的 tftpboot 目录 中 ,然后 使 用 tftp 命令 将 其 
下 载 到 开发 板 的 0X87800000 地 址 处 , 最 终 使 用 “nand write” 将 其 烧 写 到 NAND F, 命令 如 下 : 
tftp 0x87800000 u-boot.imx /下 载 u-boot.imx 到 DRAM 中 
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nand erase 0x0 0x100000 /从 地 址 0 开始 擦 除 1MB 的 空间 
nand write 0x87800000 0x0 0x100000 /将 接收 到 的 u-boot.imx 写 到 NAND 中 








u-bootimx 很 小 ， 一 般 就 是 4,5 百 KB， 所 以 擦 除 IMB 的 空间 就 可 以 了 。 写 入 的 时 候 也 是 
按照 1M 的 数据 写 入 的 ， 所 以 肯定 会 写 入 一 些 无 效 的 数据 。 你 也 可 以 将 写 入 的 大 小 改 为 u- 
boot.imx 这 个 文件 的 大 小 ， 这 样 写 入 的 数据 量 就 是 u-boot.imx 的 实际 大 小 了 。 

同 理 我 们 也 可 以 更 新 NAND 中 的 linux kernel 和 设备 树 (dtb) 文 件 ， 命 令 如 下 : 

tftp 0x87800000 zImage /下 载 zImage 到 DRAM 中 

nand erase 0x4000000 0xA00000 /从 地 址 0x4000000 开始 探 除 10MB 的 空间 

nand write 0x87800000 0x4000000 0xA00000 /将 接收 到 的 zImage 写 到 NAND 中 

这 里 我 们 擦 出 了 10MB 的 空间 ， 因 为 一 般 zImage 就 是 6,7MB 左右 ，10MB 肯定 够 了 ， 如 
果 不 够 的 话 就 将 在 多 擦 除 一 点 就 行 了 。 

最 后 烧 写 设备 树 (dtb) 文 件 文件 ， 命 令 如 下 : 

tftp 0x87800000 imx6ull-alientek-nand.dtb /下 载 dtb 到 DRAM 中 

nand erase 0x6000000 0x100000 /从 地 址 0x6000000 开始 探 除 1MB 的 空间 

nand write 0x87800000 0x6000000 0x100000 /将 接收 到 的 dtb 写 到 NAND 中 

dtb 文件 一 般 只 有 几 十 KB， 所 以 擦 除 1M 是 绰绰有余 的 了 。 

根 文 件 系 统 (rootfs) 就 不 要 在 uboot 中 更 新 了 , 还 是 使 用 NXP 提供 的 MFGTool 工具 来 烧 写 ， 
因为 根 文件 系统 太 大 ! 很 有 可 能 超过 开发 板 DRAM 的 大 小 , 这样 连 下 载 都 没 法 下 载 ， 更 别 说 更 
新 了 。 

4, nand read 命令 


此 命令 用 于 从 NAND 中 的 指定 地 址 读 取 指 定 大 小 的 数据 到 DRAM 中 ， 命 令 格式 如 下 : 
nand read addr off size 
addr 是 目的 地 址 ，off 是 要 读 取 的 NAND 中 的 数据 源 地 址 ，size 是 要 读 取 的 数据 大 小 。 比 
如 我 们 读 取 设备 树 (dtb) 文 件 到 0x83000000 地 址 处 ， 命 令 如 下 : 
nand read 0x83000000 0x6000000 0x19000 
过 程 如 图 30.4.8.4 所 示 : 
=> nand read 0x83000000 0x6000000 0x19000 



















































































NAND read: device 0 offset 0x6000000, size 0x19000 
102400 bytes read: OK 
=> 
图 30.4.8.4 nand read 读 取 过 程 
设备 树 文件 读 取 到 DRAM 中 以 后 就 可 以 使 用 fdt 命令 来 对 设备 树 进 行 操作 了 , 首先 设置 fdt 
的 地 址 ，fdt 地 址 就 是 DRAM 中 设备 树 的 首 地 址 ， 命 令 如 下 : 






































fdt addr 83000000 
设置 好 以 后 可 以 使 用 “fdt header” 来 查看 设备 树 的 头 信息 ， 输 入 命令 : 
fdt header 





结果 如 图 30.4.8.5 所 示 : 
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|» fdt header 

[magic: OxdOOdfeed 
totalsize: 0x9435 (37941) 
|off dt struct: 0x38 

off dt strings: 0x89f4 
loff_mem_rsvmap : 0x28 

|version: 17 

last comp. version: 16 

|boot. cpuid phys: 0x0 
size_dt_strings: 0xa41 

[size dt struct: Ox89bc 

number mem rsv: 0x0 

=> 


图 30.4.8.5 设备 树 头 信息 
输入 命令 “fdt print” 就 可 以 查看 设备 树 文件 的 内 容 ， 输 入 命令 : 
fdt print 
结果 如 图 30.4.8.6 所 示 : 
"2 d print 


faddress-cells = «0x00000001»; 
$size-cells = «0x00000001»; 
model - "Freescale i.MX6 UltraLite 14x14 EVK Board"; 
compatible = "fsl,imx6ul-14xl4-evk", "fsl,imx6ul"; 
chosen { 
stdout-path = "/soc/aips-bus(02000000/spba-bus&02000000/ser1ia1802020000" ; 


aliases { 
can0 "/soc/aips-bus02000000/can(02090000" ; 
canl - "/soc/aips-bus(02000000/can02094000" ; 
ethernet0 = "/soc/aips-bus(02100000/ethernet(02188000" ; 
ethernetl = "/soc/aips-bus(02000000/ethernet&à020b4000" ; 


gpio0 = M soc/aips- bus(02000000/gp1080209c000" ; 

gpiol = "/soc/aips-bus02000000/gpio8020a0000" ; 

gpio2 - "/soc/aips-bus$02000000/9pi0o8020a4000" ; 

gpio3 = "/soc/aips-bus02000000/gpi1 0802028000" ; 

gpi = "/soc/aips-bus(02000000/9gpi o8020ac000" ; 

12c0 = "/soc/aips-bus02100000/12c8021a0000" ; 

i2cl = "/soc/aips-bus(02100000/12c021a4000"; 

i2c2 = "/soc/aips-bus(02100000/12c8021a8000" ; 

i2c3 = "/soc/aips-bus(02100000/12c0021f8000"; 

mmcO = "/soc/aips-bus$02100000/us dhcà02190000" ; 

mmcl = "/soc/aips-busà02100000/us dhc802194000" ; 

serial0 = "/soc/aips-bus&02000000/spba- -busQ02000000/ser1a1802020000"; 
seriall = "/soc/aips-busà02100000/seria18021e8000"; 

serial2 = "/soc/aips-bus@02100000/serial@02lec000": 

serial3 = "/soc/aips-bus@02100000/serial@021f0000"; 

serial4 = "/soc/aips-bus@02100000/serial@021f4000"; 

serial5 = "/soc/aips-bus@02100000/serial@021fc000"; 

serial6 = "/soc/aips-bus@02000000/spba-bus@02000000/serial@02018000"; 


serial7 = "/soc/aips-bus@02000000/spba- -bus@02000000/seria1@02024000": 
spi0 = "/soc/aips-bus02000000/spba- bus@02000000/ecspi@02008000"; 
spil = "/soc/aips-bus@02000000/spba-bus@02000000/ecspi@0200c000"; 


30.4.8.6 设备 树 文件 
30.4.8.6 中 的 文件 就 是 我 们 写 到 NAND 中 的 设备 树 文件 ， 至 于 设备 树 文件 的 详细 内 容 我 
们 后 面 会 有 专门 的 章节 来 讲解 ， 这 里 大 家 知道 这 个 文件 就 行 了 。 
NAND 常用 的 操作 命令 就 是 擦 除 、 读 和 写 ， 至 于 其 他 的 命令 大 家 可 以 自行 研究 一 下 ， 一定 
不 要 尝试 全 片 擦 除 NAND 的 指令 !! 否则 NAND 就 被 全 部 擦 除 掉 了 ， 什么 都 没有 了 ， 又 得 重头 
烧 整 个 系统 。 











30.4.9 BOOT 操作 命令 

uboot 的 本 质 工作 是 引导 Linux, PALA uboot 肯定 有 相关 的 boot( 引 导 ) 命 令 来 启动 Linux。 常 
用 的 跟 boot 有 关 的 命令 有 : bootz、bootm 和 boot。 

1、bootz 命令 


要 启动 Linux， 需 要 先 将 Linux 镜像 文件 拷贝 到 DRAM 中 ， 如 果 使 用 到 设备 树 的 话 也 需 
将 设备 树 拷贝 到 DRAM F. 可 以 从 EMMC 或 者 NAND 等 存储 设备 中 将 Linux 镜像 和 设备 树 文 
拷贝 到 DRAM， 也 可 以 通过 nfs 或 者 tftp 将 Linux 镜像 文件 和 设备 树 文件 下 载 到 DRAM 中 。 











HE 
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不 管用 那 种 方法 ， 只 要 能 将 Linux 镜像 和 设备 树 文件 存 到 DRAM 中 就 行 ， 然 后 使 用 bootz 命令 
来 启动 ，bootz 命令 用 于 自动 zImage 镜像 文件 ，bootz 命令 格式 如 下 : 

bootz [addr [initrd[:size]] [fdt]] 

命令 bootz 有 三 个 参数 ，addr 是 Linux 镜像 文件 在 DRAM 中 的 位 置 ，initrd Æ initrd 文件 在 
DRAM 中 的 地 址 ， 如 果 不 使 用 initrd 的 话 使 用 “-” 代 替 即 可 ，fadt 就 是 设备 树 文件 在 DRAM 中 
的 地 址 。 现 在 我 们 使 用 网 络 和 EMMC 两 种 方法 来 启动 Linux 系统 ， 首 先 将 LMX6U-ALPHA FF 
发 板 的 Linux 镜像 和 设备 树 到 发 送 到 Ubuntu 主机 中 的 tftpboot LIFR Fo Linux 镜像 文件 前 面 
已 经 放 到 了 tftpboot 文件 夹 中 ， 现 在 把 设备 树 文件 放 到 tftpboot 文件 夹 里 面 。 以 EMMC 核心 板 
为 例 ， 将 开发 板 光盘 ->8、 开 发 板 系 统 镜像 ->imx6ull-alientek-emmec.dtb 文件 发 送 到 Ubuntu 主机 
中 的 tftpboot 文件 夹 里 面 ， 完 成 以 后 的 tftpboot 文件 夹 如 图 30.4.9.1 所 示 : 




































































lo IUE 








图 30.4.9.1 tftpboot 文件 夹 

下 载 Linux 镜像 文件 和 设备 树 都 准备 好 了 ， 我 们 先 学 习 如 何 通过 网 络 启动 Linux， 使 用 tftp 
命令 将 zImage 下 载 到 DRAM 的 0X80800000 地 址 处 ， 然 后 将 设备 树 imx6ull-alientek-emmc.dtb 
下 载 到 DRAM 中 的 0X83000000 地 址 处 ， 最 后 之 后 命令 bootz 启动 ， 命 令 如 下 : 

tftp 80800000 zImage 

tftp 83000000 imx6ull-alientek-emmc.dtb 

booke 80800000 - 83000000 

命令 运行 结果 如 图 30.4.9.2 所 示 : 


| 80800000 g 

oetra Tey 、 下 载 zlImage 

TFTP from server 192. 168.1.250; our IP address is m 168. 1.50 

Filename 'zimage 

Load address: 0x80800000 

Loading: BESEESSESESESESEEESESEEELEUESEEESEUEEEEEEEEEESEEEUEESEEESEUSEEEUEUE 
PHEREEREAEREREREAEREREREREREREREREREAERERERE HE REREREAEREREREEEREREREREREREREREEEAEREREEAEREREREEREREREE EIER ERE 
PESESSSEESSEESESESESESEEHSESESEAEHSTEEHESSESESESESHESEEHSEEEHSEESESE NN 
PEEREREREHEREEREAEREREREREREREREEREAEREIEREAEHEREREAEREREREEAEREREREREAEREREEREAEREEEREAEREREREAEREREREEREAEREERE AERE RE RE 
GHRHEEHEEHEREEEHIERERERE IEEE REEE IEEE IEEE EE EE EE EEEEEEEE EE EE EE EHE EE EE E 
PREREREREREREREREAEREREREREREREREEREAEREREREAEIEREREEREREREEEAEREREREEAEREREEREAEREREREAEREREREEAEIEREEEAEREREEAERE RE RE 
HEIIEIEIEREEIHHIEIHHHEIIEIIERE RE RE 
































tp 8300 mxóu t tb qe 
sing device 下 载 设备 树 imx6ul- -alientek-emmc.dtb 
TFTP from server 192.168.1.250; o6 IP address is 192. 2ted 
t 


Filename 'imx6ull-alientek-emmc. 
Load address: 0x83000000 
## 


Loading: 
1.6 MiB/s 
ann 
IES borz. -50800000 = - -23000000 3、 使 用 命令 “bootz” 启 动 linux 


00 Ox000000 - 0x5c2/20 ] 
^ Flattened Device "Tree blob at 83000000 
Booting using the fdt blob at 0x83000000 
Using Device Tree in place at 83000000, end 8300cid2 : 
Modify /soc/aips-bus&02100000/sim&0218c000:status disabled 4、Linux 启 动 信息 
ft system setup for mx 


Starting kernel ... 


Booting Linux on LS ical CPU 0x0 

Linux version 4.1.15 (zuozhongkaiGubuntu) (gcc version 4.9.4 (Linaro GCC 4.9-2017.01) ) #9 SMP PREEMPT Fri Apr 19 17:15:22 CST 2019 
CPU: ARMv7 Processor [410fc075] revision 5 (ARMv7), cr-10c5387d 

CPU: PIPT / VIPT nonaliasing data cache, VIPT aliasing instruction cache 

Machine model: Freescale i.MX6 UltraLite 14x14 EVK Board 

Reserved memory: created CMA menory. pool at 0x8c000000, size 320 M 

Reserved memory: initialized node jnux, cma, compatible id shared- des pool 

Memory policy: Data cache writeallo 

PERCPU: Embedded 12 pages/cpu G8bb31000 517280 r8192 d23680 u49152 

Built 1 zonelists in zone order, mobility grouping on. Total pages: 130048 








图 30.4.9.2. 通过 网 络 启动 Linux 

上 图 就 是 我 们 通过 tftp 和 bootz 命令 来 从 网 络 启动 Linux 系统 ， 如 果 我 们 要 从 EMMC 中 局 
动 Linux 系统 的 话 只 需要 使 用 命令 fatload 将 zImage 和 imx6ull-alientek-emmc.dtb 从 EMMC 的 
分 区 1 中 拷贝 到 DRAM 中 ， 然 后 使 用 命令 bootz 启动 即 可 。 先 使 用 命令 fatls 查看 要 下 EMMC 
的 分 区 1 中 有 没有 Linux 镜像 文件 和 设备 树 文件 , 如果 没有 的 话 参考 30.4.6 小 节 中 讲解 的 fatwrite 
命令 将 tftpboot 中 的 zImage 和 imx6ull-alientek-emmc.dtb 文件 烧 写 到 EMMC 的 分 区 1 中 。 然 后 
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使 用 命令 fatload 将 zImage 和 imx6ull-alientek-emmc.dtb 文件 拷贝 到 DRAM 中 ， 地 址 分 别 为 
0X80800000 和 0X83000000， 最 后 使 用 bootz 启动 ， 命 令 如 下 : 

fatload mmc 1:1 80800000 zImage 

fatload mmc 1:1 83000000 imx6ull-alientek-emmc.dtb 

poole OS 83000000 

命令 运行 结果 如 zl 30.4.9.3 所 示 : 
1、 读 取 zlmage 





















ETT reU TI-A- emne. ATD 2、 读 取 imx6ull-alientek-emmc.dtb 
=> bootz 80800000 - 83000000 i 
» Flattened Device Tree blob at 83000000 
Booting using the fdt blob at 0x83000000 
Using Device Tree in place at 83000000, end 8300cid2 


Modify /soc/aips-bus&02100000/ /sim&0218c000:status disabled 4、Linux 启 动 信息 
ft _system_setup for mx6 


3、 使 用 bootz 启 动 


Starting kernel ... 


Booting Linux on physical cPU OxO 
Linux version 4.1.15 esed pier la (gcc version 4.9.4 ad GCC 4.9-2017.01) ) #9 SMP PREEMPT Fri Apr 19 17:15:22 CST 2019 


CPU: ARMv7 Processor [410fc075] revision 5 (ARMv7), cr-10c5387d 
CPU: PIPT / VIPT nonaliasing data cache, VIPT aliasing instruction cache 
Machine model: Freescale i.MX6 UltraLite 14x14 EVK Board 
Reserved wemOry: created .CMA memory pool at 0x8c000000, size 320 Wis 
H DUX e Da ü- dz. 











图 30.4.6.3 EMMC 中 启动 Linux 





2、bootm 命令 


bootm 和 bootz 功能 类 似 ， 但 是 bootm 用 于 启动 uImage 镜像 文件 。 如 果 不 使 用 设备 树 的 话 
启动 Linux 内 核 的 命令 如 下 : 

bootm addr 

addr 是 ulmage 镜像 在 DRAM 中 的 首 地 址 。 

如 果 要 使 用 设备 树 ， 那 么 boom 命令 和 bootz 一 样 ， 命 令 格式 如 下 : 

bootm [addr [initrd[:size]] [fdt]] 

其 中 addr 是 uImage 在 DRAM 中 的 首 地 址 ，initrd 是 initrd 的 地 址 ，fdt 是 设备 树 (.dtb) 文 件 
在 DRAM 中 的 首 地 址 ， 如 果 initrd 为 空 的 话 ， 同 样 是 用 “-” 来 蔡 代 。 


3. boot 命令 


boot 命令 也 是 用 来 启动 Linux. 系统 的 ， 只 是 boot 会 读 取 环 境 变量 bootemd 来 启动 Linux 系 
统 ，bootcmd 是 一 个 很 重要 的 环境 变量 ! 其 名 字 分 为 “boot” 和 “cmd”， 也 就 是 “引导 ”和 “ 命 
令 ” 说 明 这 个 环境 变量 保存 着 引导 命令 , 其 实 就 是 启动 的 命令 集合 , 具体 的 引导 命令 内 容 是 可 
以 修改 的 。 比 如 我 们 要 想 使 用 tftp 命令 从 网 络 启动 Linux 那么 就 可 以 设置 bootcmd 为 “tftp 
80800000 zImage; tftp 83000000 imx6ull-alientek-emmc.dtb; bootz 80800000 - 83000000”, 然后 使 
用 saveenv 将 bootemd 保存 起 来 。 然 后 直接 输入 boot 命令 即 可 从 网 络 启动 Linux 系统 ， 命 令 如 
F: 

setenv bootcmd 'tftp 80800000 zImage; tftp 83000000 imx6ull-alientek-emmc.dtb; bootz 
80800000 - 83000000' 

saveenv 

boot 

运行 结果 如 图 30.4.6.4 所 示 : 
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=> Setenv b 
-» Saveenv 


1、 设 置 环境 变量 bootcmd 并 保存 


TFTP from, server ,1 ,192.168.1.250; our IP address is 192.168.1.50 tz i 
| roger 3、 运 行 bootcmd 中 的 启动 命令 启动 Linux 


Loading: “玉林 
BEREEEEHEREEEEEERENEEEEEEEEREEEEEEEEEEEEEEEEEWEEREEEEERENEREWEPENHP 
BEMEUPEEEEEEEEEEEEEEEEEUEEEEEEEEEEEEEEEEEEEEEEEEERUNEOEEEEENEEEEEE 
BEBEEEEEEEEEEEEEEHEEEEREEEEEEEEEEEEEEEEEEEEEEEEREEEEREREEENEEEEHE 
Dodd dd dd dd dd dd dd ddd ddd dd 
BEBEEEEBEEEBEEEEEHEEEEEEEEEEEEEEEEEEEEEEEEEEEEEREEEEREPEEEHEEEEHM 
SEREEREREEREREEEEHPÓMM 
2.1 MiB/s 

done 

Bytes transferred = 6039328 (5c2720 hex) 

Using FEC1 device 

TFTP from server 192.168.1.250; our IP address is 192.168.1.50 

Filename 'imx6ull-alientek-emmc.dtb'. 

Load address: 0x83000000 

Loading: $44 
2.4 MiB/s 

done 

Bytes transferred - 37331 go hex) 

Kernel image @ 0x80800000 [ 0x000000 - 0x5c2720 ] 

$9 Flattened Device Tree blob at 83000000 

Booting using the fdt blob at 0x83000000 
Using Device Tree in place at 83000000, end 8300cid2 

Modify /soc/aips-bus&02100000/ /sim&0218c000:status disabled 

ft system setup for mx6 


Starting kernel ... 


Booting Linux on physical CPU OxO 

Linux version 4.1.1 quon a VNDE) (gcc version 4.9.4 (Linaro GCC 4.9-2017.01) ) 49 SMP PREEMPT Fri Apr 19 17:15:22 CST 2019 
CPU: ARMV7 Processor [410fc075] revision 5 (ARMv7), cr-10c5387d 

CPU: PIPT / VIPT nonaliasing data cache, VIPT aliasing instruction cache 

Machine model: Freescale i.MX6 UltraLite 14x14 EVK Board 

Reserved memory: created CMA — pool at Ox8c000000, size 320 M 

Reserved memory: initialized node linux,cma, compatible id uu i-r] 





图 30.4.6.4. 设置 bootemd 从 网 络 启动 Linux 
前 面 说 过 uboot 倒计时 结束 以 后 就 会 启动 Linux 系统 ， 其 实 就 是 执行 的 bootemd 中 的 启 

命令 。 只 要 不 修改 bootemd 中 的 内 容 ， 以 后 每 次 开机 uboot 倒计时 结束 以 后 都 会 使 用 tftp 命 
从 网 络 下 载 zImage 和 imx6ull-alientek-emmc.dtb， 然 后 启动 Linux» 

如 果 想 从 EMMC 启动 那 就 设置 bootcmd 为 “fatload mmc 1:1 80800000 zImage; fatload mmc 
1:1 83000000 imx6ull-alientek emmc.dtb; bootz 80800000 - 83000000”, 然后 使 用 boot 命令 启动 即 
可 ， 命 令 如 下 : 

setenv bootcmd 'fatload mmc 1:1 80800000 zImage; fatload mmc 1:1 83000000 imx6ull- 
alientek emmc.dtb; bootz 80800000 - 83000000' 

savenev 

boot 

ctus 30.4.6.5 所 示 : 























P 
2、 启 动 Linux 1、 设 置 环境 便 令 bootcmd 并 保存 


cang imx6ull-alientek emmc.dtb 
** unable to read file imx6ull-alientek emmc.dtb ** 
Kernel image @ 0x80800000 f 0x000000 - 0x5c2720 ] 
## Flattened Device Tree blob at 83000000 
Boang using the fdt blob at 0x83000000 
reserving fdt memory region: addr=83000000 size=a000 
usi Device Tree in place at 83000000, end 8300cfff 
modify /soc/aips-bus@02100000/ sime0218c000:status disabled 
ft _system_setup for mx6 


Starting kernel ... 


Booting Linux on physical CPU OxO 


Linux version 4.1.15 th (gcc version 4.9.4 (Linaro GCC 4.9-2017.01) ) #9 SMP PREEMPT Fri Apr 19 17:15:22 CST 2019 
CPU: ARMv7 Processor [410fc075] revision 5 (ARMv7), cr-10c5387d 

CPU: PIPT / VIPT nonaliasing data cache, VIPT aliasing instruction cache 

Machine model: Freescale i.MX6 UltraLite 14x14 EVK Board 


30.4.6.5 设置 bootcmd 从 EMMC 启动 Linux 
如 果 不 修改 bootcmd 的 话 ， 每 次 开机 uboot 倒计时 结束 以 后 都 会 自动 从 EMMC 里 面 读 取 
zImage 和 imx6ull-alientek-emmc.dtb， 然 后 启动 Linux. 











30.4.10 其 他 常用 命令 


uboot 中 还 有 其 他 一 些 常用 的 命令 ， 比 如 reset、go、run 和 mtest 等 。 
1、reset 命令 
reset 命令 顾名思义 就 是 复位 的 ， 输 入 “reset” 即 可 复位 重启 ， 如 图 30.4.10.1 所 示 : 
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[resetting n 
tt ee. 
" resetting 2. 重启 后 的 uboot 


U-Boot 2016.03 (Apr 21 2019 - 22:17:44 +0800) 


CPU: Freescale i.MX6ULL revi.1 528 MHz (running at 396 MHz) 
CPU: Industrial temperature grade (-40C to 105C) at 57C 
Reset cause: WDOG 
Board: MX6UL 14x14 EVK 
I2C: ready 
DRAM: 512 MiB 
MMC : FSL SDHC: 0, FSL. SDHC: 1 
Display: TFT7016 (1024x600) 
Video: 1024x600x24 
serial 
serial 
serial 
switch to partitions #0, OK 
mmcl(part 0) is current device 
Net: FEC1 
Normal Boot 
Hit any key to stop autoboot: 
=> 





30.4.10.1 reset 命令 运行 结果 


2. go 命令 
go 命令 用 于 跳 到 指定 的 地 址 处 执行 应 用 ， 命 令 格式 如 下 : 
go addr [arg ...] 


addr 是 应 用 在 DRAM 中 的 首 地 址 , 我 们 可 以 编译 一 下 裸 机 例 程 的 实验 13_printf, 然后 将 编 
译 出 来 的 printf.bin $5 U1 8] Ubuntu 中 的 tftpboot 文件 夹 里 面 , 注意 , 这 里 要 拷贝 printfbin 文件 ， 
不 需要 在 前 面 添加 IVT 信息 ， 因 为 uboot 已 经 初始 化 好 了 DDR 了。 使 用 tftp 命令 将 printfbin 
下 载 到 开发 板 DRAM 的 0X87800000 地 址 处 ， 因 为 裸 机 例 程 的 链接 首 地 址 就 是 0X87800000, 
最 后 使 用 go 命令 启动 printf.bin 这 个 应 用 ， 命 令 如 下 : 

tftp 87800000 printf.bin 

go 87800000 
结果 如 图 30.4.10.2 所 示 : 


=> tftp a print 
[Using FECI devic 1. 下 载 printf.bin 
TFTP from server *192. 168.1.250; our IP address is 192.168.1.50 
Filename 'printf.bin'. 
Load address: 0x87 800000 
Loading: # 

225.6 KiB/s 


= 11585 (2d41 hex) e" 
2、 运 行 mmm" i. printf.bin 


正常 运行 























































done 
Bytes transferred 





MARTER, 6 位 用 空格 隔 开 : 54 6 
数据 54 + 6 = 





30.4.10.2 go 命令 运行 裸 机 例 程 
从 图 30.4.10.2 可 以 看 出 ， 通 过 go 命令 我 们 就 可 以 在 uboot 中 运行 裸 机 例 程 。 
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3. run 命令 


























run 命令 用 于 运行 环境 变量 中 定义 的 命令 ， 比 如 可 以 通过 “runbootcmd” 来 运行 bootcmd 中 
的 启动 命令 ， 但 是 run 命令 最 大 的 作用 在 于 运行 我 们 自 定义 的 环境 变量 。 在 后 面 调试 Linux 系 
统 的 时 候 常常 要 在 网 络 启动 和 EMMC/NAND 启动 之 间 来 回 切 换 ， 而 bootcmd 只 能 保存 一 种 启 
动 方式 ， 如 果 要 换 另 外 一 种 启动 方式 的 话 就 得 重 写 bootcmd， 会 很 麻烦 。 这 里 我 们 就 可 以 通过 
自 定义 环境 变量 来 实现 不 同 的 启动 方式 ， 比 如 定义 环境 变量 mybootemmc 表示 从 emme 启动 ， 
定义 mybootnet 表示 从 网 络 启动 ， 定 义 mybootnand 表示 从 NAND 启动 。 如 果 要 切换 启动 方式 
的 话 只 需要 运行 “run mybootxxx(xxx 7j emme, net 或 nand)” 即 可 。 

说 干 就 干 ， 创 建 环境 变量 mybootemmc、mybootnet 和 mybootnand， 命 令 如 下 : 

setenv mybootemmc 'fatload mmc 1:1 80800000 zImage; fatload mmc 1:1 83000000 imx6ull- 
alientek-emmc.dtb;bootz 80800000 - 83000000' 

setenv mybootnand 'nand read 80800000 4000000 800000;nand read 83000000 6000000 
100000;bootz 80800000 - 83000000' 

setenv mybootnet 'tftp 80800000 zlmage; tftp 83000000 imxóull-alientek-emmc.dtb; bootz 
80800000 - 83000000' 

saveenv 

创建 环境 变量 成 功 以 后 就 可 以 使 用 run 命令 来 运行 mybootemmc、mybootnet 或 mybootnand 
来 实现 不 同 的 启动 : 

run mybootemmc 

或 

run mytoobnand 

或 

run mybootnet 

4、mtest 命令 

metest 命令 是 一 个 简单 的 内 存 读 写 测试 命令 ， 可 以 用 来 测试 自己 开发 板 上 的 DDR， 命 令 格 
式 如 下 : 

mtest [start [end [pattern [iterations]]]] 

start 是 要 测试 的 DRAM 开始 地 址 ,end 是 结束 地 址 , 比如 我 们 测试 0X80000000~0X80001000 
这 段 内 存 ， 输 入 “mtest 80000000 80001000” 结果 如 图 30.4.10.3 所 示 : 


=> mtest 80000000 80001000 
Testing 80000000 ... 80001000: 
Pattern FFFFFFFF Writing... ading...Iteration: 486 
































































































































图 30.4.10.3 mtest 命令 运行 结果 
从 图 30.4.10.3 可 以 看 出 , 测试 范围 为 0X80000000~0X80001000,， 已 经 测试 了 486 次 ， 如 果 
要 结束 测试 就 按 下 键盘 上 的 “Ctrl+C” 键 。 
至 此 ，uboot 常用 的 命令 就 讲解 完了 ， 如 果 要 使 用 uboot 的 其 他 命令 ， 可 以 查看 uboot 中 的 
帮助 信息 ， 或 者 上 网 查询 一 下 相应 的 资料 。 
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第 三 十 一 章 U-Boot 顶层 Makefile 详解 


上 一 章 我 们 详细 的 讲解 了 uboot 的 使 用 方法 ， 其 实 就 是 各 种 命令 的 使 用 ， 学 会 uboot 使 用 




















以 后 就 可 以 尝试 移植 uboot 到 自己 的 开发 板 上 了 ,但 是 在 移植 之 前 需要 我 得 先 分 析 一 边 uboot 的 
启动 流程 源码 ， 得 择 一 下 uboot 的 启动 流程 ， 否 则 移植 的 时 候 都 不 知道 该 修改 那些 文件 。 本 章 
我 们 就 来 分 析 一 下 正点 原子 提供 的 uboot 源码 ， 重 点 是 分 析 uboot 启动 流程 ， 而 不 是 整个 uboot 
源码 ，uboot 整个 源码 非常 大 ， 我 们 只 看 跟 我 们 关心 的 部 分 即 可 。 
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31.1 U-Boot 工程 目录 分 析 


本 书 我 们 以 EMMC 版 本 的 核心 板 为 例 讲解 ， 为 了 方便 ，uboot 启动 源码 分 析 就 在 Windows 
下 进行 ， 将 正点 原子 提供 的 uboot 源码 进行 解压 ， 解 压 完成 以 后 的 目录 如 图 31.1.1 所 示 : 












































| api .] Jitignore 

T arch | .mailmap 

T board | config.mk 

T cmd | Kbuild 

T common  [) Kconfig 

T configs | ] MAINTAINERS 
7 disk MAKEALL 

- doc | Makefile 

| drivers | README 

- dts | snapshot.commit 
| examples 

T fs 

T include 

| lib 

| Licenses 

T net 

T post 

| scripts 

T test 

T tools 


图 31.1.1. 未 编译 的 uboot 
31.1.1 是 正点 原子 提供 的 未 编译 的 uboot 源码 目录 ， 我 们 在 分 析 uboot 源码 之 前 一 定 要 
先 在 Ubuntu 中 编译 一 下 uboot 源码 ， 因 为 编译 过 程 会 生成 一 些 文件 ， 而 生成 的 这 些 恰恰 是 分 析 
uboot 源码 不 可 或 缺 的 文件 。 使 用 上 一 章 创建 的 shell 脚本 来 完成 编译 工作 ， 命 令 如 下 : 




















cd alientek uboot /进入 正点 原子 uboot 源码 目录 
./mx6ull alientek emmc.sh /编译 uboot 
cd ../ /返回 上 一 级 目录 





tar -vcjfalientek uboot.tarbz2 alientek uboot /压缩 
最 终 会 生成 一 个 名 为 alientek uboot.tar.bz2 的 压缩 包 ， 将 alientek uboot.tar.bz2 拷贝 到 windows 
系统 中 并 解压 ， 解 压 后 的 目录 如 图 31.1.2 所 示 : 
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T api |] .config | MAINTAINERS 
- arch | gitignore |] MAKEALL 
| board | .mailmap | Makefile 
- cmd [€] .u-boot.bin.cmd | mx6ull alientek emmc.sh 
- common =Œ] .u-boot.cfg.cmd .| mx6ull alientek nand.sh 
T configs | ] .u-boot.cfg.d |] README 
- disk [€] .u-boot.cmd |] snapshot.commit 
| doc [€] .u-boot.imx.cmd ] System.map 
- drivers [=Œ] .u-boot.Ids.cmd | u-boot 
- dts 图 | .u-boot.srec.cmd | | u-boot.bin 
| examples — [2] u-boot.sym.cmd | | u-boot.cfg 
T fs S|] .u-boot-nodtb.bin.cmc |} u-bootimx 
| include | ] config.mk | u-boot.lds 
| lib | | imxdownload | u-boot.map 
| Licenses ] Kbuild | | u-boot.srec 
| net | ] Kconfig | u-boot.sym 
| post | | load.imx | u-boot-nodtb.bin 
T scripts 
| test 
| tools 


图 31.1.2 编译 后 的 uboot 源码 文件 
对 比 图 31.1.2 和 图 31.1.1， 可 以 看 出 编译 后 的 uboot 要 比 没 编译 之 前 多 了 好 多 文件 ， 这 些 
文件 夹 或 文件 的 含义 见 表 31.1.1 所 示 : 

























































































api 与 硬件 无 关 的 API 函数 。 
arch 与 架构 体系 有 关 的 代码 。 
board 不 同 板子 (开发 板 ) 的 定制 代码 。 
cmd 命令 相关 代码 。 
common 通用 代码 。 
configs 配置 文件 。 
disk 磁盘 分 区 相关 代码 
doc 文档 。 ai 
文件 区 drivers 驱动 代码 。 yo 
dts 设备 树 。 
examples 示例 代码 。 
fs 文件 系统 。 
include 头 文件 。 
lib 库 文件 。 
Licenses 许可 证 相关 文件 。 
net 网 络 相 关 代 码 。 
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post EE BIETE o 
scripts 脚本 文件 。 
test 测试 代码 。 
tools 工具 文件 夹 。 

.config 配置 文件 ， 重 要 的 文件 。 编译 生成 的 文件 
.gitignore git 工具 相关 文件 。 
.mailmap 邮件 列表 。 ioa 

.u-boot.xxx.cmd 这 是 一 系列 的 文件 ， 用 于 保存 着 一 —— 
(一 系列 ) Bd ds. 编译 生成 的 文件 
config.mk 某 个 Makefile 会 调用 此 文件 。 uboot 自 带 

imxdownload 正点 原子 编写 的 SD 卡 烧 写 软件 。 | 正点 原子 提供 

Kbuild 用 于 生成 一 些 和 汇编 有 关 的 文件 。 

Kconfig 图 形 配置 界面 描述 文件 。 
MAINTAINERS 维护 者 联系 方式 文件 。 oe i 
文件 一 个 shell 脚本 文件 ， 帮 助 编译 
MAKEALL 
uboot 的 。 
Makefile 主 Makefile， 重 要 文件 ! 
mx6ull_alientek_emmc.sh | 上 一 章 编写 的 编译 脚本 文件 -一 音 编写 的 
mx6ull alientek nand.sh | 上 一 章 编写 的 编译 脚本 文件 i di 
README 相当 于 帮助 文档 。 m 
uboot 自 带 
snapshot.commint ?22? 
System.map 系统 映射 文件 
u-boot 编译 出 来 的 u-boot 文件 。 、 
u-boot.xxx 生成 的 一 些 u-boot 相关 文件 ， 包 括 0 
(一 系列 ) u-boot.bin、u-boot.imx. 等 
表 31.1.1 uboot 目录 列表 
表 31.1.1 中 的 很 多 文件 夹 和 文件 我 们 都 不 需要 去 关心 ， 我 们 要 关注 的 文件 夹 或 文件 如 下 : 





1. arch 文件 夹 


这 个 文件 夹 里 面 存放 着 和 架构 有 关 的 文件 ， 如 图 31.1.3 所 示 : 

















720 








LMX6U RAR Linux 驱动 开发 指南 贸 正 点 原子 





原子 哥 在 线 教学 : www.yuanzige.com 论坛 :Www.opendev.com 
[d arc 2019-04-22 21:07 ”文件 去 
| | arm 2019-04-22 21:07 ”文件 夫 
|j avr32 2019-04-22 21:07 ”文件 去 
| 1 blackfin 2019-04-22 21:07 ”文件 去 
| | m68k 2019-04-22 21:07 ”文件 去 
| | microblaze 2019-04-22 21:07 ”文件 去 
| | mips 2019-04-22 21:07 ”文件 去 
| | nds32 2019-04-22 21:07 ”文件 夫 
| 1 nios2 2019-04-22 21:07 ”文件 去 
| | openrisc 2019-04-22 21:07 ”文件 去 
| | powerpc 2019-04-22 21:07 ”文件 去 
| | sandbox 2019-04-22 21:07 ”文件 夫 
F sh 2019-04-22 21:07 ”文件 去 
|i sparc 2019-04-22 21:07 ”文件 去 
| | x86 2019-04-22 21:07 ”文件 去 
[] .gitignore 2019-03-26 15:49 ”GITIGNORE 文件 1 KB 
| ] Kconfig 2019-03-26 15:409 ”文件 5 KB 





31.1.3 arch 文件 夹 
从 图 31.1.3 可 以 看 出 有 很 多 架构 ， 比 如 arm、avr32、m68k 等 ， 我 们 现在 用 的 是 ARM w 
片 ， 所 以 只 需要 关心 arm 文件 夹 即 可 ， 打 开 arm 文件 夹 里 面 内容 如 图 31.1.4 所 示 : 








| cpu 2019-04-22 21:07 ”文件 夫 | 
|] dts 2019-04-22 21:07 ”文件 去 
| | imx-common 2019-04-22 21:07 ”文件 去 
| | include 2019-04-22 21:07 ”文件 去 
[i lib 2019-04-22 21:07 ”文件 夫 
| | mach-at91 2019-04-22 21:07 ”文件 去 
| | mach-bcm283x 2019-04-22 21:07 ”文件 去 
|. | mach-davinci 2019-04-22 21:07 ”文件 去 
| | mach-exynos 2019-04-22 21:07 ”文件 去 
|. mach-highbank 2019-04-22 21:07 ”文件 去 
| | mach-integrator 2019-04-22 21:07 ”文件 夫 
|. | mach-keystone 2019-04-22 21:07 ”文件 夫 


31.1.4 arm 文件 夹 
31.1.4 只 截取 了 一 部 分 ， 还 有 一 部 分 mach-xxx 的 文件 夹 。mach 开头 的 文件 夹 是 跟 有 具体 
的 设备 有 关 的 ， 比 如 “mach-exynos” 就 是 跟 三 星 的 exyons 系列 CPU 有 关 的 文件 。 我 们 使 用 的 
是 LIMX6ULL， 所 以 要 关注 “imx-common” 这 个 文件 夹 。 另 外 “cpu” 这 个 文件 夹 也 是 和 cpu 架 
构 有 关 的 ， 打 开 以 后 如 图 31.1.5 所 示 : 
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| | armi 2019-04-22 21:07 ”文件 去 

|. | arm720t 2019-04-22 21:07 ”文件 去 

| | arm920t 2019-04-22 21:07 ”文件 夫 

| | arm926ejs 2019-04-22 21:07 ”文件 去 

| | arm946es 2019-04-22 21:07 ”文件 去 

| | arm1136 2019-04-22 21:07 ”文件 去 

| | arm1176 2019-04-22 21:07 ”文件 去 

| | armv7 2019-04-22 21:07 Již 

armv?m 2019-04-22 21:07 ”文件 夫 

| | armv8 2019-04-22 21:07 ”文件 去 

|] pxa 2019-04-22 21:07 ”文件 去 

|] sa1100 2019-04-22 21:07 ”文件 去 

[5] .built-in.o.cmd 2019-04-22 20:552 Windows 命令 脚本 1KB 
] built-in.o 2019-04-22 20552  O 文件 1KB 
] Makefile 2019-03-26 15:49 ”文件 1 KB 
] u-boot.lds 2019-03-26 15:49  LDS 文件 3 KB 

| ] u-boot-spl.lds 2019-03-26 15:49 LDS 文件 2 KB 











31.1.5 cpu 文件 夹 

从 图 31.1.5 可 以 看 出 有 多 种 ARM 架构 相关 的 文件 来 ，I.MX6ULL 使 用 的 Cortex-A7 内 核 ， 
Cortex-A7 属于 armv7， 所 以 我 们 要 关心 “armv7” 这 个 文件 夹 。cpu 文件 夹 里 面 有 个 名 为 就 “u- 
boot.lds” 的 链接 脚本 文件 ， 这 个 就 是 ARM 芯片 所 使 用 的 u-boot 链接 脚本 文件 ! armv7 这 个 文 
件 夹 里 面 的 文件 都 是 跟 ARMV7 架构 有 关 的 ， 是 我 们 分 析 uboot 启动 源码 的 时 候 需 要 重点 关注 
的 。 

2、board 文件 夹 

board 文件 夹 就 是 和 具体 的 板子 有 关 的 ， 打 开 此 文件 夹 ， 里 面 全 是 不 同 的 板子 ， 毫 无 疑问 ! 
正点 原子 的 开发 板 上 表 定 也 在 里 面 (正点 原子 添加 的 )，borad 文件 夹 里 面 有 个 名 为 “freescale ”的 
文件 来， 如 图 31.1.6 所 示 : 






































|j evb_rk3035 2U19-U4-22 21:U/ MIFE 
[] firefly 2019-04-22 21:07 ”文件 去 
| | freescale 2019-04-22 21:07 Xi 
| | gaisler 2019-04-22 21:07 ”文件 去 
Em . 一 一 = 一 = a 


图 31.1.6 freescale 文件 夹 
所 有 使 用 freescale 芯片 的 板子 都 放 到 此 文件 夹 中 ，LMX 系列 以 前 属于 freescale， 只 是 
freescale 后 来 被 NXP 收购 了 。 打 开 此 freescale 文件 夹 ， 在 里 面 找到 和 mx6u(I.MX6UL/ULL) 有 
关 的 文件 夹 ， 如 图 31.1.7 所 示 : 

















T mx6ul 14x14 ddr3 arm2 2019-09-03 0:17 文件 夹 
mx6ul_ 14x14 evk 2019-09-03 0:17 文件 夹 
mx6ul 14x14 Ipddr2 arm2 2019-09-03 0:17 文件 夹 
mx6ull ddr3 arm2 2019-09-03 0:17 文件 夹 
mx6ullevk 2019-09-03 0:17 文件 夹 


31.1.7 mx6u 相关 板子 
图 31.1.7 中 有 5 个 文件 来 ， 这 5 个 文件 夹 对 应 5 种 板子 ， 以 “mx6ul” 开 头 的 表示 使 用 
LMX6UL 芯片 的 板子 ， 以 mx6ull 开头 的 表示 使 用 LMX6ULL 芯片 的 板子 。mx6ullevk 是 NXP 
官方 的 LMX6ULL 开发 板 ,正点 原子 的 ALPHA 开发 板 就 是 在 这 个 基础 上 开发 的 ,因此 mx6ullevk 
也 是 正点 原子 的 开发 板 。 我 们 后 面 移植 uboot 到 时 候 就 是 参考 的 NXP 官方 的 开发 板 ， 也 就 是 要 
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参考 mx6ullevk 这 个 文件 夹 来 定义 我 们 的 板子 。 
3. configs 文件 夹 


此 文件 夹 为 uboot 配置 文件 ，uboot 是 可 配置 的 ， 但 是 你 要 是 自己 从 头 开始 一 个 一 个 项 目的 
配置 ， 那 就 太 麻 烦 了 ， 因 此 一 般 半 导体 或 者 开发 板 厂 商都 会 制作 好 一 个 配置 文件 。 我 们 可 以 在 





























这 个 做 好 的 配置 文件 基础 上 来 添加 自己 想 要 的 功能 ， 这 些 半导体 厂商 或 者 开发 板 厂 商 制作 好 的 
配置 文件 统一 命名 为 {xxx_defconfig”, xxx n 这 些 defconfig 文件 都 存放 在 configs 
文件 夹 ， 因 此，NXP 官方 开发 板 和 正点 原子 的 开发 板 配 置 文件 肯定 也 在 这 个 文件 夹 中 ， 如 图 
31.1.8 所 示 : 




















mx6ull 14x14 ddr3 arm2 defconfig 2019-08-31 11:46 文件 KB 


mx6ull 14x14 ddr3 arm2 emmc defconfig — 2019-08-31 11:46 文件 KB 
| mx6ull 14x14 ddr3 arm2 epdc defconfig 2019-08-31 11:46 xf# 正 点 原子 ALPHA 开 KB 


| | mx6ull 14x14 ddr3 arm2 nand defconfig 2019-08-31 11:46 文件 发 板 对 应 的 默认 配置 Ke 


_| mxéull 14x14 ddr3 arm2 qspi1 defconfig 2019-08-31 11:46 文件 KB 
|. | mx6ull 14x14 ddr3 arm2 spinor defconfig 2019-08-31 11:46 xf 文件 KB 
|. | mx6ull 14x14 ddr3 arm2 tsc defconfig 2019-08-31 11:46 Xf KB 
mx6ull 14x14 ddr256 emmc defconfig 2019-08-31 

|] mx6ull 14x14 ddr256 nand defconfig 2019-08-31 
| mx6ull 14x14 ddr256 nand sd defconfig 2019-08-31 


| mx6ull 14x14 ddr512 emmc defconfig 2019-08-31 
| mx6ull 14x14 ddr512 nand defconfig 2019-08-31 
| mx6ull 14x14 ddr512 nand sd defconfig 2019-08-31 




















图 31.1.8 正点 原子 开发 板 配置 文件 

图 31.1.8 中 这 6 个 文件 就 是 正点 原子 LMX6U-ALPHA 开发 板 所 对 应 的 uboot 默认 配置 文 
件 。 我们 只 关心 mx6ull 14x14. ddr512 emmc defconfig 和 mx6ull 14x14 ddr256 nand defconfig 
这 两 根 文件 ， 分 别 是 正点 原子 LMX6ULL EMMC 核心 板 和 NAND 核心 板 的 配置 文件 。 使 用 

“make xxx_defconfig” 命 令 即 可 配置 uboot， 比 如 : 

make mx6ull 14x14 ddr512 emmc defconfig 

上 述 命令 就 是 配置 正点 原子 的 LMX6ULL EMMC 核心 板 所 使 用 的 uboot。 
在 编译 uboot 之 前 一 定 要 使 用 defconfig 来 配置 uboot! 
在 编译 uboot 之 前 一 定 要 使 用 defconfig 来 配置 uboot! 
在 编译 uboot 之 前 一 定 要 使 用 defconfig 来 配置 uboot ! 
在 mx6ull alientek emmc.sh 中 就 有 下 面 这 一 句 : 

make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- mx6ull 14x14 ddr512 emmc - 
defconfig 

这 个 就 是 调用 mx6ull 14x14 ddr512 emmc defconfig 来 配置 uboot, 只 是 这 个 命令 还 带 了 一 
些 其 它 参 数 而 已 。 

4. .u-boot.xxx cmd 文件 


.u-boot.xxx. cmd 是 一 系列 的 文件 ， 这 些 文件 都 是 编译 生成 的 ， 都 是 一 令 文 件 ， 比 如 文 
件 .u-boot.bin.cmd， 看 名 字 应 该 是 和 u-boot.bin 有 关 的 ， 此 文件 的 iia 
示例 代码 31.1.1 .u-boot.bin.cmd 代码 
1 mel leo bin 15 Cp oo noc el 
.u-boot.bin.cmd 里 面 定 义 了 一 个 变量 : cmd_u-bootbin， 此 变量 的 值 为 “cp u-boot-nodtb.bin 
u-boot.bin” 也 就 是 拷贝 一 封 u-boot-nodtb.bin 文件 , 并 且 重 命名 为 u-boot.bi, 这 个 就 是 u-boot.bin 
的 来 源 ， 来 自 于 文件 u-poot-nodtb.bin。 
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那么 u-boot-nodtb.bin 是 怎么 来 的 呢 ? 文件 .u-bootnodtb.bin.cmd 就 是 用 于 生成 u-boot.nodtb.bin 
的 ， 此 文件 内 容 如 下 : 








示例 代码 31.1.2 .u-boot-nodtb.bin.cmd 代码 
i emel u-boot=nodto Join nn eal ln 
J tekt —7| -SCCUre trekt ~J oda -J nash —j -clewe —) -GOL — 
J got- ple =J .u boot List =J Fel cyn -0 /onany Uoool VO 
iaÓayelieloya fortan 
这 里 用 到 了 arm-linux-gnueabihf-objcopy. EMH objcopy 将 ELF 格式 的 u-boot 文件 转换 为 二 
制 的 u-boot-nodtb.bin 文件 。 
文件 u-boot 是 ELF 格式 的 文件 ， 文 件 .u-boot.cmd 用 于 生成 u-boot， 文 件 内 容 如 下 : 
示例 代码 31.1.3 .u-boot.cmd 代码 
L emel u=-bcot gs arm=-linuz-gnueabini=-le biel). ein 


Betari -rreket (05x65 7900000 =0 u=-bo0t =T wool 

















TT 

















arem arm epu acm Sear Ne a O oU pae ar eeu oua l.i ab] s (09 
arch/arm/cpu/armv7/built-in.o arch/arm/imx-common/built-in.o 
arch/arm/lib/built-in.o board/freescale/common/built-in.o 
Doara/frecscale moull alicntek en Duili-in.o eod Duil- ino 
comnon lewsLlie-3u8:.0)  cehigik/lewbilie—sumso  ceugweus/lowull-3m 6 
drivers/dma/built-in.o drivers/gpio/built-in.o drivers/i2c/built- 
in Creiyers/mme/ouilre=in:0 Gleis mou leu. IL 38 s (9) 


drivers/mtd/onenand/built-in.o drivers/mtd/spi/built-in.o 





driyers/net/built=in:0 ivers/ne/ een/ioulile= in.60  qgolcaxescsy pau lox lie 
in.o drivers/power/built-in.o drivers/power/battery/built-in.o 
drivers/power/fuel gauge/built-in.o drivers/power/mfd/built-in.o 
drivers/power/pmic/built-in.o drivers/power/regulator/built-in.o 
driyers/serial/builrt=in- -© — (ohesbyese sy qon lob. 1Lie i 
drivers/usb/dwc3/built-in.o drivers/usb/emul/built-in.o 
drivers/usb/eth/built-in.o drivers/usb/gadget/built-in.o 
drivers/usb/gadget/udc/built-in.o drivers/usb/host/built-in.o 
drivers/usb/musb-new/built-in.o drivers/usb/musb/built-in.o 
drivers/usb/phy/built-in.o drivers/usb/ulpi/built-in.o £fs/built-in.o 
lsdsw/lsyLibip—iba o) net/büuile=im- -© test/ouilre=in: © test/cm/bailt=im -© == 








end group arch/arm/lib/eabi compat.o -L /usr/local/arm/gcc-linaro- 
4.9.4-2017.01-x86 64 arm-linux-gnueabihf/bin/../lib/gcc/arm-linux- 
gpouemloIm/ 4.9.4 lo -Map u-bo0t- me 

.u-boot.cmd 使 用 到 了 arm-linux-gnueabihf-ld.bfd, 也 就 是 链接 工具 , 使 用 Id.bfd 将 各 个 built- 
in.o 文件 链接 在 以 前 就 形成 了 u-boot 文件 。uboot 在 编译 的 时 候 会 将 同一 个 目录 中 的 所 有 .c 文件 
都 编译 在 一 起 ， 并 命名 为 built-in.o， 相 当 于 将 众多 的 .c 文件 对 应 的 .o 文件 集合 在 一 起 ， 这 个 就 
是 u-boot 文件 的 来 源 。 

如 果 我 们 要 用 NXP 提供 的 MFGTools 工具 向 开发 板 烧 写 uboot， 此 时 烧 写 的 是 u-boot.imx 
文件 , 而 不 是 u-boot.bin 文件 。u-boot.imx 是 在 u-boot.bin 文件 的 头 部 添加 了 IVT. DCD 等 信息 。 
这 个 工作 是 由 文件 .u-boot.imx.cmd 来 完成 的 ， 此 文件 内 容 如 下 : 

示例 代码 31.1.4 .u-boot.imx.cmd 代码 
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I cmd u-boot. imz c ./tools/mkimage -n 


board/freescale/mx6ull alientek emmc/imximage.cfg.cfgtmp -T imximage - 
e 0x87800000 -d u-boot.bin u-boot.imx 

可 以 看 出 ， 这 里 用 到 了 工具 tools/mkimage, ifj IVT, DCD 等 数据 保存 在 了 文件 
board/freescale/mx6ullevk/imximage-ddr512.cfg.cfgtmp 中 (如 果 是 NAND 核心 板 的 话 就 是 
imximage-ddr256.cfg.cfgtmp)， 工 具 mkimage 就 是 读 取 文 件 imximage-ddr512.cfg.cfgtmp 里 面 的 
信息 ， 然 后 将 其 添加 到 文件 u-boot.bin 的 头 部 ， 最 终生 成 u-boot.imx。 

文件 .u-bootlds.cmd 就 是 用 于 生成 u-boot.lds 链接 脚本 的 ， 由 于 .u-boot.lds.cmd 文件 内 容 太 
多 , 这 里 就 不 列 出 来 了 。uboot 根 目 录 下 的 u-boot.lds 链接 脚本 就 是 来 源 于 arch/arm/cpu/u-boot.lds 
文件 5 

还 有 一 些 其 它 的 .u-boot.lds.xxx.cmd 文件 , 大 家 自行 分 析 一 下 ,关于 .u-boot.lds.xxx.cmd 文件 
就 讲解 到 这 里 。 

5. Makefile 文件 

这 个 是 顶层 Makefile X fF, Makefile dé Sc FERES], t.e Tz: Makefile 可 以 调用 子 目录 
中 的 Makefile 文件 。Makefile 据 套 在 大 项 目 中 很 常见 ， 一 般 大 项 目 里 面 所 有 的 源 代码 都 不 会 放 
到 同一 个 目录 中 ， 各 个 功能 模块 的 源 代 码 都 是 分 开 的 ， 各 自 存 放 在 各 自 的 目录 中 。 每 个 功能 模 
块 目 录 下 都 有 一 个 Makefile， 这 个 Makefile 只 处 理 本 模块 的 编译 链接 工作 ， 这 样 所 有 的 编译 链 
接 工作 就 不 用 全 部 放 到 一 个 Makefile 中 ， 可 以 使 得 Makefile 变 得 简洁 明了 。 

uboot 源码 根 目 录 下 的 Makefile 是 顶层 Makefile， 他 会 调用 其 它 的 模块 的 Makefile 文件 ， 
比如 drivers/adc/Makefile。 当 然 了 ， 顶 层 Makefile 要 做 的 工作 可 远 不 止 调 用 子 目录 Makefile 这 
么 简单 ， 关 于 顶层 Makefile 的 内 容 我 们 稍 后 会 有 详细 的 讲解 。 

6、u-boot.xxx 文件 


u-boot.xxx 同样 也 是 一 系列 文件 ,包括 u-boot、u-boot.bin、u-boot.cfg、u-boot.imx、u-boot.lds、 
u-boot.map. u-boot.srec. u-boot.sym 和 u-boot-nodtb.bin， 这 些 文件 的 含义 如 下 : 
u-boot: 编译 出 来 的 ELF 格式 的 uboot 镜像 文件 。 
u-boot.bin: 编译 出 来 的 二 进 制 格式 的 uboot 可 执行 镜像 文件 。 
u-boot.cfg: uboot 的 另外 一 种 配置 文件 。 
u-boot.imx: u-boot.bin 添加 头 部 信息 以 后 的 文件 ，NXP 的 CPU 专用 文件 。 
u-boot.lds: 链接 脚本 。 
u-boot.map: uboot 映射 文件 ， 通 过 查看 此 文件 可 以 知道 某 个 函数 被 链接 到 了 哪个 地 址 上 。 
u-boot.srec: S-Record 格式 的 镜像 文件 。 
u-boot.sym: uboot 符号 文件 。 
u-boot-nodtb.bin: 和 u-boot.bin —ffÉ, u-boot.bin 就 是 u-boot-nodtb.bin 的 复制 文件 。 


7、.config 文件 


uboot 配置 文件 ， 使 用 命令 “make xxx _defconfig” 配 置 uboot 以 后 就 会 自动 生成 ，.config 内 
容 如 下 : 













































































































































































































































































示例 代码 31.1.5 .config 代码 
# 
# Automatically generated file; DO NOT EDIT. 
i U-Boot 2015.0 Coni iguratiom 
# 
CONFIG CREATE ARCH SYMLINK-y 














QU HS COE INO ES 
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7 CONFIG SYS GENERIC BOARD-y 
8 F CONFIG ARC Ia nor set 
9 CONFIG ARM-y 


6 CONFIG HAVE GENERIC BOARD-y 
































LO i CONFTCG AVR 2 is nor Set 

11L s e ONET CEB TACK EM 18 not set 
12 sp CONFIG MOOK 1s net set 

13 # CONFIG MICROBLAZE is not set 
I4 gp CONFIG MIPS is not set 

IS F CONFTG NDO3 Te not set 

15 sg CONFIG NIOS2 is not iiec 

1 CONEIG OPENRISC 18 not set 
18 i CIONNEIG PPC ie mou ee 

19 $ CONFIG SANDBOX is not set 
2 sp CONFIG SH ia not set 

21 4; CION( IC PARCO Set 

Z2 s; CONFIG X86 18 not set 





23 CONFIG SYS ARCHz"arm" 

24 CONFIG SYS CPUz-"armv7" 

25 CONFIG SYS SOC2"mx6" 

26 CONFIG SYS VENDOR-2"freescale" 

27 CONFIG SYS BOARD2"mx6ull alientek emmc" 

28 CONFIG SYS CONFIG NAME-2"mx6ull alientek emmc" 














33 4 Boot commands 


35 CONFIG CMD BOOTD-y 
36 CONFIG CMD BOOTM-y 
37 CONFIG CMD ELF=y 
38 CONFIG CMD GO=y 

39 CONFIG CMD RUN=y 
40 CONFIG CMD IMI=y 
41 CONFIG CMD IMLS=y 
42 CONFIG CMD XIMG=y 




















45 # Environment commands 











47 CONFIG CMD EXPORTENV-y 
48 CONFIG CMD IMPORTENV-y 
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49 CONFIG CMD EDI 


TENV-y 





50 CONFIG CMD SAVE 








'ENV=y 











51 CONFIG CMD ENV 





EXISTS-y 





52. 

oH p 
54 
SE if 
56 4 Library rout 
5E 
58 4 CONFIG CC OP 
59 CONFIG HAVE PR 
60 # CONFIG USE P 
61 CONFIG SYS HZ- 
62 $ CONFIG USE T 
63 CONFIG REGEX-y 























ines 





TIMIZE LIBS FOR SPEED is not set 
IVATE LIBGCC-y 
RIVATE LISSGCOC i6 not Set 
1000 


TANVEER TNTA ORE E 


























可 以 看 出 .config 文件 









































都 是 以 “CONFIG ”开始 的 配置 项 ， 这 些 配置 项 就 是 Makefile 中 的 

















变量 ， 因 此 后 面 都 跟 有 相应 的 值 ，uboot 的 顶层 Makefile 或 子 Makefile 会 调用 这 些 变量 值 。 




















在 .config 中 会 有 大 量 的 变量 值 为 “y”， 这 些 为 “y” 的 变量 一 般 用 于 控制 某 项 功能 是 否 使 能 ， 为 











‘y” 的 话 就 表示 功能 使 能 ， 比 如 : 
CONFIG CMD BOOTD=y 


如 果 使 能 了 bootd 
有 如 下 代码 : 


ifndef CONFIG S 
# core command 
obj-y -*- boot.o 
obj-$ (CONFIG CM 
obj-y += help.o 


S OTAS OTN 


obj-y += versio 


在 示例 代码 31.1.6 








这 个 命令 的 话 ，CONFIG_CMD BOOTM i ‘y’. E cmd/Makefile 中 














示例 代码 31.1.6 cmd/Makefile 代码 
PL BUILD 


D BOOTM) += bootm.o 


n.o 


中 ， 有 如 下 所 示 一 行 代码 : 

















obj-$(CONFIG CMD BOOTM) += bootm.o 
CONFIG CMD BOOTM=y， 将 其 展开 就 是 : 


obj-y += bootm.o 
也 就 是 给 obj-y iÈ 




















> 
































加 了 一 个 “bootm.o”， obj-y 包含 着 所 有 要 编译 的 文件 对 应 的 .o 文件 ， 这 




















有 表示 需要 编译 文件 cmd/bootm.c。 相 当 于 通过 “CONFIG _ CMD _BOOTD=y” 来 使 能 bootm 这 
命令 ， 进 而 编译 cmd/bootm.c 这 个 文件 ， 这 个 文件 实现 了 命令 bootm。 在 uboot 和 Linux 内 核 

















中 都 是 采用 这 种 方法 来 选择 使 能 某 个 功能 ， 编 译 对 应 的 源码 文件 。 





8. README 

















README 文件 描述 了 uboot 的 详细 信息 ， 包 括 uboot 该 如 何 编译 、uboot 中 各 文件 夹 的 含 














义 、 相 应 的 命令 等 等 。 




















建议 大 家 详细 的 阅读 此 文件 ， 可 以 进一步 增加 对 uboot 的 认识 。 


























关于 uboot 根 目 录 中 的 文件 和 文件 夹 的 含义 就 讲解 到 这 里 ， 接 下 来 就 要 开始 分 析 uboot 的 








启动 流程 了 。 
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31.2 VScode 工程 创建 


先 在 Ubuntu 下 编译 一 下 uboot， 然 后 将 编译 后 的 uboot 文件 夹 复制 到 windows 下 ， 并 创建 
VScode 工程 。 打 开 VScode， 选 择 : 文件 -> 打开 文件 夹 ...， 选 中 uboot 文件 夹 ， 如 图 31.2.1 所 
示 : 
































x) 打开 文件 夹 x 
c v ^ T « IMX6UL NXP UB... > IMX6ULL > v O 搜索 "IMX6ULL" p 
组 织 ~ ”新 建文 件 夹 =E @ 

小 音乐 ^ 名 称 修改 日 其 
msn | Jalenekubost 0000%8 | 
> 本 地 磁盘 (C) T gst1.0-imx 2019-04-18 9:59 
“= 本 地 磁盘 (D:) T Linux \ 2018-08-20 9:39 
«> 工作 (E:) T Linux 49x. 选中 uboot 源 码 文件 夹 201s.11.10 15:08 
< 仓库 CF) T rootfs 2019-04-29 21:42 
L linux33 (H) T Uboot 4.9.x 2018-11-10 15:05 
~> Ubuntu (|:) 
~> 其 他 (J:) 
点 "H * 4" 

d 网 络 2、 mu 选择 文件 夹 

NE ES » 





文件 夹 : alientek uboot 











选择 文件 夹 取消 











图 31.2.1 选择 uboot 源码 文件 夹 
打开 uboot 目录 以 后 ，VSCode 界面 如 图 31.2.2 所 示 : 
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vV UBOOT (工作 区 ) 

> api 
arch 
board 
cmd 
common 
configs 
disk 
doc 
drivers 
dts 


examples 


irancac 





图 31.2.2 VScode 界面 
点 击 “ 文 件 -> 将 工作 区 另存 为 ...” 打开 保存 工作 区 对 话 框 ， 将 工作 区 保存 到 uboot 源码 根 
目录 下 ， 设 置 文件 名 为 “uboot”， 如 图 31.2.3 所 示 : 














» uboot-imx-rel i... 


1、 保 存 到 uboot 源 码 根 目录 下 


名 称 
LA nu 
Licenses 


net 

E post 
| | scripts 
test 

| | tools 


























2、 工 作 区 名 字 设 置 


3、 保 存 


图 31.2.3 保存 工作 区 

保存 成 功 以 后 就 会 在 uboot 源码 根 目 录 下 存在 一 个 名 为 uboot.code-workspace 的 文件 。 这 样 
一 个 完整 的 VSCode 工程 就 建立 起 来 了 。 但 是 这 个 VSCode 工程 包含 了 uboot 的 所 有 文件 ，uboot 
中 有 些 文件 是 不 需要 的 ， 比 如 arch 目录 下 是 各 种 架构 的 文件 来， 如 图 31.2.4 所 示 ; 









































729 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


arch 
arc 
arm 
avr32 
blackfin 
m68k 
microblaze 
mips 
nds32 
nios2 
openrisc 
powerpc 
sandbox 
sh 
sparc 
x86 
Ð .gitignore 
D Kconfig 








图 31.2.4 arch 目录 

在 arch 目录 下 ， 我 们 只 需要 arm 文件 夹 ， 所 以 需要 将 其 它 的 目录 从 VSCode 中 给 屏蔽 掉 ， 
比如 将 arch/avr32 这 个 目录 给 屏蔽 掉 。 
在 VSCode 上 建 名 为 “.vscode ”的 文件 夹 ， 如 图 31.2.5 所 示 : 






































4 无 标 权 (工作 区 ) O w O g 


4 &yl uboot-imx-rel imx 4.1.15 2.1.0 ga alient... 





图 31.2.5. 新 建 .vscode 文件 夹 
输入 新 建文 件 夹 的 名 字 ， 完 成 以 后 如 图 31.2.6 所 示 。 














4 无 标题 (工作 区 ) 
ZEE uboot-imx-rel_imx_4.1.15_2.1.0_ga_alient... 
b .vscode 
api 
arch 
board 
cmd 


common 


| configs 
disk 





图 31.2.6 新 建 的 .vscode 文件 夹 
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在 .vscode 文件 夹 中 新 建 一 个 名 为 “settings.json” 的 文件 ， 然 后 在 settings.json 中 输入 如 下 内 





























示例 代码 31.2.1settings.json 文件 代码 

IET 
2 "Ssearch.exclude": { 
B "**/node modules": true, 
4 "**/bower components": true, 
5 }, 
6 "files.exclude": { 
Wye le on 
8 We hi od 
9 /ee 
10 WA CVS ne 
al Meu) DS Storer Crue; 
12 } 
i3 p 

结果 如 图 31.2.7 所 示 : 





settingsjson X 


{ 





图 31.2.7 settings.json 文件 默认 内 容 




















其 中 "search.exclude" 里 面 是 需要 在 搜索 结果 中 排除 的 文件 或 者 文件 夹 ，"files.exclude" 是 左 
便 工 程 目录 中 需要 排除 的 文件 或 者 文件 来。 我 们 需要 将 arch/avr32 文件 夹 下 的 所 有 文件 从 搜索 
结果 和 左 侧 的 工程 目录 中 都 排除 掉 ,因此 在 "search.exclude" 和 "files.exclude" 中 输入 如 图 31.2.8 所 
示 内 容 : 
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{} settingsjson X 


D 


"search.exclude": 


"** /node modules": 


论坛 :Www.opendev.com 


{ 


true, 


"**/bower components": true, 


"arch/avr32": true, 


p 


"files.exclude": { 
ET Erue; 


ee L1 (pale 


true, 


sp hg": true, 


“GUS 


true, 


"**/.DS Store": true, 


图 31.2.8 排除 arch/avr32 目录 











LIS] B 








中 看 一 下 左 侧 的 工程 目录 ， 发 现 arch H 








个 文件 夹 被 排除 掉 了 ， 如 图 31.2.9 所 示 : 


RAT H Xe TE" search.exclude" f 














4 机 arch 

arc 

arm 
blackfin 
m68k 
microblaze 
mips 
nds32 
nios2 
openrisc 


powerpc 


sandbox 
sh 


sparc 


x36 








除 的 文件 或 者 文件 夹 ， 
和 拖 不 需要 的 文件 ,或 者 文件 夹 排除 掉 , 对 于 本 章 我 们 分 析 uboot 而 言 , 在 "search.exclude" 





方法 即 可 ; 











冒号 后 面 为 是 否 将 文件 























图 31.2.9 arch/avr32. 目录 排除 
DI"files.exclude" FHJIILA. Y: rch/avr32": true, E BU TAE EHE 








FHERR, true 表示 排除 ，false 
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录 下 没有 avr32 这 个 文件 夹 了 ， 说 明 avr32 这 











表示 不 排除 。 用 这 种 
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和 "files.exclude" 中 需要 输入 的 完成 的 内 容 如 下 : 
示例 代码 31.2.2 settings.json 文件 代码 


Ue Nn 
Te EE 
De Eo Er 
are /em en te euS, 
el/ an Ee 
meme lA Te 


"arch/m68k":true, 


CONI POETS SML 


"arch/microblaze":true, 

ONE cT SEATS 

OM rae rayos. 9.21 EXE TETUKS A 
Mirarchi anios key 

I2 tareh openri se: true, 

13 "arch/powerpc":true, 

14 "arch/sandbox":true, 

US orem iim eney 

te Tareh/ sparet- true, 

J eO ee 

18 "arch/arm/mach*":true, 

JlS)- Wewetelav/ arm cp arm IERREUS 
20 archa rm epua rml2 0C CEUS, 
21 "arch/arm/cpu/arm9*":true, 
22 "arch/arm/cpu/armv7m":true, 
23 "arch/arm/cpu/armv8":true, 
24 "arch/arm/cpu/pxa":true, 

gibus cei demde sO TU 
26 "board/[a-e]*":true, 

27 Oe [ersva]| v V Sese ra, 

20m poar [Hes] ss ele 

29 "board/[A-Z]*":true, 

S00 Gas cie E CENE, 

31 "board/freescale/b*":true, 


32 "board/freescale/l*":true, 











33 "board/freescale/m5*":true, 
34 "board/freescale/mp*":true, 
35 "board/freescale/c29*":true, 
36 "board/freescale/cor*":true, 
37 "board/freescale/mx7*":true, 
38 "board/freescale/mx2*":true, 
39 "board/freescale/mx3*":true, 
40 "board/freescale/mx5*":;true, 


41 "board/freescale/p*":true, 
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42 
43 
44 
45 
46 
47 
48 
49 
50 
di 
52 
53 
54 
59 
56 
57 


ES 


"board/freescale/qg*":true, 


"board/freescale/t*":true, 





"board/freescale/v*":true, 
yeemi no la- des ne 
"te Sua ens lanal 5 B Ib S 
Tepon igs ATARAR Erue, 
srerona ons M acz ne 
"Configs/M 


"Configs/M[0- 


a ERUS 
VOV EEG, 
"Configs/m 


ei) le 
Tcen t epe m 0) 7 ]| 5-4 BEI P 





Teeni ige AN SOT ESSEN 
nee onda as UE C 
mimeliude/ contigs Sz SETS CS 


"ome contigs RS ZA C 





"include/configs/m[a-w]*":true, 





上 上述 代 码 用 到 了 通配符 “*” 比如 “**/*.o” 
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示 所 有 .o 结尾 的 文件 。“configs/[a-1]*” 表 
configs 目录 下 所 有 以 “a”~ “1” 开头 的 文件 或 者 文件 来 。 上 述 配置 只 是 


排除 了 一 部 分 文件 


夹 ， 大 家 在 实际 的 使 用 中 可 以 根据 自己 的 实际 需求 来 选择 将 哪些 文件 或 者 文件 夹 排 除 掉 。 排 除 


以 后 我 们 的 工程 就 会 清爽 很 多 ， 搜 索 的 时 候 也 不 会 跳出 很 多 文 


31 


先 从 顶层 Makefile J 


程 

















.3 U-Boot 顶层 Makefile 分 析 


























i 


在 阅读 uboot 源码 之 前 , 肯定 是 要 先 看 一 下 顶层 Makefile, 分 析 gcc 版 本 代码 的 时 候 一 定 是 
开始 的 ， 然 后 再 是 子 Makefile， 这 样 通过 层 层 分 析 Makefile 即 可 了 解 整 个 工 


的 组 织 结构 。 顶 层 Makefile 也 就 是 uboot 根 目录 下 的 Makefile 文件 ， 由 于 顶层 Makefile 文件 
内 容 比 较 多 ， 所 以 我 们 将 其 分 开 来 看 。 





31.3.1 版 本 号 
顶层 Makefile 一 开始 是 版 本 号 ， 内 容 如 下 (为 了 方便 分 析 ， 顶 层 Makefile 代码 段 前 段 行 号 


采用 Makefile 中 的 行 号 ， 因 为 uboot 会 更 新 ， 因 此 行 号 可 外 








同 ): 


O CD D OC 


版 本 信息 ，NAME 是 和 名 字 有 关 的 ， 一 般 不 使 用 这 两 个 。 


kbA 





EAJ 





示例 代码 31.3.1.1 顶层 Makefile 代码 


VERSION = 2016 
PATCHLEVEL - 03 
EL 





























EXTRAVERSION = 
NAME = 











你 所 看 的 顶层 Makefile 有 所 不 





VERSION 是 主 版 本 号 ，PATCHLEVEL 是 补丁 版 本 号 ，SUBLEVEL 是 次 版 本 号 ， 这 三 个 一 
起 构成 了 uboot 的 版 本 号 ， 比 如 当前 的 uboot 版 本 号 就 是 “2016.03”。EXTRAVERSION 是 附加 
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31.3.2 MAKEFLAGS 变量 


make 是 支持 递归 调用 的 ， 也 就 是 在 Makefile 中 使 用 “make” 命 令 来 执行 其 他 的 Makefile 
文件 ， 一 般 都 是 子 目录 中 的 Makefile 文件 。 假 如 在 当前 目录 下 存在 一 个 “subdir” 子 目录 ， 这 个 
子 目 录 中 又 有 其 对 应 的 Makefile 文件 ,那么 这 个 工程 在 编译 的 时 候 其 主 目录 中 的 Makefile 就 可 
以 调用 子 目录 中 的 Makefile， 以 此 来 完成 所 有 子 目 录 的 编译 。 主 目录 的 Makefile 可 以 使 用 如 下 
代码 来 编译 这 个 子 目录 ; 

$(MAKE) -C subdir 

$(MAKE) 就 是 调用 “make” 命 令 ，-C 指定 子 目 录 。 有 时 候 我 们 需要 向 子 make 传递 变量 ， 

这 个 时 候 使 用 “export” 来 导出 要 传递 给 子 make 的 变量 即 可 ， 如 果 不 希 望 哪 个 变量 传递 给 子 

make 的 话 就 使 用 “unexport” 来 声明 不 导出 : 

export VARIABLE -+--+ // 导 出 变量 给 子 make 。 

unexport VARIABLE.…… // 不 导出 变量 给 子 make。 
有 两 个 特殊 的 变量 :“SHELL” 和 “MAKEFLAGS”, 这 两 个 变量 除非 使 用 “unexport” 声 明 ， 
否则 的 话 在 整个 make 的 执行 过 程 中 ,它们 的 值 始 终 自 动 的 传递 给 子 make。 在 uboot 的 主 Makefile 
中 有 如 下 代码 : 




























































































示例 代码 31.3.2.1 顶层 Makefile 代码 
20 MAKEFLAGS += -rR --include-dir=$ (CURDIR) 

上 述 代码 使 用 “+=” 来 给 变量 MAKEFLAGS 追加 了 一 些 值 ,“-rR” 表 示 禁 止 使 用 内 置 的 隐 
含 规则 和 变量 定义 ,“--include-dir” 指 明 搜 索 路 径 ， 中 (CURDIR)” 表 示 当 前 目录 。 
























































31.3.3 命令 输出 


uboot 默认 编译 是 不 会 在 终端 中 显示 完整 的 命令 ， 都 是 短命 令 ， 如 图 31.3.3 所 示 : 

examples/standalone/stubs.o 
examples/standalone/libstubs.o 
examples/standalone/hello world.o 
examples/standalone/hello world 

0BJCOPY examples/standalone/hello world.srec 

0BJCOPY examples/standalone/hello world.bin 

LDS u-boot.lds 

LD u-boot 




















OBJCOPY u-boot-nodtb.bin 


COPY u-boot.bin 
CFGS board/freescale/mx6ull alientek emmc/imximage.cfg.cfgtmp 
MKIMAGE u-boot.imx 
0BJCOPY u-boot.srec 
SYM u-boot.sym 
CFG u-boot.cfg 





图 31.3.3.1 终端 短命 令 输出 
在 终端 中 输出 短命 令 虽然 看 起 来 很 清 费 ， 日 是 不 利于 分 析 uboot 的 编译 过 程 。 可 以 通过 设 
置 变量 “V=1“ 来 实现 完成 的 命令 输出 ， 这 个 在 调试 uboot 的 时 候 很 有 用 ， 结 果 如 图 31.3.3.2 所 
JR: 
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arm-Linux-gnueabihf-Ld.bfd -pie --gc-sections -Bstatic -Ttext 0x87800000 -o u-boot -T u-boot.lds arch/arm/c 
pu/armv7/start.o --start-group arch/arm/cpu/built-in.o arch/arm/cpu/armv7/built-in.o arch/arm/imx-common/buil 
t-in.o arch/arm/lib/built-in.o board/freescale/common/built-in.o  board/freescale/mx6ull alientek emmc/built-i 
n.o cmd/built-in.o common/built-in.o disk/built-in.o drivers/built-in.o drivers/dma/built-in.o drivers/gpi 
o/built-in.o drivers/i2c/built-in.o drivers/mmc/built-in.o drivers/mtd/built-in.o drivers/mtd/onenand/built- 
in.o drivers/mtd/spi/built-in.o drivers/net/built-in.o drivers/net/phy/built-in.o drivers/pci/built-in.o dr 
ivers/power/built-in.o drivers/power/battery/built-in.o drivers/power/fuel gauge/built-in.o drivers/power/mfd 
/built-in.o drivers/power/pmic/built-in.o drivers/power/regulator/built-in.o drivers/serial/built-in.o drive 
rs/spi/built-in.o drivers/usb/dwc3/built-in.o drivers/usb/emul/built-in.o drivers/usb/eth/built-in.o drivers 
/usb/gadget/built-in.o drivers/usb/gadget/udc/built-in.o drivers/usb/host/built-in.o drivers/usb/musb-new/bui 
lt-in.o drivers/usb/musb/built-in.o drivers/usb/phy/built-in.o drivers/usb/ulpi/built-in.o fs/built-in.o li 

LibreorficeImpress net/built-in.o test/built-in.o test/dm/built-in.o --end-group arch/arm/lib/eabi compat.o -L /us 
r/local/arm/gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf/bin/../lib/gcc/arm-linux-gnueabihf/4.9.4 -lgcc - 
Map u-boot.map 

arm-linux-gnueabihf-objcopy --gap-fill-Oxff -j .text -j .secure text -j .rodata -j .hash -j .data -j .got -j 
.got.plt -j .u boot list -j .rel.dyn -0 binary u-boot u-boot-nodtb.bin 

cp u-boot-nodtb.bin u-boot.bin 
make -f ./scripts/Makefile.build objzarch/arm/imx-common u-boot.imx 
mkdir -p board/freescale/mx6ull alientek emmc/ 

./tools/mkimage -n board/freescale/mx6ull alientek emmc/imximage.cfg.cfgtmp -T imximage -e 0x87800000 -d u-boo 
t.bin u-boot.imx 
“Image Type: Freescale IMX Boot Image 
Image Ver: 2 (i.MX53/6/7 compatible) 
Mode: DCD 
Data Size: 425984 Bytes = 416.00 kB = 0.41 MB 
Load Address: 877ff420 
Entry Point: 87800000 

arm-linux-gnueabihf-objcopy --gap-fill=0xff -j .text -j .secure_text -j .rodata -j .hash -j .data -j 
.got.plt -j -u boot list .rel.dyn -0 srec u-boot u-boot.srec 

arm-linux-gnueabihf -obj -t u-boot » u-boot.sym 














顶层 Makefile 中 控制 命令 输出 的 代码 如 下 : 

示例 代码 31.3.3.1 顶层 Makefile 代码 
73 ifeq ("S(origin V)", "command line") 
74  KBUILD VERBOSE = $(V) 
75 endif 
76 ifndef KBUILD VERBOSE 
33 KBUILD VERBOSE = 0 
78 endif 
JS, 
80 ifeq ($(KBUILD VERBOSE),1) 


















































81 quiet = 
82 Q= 
83 else 
84 quiet=quiet 
85 Q=@ 
86 endif 

上 述 代码 中 先 使 用 ifeq 来 判断 "$(origin V)" M" command line" 是 否 相等 .这 里 用 到 了 Makefile 
中 的 函数 origin, origin 和 其 他 的 函数 不 一 样 ， 它 不 操作 变量 的 值 ，origin 用 于 告诉 你 变量 是 哪 
来 的 ， 语 法 为 : 

$(origin <variable>) 

variable 是 变量 名 ，o 函数 的 返回 值 就 是 变量 来 源 ， 因 此 $(origin V) 就 是 变量 V 的 来 源 。 如 
果 变 量 V 是 在 命令 行 定 义 的 那么 它 的 来 源 就 是 "command line"， 这 样 "$(origin V oond 
line" 就 相等 了 。 当 这 两 个 相等 的 时 候 变 量 KBUILD_VERBOSE 就 等 于 V 的 值 ， 比如 在 命令 行 中 
输入 “V=1 “的 话 那 么 KBUILD VERBOSE=1 。 如 果 没 有 在 命令 行 输 入 V Iu 
KBUILD VERBOSE-0. 

第 80 行 判断 KBUILD VERBOSE 是 否 为 1， 如 果 KBUILD_VERBOSE 为 1 的 话 变 量 quiet 
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和 Q 都 为 室 ， 如 果 KBUILD_VERBOSE=0 的 话 变量 quiet X “quiet. “， 变 量 Q 为 “@”, 综 上 


























所 述 : 
V=1 的 话 : 
KBUILD VERBOSE-1 
quiet- 空 。 


= 2 


EO 

V=0 或 者 命令 行 不 定义 V 的 话 : 

KBUILD VERBOSE-0 

quiet- quiet . 

Q- (9. 

Makefile 中 会 用 到 变量 quiet 和 Q 来 控制 编译 的 时 候 是 否 在 终端 输出 完整 的 命令 ， 在 顶层 
Makefile 中 有 很 多 如 下 所 示 的 命令 : 

$(Q)$(MAKE) $(build)=tools 

如 果 V=0 的 话 上 述 命 令 展开 就 是 “@ make $(build)=tools”，make 在 执行 的 时 候 默 认 会 在 终 
端 和 输出 命令 ， 但 是 在 命令 前 面 加 上 “@” 就 不 会 在 终端 输出 命令 了 。 当 V=1 的 时 候 Q 就 为 空 ， 
上 述 命令 就 是 “make $(build)=tools” 因此 在 make 执行 的 过 程 , 命令 会 被 完整 的 输出 在 终端 上 。 
有 些 命令 会 有 两 个 版 本 ， 比 如 : 

quiet cmd sym ?= SYM $@ 

cmd_sym ?= $(OBJDUMP) -t $< > $@ 

sym 命令 分 为 “quiet cmd_sym” 和 “cmd_sym” 两 个 版 本 ,这 两 个 命令 的 功能 都 是 一 样 的 ， 
区 别 在 于 make 执行 的 时 候 输 出 的 命令 不 同 。quiet cmd xxx 命令 输出 信息 少 ， 也 就 是 短命 令 ， 
而 cmd xxx 命令 输出 信息 多 ， 也 就 是 完整 的 命令 。 

如 果 变 量 quiet 为 空 的 话 ， 整 个 命令 都 会 输出 。 

如 果 变 量 quiet 为 “quiet ”的 话 ， 仅 输出 短 版 本 。 

WREE quiet 为 “silent ”的 话 ， 整 个 命令 都 不 会 输出 。 










































































31.3.4. 静默 输出 


上 一 小 节 讲 了 , 设置 V=0 或 者 在 命令 行 中 不 定义 V 的 话 ,编译 uboot 的 时 候 终端 中 显示 的 
短命 令 ， 但 是 还 是 会 有 命令 输出 ， 有 时 候 我 们 在 编译 uboot 的 时 候 不 需要 输出 命令 ， 这 个 时 候 
就 可 以 使 用 uboot 的 静默 输出 功能 ,编译 的 时 候 使 用 “make -s” 即 可 实现 静默 输出 , 顶层 Makefile 
相应 的 代码 如 下 : 



















































































示例 代码 31.3.4.1 顶层 Makefile 代码 
88 4 If the user is running make -s (silent mode), suppress echoing of 
89 # commands 
90 
91 ifneq ($(filter 4.*5,9(MAKE VERSION)),) i make-4 
92 ifneq (S$S(filter $s ,S$(firstword xs (MAKEFLAGS))),) 

















95 cquiet=silent 

94 endif 

95 else # make-3.8x 

96 ifneq (S$(filter s% -s%,$ (MAKEFLAGS)),) 





2i quietzsilent 
9$ emeut 
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BSA 
100 
101 export quiet Q KBUILD VERBOSE 

第 91 行 判断 当前 正在 使 用 的 编译 器 版 本 号 是 否 为 4.x, 74] rS (filter 4.%,$(MAKE VERSION)) 
和 “ ”( 空 ) 是 否 相 等 ， 如 果 不 相等 的 话 就 成 立 ， 执 行 里 面 的 语句 。 也 就 是 说 $(filter 
4.%,$(MAKE_VERSION)) 不 为 空 的 话 条 件 就 成 立 ， 这 里 用 到 了 Makefile 中 的 filter 函数 ， 这 是 
个 过 滤 函 数 ， 函 数 格式 如 下 : 

$(filter <pattern...>,<text>) 

filter 函数 表示 以 pattern 模式 过 滤 text 字符 串 中 的 单词 ， 仅 保留 符合 模式 pattern 的 单词 ， 
可 以 有 多 个 模式 。 函 数 返 回 值 就 是 符合 pattern 的 字符 串 。 因 此 $(filter 4.%,$(MAKE VERSION)) 
的 含义 就 是 在 字符 串 “MAKE VERSION ”中 找 出 符合 “4.%” 的 字符 (% 为 通配符 )， 
MAKE VERSION 是 编译 器 的 版 本 号 ， 我们 当前 使 用 的 交叉 编译 器 版 本 号 为 4.9.4， 所 以 肯定 可 
以 找 出 “4.%”。 因此 $(filter 4.%,$GMAKE VERSION)) 不 为 空 , 条 件 成 立 , 执行 92~94 行 的 语句 。 
第 92 行 也 是 一 个 判断 语句 ， 如 果 $(filter %s ,$(firstword x$(MAKEFLAGS))) 不 为 空 的 话 条 件 成 
XL, AERE quiet 等 于 “silent ”。 这 里 也 用 到 了 函数 filter， 在 $(firstword x$(MAKEFLAGS))) 中 过 
滤 出 符合 “%s” 的 单词 。 到 了 函数 furstword, PAX firstword 是 获取 首 单词 ， 函 数 格式 如 下 : 

$(firstword <text>) 

firstword 函数 用 于 取出 text 字符 串 中 的 第 一 个 单词 ， 函 数 的 返回 值 就 是 获取 到 的 单词 。 当 
使 用 “make -s” 编 译 的 时 候 ,“-s” 会 作为 MAKEFLAGS 变量 的 一 部 分 传递 给 Makefile。 在 项 
层 Makfile 中 添加 如 图 31.3.4.1 所 示 的 代码 : 






































































































































-silent 


zsilent 


quiet Q KBUILD VERBOSE 





图 31.3.4.1 顶层 Makefile 添加 代码 
图 31.3.4.1 中 的 两 行 代码 用 于 输出 $(firstword x$(GMAKEFLAGS)) 的 结果 ， 最 后 修改 文件 
mx6ull alientek_emmc.sh， 在 里 面 加 入 “-s” 选 项 ， 结 果 如 图 31.3.4.2 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/alientek_uboot 














make =arm =arm-Linux-gnueabihf- distclean 
make =arm -arm-linux-gnueabihf- mx6ull 14x14 ddr512 emmc defconfig 


make! -s -arm -arm-linux-gnueabihf- -j 





图 31.3.4.2. 加 入 -s 选项 
修改 完成 以 后 执行 mx6ull alientek emmc.sh， 结 果 如 图 31.3.4.3 所 示 : 
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$ ./mx6ull alientek emmc.sh 





CLEAN scripts/basic 

CLEAN scripts/kconfig 

CLEAN include/config include/generated 
CLEAN .config include/autoconf.mk include/autoconf.mk.dep include/config.h 
HOSTCC scripts/basic/fixdep 

HOSTCC scripts/kconfig/conf.o 

SHIPPED scripts/kconfig/zconf.tab.c 

SHIPPED scripts/kconfig/zconf.lex.c 

SHIPPED scripts/kconfig/zconf.hash.c 


HOSTCC scripts/kconfig/zconf.tab.o 
HOSTLD scripts/kconfig/conf 

# 

# configuration written to .config 

# 

firstword= xrRs 





图 31.3.4.3 修改 顶层 Makefile 后 的 执行 结果 

从 图 31.3.4.3 可 以 看 出 第 一 个 单词 是 “xrRs”， 将 $(filter %s ,S(firstword x$(MAKEFLAGS))) 
展开 就 是 $(filter Vos, xrRs)， 而 $(filter Yos, xrRs) 的 返回 值 肯定 不 为 空 ， 条 件 成 六 ，quiet=silent . 
第 101 行 使 用 export 导出 变量 quiet, Q 和 KBUILD VERBOSE。 





























NX 





31.3.5 设置 编译 结果 输出 目录 


uboot 可 以 将 编译 出 来 的 目标 文件 输出 到 单独 的 目录 中 ， 在 make 的 时 候 使 用 “O” 来 指定 
输出 目录 ， 比 如 “make O=out” 就 是 设置 目标 文件 输出 到 out 目录 中 。 这 么 做 是 为 了 将 源 文件 
和 编译 产生 的 文件 分 开 ， 当 然 也 可 以 不 指定 O 参数 ,不 指定 的 话 源 文件 和 编译 产生 的 文件 都 在 
同一 个 目录 内 ， 一 般 我 们 不 指定 O 参数 。 顶 层 Makefile 中 相关 的 代码 如 下 : 
示例 代码 31.3.5.1 顶层 Makefile 代码 


103 4$ kbuild supports saving output files in a separate directory. 












































104 # To locate output files in a separate directory two syntaxes are 
supported. 
105 # In both cases the working directory must be the root of the 


laenmmea EC 


106 # 1) O= 
107 4 Use "make O-dir/to/store/output/files/" 
108 4 


109) s 2) Set KEUILD OUTPUT 

110 s; Set the enyironment variable KBUILD QUTPUT to point to the 
directory 

111 # where the output files shall be placed. 

112 # export KBUILD OUTPUT-dir/to/store/output/files/ 

113 # make 

114 4 
115 ṣẹ The O2 assignment takes precedence over the KBUILD OUTPUT 








environment 
116 4 variable. 
TIE 











118 £ KBUILD SRC is set on invocation of make in OBJ directory 
11.5) sp KBUILD SRC is not intended to be used by the regalar user (ere 





now) 
120 ifeq (S(KBUILD SRC),) 
T2 
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122 # OK, Make called in directory where kernel src resides 


123 4 Do we want to locate output files in a separate directory? 


124 ifeq ("S(origin O)", "command line") 





125  KBUILD OUTPUT :- $(0O) 
126 endif 
11277 


128 # That's our default target when none is given on the command line 
129 PHONY := all 

BoT: 

TS 

132 # Cancel implicit rules on top Makefile 

133 $ (CURDIR)/Makefile Makefile: ; 

134 

135 ifneq ($(KBUILD OUTPUT),) 





136 # Invoke a second make in the output directory, passing relevant 
variables 


137 4 check that the output directory actually exists 








138 saved-output :- S$(KBUILD OUTPUT) 

JS DER UBNSISIDMEG UUTSP DS $(shell mkdir -p S(KBUILD OUTPUT) && cd 
$ (KBUILD OUTPUT) V 

140 && /bin/pwd) 


To endif p itneg ( (FBEUITLD OUTEUT),} 
156 endif sp ifeq (F (FBUILD (SNC jy 

第 124 行 判 断 “0” 是 否 来 自 于 命令 行 ,如 果 来 自命 令 行 的 话 条 件 成 立 , KBUILD OUTPUT 
就 为 $(O)， 因 此 变量 KBUILD_ OUTPUT 就 是 输出 目录 。 

第 135 行 判 断 KBUILD OUTPUT 是否 为 空 。 

第 139 行 调用 mkdir 命令 ， 创 建 KBUILD OUTPUT 目录 ， 并 且 将 创建 成 功 以 后 的 绝对 路 
径 赋 值 给 KBUILD OUTPUT。 至 此 ， 通 过 O 指定 的 输出 目录 就 存在 了 。 
































31.3.6 代码 检查 


uboot 支持 代码 检查 ， 使 用 命令 “make C=1” 使 能 代码 检查 ， 检 查 那些 需要 重新 编译 的 文 
fF. “make C=2” 用 于 检查 所 有 的 源码 文件 ， 顶 层 Makefile 中 的 代码 如 下 : 
示例 代码 31.3.6.1 顶层 Makefile 代码 
166 # Call a source code checker (by default, "sparse") as part of the 









































167 4$ C compilation. 
168 4 

169 # Use 'make C-1' to enable checking of only re-compiled files. 
170 4 Use 'make C-2' to enable checking of *all* source files, 
regardless 

171 # of whether they are re-compiled or not. 


172 t 
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173 4 See the file "Documentation/sparse.txt" for more details, 


including 

174 4$ where to get the "sparse" utility. 

1L 7/55 

Ire irea (OCP (Origin cce cedes cu) 

177 |KBUILD CHECKSRC - $(C) 

178 endif 

179 ifndef KBUILD CHECKSRC 

180 KBUILD CHECKSRC - 0 

181 endif 
第 176 行 判 断 C 是 否 来 源 于 命令 行 ， 如 果 C 来 源 于 命令 行 ， 那 就 将 C 赋值 给 变量 

KBUILD_CHECKSRC， 如 果 命 令 行 没 有 C 的 话 KBUILD_ CHECKSRC 就 为 0。 























31.3.7 模块 编译 


在 uboot 中 允许 单独 编译 某 个 模块 ， 使 用 命令 “make M=dir” 即 可 ， 旧 语法 “make 
SUBDIRS=dir” 也 是 支持 的 。 顶 层 Makefile 中 的 代码 如 下 : 
示例 代码 31.3.7.1 顶层 Makefile 代码 
183 # Use make M=dir to specify directory of external module to build 
184 £$ Old syntax make ... SUBDIRSZSPWD is still supported 
185 p Setting the environment variable KBUILD EXTMOD take precedence 
186 ifdef SUBDIRS 
187  KBUILD EXTMOD ?= $(SUBDIRS) 
188 endif 
189 
190 ifeq ("S(origin M)", "command line") 
191  KBUILD EXTMOD := $(M) 
192 endif 
9S 
194 $ If building an external module we do not care about the all: rule 
195 4$ but instead all depend on modules 
196 PHONY -*- all 
197 ifeq ($(KBUILD EXTMOD),) 
19/5. mug eu 





























199 else 

200 me moctles 

201 endif 

202 

203 ifeq ( ( BUILD SRC),) 

204 # building in the source tree 

205 srctree :- 

206 else 

207 ifeq ($(KBUILD SRC)/,$(dir $(CURDIR))) 

208 # building in a subdirectory of the source tree 


741 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 











原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
209 Sheec =E 

zo else 

2a srctree := S$(KBUILD SRC) 

2L endif 

ZLs r endif 

214 objtree := . 

25 SPE = S(srctree) 

216 obj c (esie) 

2/17 

218 VPATH := $(srctree)$(if S(KBUILD EXTMOD),:$(KBUILD EXTMOD)) 
VES) 


220 export srctree objtree VPATH 

第 186 行 判 断 是 否定 义 了 SUBDIRS, W R Æ X [f SUBDIRS, 4E 
KBUILD_EXTMOD=SUBDIRS， 这 里 是 为 了 文 持 老 语法 “make SUBIDRS-dir" 

第 190 行 判 断 是 否 在 命令 行 定义 了 M， 如 果 定 义 了 的 话 KBUILD_EXTMOD=$(M)。 

第 197 行 判 断 KBUILD_EXTMOD 时 候 为 空 ， 如 果 为 空 的 话 目 标 _all 依赖 all， 因此 要 先 编 
译 出 all。 和 否则 的 话 默认 目标 _all 依赖 modules， 要 先 编 译 出 modules， 也 就 是 编译 模块 。 一 般 情 
况 下 我 们 不 会 在 uboot 中 编译 模块 ， 所 以 此 处 会 编译 all 这 个 目标 。 

第 203 行 判断 KBUILD_SRC 是 否 为 空 ， 如 果 为 空 的 话 就 设置 变量 srctree 为 当前 目录 ， 即 
srctree 为 “.” 一 般 不 设置 KBUILD_SRC。 

第 214 行 设置 变量 objtree 为 当前 目录 。 
第 215 和 216 行 分 别 设置 变量 src 和 obj， 都 为 当前 目录 。 

第 218 行 设置 VPATH。 

第 220 行 导 出 变量 scrtree、objtree 和 VPATH，。 


地 

























































































31.3.8 获取 主机 架构 和 系统 


接 下 来 顶层 Makefile 会 获取 主机 架构 和 系统 ， 也 就 是 我 们 电脑 的 架构 和 系统 ， 代 码 如 下 : 
示例 代码 31.3.8.1 顶层 Makefile 代码 





227 HOSTARCH :-2 $(shell uname man 

228 sed -e s/i.86/x86/ \ 

229 -e s/sun4du/sparc64/ \ 

230 三 全 

2l -e s/sall0/arm/ \ 

292 -e s/ppc64/powerpc/ \ 

233 -e s/ppc/powerpc/ \ 

234 -e s/macppc/powerpc/N 

Z5 -e s/sh.*/sh/) 

256 

2971 HOSTOS := (Smell ueme cs NN ece le we 
2 Sys) Sed -e 's/N(ecygwinN)-*/ceygwimn/"') 
239 


240 export HOSTARCH HOSTOS 
第 227 行 定义 了 一 个 变量 HOSTARCH， 用 于 保存 主机 架构 ， 这 里 调用 shell 命令 “uname - 
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m” 获 取 架 构 名 称 ， 结 果 如 图 31.3.8.1 所 示 : 


: $ uname -m 
x86 64 
: $ 


图 31.3.8.1 uname -m 命令 
从 图 31.3.8.1 可 以 看 出 当前 电脑 主机 架构 为 “x86 64” shell 中 的 “|” 表 示 管 道 ， 意 思 是 将 
左边 的 输出 作为 右边 的 输入 ，sed -e 是 替换 命令 ，“sed -e s/i.86/x86/” 表 示 将 管道 输入 的 字符 串 


























中 的 “i.86” 蔡 换 为 “x86”, 其 他 的 “sed -s” 命 令 同 理 。 对 于 我 的 电脑 而 言 , HOSTARCH=x86 64。 
第 237 行 定义 了 变量 HOSTOS， 此 变量 用 于 保存 主机 OS 的 值 ， 先 使 用 shell 命令 “name - 
s” 来 获取 主机 OS， 结 果 如 图 31.3.8.2 所 示 : 


E $ uname -s 
Linux 
: su 


图 31.3.8.2 uname -s 命令 
从 图 31.3.8.2 可 以 看 出 此 时 的 主机 OS I“ Linux”, 使 用 管道 将 “Linux ”作为 后 面 “tr'[:upper:]' 
[lower] ”的 输入 ,，“tr'[:upper:]''[:lower:] ”表示 将 所 有 的 大 写字 母 蔡 换 为 小 写字 母 ， 因 此 得 到 
“linux”. 最 后 同样 使 用 管道 ， 将 “linux” 作 为 “sed -e's 人 (cygwin\).*/cygwin/'” 的 输入 ， 用 于 将 
cygwin.* 蔡 换 为 cygwin。 因 此 ，HOSTOS=linux。 
第 240 行 导出 HOSTARCH=x86 64，HOSTOS=linux。 


















































31.3.9 设置 目标 架构 、 交 又 编译 器 和 配置 文件 


编译 uboot 的 时 候 需 要 设置 目标 板 架 构 和 交叉 编译 器 ，“ make ARCH=arm 
CROSS_COMPILE=arm-linux-gnueabihf-” 就 是 用 于 设置 ARCH 和 CROSS COMPILE， 在 顶层 
Makefile 中 代码 如 下 : 
































示例 代码 31.3.9.1 顶层 Makefile 代码 

244 # set default to nothing for native builds 
245 ifeq ($(HOSTARCH),S (ARCH)) 
246 CROSS COMPILE ?= 
247 endif 
248 
249 KCONFIG CONFIG ?= .config 
250 export KCONFIG CONFIG 

第 245 行 判 断 HOSTARCH 和 ARCH 这 两 个 变量 是 否 相 等 , 主机 架构 (变量 HOSTARCH) 是 
x86_64， 而 我 们 编译 的 是 ARM 版 本 uboot， 肯 定 不 相等 ， 所 以 CROS COMPILE- arm-linux- 
gnueabihf-。 从 示例 代码 31.3.9.1 可 以 看 出 ， 每 次 编译 uboot 的 时 候 都 要 在 make 命令 后 面 设置 
ARCH 和 CROS COMPILE, 使 用 起 来 很 麻烦 ， 可 以 直接 修改 顶层 Makefile, 在 里 面 加 入 ARCH 
和 CROSS_COMPILE 的 定义 ， 如 图 31.3.9.1 所 示 : 












































„$ (ARCH) ) 


;= 


?= arm-Linux-gnueabihf- 


X [G ?= .config 
j export KCONFIG CONFIG 


图 31.3.9.1 定义 ARCH 和 CROSS. COMPILE 
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按照 图 31.3.9.1 所 示 , 直接 在 顶层 Makefile 里 面 定 义 ARCH 和 CROSS_COMPILE, 这 样 就 


























不 用 每 次 编译 的 时 候 都 要 在 make 命令 后 面 定义 ARCH 和 CROSS_COMPILE。 

第 249 行 定义 变量 KCONFIG CONFIG, uboot 是 可 以 配置 的 ， 这 里 设置 配置 文件 
为 .config，.config 默认 是 没有 的 ， 需 要 使 用 命令 “make xxx_defconfig” 对 uboot 进行 配置 ， 配 
置 完 成 以 后 就 会 在 uboot 根 目录 下 生成 .config。 默 认 情 况 下 .config 和 xxx. defconfig 内 容 是 一 样 
的 , 因为 .config 就 是 从 xxx. defconfig 复制 过 来 的 .如 果 后 续 自 行 调整 了 uboot 的 一 些 配置 参数 ， 
那么 这 些 新 的 配置 参数 就 添加 到 了 .config 中 ,而 不 是 xxx_defconfig。 相 当 于 xxx_defconfig 只 是 
一 些 初始 配置 ， 而 .config 里 面 的 才 是 实时 有 效 的 配置 。 












































31.3.10 调用 scripts/Kbuild.include 





E Makefile 会 调用 文件 scripts/Kbuild.include 这 个 文件 ， 顶 层 Makefile 中 代码 如 下 : 

示例 代码 31.3.10.1 顶层 Makefile 代码 

327 4 We need some generic definitions (do not try to remake the file). 
328 scripts/Kbuild.include: ; 

329 include scripts/Kbuild.include 


示例 代码 31.3.10.1 中 使 用 “include” 包 含 了 文件 scripts/Kbuild.include， 此 文件 里 面 定义 了 
很 多 变量 ， 如 图 31.3.10.1 所 示 : 

















DH 


t kbuild: Generic definitions 


# Convenient variables 
comma := ， 
quote := " 
squote := ' 
empty := 
| space := $ (empty) $ (empty) 


HH 
# Name of target with a '.' as filename prefix. foo/bar.o => foo/.bar.o 
dot-target = $(dir $80).$(notdir $8) 


HH 
t The temporary file to save gcc -MD generated dependencies must not 
# contain a comma 


depfile = $(subst $ (comma), ,$(dot-target).d) 


图 31.3.10.1 Kbuild.include 文件 
在 uboot 的 编译 过 程 中 会 用 到 scripts/Kbuild.include 中 的 这 些 变量 , 后 面 用 到 的 时 候 再 分 析 。 

















31.3.11 交叉 编译 工具 变量 设置 


上 面 我 们 只 是 设置 了 CROSS COMPILE 的 名 字 , 但 是 交叉 编译 器 其 他 的 工具 还 没有 设置 ， 

顶层 Makefile 中 相关 代码 如 下 : 
示例 代码 31.3.11.1 顶层 Makefile 代码 

331 # Make variables (CC, etc...) 
332 
2333 AS = $(CROSS_COMPILE)as 
334 # Always use GNU ld 
335 ifneq ($(shell $(CROSS_COMPILE)ld.bfd -v 2» /dev/null),) 
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E)lId.bfd 





E)ld 





I) exe 








E)ar 





E)nm 





E)ldr 





E)strip 





E) objcopy 
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336 LD = S$(CROSS COMPI 
337 else 

53:9 9 ID) = S(CROSS COMPI 
SSO em 

340 CC = s (CROSS COMPT 
341 CPP = $(CC) -E 

342 AR = S(CROSS COMPI 
343 NM = (CROSS COMPT 
344 LDR = S(CROSS COMPI 
SARS TERTRE = $ (CROSS COMPI 
346 OBJCOPY = S$(CROSS COMPI 
347 OBJDUMP = S$(CROSS COMPTII 





31.3.12. 导出 其 他 变量 












































E)objdump 





















































































































































接 下 来 在 顶层 Makefile 会 导出 很 多 变量 ， 代 码 如 下 : 
示例 代码 31.3.12.1 顶层 Makefile 代码 

368 export VERSION PATCHLEVEL SUBLEVEL UBOOTRELEASE UBOOTVERSION 
369 export ARCH CPU BOARD VENDOR SOC CPUDIR BOARDDIR 
370 export CONFIG SHELL HOSTCC HOSTCFLAGS HOSTLDFLAGS CROSS COMPILE AS 
nD CG 
371 export CPP AR NM LDR STRIP OBJCOPY OBJDUMP 
372 export MAKE AWK PERL PYTHON 
373 export HOSTCXX HOSTCXXFLAGS DTC CHECK CHECKFEFLAGS 
ZTA 
375 export KBUILD CPPFLAGS NOSTDINC FLAGS UBOOTINCLUDE OBJCOPYFLAGS 
LDFLAGS 
376 export KBUILD CFLAGS KBUILD AFLAGS 

这 些 变量 中 大 部 分 都 已 经 在 前 面 定义 了 ， 我 们 重点 来 看 一 下 下 面 这 几 个 变量 : 

ARCH CPU BOARD VENDOR SOC CPUDIR BOARDDIR 

ix 7 个 变量 在 顶层 Makefile 是 找 不 到 的 ， 说 明 这 7 个 变量 是 在 其 他 文件 里 面 定义 的 ， 先 来 
看 一 下 这 7 个 变量 都 是 什么 内 容 ， 在 顶层 Makefile 中 输入 如 图 31.3.12.1 所 示 的 内 容 : 





VERSION PATCHLEVEL SUBLEVEL 
ARCH CPU BOARD 





VENDOR 


SOC CPUDIR 








UBOOTRELEASE UBOOTVERSION 
BOARDDIR 


CONFIG SHELL HOSTCC HOSTCFLAGS HOSTLDFLAGS CROSS COMPILE AS LD CC 


CPP AR NM LDR 


STRIP 0BJCOPY OBJDUMP 


MAKE AWK PERL PYTHON 
HOSTCXX HOSTCXXFLAGS DTC CHECK CHECKFLAGS 


KBUILD CPPFLAGS NOSTDINC FLAGS UBOOTINCLUDE OBJCOPYFLAGS LDFLAGS 
KBUILD CFLAGS KBUILD AFLAGS 


@ 
@ 


TMAA 


make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- 





图 31.3.12.1 输出 变量 值 
修改 好 顶层 Makefile 以 后 执行 如 下 命令 : 





mytest 
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结果 如 图 31.3.12.2 所 示 : 


ARCH= arm 
CPU= armv7 
BOARD= mx6ullevk 
VENDOR- freescale 








SOC- mx6 
CPUDIR- arch/arm/cpu/armv7 
BOARDDIR- freescale/mx6ullevk 





图 31.3.12.2 变量 结果 
从 图 31.3.12.2 可 以 看 到 这 7 个 变量 的 值 ， 这 7 个 变量 是 从 哪里 来 的 呢 ? 在 uboot 根 目录 下 
有 个 文件 叫做 config.mk， 这 7 个 变量 就 是 在 config.mk 里 面 定义 的 ， 打 开 config.mk 内 容 如 下 : 
示例 代码 31.3.12.2 config.mk 代码 















































do 

A o (c) copyright 2000-2073 

3 4 Wolfgang Denk, DENX Software Engineering, wdGdenx.de. 

4 # 

5 # SPDX-License-Identifier: GPL-2.0+ 

6 # 

7 

FE E FE AE FE AE FE HE FE HE FE HE FE AE FE AE FE E FE AE FE AE FE AE FE AE FE AE TE AE FE AE FE FE FE FE FE E FE FE FE FE FE FE FE FE AE FE AE FE HE FE HE FE HE FE AE FE E AE HE AE HE TE HE E E E E E E 
Td 

8 


9 4 This file is included from ./Makefile and spl/Makefile. 
10 # Clean the state to avoid the same flags added twice. 

11 4 
12 # (Tegra needs different flags for SPL. 





13 # That's the reason why this file must be included from spl/Makefile 
too. 
14 $ If we did not have Tegra SoCs, build system would be much 
simpler...) 

15 PLATFORM RELFLAGS :- 

16 PLATFORM CPPFLAGS = 

17 PLATFORM LDFLAGS := 

18 LDFLAGS := 
19 LDFLAGS FINAL :- 

20 OBJCOPYFLAGS := 

21 $4 clear VENDOR for tcsh 

22 VENDOR := 

29 

FE E FE AE FE AE FE AE FE HE FE HE FE AE FE AE FE E FE AE FE AE FE AE FE AE FE AE FE AE FE AE FE FE FE E FE FE FE FE FE FE FE E FE FE HE FE HE FE AE FE HE FE AE FE AE FE E FE HE AE HE TE EE E E E E E E 
Td 

24 

25 ARCH :z $ (CONFIG SYS ARCH:"$"z-$£) 

26 CPU := $(CONFIG SYS CPU:"$"z$) 
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27 ifdef CONFIG SPL BUILD 
28 ifdef CONFIG TEGRA 




















29) (QU sc eun 20) 

30 endif 

31 endif 

32 BOARD := $ (CONFIG SYS BOARD: ""-$) 
33 ifneq ($(CONFIG SYS VENDOR),) 

34 VENDOR := $(CONFIG SYS VENDOR:"$"z$) 
35 endif 

36 ifneq ($(CONFIG SYS SOC),) 

37 SOC z= $(CONFIG SYS SOC:"$"-$) 

38 endif 

S9 


40 # Some architecture config.mk files need to know what CPUDIR is set 
EO 

41 $ so calculate CPUDIR before including ARCH/SOC/CPU config.mk files. 
42 $ Check if arch/SARCH/cpu/S$CPU exists, otherwise assume 
arch/SARCH/cpu contains 

43 4 CPU-specific code. 

44 CPUDIR-2arch/$(ARCH)/cpu$(if $(CPU),/$(CPU),) 

45 

46 sinclude $(srctree)/arch/$ (ARCH)/config.mk 

47 sinclude $(srctree)/$(CPUDIR)/config.mk 

48 

49 ifdef SOG 

50 sinclude $(srctree)/$(CPUDIR)/$(SOC)/config.mk 

51 endif 

52 ifneq ($(BOARD),) 

59 ifdef VENDOR 

54 BOARDDIR = $ (VENDOR) /$ (BOARD) 

55 else 

56 BOARDDIR 
57 endif 

58 endif 

5/9 eles BOARD 

60 sinclude $(srctree)/board/$ (BOARDDIR)/config.mk # include board 











$ (BOARD) 





specific rules 
61 endif 

62 

63 ifdef FTRAC 
64 PLATFORM CPPFLAGS 4- -finstrument-functions -DFTRACI 
65 endif 

66 


ER] 








Ral 
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67 4$ Allow use of stdint.h if available 

68 itneg ($(USE STDINT),) 

69 IDISESIBO SMOD DBINAGS Mb PCONE CRUS EDINE 

70 endif 

E 

qm 
IOHOHBEEHHBEHHBEHHEERBRERERRBREREHRBEHRHBRBRHRBRBRBRERRBRERERRBEBRHBERBHRHBRBRBRRBRRRER BG RH BERGER ERE 
p 

DE 

74 RELFLAGS := S(PLATFORM RELFLAGS) 

TRS 
76 PLATFORM CPPFLAGS T= $ (RELFLAGS) 
75 ISISGSUROSMMOEPDHBINAG SM -pipe 

78 
79 LDFLAGS += S(PLATFORM LDFLAGS) 
80 LDFLAGS FINAL t= —iBisiic et 3.6 

81 
82 export PLATFORM CPPFLAGS 

83 export RELFLAGS 

84 export LDFLAGS FINAL 

第 25 行 定 义 变量 ARCH, ， 值 为 $(CONFIG SYS ARCH:"%"=%) ， 也 就 是 提取 
CONFIG SYS ARCH 里 面 双 引 号 “” 之 间 的 内 容 。 比 如 CONFIG_SYS_ARCH=“arm” 的 话 ， 
ARCH=arm。 

第 26 行 定 义 变量 CPU， 值 为 $(CONFIG SYS_CPU:"%"=%)。 

第 32 行 定义 变量 BOARD， 值 为 (CONFIG SYS _ BOARD:"%"=%)。 

第 34 行 定义 变量 VENDOR， 值 为 $(CONFIG SYS VENDOR:"%"=%)。 

第 37 行 定义 变量 SOC， 值 为 $4(CONFIG _SYS_SOC:"%"=%)。 

第 44 行 定义 变量 CPUDIR， 值 为 arch/$(ARCH)/cpu$(if $(CPU),/$(CPU),)。 

第 46 行 sinclude 和 include 的 功能 类 似 ， 在 Makefile 中 都 是 读 取 指定 文件 内 容 ， 这 里 读 取 
文件 $(srctree)/arch/$(ARCH)/config.mk 的 内 容 。sinclude 读 取 的 文件 如 果 不 存 在 的 话 不 会 报错 。 

第 47 行 读 取 文 件 $(srctree)/$(CPUDIR)/config.mk 的 内 容 。 

第 50 行 读 取 文 件 $(srctree)/$(CPUDIR)/$(SOC)/configmk 的 内 容 。 

第 54 行 定 义 变 量 BOARDDIR ， 如 果 定 义 了 VENDOR 那么 
BOARDDIR-$(VENDOR)/S(BOARD), fill] BOARDDIR-S$(BOARD). 

第 60 4T ERO fS (sretree)/board/$(BOARDDIR J/config.mk . 

接 下 来 需要 找到 CONFIG SYS ARCH. CONFIG SYS CPU. CONFIG SYS BOARD, 
CONFIG SYS VENDOR 和 CONFIG SYS SOC 这 5 个 变量 的 值 。 这 5 个 变量 在 uboot 根 目录 
下 的 .config 文件 中 有 定义 ， 定 义 如 下 : 

示例 代码 31.3.12.3 .config 文件 代码 
23 CONFIG SYS ARCH-"arm" 
24 CONFIG SYS CPUs"armv7" 
25 CONFIG SYS SOC="mx6" 
26 CONFIG SYS VENDOR-2"freescale" 
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27 CONFIG SYS BOARD2"mx6ullevk " 
28 CONFIG SYS CONFIG NAME-"mx6ullevk" 
根据 示例 代码 31.3.12.3 HT AU: 
ARCH - arm 
CPU - armv7 
BOARD = mx6ullevk 
VENDOR - freescale 
SOC = mx6 
CPUDIR - arch/arm/cpu/armv7 
BOARDDIR = freescale/mx6ullevk 
在 config.mk 中 读 取 的 文件 有 : 
arch/arm/config.mk 
arch/arm/cpu/armv7/config.mk 
arch/arm/cpu/armv7/mx6/config.mk (此 文件 不 存在 ) 
board/ freescale/mx6ullevk/config.mk (此 文件 不 存在 ) 











T 














31.3.13 make xxx defconfig 过 程 





在 编译 uboot 之 前 要 使 用 “make xxx_defconfig” 命 令 来 配置 uboot， 那 么 这 个 配置 过 程 是 如 
何 运行 的 呢 ? 在 顶层 Makefile 中 有 如 下 代码 : 
示例 代码 31.3.13.1 顶层 Makefile 代码 段 


414 $ To make sure we do not include .config for any of the *config 








ICSUEOISES 
415 # catch them early, and hand them over to scripts/kconfig/Makefile 





416 4$ It is allowed to specify more targets when calling make, 
including 

417 4 mixing *config targets and build targets. 

418 4$ For example 'make oldconfig all'. 





419 $ Detect when mixed targets is specified, and make a second 





invocation 


420 # of make so .config is not included in this case either (for 








JOOME LE) a 

421 

422 version h := include/generated/version autogenerated.h 

423 timestamp h :- include/generated/timestamp autogenerated.h 
424 

425 no-dot-config-targets := clean clobber mrproper distclean \ 
426 help $docs check% coccicheck \ 

427 ubootversion backup 

428 

429 config-targets :- 0 

430 mixed-targets := 0 

431 dot-config := 1 

432 
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433 ifneq ($(filter $(no-dot-config-targets), S$(MAKECMDGOALS)),) 

434 ifeq (S$(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),) 
435 dot-config :-2 0 

436 endif 

437 endif 

438 

439 ifeq ($(KBUILD EXTMOD),) 

440 ifneq ($(filter config $config,$ (MAKECMDGOALS)),) 

441 config-targets := 1 

442 ifneq ($(words $ (MAKECMDGOALS)),1) 

443 mixed-targets := 1 

444 endif 

445 endif 

446 endif 

447 

448 ifeq ($(mixed-targets),1) 

MEE ================================================================ 


450 # We're called with mixed targets (*config and build targets). 
451 # Handle them one by one. 

452 

453 PHONY += $(MAKECMDGOALS) . build one by one 

454 

455 $(filter-out X build one by one, $ (MAKECMDGOALS)): 








. build one low one 

456 Q: 

457 

458 — build one by one: 
459 $(Q)set -e; ^ 








460 for i in S$(MAKECMDGOALS); do \ 

461 S(MAKE) -f $(srctree)/Makefile $$i; N 

462 done 

463 

464 else 

465 ifeq (S$(config-targets),1) 

466 4$ ———-—2-z2-z2-z2----l-lllllllllllllllllllll-l-l----------l-l-ll-ll-l-l-l----- 


467 4$ *config targets only - make sure prerequisites are updated, and 
descend 


468 4 in scripts/kconfig to make the *config target 














469 
470 KBUILD DEFCONFIG :- sandbox defconfig 
471 export KBUILD DEFCONFIG KBUILD KCONFIG 
472 


fl 





413 contigs seis basie outputmeaketile FORC 
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474 S$ (Q) $ (MAKE) $(build)sscripts/kconfig $8 

475 

476 $config: scripts basic outputmakefile FORCE 

Alg $ (Q) $ (MAKE) $(build)=scripts/kconfig $@ 

478 

479 else 

MN e ——————————————— 


481 # Build targets only - this includes vmlinux, arch specific 
targets, clean 

482 4 targets and others. In general all targets except *config 
TEGELS 

483 

Z9 tede (> (dot contig) r 1) 

485 # Read in config 

486 -include include/config/auto.conf 


第 422 行 定 义 了 变量 version h， 这 变量 保存 版 本 号 文件 ， 此 文件 是 自动 生成 的 。 文 人 
include/generated/version autogenerated.h 内 容 如 图 31.3.13.1 Bray: 








u HALMX 6\LMX 6UL\IMX6UL NXP UBOOT And LinwIMX6UL\uboot\uboot-imx-rel imx 4 1 15 2.10 ga alientekincludelgenerated Version autogenerated.h - Notepad ies a 

文件 (F) RRO RRSO RAV SAN) EAN EAM IAO) AM) 运行 (R) 插件 (P) 窗 D(W) ? x 
LENT 4 LEL E ERIE E EAE r REER 
Fei version_autogenerated. h EJ 

1 efine PLAIN VERSION "2016.03" 

#define U_BOOT_VERS ION "U-Boot " PLAIN VERSION 
*define CC VERSION STRING "arm-linux-gnueabihf-gcc (Linaro GCC 4.9-2017.01) 4.9.4" 

$define LD VERSION STRING "GNU ld (Linaro Binutils-2017.01) 2.24.0.20141017 Linaro 2014 11-3-git" 





























C++ source file length:260 lines:5 In:1 Col:1 Sel:0|0 Unix (LF) UTF-8 IN 


31.3.13.1 版 本 号 文件 
第 423 行 定义 了 变量 timestamp_h， 此 变量 保存 时 间 惟 文件， 此 文件 也 是 自动 生成 的 。 文 件 
include/generated/timestamp autogenerated.h 内 容 如 图 31.3.13.2 所 示 : 

















Si H:\I.MX 6\I.MX 6UL\IMX6UL NXP UBOOT And Linux\IMX6UL\uboot\ubo.. 一 口 X 
文件 (F) 编辑 (E) 搜索 (S$) 视图 (V) 编码 (N) 语言 (L) 设置 (D) 工具 (O) 宏 (M) 运行 (R) 插件 (P) 窗口 (W) 
? X 


BARGLAR 2ciaiwi «ia 10? 


3 timestamp autogenerated. h EJ 


fdefine U BOOT DATE "Apr 30 2019" 
Kdefine U BOOT TIME "10:32:58" 


Kdefine U BOOT TZ "+0800" 
define U BOOT DMI DATE "04/30/2019" 








length: 1;[n:1 Col:1 Sel:0[0 Unix (LF) UTF-8 
31.3.13.2 时 间 惟 文件 
第 425 行 定义 了 变量 no-dot-config-targets。 
第 429 行 定义 了 变量 config-targets， 初 始 值 为 0。 
第 430 行 定义 了 变量 mixed-targets， 初 始 值 为 0。 
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第 431 行 定义 了 变量 dot-config， 初 始 值 为 1。 
第 433 行将 MAKECMDGOALS 中 不 符合 no-dot-config-targets 的 部 分 过 滤 掉 ， 剩 下 的 如 果 











不 为 空 的 话 条 件 就 成 立 。MAKECMDGOALS 是 make 的 一 个 环境 变量 , 这 个 变量 会 保存 你 所 指 
定 的 终极 目标 列表 , 比如 执行 “make mx6ull alientek_emmc_defconfig” 那么 MAKECMDGOALS 
就 为 mx6ull alientek emmc defconfig. 很 明显 过 滤 后 为 空 , 所 以 条 件 不 成 立 , 变量 dot-config K 
HX 1. 

第 439 行 判断 KBUILD_EXTMOD 是 否 为 空 ,如 果 KBUILD_EXTMOD 为 空 的 话 条 件 成 立 ， 
经 过 前 面 的 分 析 ， 我 们 知道 KBUILD_EXTMOD 为 空 ， 所 以 条 件 成 立 。 

第 440 行将 MAKECMDGOALS 中 不 符合 “config” 和 “%config” 的 部 分 过 滤 掉 ， 如 果 剩 
下 的 部 分 不 为 空 条 件 就 成 立 ， 很 明显 此 处 条 件 成 立 ， 变 量 config-targets=1。 

第 442 行 统计 MAKECMDGOALS 中 的 单词 个 数 ， 如 果 不 为 1 的 话 条 件 成 立 。 此 处 调用 
Makefile 中 的 words 函数 来 统计 单词 个 数 ，words 函数 格式 如 下 : 

$(words <text>) 

很 明显 ，MAKECMDGOALS 的 单词 个 数 是 1 个 ， 所 以 条 件 不 成 立 ，mixed-targets 继续 为 
0。 综 上 所 述 ， 这 些 变量 值 如 下 ; 


config-targets — 1 












































mixed-targets — 0 

dot-config = 1 

第 448 行 如 果 变 量 mixed-targets 为 1 的 话 条 件 成 立 ， 很 明显 ， 条 件 不 成 立 。 

第 465 行 如 果 变 量 config-targets 为 1 的 话 条 件 成 立 ， 很 明显 ， 条 件 成 立 ， 执 行 这 个 分 文 。 

第 473 行 ， 没 有 目标 与 之 匹配 ， 所 以 不 执行 。 

第 476 行 ， 有 目标 与 之 匹配 ， 当 输入 “make xxx_defconfig” 的 时 候 就 会 匹配 到 %config H 
标 ， 目 标 “%config” 依 赖 于 scripts basic. outputmakefile 和 FORCE. FORCE 在 顶层 Makefile 
的 1610 行 有 如 下 定义 : 






































示例 代码 31.3.13.2 顶层 Makefile 代码 段 

1610 PHONY 4*- FORCE 
ENEORCE: 

可 以 看 出 FORCE 是 没有 规则 和 依赖 的 ， 所 以 每 次 都 会 重新 生成 FORCE。 当 FORCE 作为 
其 他 目标 的 依赖 时 ， 由 于 FORCE 总 是 被 更 新 过 的 ， 因 此 依赖 所 在 的 规则 总 是 会 执行 的 。 
依赖 scripts basic 和 outputmakefile 在 顶层 Makefile 中 的 内 容 如 下 : 

示例 代码 31.3.13.3 顶层 Makefile 代码 段 

394 4$ Basic helpers built in scripts/ 
395 PHONY -*- scripts basic 





























3:519 BCriptrs base: 





397 $ (Q) $ (MAKE) $(build)=scripts/basic 
SOS $(Q)rm -f .tmp quiet recordmcount 
899 


400 4 To avoid any implicit rule to kick in, define an empty command. 


A seripts/ basies: manie S MI SER ? 


403 PHONY += outputmakefile 
404 # outputmakefile generates a Makefile in the output directory, if 





405 # using a separate output directory. This allows convenient use of 
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406 4$ make in the output directory. 

407 outputmakefile: 

408 ifneq (S(KBUILD SRC),) 




















409 $(Q)1n -fsn $(srctree) source 

410 $(Q)S(CONFIG SHELL) $(srctree)/scripts/mkmakefile \ 
a. S$(srctree) $(objtree) S(VERSION) $(PATCHLEVEL) 
412 endif 




















第 408 fr. JB; KBUILD SRC 是 否 为 空 ， 只 有 变量 KBUILD SRC 不 为 空 的 时 候 
outputmakefile 才 有 意义 ， 经 过 我 们 前 面 的 分 析 KBUILD SRC 为 空 ， 所 以 outputmakefile 无 效 。 
只 有 scripts_basic 是 有 效 的 。 

第 396-398 行 是 scripts_basic 的 规则 , 其 对 应 的 命令 用 到 了 变量 Q. MAKE 和 build, 其 中 : 

Q=@ 或 为 空 

MAKE=make 

变量 build 是 在 scripts/Kbuild.include 文件 中 有 定义 ， 定 义 如 下 : 

示例 代码 31.3.13.3 Kbuild.include 代码 段 





























177 HH 
178 # Shorthand for $(0)$ (MAKE) -f scripts/Makefile.build obj= 
179 4 Usage: 
180 # $(Q)$(MAKE) $(build)-dir 
181 build :- -f $(srctree)/scripts/Makefile.build obj 
从 示例 代码 31.3.13.3 可 以 看 出 build—-f S(srctreey'scripts/Makefile.build obj, 经 过 前 面 的 分 析 
可 知 ， 变 量 srctree 为 ””， 因 此 : 
build=-f ./scripts/Makefile.build obj 
scripts basic 展开 以 后 如 下 : 
scripts basic: 
@make -f ./scripts/Makefile.build obj-scripts/basic ” // 也 可 以 没有 @， 视 配置 而 定 
@rm -f.tmp quiet recordmcount /也 可 以 没有 @ 
scripts basic 会 调用 文件 ./scripts/Makefile.build， 这 个 我 们 后 面 在 分 析 。 
接着 回 到 示例 代码 31.3.13.1 中 的 %config 处 ， 内 容 如 下 : 
%config: scripts basic outputmakefile FORCE 
$(Q)$(MAKE) $(build)-scripts/kconfig $(a) 
将 命令 展开 就 是 : 
@make -f ./scripts/Makefile.build obj-scripts/kconfig xxx  defconfig 
同样 也 跟 文件 ./scripts/Makefile.build 有 关 , 我 们 后 面 再 分 析 此 文件 ,使 用 如 下 命令 配置 uboot， 
并 观察 其 配置 过 程 : 
make mx6ull 14x14 ddr512 emmc defconfig V-1 
配置 过 程 如 图 31.3.13.1 所 示 : 
























































-f ./scripts/Makefile.build obj=scripts/basic 

.tmp quiet recordmcount 

-f ./scripts/Makefile.build obj-scripts/kconfig mx6ull 14x14 ddr512 emmc defconfig 
scripts/Kcontig/cont  --dercontig-arch/../contigs/mxoull 14x14 ddr512 emmc detconric Kconfig 


# 
# configuration written to .config 





图 31.3.13.1 uboot 配置 过 程 
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从 图 31.3.13.1 可 以 看 出 ， 我 们 的 分 析 是 正确 的 ， 接 下 来 就 要 结合 下 面 两 行 命令 重点 分 析 一 
下 文件 scripts/Makefile.build。 

(D. scripts basic 目标 对 应 的 命令 

@make -f ./scripts/Makefile.build obj=scripts/basic 

©, %config 目标 对 应 的 命令 

@make -f ./scripts/Makefile.build obj-scripts/kconfig xxx defconfig 























31.3.14 Makefile.build 脚本 分 析 


从 上 一 小 节 可 知 ,“make xxx defconfig“ 配 置 uboot 的 时 候 如 下 两 行 命令 会 执行 脚本 
scripts/Makefile.build: 

@make -f ./scripts/Makefile.build obj-scripts/basic 

@make -f ./scripts/Makefile.build obj-scripts/kconfig xxx defconfig 

依次 来 分 析 一 下 : 

1、scripts_basic 目标 对 应 的 命令 

scripts basic 目标 对 应 的 命令 为 : @make -f /scripts/Makefile.build obj=scripts/basic。 打 开 文 
ft scripts/Makefile.build， 有 如 下 代码 : 

示例 代码 31.3.14.1 Makefile.build 代码 段 

8 4 Modified for U-Boot 





9 prefix :- tpl 

10 src :-2 S$(patsubst $(prefix)/$,$,5$(0bj)) 
Tua ieee oto») 56) 

12 prefix :- spl 

13 sre := $(patsubst $(prefix)/$,$,5$(0bj)) 
14 ifeq ($(0bj),S$ (src)) 

15 prefix := . 

16 endif 

17 endif 

第 9 行 定义 了 变量 prefix 值 为 tpl。 

第 10 行 定义 了 变量 sre， 这 里 用 到 了 函数 patsubst， 此 行 代码 展开 

$(patsubst tpl/%,%, scripts/basic) 
patsubst 是 蔡 换 函 数 ， 格 式 如 下 ; 

S$(patsubst «pattern-,«replacement»,«text^) 

此 函数 用 于 在 text. 中 查找 符合 pattern 的 部 分 ， 如 果 匹 配 的 话 就 用 replacement. 蔡 换 掉 。 
pattenr 是 可 以 包含 通配符 “%”， 如 果 replacement 中 也 包含 通配符 “%?” 那么 replacement 中 的 
这 个 “%” 将 是 pattern 中 的 那个 “%” 所 代表 的 字符 串 。 函 数 的 返回 值 为 蔡 换 后 的 字符 串 。 因 
此 ， 第 10 行 就 是 在 “scripts/basic” 中 查找 符合 “tpl//%” 的 部 分 ， 然 后 将 “tpl/” 取 消 掉 ， 但 是 

“scripts/basic” 没 有 “tpl/”， 所 以 src= scripts/basic。 

第 11 行 判断 变量 obj 和 src 是 否 相 等 ， 相 等 的 话 条 件 成 立 ， 很 明显 ， 此 处 条 件 成 立 。 

第 12 行 和 第 9 行 一 样 ， 只 是 这 里 处 理 的 是 “spl”，“scripts/basic ”里面 也 没有 “spl/”， 所 以 
src 继续 为 scripts/basic 。 

第 15 行 因为 变量 obj 和 src 相等 ， 所 以 prefix=.。 

继续 分 析 scripts/Makefile.build， 有 如 下 代码 : 














F 











后 为 : 










































































pun 
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示例 代码 31.3.14.2 Makefile.build 代码 段 
56 4 The filename Kbuild has precedence over Makefile 





57 Mdexsllkek-ehise 2c Sus (er (Se) p (esee) n (sneeree)/ 8 (User) )) 
58 kbuild-file := $(if $(wildcard $(kbuild-dir)/Kbuild),$ (kbuild- 
dir)/Kbuild,$ (kbuild-dir)/Makefile) 
59 include $(kbuild-file) 

将 kbuild-dir 展开 后 为 : 

$Gf $(filter /%, scripts/basic), scripts/basic, ./scripts/basic), 
因为 没有 以 “/” 为 开头 的 单词 ， 所 以 $(filter /%，scripts/basic) 的 结果 为 空 ，kbuild- 
dir— /scripts/basic 。 

将 kbuild-file 展开 后 为 : 

$Gf $(wildcard ./scripts/basic/Kbuild), ./scripts/basic/Kbuild, ./scripts/basic/Makefile) 

为 scrpts/basic 目录 中 没有 Kbuild 这 个 文件 ， 所 以 kbuild-file= ./scripts/basic/Makefile。 最 
后 将 59 行 展开 ， 即 : 

include ./scripts/basic/Makefile 

也 就 是 读 取 scripts/basic 下 面 的 Makefile 文件 。 

继续 分 析 scripts/Makefile.build， 如 下 代码 : 

示例 代码 31.3.14.3 Makefile.build 代码 段 

116 build: (if S(KBUILD BUILTIN),$(builtin-target) S$(lib-target) 
$(extra-y)) \ 









































aig $(if S(KBUILD MODULES),$(obj-m) $(modorder-target)) i 
118 $(subdir-ym) S$(always) 
119 Q: 





. build 是 默认 目标 ， 因 为 命令 “@make -f /scripts/Makefile.build obj=scripts/basic ”没有 指 
定 目 标 ， 所 以 会 使 用 到 默认 目标 : _build。 在 顶层 Makefile 中 ，KBUILD BUILTIN 为 1， 
KBUILD MODULES 为 0， 因 此 展开 后 目标 _build Jy: 

. build:$(builtin-target) $(lib-target) $(extra-y)) $(subdir-ym) $(always) 

@: 

可 以 看 出 目标 _build 有 5 个 依赖 : builtin-target、lib-target、extra-y、subdir-ym 和 always. 
这 5 个 依赖 的 具体 内 容 我 们 就 不 通过 源码 来 分 析 了 ， 直 接 在 scripts/Makefile.build 中 输入 图 
31.3.14.1 所 示 内 容 ， 将 这 5 个 变量 的 值 打 印 出 来 : 






















































































图 31.3.14.1 输出 变量 





Titi 


执行 如 下 命令 : 
make mx6ull 14x14 ddr512 emmc defconfig V-1 
结果 如 图 31.3.14.2 所 示 : 
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make -f ./scripts/Makefile.build obi=scripts/basic 

builtin-target = 

lib-target = 

extra-y = 

subdir-ym = 

always = scripts/basic/fixdep 

rm -T .tmp quiet recordmcount 

make -f ./scripts/Makefile.build objsscripts/kconfig mx6ull alientek emmc defconfig 
scripts/kconfig/conf  --defconfig-arch/../configs/mx6ull alientek emmc defconfig Kconfig 
# 


# configuration written to .config 
# 





图 31.3.14.2 输出 结 
从 上 图 可 以 看 出 ， 只 有 always 有 效 ， 因 此 _build RX: 
. build: scripts/basic/fixdep 
(Q): 
_ build 依赖 于 scripts/basic/fixdep， 所 以 要 先 scripts/basic/fixdep.c 编译 ， 生 成 fixdep， 前 
已 经 读 取 了 scripts/basic/Makefile 文件 。 
综 上 所 述 ，scripts_basic 目标 的 作用 就 是 编译 出 scripts/basic/fixdep 这 个 软件 。 


2、%config 目标 对 应 的 命令 


%config 目标 对 应 的 命令 为 : @make -f ./scripts/Makefile.build obj=scripts/kconfig 
Xxx_defconfig， 各 个 变量 值 如 下 : 

Src= scripts/kconfig 

kbuild-dir = ./scripts/kconfig 

kbuild-file = ./scripts/kconfig/Makefile 

include ./scripts/kconfig/Makefile 

可 以 看 出 ，Makefilke.build 会 读 取 scripts/kconfig/Makefile 中 的 内 容 ， 此 文件 有 如 下 所 示 内 















































T 


示例 代码 31.3.14.4 scripts/kconfig/Makefile 代码 段 
113 $ defconfig: $(obj)/conf 


IA $(Q)$« $(silent) --defconfigzarch/$ (SRCARCH)/configs/$G 
$ (Kconfig) 
EIUS 


116 4 Added for U-Boot (backward compatibility) 
117 a COMEL 55 OS 
118 Q: 

HER% defconfig 刚好 和 我 们 输入 的 xxx defconfig 匹配 ， 所 以 会 执行 这 条 规则 。 依 赖 为 
$(obj)/conf， 展 开 后 就 是 scripts/kconfig/conf。 接 下 来 就 是 检查 并 生成 依赖 scripts/kconfig/conf. 
conf 是 主机 软件 ， 到 这 里 我 们 就 打住 ， 不 要 纠结 conf 是 怎么 编译 出 来 的 ， 否 则 就 越 陷 越 深 ， 太 
IRT, 像 conf 这 种 主机 所 使 用 的 工具 类 软件 我 们 一 般 不 关心 它 是 如 何 编译 产生 的 。 如 果 一 定 要 
看 是 conf 是 怎么 生成 的 ， 可 以 输入 如 下 命令 重新 配置 uboot， 在 重新 配置 uboot 的 过 程 中 就 会 
输出 conf 编译 信息 。 

make distclean 

make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- mx6ull 14x14 ddr512 emmc 
defconfig V-1 
结果 如 图 31.3.14.3 所 示 : 
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cc -o scripts/kconfig/conf scripts/kconfig/conf.o scripts/kconfig/zconf .tab.o 
scripts/kconfig/conf  --defconfig-arch/../configs/mx6ull 14x14 ddr512 emmc defconfig Kconfig 
# 
# configuration written to .config 
# 





3 | 


图 31.3.14.3 编译 过 程 

得 到 scripts/kconfig/conf 以 后 就 要 执行 目标 %_defconfig 的 命令 : 

$(Q)$< S(silent) --defconfig=arch/$(SRCARCH)/configs/$@ $(Kconfig) 

相关 的 变量 值 如 下 : 

silent--s 或 为 空 

SRCARCH=.. 

Kconfig-Kconfig 

将 其 展开 就 是 : 

(à) scripts/kconfig/conf --defconfig-arch/../configs/xxx defconfig Kconfig 

上 述 命令 用 到 了 xxx defconfig 文件 ， 比 如 mx6ull alientek emmc _defconfig。 这 里 会 将 
mx6ull alientek emmc defconfig 中 的 配置 输出 到 .config 文件 中 ， 最 终生 成 uboot 根 目录 下 
的 .config 文件 。 

这 个 就 是 命令 make xxx defconfig 执行 流程 ， 总 结 一 下 如 图 31.3.14.4 所 示 : 


i scripts basic L--9 make -f ./scripts/Makefile.build obj7scripts/basic 





















































v 
-| 依赖 outputmakefile 生成 : scripts/basic/fixdep 























~ FORCE 
顶层 Makefile 


make xxx defconfig | %config < 



































S [命令 |--Pmake -f ./scripts/Makefile. build obj=scripts/kconfig xxx defconfig 
Y 
生成 : scripts/kconf i g/conf 
命令 : scripts/kconfig/conf —-defconfig-arch/.. /configs/xxx defconfig Kconfig 


v 
生成 : .config 


图 31.3.14.4 make xxx_defconfig 执行 流程 图 


至 此 ，make xxx defconfig 就 分 析 完 了 ， 接 下 来 就 要 分 析 一 下 u-bootbin 是 怎么 生成 的 了 。 











31.3.15 make 过 程 


配置 好 uboot 以 后 就 可 以 直接 make 编译 了 ， 因 为 没有 指明 目标 ， 所 以 会 使 用 默认 目标 , 主 
Makefile 中 的 默认 目标 如 下 : 








示例 代码 31.3.15.1 顶层 Makefile 代码 段 
128 # That's our default target when none is given on the command line 
129 PHONY := all 
TSOEN: 
目标 _all 又 依赖 于 all， 如 下 所 示 ; 
示例 代码 31.3.15.2 顶层 Makefile 代码 段 
194 # If building an external module we do not care about the all: rule 


195 £ but instead all depend on modules 
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196 PHONY += all 
197 ifeq ($(KBUILD EXTMOD),) 
Jo. eae Gul 
199 else 
PODES Mme 
201 endif 

如 果 KBUILD EXTMOD 为 空 的 话 al 依赖 与 al。 这 里 不 编译 模块 ， 所 以 
KBUILD EXTMOD 肯定 为 空 ，_all 的 依赖 就 是 al。 在 主 Makefile 中 all. 目标 规则 如 下 : 

示例 代码 31.3.15.2 顶层 Makefile 代码 段 













































































02. ES $ (ALL-y) 

803 ifneq ($(CONFIG SYS GENERIC BOARD),y) 

804 Qecho " WARNING » 
805 Qecho "Please convert this board to generic board." 

806 Qecho "Otherwise it will be removed by the end of 2014." 

807 Qecho "See doc/README.generic-board for further information" 
808 Qecho " A 
809 endif 

810 ifeq ($(CONFIG DM I2C COMPAT), y) 

811 Qecho " WARNING E 
812 Eee 
91/9 Qecho "(possibly in a subsequent patch in your series)" 

814 Qecho "before sending patches to the mailing list." 

S15 Qecho " E 
816 endif 





从 802 行 可 以 看 出 ，all 目标 依赖 $(ALL-y)， 而 在 顶层 Makefile H, ALL-y 如 下 : 
示例 代码 31.3.15.3 顶层 Makefile 代码 段 
730 # Always append ALL so that arch config.mk's can add custom ones 
731 ALL-y -*- u-boot.srec u-boot.bin u-boot.sym System.map u-boot.cfg 
binary size Check 
132 
733 ALL-S$(CONFIG ONENAND U BOOT) += u-boot-onenand.bin 
734 ifeq ($(CONFIG SPL FSL PBL),y) 
735 ALL- (CONFIG RAMBOOT PBL) += u-boot-with-spl-pbl.bin 
736 else 
737 ifneq ($(CONFIG SECURE BOOT), y) 
































738 # For Secure Boot The Image needs to be signed and Header must also 
739 4 be included. So The image has to be built explicitly 

740 ALL-$(CONFIG RAMBOOT PBL) t- u-boot.pbl 

741 endif 

742 endif 

743 ALL-S(CONFIG SPL) -*- spl/u-boot-spl.bin 

744 ALL-$ (CONFIG SPL FRAMEWORK) += u-boot.img 

745 ALL-S(CONFIG TPL) -*- tpl/u-boot-tpl.bin 
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746 
747 
748 
749 
750 
v: 
T52 
T52 
754 
TS) 
756 
TESINI 
TES; 
159 
760 
761 
762 
763 
764 
765 
766 
761 
768 
TOSS; 
"10 
Jana 


System.map. u-boot.cfg 和 binary size check 这 几 个 文件 。 根据 uboot 的 配置 情况 也 可 能 包含 其 











ALL-$(CONFIG OF SEPARATE) += 
ifeq ($(CONFIG SPL 


FRAMEWORK 











jL-S$ (CONFIG OF S 





EPARATE) += 





B 
A 
endif 
A 








ndif 











L-S$(CONFIG OF HOSTFILE) += 
ifneq ($(CONFIG SPL TARGET), 




















jL-S(CONFIG EFI A 























L 
A 
= 
ALL-$ (CONFIG REMAKE . 
A 
A 





ifneq ($(BUILD ROM),) 





ALL-$(CONFIG X86 RE 














endif 
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eelesciae 


) ,1y) 
Ubit = le bn] 


uui -looxore «eh 
) 


jL-$(CONFIG SPL) += $(CONFIG SPL TARGET:"£"-$) 





ELF) += u-boot.elf 
PP) += u-boot-app.efi 
L-S$(CONFIG EFI STUB) += u-boot-payload.efi 


SET VECTOR) += u-boot.rom 


# enable combined SPL/u-boot/dtb rules for tegra 
ifeq ($ (CONFIG TEGRA)$(CONFIG SPL),yy) 





ALL-y -*- u-boot-tegra.bin u-boot-nodtb-tegra.bin 




















ALL-$(CONFIG OF SEPARATE) += 








endif 


# Add optional build targe 
ifneq ($(CONFIG BUILD TARG 
ALL-y += S(CONFIG BUILD TARG 


endif 


从 示例 代码 代码 31.3.15 


他 的 文件 ， 比 如 : 
ALL-$(CONFIG ONENAND U BOOT)+= u-boot-onenand.bin 

CONFIG ONENAND U BOOT 就 是 uboot 中 跟 ONENAND 配置 有 关 的 ， 如 果 我 们 使 能 
ONENAND,， 那么 在 .config 配置 文件 中 就 会 有 “CONFIG_ ONENAND U BOOT=y” 这 一 句 。 相 
当 于 CONFIG. ONENAND U BOOT 是 个 变量 ， 这 个 变量 的 值 为 “y”， 所 以 展开 以 后 就 是 : 


顶层 Makefile 或 者 其 他 Makefile 中 调用 这 些 变量 。 





ALL-y += u-boot-onenand.bin 
这 个 就 是 .config 里 面 的 配置 参数 

















.3 可 以 看 出 ， 






































u-boot-dtb-tegra.bin 


t if defined in board/cpu/soc headers 
ET),) 





ET: "%"=%) 


ALL-y 包含 u-bootsrec. u-boot.bin, u-boot.sym, 



























































的 含义 ， 这 些 参数 其 实 都 是 变量 ， 后 面 跟着 变量 值 ， 会 在 











ALL-y 里 面 有 个 u-boot.bin， 这 个 就 是 我 们 最 终 需 要 的 uboot 二 进 制 可 执行 文件 ， 所 作 的 所 
有 工作 就 是 为 了 它 。 在 顶层 Makefile 中 找到 u-boot.bin 目标 对 应 的 规则 ， 如 下 所 示 : 
示例 代码 31.3.15.4 顶层 Makefile 代码 段 























825 ifeq ($ (CONFIG OF SEPARATE), y) 


826 
827 
828 


u-boot-dtb.bin: u-boot-nodtb.bin dts/dt.dtb FORCE 


Seul if cnang 











ed cat) 
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SORT Wooo —elielo o let. ORCE 





830 $(call if changed,copy) 
831 else 
532 U-boot- oim qw-loxexot-oexcllo lox KORCE 





93s $(call if changed,copy) 
834 endif 

第 825 行 判断 CONFIG OF SEPARATE 是 否 等 于 y， 如 果 相 等 ， 那 条 件 就 成 立 ， 在 .config 
中 搜索 “CONFIG OF SEPARAT”， 没 有 找到 ， 说 明 条 件 不 成 立 。 

第 832 行 就 是 目标 u-boot.bin 的 规则 , 目标 u-boot.bin 依赖 于 u-boot-nodtb.bin, 命令 为 $(call 
if changed,copy) ， ix 里 调用 了 if changed, if changed 是 一 个 函数 ， 这 个 函数 在 
scripts/Kbuild.include 中 有 定义 ， 而 顶层 Makefile 中 会 包含 scripts/Kbuild.include 文件 ， 这 个 前 
面 已 经 说 过 了 。 

if changed 在 Kbuild.include 中 的 定义 如 下 : 

示例 代码 31.3.15.5 Kbuild.include 代码 段 






































226 ### 

227 s LE changea - execute command if any prerequisite is newer than 
228 f target, or command line has changed 

225 sr inr clwewwsyec! dep — as it Changed, but uses ixelej to reysal 

230 # dependencies including used config symbols 

250 s; iE changet! rule = as ii changed but execute rule instead 

232 # See Documentation/kbuild/makefiles.txt for more info 

299 





234 ifneq ($(KBUILD NOCMDDEP),1) 

235 4 Check if both arguments has same arguments. Result is empty 
string if equal. 

236 4 User may override this check using make KBUILD NOCMDDEP-1 
237 arg-check = $(strip S$(filter-out $(cmd $(1)), $(cmd $80)) * 








238 $(filter-out $(cmd $0),  $(cmd $(1))) ) 

239 else 

240 arg-check = $(if S(strip $(cmd $0)),,1) 

241 endif 

242 

243 $ Replace >$< with »$$« to preserve $ when reloading the .cmd file 





244 


十 


(needed for make) 





245 $ Replace >#< with >\#< to avoid starting a comment in the .cmd 
file 
246 4 (needed for make) 

247 $ Replace »'« with >'\''< to be able to enclose the whole string in 


Y Y 








248 4 (needed for the shell) 

249 make-cmd = $(call escsq,$(subst ME,NNNE,$ (subst 
$$,95$5$,$(emd $ (1))))) 

250 


760 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


251 4 Find any prerequisites that is newer than target or that does not 


exist. 

252 4 PHONY targets skipped in both cases. 

253 any-prereq = $(filter-out $(PHONY),$?) S(filter-out $(PHONY) 
S((uwxLlleleeusol S^» SS) 

254 


255 4 Execute command if command has changed or prerequisite(s) are 





updated. 

256 4 

257 if changed = $(if $(strip $(any-prereq) $(arg-check)), wN 

258 QGset -e; N 

259 $(echo-cmd) $(cmd $(1)); N 

260 printf '$sWMn' 'cmd $80 :- $(make-cmd)' » $(dot-target).cmd) 
ZI 








第 227 行为 if changed 的 描述 ， 根 据 描述 ， 在 一 些 先决 条 件 比 目 标 新 的 时 候 ， 或 者 命令 行 
有 改变 的 时 候 ，if_changed 就 会 执行 一 些 命令 。 

第 257 行 就 是 函数 if changed, if changed 函数 引用 的 变量 比较 多 ， 也 比较 绕 ， 我 们 只 需要 
知道 它 可 以 从 u-boot-nodtb.bin 生成 u-boot.bin 就 行 了 。 

既然 u-boot.bin 依赖 于 u-boot-nodtb.bin， 那 么 肯定 要 先生 成 u-boot-nodtb.bin 文件 ， 顶 层 
Makefile 中 相关 代码 如 下 : 

















7 











7 


示例 代码 31.3.15.6 顶层 Makefile 代码 段 
Hce wicloxoxenc-swoxelilo lesus S ood FORCE 


























867 $(call if changed,objcopy) 
868 $(call DO STATIC RELA,$€,$G,$(CONFIG SYS TEXT BASE)) 
869 $(BOARD SIZE CHECK) 

目标 u-boot-nodtb.bin 又 依赖 于 u-boot， 顶 层 Makefile 中 u-boot 相关 规则 如 下 : 


示例 代码 31.3.15.7 顶层 Makefile 代码 段 
1170 u-boot: $(u-boot-init) $(u-boot-main) u-boot.lds FORCE 
zt nal $(call if changed,u-boot ) 
1172 ifeq ($(CONFIG KALLSYMS), y) 
TES $(call emd,smap) 





1174 $(call cmd,u-boot ) common/system map.o 
le moe 

目标 u-boot 依赖 于 u-boot init, u-boot-main 和 u-boot.lds, u-boot init 和 u-boot-main 是 两 个 
变量 ， 在 顶层 Makefile 中 有 定义 ， 值 如 下 : 

示例 代码 31.3.15.8 顶层 Makefile 代码 段 

678 u-boot-init = $(head-y) 
G7 oor mem sols sy) 

$(head-y) 跟 CPU 架构 有 关 ， 我 们 使 用 的 是 ARM 蕊 片 ， 所 以 head-y 在 arch/arm/Makefile 中 
被 指定 为 : 

head-y := arch/arm/cpu/$(CPU)/start.o 

根据 31.3.12 小 节 的 分 析 ， 我 们 知道 CPU=armv7， 因 此 head-y 展开 以 后 就 是 : 

head-y := arch/arm/cpu/armv7/start.o 
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因此 : 
u-boot-init- arch/arm/cpu/armv7/start.o 
$(ibs-y) 在 顶层 Makefile 中 被 定义 为 uboot 所 有 子 目录 下 build-in.o 的 集合 ， 代 码 如 下 : 
示例 代码 31.3.15.9 顶层 Makefile 代码 段 








620 libs-y += lib/ 

621 libs-$(HAVE VENDOR COMMON LIB) += board/$ (VENDOR) /common/ 
622 libs-$ (CONFIG OF EMBED) += dts/ 

623 libs-y += fs/ 

624 libs-y 42 net/ 

625 libs-y 42 disk/ 

626 libs-y += drivers/ 

627 libs-y += drivers/dma/ 





























628 libs-y += drivers/gpio/ 

629 libs-y += drivers/i2c/ 

660 libs-y += cmd/ 

661 libs-y += common/ 

662 libs-S$(CONFIG API) += api/ 

663 libs-S$(CONFIG HAS POST) += post/ 
664 libs-y += test/ 

665 libs-y += test/dm/ 

666 libs-S(CONFIG UT ENV) += test/env/ 








667 

668 libs-y += $(if $(BOARDDIR),board/$ (BOARDDIR)/) 

669 

$70 es se Sei (es yy) 

GEI 

672 u-boot-dirs := $(patsubst $/,$,$(filter $/, $S(libs-y))) tools 
examples 

673 

674 u-boot-alldirs := $ (sort $(u-boot-dirs) 

$(patsubst $/,$,$(filter $/, $(libs-)))) 

ONIS 

676 libs-y := S$(patsubst $/, $/built-in.o, $(libs-y)) 














从 上 面 的 代码 可 以 看 出 ，libs-y 都 是 uboot 各 子 目 录 的 集合 ， 最 后 : 

libs-y := $(patsubst %/, %/built-in.o, $(libs-y)) 

这 里 调用 了 函数 patsubst， 将 libs-y 中 的 “/” 替 换 为 ”Wbuilt-in.o”， 比 如 “drivers/dma/” 就 变 
JJ T *drivers/dma/built-in.o", 相当 于 将 libs-y 改 为 所 有 子 目 录 中 built-in.o 文件 的 集合 。 那 么 u- 
boot-main 就 等 于 所 有 子 目 录 中 built-in.o 的 集合 。 

这 个 规则 就 相当 于 将 以 u-boot.lds 为 链接 脚本 ， 将 arch/arm/cpu/armv7/start.o 和 各 个 子 目 录 
下 的 built-in.o 链接 在 一 起 生成 u-boot。 

u-boot.lds 的 规则 如 下 : 

示例 代码 31.3.15.10 顶层 Makefile 代码 段 
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u-boot.lds: S$(LDSCRIPT) prepare FORCI 





[E] 


$(call if changed dep,cpp 1ds) 
接 下 来 的 重点 就 是 各 子 目 录 下 的 built-in.o 是 怎么 生成 的 ， 以 drivers/gpio/built-in.o 为 例 , 在 
drivers/gpio/ 目 录 下 会 有 个 名 为 .built-in.o.cmd 的 文件 ， 此 文件 内 容 如 下 : 
示例 代码 31.3.15.11 drivers/gpio/.built-in.o.cmd 代码 


1 cmd drivers/gpio/built-in.o := arm-linux-gnueabihf-ld.bfd = o 














drivers/gpio/built-in.o drivers/gpio/mxco gpio.o 

从 命令 “cmd _ drivers/gpio/built-in.o” 可 以 看 出 ，drivers/gpio/built-in.o 这 个 文件 是 使 用 1d 命 
令 由 文件 drivers/gpio/mxc_gpio.o 生成 而 来 的 ，mxc_gpio.o 是 mxc_gpio.c 编译 生成 的 .o 文件 ， 
这 个 是 NXP 的 IMX 系列 的 GPIO 驱动 文件 。 这 里 用 到 了 Id 的 “-r” 参 数 ， 参 数 含 义 如 下 : 

-r-relocateable: 产生 可 重 定向 的 输出 ， 比 如 ， 产 生 一 个 输出 文件 它 可 再 次 作为 “ld” 的 输 
入 ， 这 经 常 被 叫做 “部 分 链接 ”， 当 我 们 需要 将 儿 个 小 的 .o 文件 链接 成 为 一 个 .o 文件 的 时 候 ， 需 
要 使 用 此 选项 。 

最 终 将 各 个 子 目 录 中 的 built-in.o 文件 链接 在 一 起 就 形成 了 u-boot, 使 用 如 下 命令 编译 uboot 
就 可 以 看 到 链接 的 过 程 : 

make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- mx6ull 14x14 ddr512 emmc 
defconfig V-1 

make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- V=1 

编译 的 时 候 会 有 如 图 31.3.15.1 所 示 内 容 输出 : 


































































































pe 








arm-linux-gnueabihf-ld.bfd -pie --gc-sections -Bstatic -Ttext 0x87800000 -o u-boot -T u-boot.lds arch/ar 
m/cpu/armv7/start.o --start-group arch/arm/cpu/built-in.o arch/arm/cpu/armv7/built-in.o arch/arm/imx-commo 
n/built-in.o arch/arm/lib/built-in.o board/freescale/common/built-in.o board/freescale/mx6ull_alientek_emm 
c/built-in.o cmd/built-in.o common/built-in.o disk/built-in.o drivers/built-in.o drivers/dma/built-in.o 

drivers/gpio/built-in.o drivers/i2c/built-in.o drivers/mmc/built-in.o drivers/mtd/built-in.o drivers/mtd 
/onenand/built-in.o drivers/mtd/spi/built-in.o drivers/net/built-in.o drivers/net/phy/built-in.o drivers/ 
pci/built-in.o drivers/power/built-in.o drivers/power/battery/built-in.o drivers/power/fuel_gauge/built-in 


.0 drivers/power/mfd/built-in.o drivers/power/pmic/built-in.o drivers/power/regulator/built-in.o drivers/ 
serial/built-in.o drivers/spi/built-in.o drivers/usb/dwc3/built-in.o drivers/usb/emul/built-in.o drivers/ 
usb/eth/built-in.o drivers/usb/gadget/built-in.o drivers/usb/gadget/udc/built-in.o drivers/usb/host/built- 
in.o drivers/usb/musb-new/built-in.o drivers/usb/musb/built-in.o drivers/usb/phy/built-in.o drivers/usb/u 
lpi/built-in.o fs/built-in.o lib/built-in.o net/built-in.o test/built-in.o test/dm/built-in.o --end-grou 
p arch/arm/lib/eabi compat.o -L /usr/local/arm/gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf/bin/../li 
b/gcc/arm-linux-gnueabihf/4.9.4 -lgcc -Map u-boot.map 


图 31.3.15.1 编译 内 容 输 H 














LC 

















将 其 整理 一 下 ， 内 容 如 下 : 
arm-linux-gnueabihf-ld.bfd ^ -pie --gc-sections -Bstatic -Ttext 0x87800000 ^ 
-o u-boot -T u-boot.lds V 

arch/arm/cpu/armv 7/start.o \ 

--start-group — arch/arm/cpu/built-in.o V 
arch/arm/cpu/armv 7/built-in.o ^ 
arch/arm/imx-common/built-in.o \ 
arch/arm/lib/built-in.o V 
board/freescale/common/built-in.o V 
board/freescale/mx6ull alientek emmco/built-in.o \ 
cmd/built-in.o \ 

common/built-in.o \ 

disk/built-in.o ^ 

drivers/built-in.o * 

drivers/dma/built-in.o \ 

drivers/gpio/built-in.o \ 
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drivers/spi/built-in.o \ 
drivers/usb/dwc3/built-in.o * 
drivers/usb/emul/built-in.o  * 
drivers/usb/eth/built-in.o \ 
drivers/usb/gadget/built-in.o \ 
drivers/usb/gadget/udc/built-in.o ^ 
drivers/usb/host/built-in.o \ 
drivers/usb/musb-new/built-in.o \ 
drivers/usb/musb/built-in.o. * 
drivers/usb/phy/built-in.o. * 
drivers/usb/ulpi/built-in.o — V 
fs/built-in.o \ 

lib/built-in.o \ 

net/built-in.o \ 

test/built-in.o \ 
test/dm/built-in.o \ 


论坛 :www.opendev.com 


--end-group arch/arm/lib/eabi compat.o \ 


-L /usr/local/arm/gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf/bin/. /lib/gcc/arm-linux- 


gnueabihf/4.9.4 -lgcc -Map u-boot.map 











可 以 看 出 最 终 是 用 arm-linux-gnueabihf-Id.bfd 命令 将 arch/arm/cpu/armv7/start.o 和 其 他 众多 


的 built in.o 链接 在 一 起 ， 形 成 u-boot。 











目标 all 除了 u-boot.bin 以 外 还 有 其 他 的 依赖 , 比如 u-boot.srec 、u-boot.sym 、System.map、 


u-boot.cfg 和 binary size check 等 等 ， 


这 些 依 赖 的 生成 方法 和 u-boot.bin 很 类 似 ， 大 家 自行 查看 











一 下 顶层 Makefile， 我 们 就 不 详细 的 讲解 了 。 








总 结 一 下 “make” 命 令 的 流程 ， 如 








图 31.3.15.2 所 示 : 
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A u-boot. srec 
依赖 依赖 
u-boot. bin | ^ u-boot-nodtb. bin E u-boot E 
u-boot. sym 
命令 默认 目标 依赖 依赖 
make all all ALL-y System. map 
u-boot. cfg 
binary size check 
\ “其 他 配置 依赖 
最 终 的 文件 变量 依赖 
arch/arm/cpu/armv7/start.o 时 head-y i u-boot-init EN 











test/dm/built-in.o 
arch/arm/lib/eabi compat.o 


arch/arm/cpu/built- 
arch/arm/cpu/armv7/built-in.o 

arch/arm/imx-common/built-in.o 

arch/arm/lib/built- 








in.o 


-— 
I «—| libs-y i u-boot-main 





in.o L^ 




















图 31.3.15.2 





图 31.3.15.2 就 是 “make” 命 令 的 执行 流程 
点 是 “make xxx_defconfig” 和 “make” 这 两 个 命令 的 执行 流程 : 
日 于 配置 uboot， 这 个 命 
要 工作 就 是 生成 二 进 
些 与 uboot 有 关 的 文件 ， 比 如 u-boot.imx 等 等 。 








make xxx defconfig: H 
make: 用 于 编译 uboot， 这 个 命令 的 


E 


BEDS 




















make 命令 流程 


关于 uboot 的 顶层 Makefile 就 分 析 到 这 


x H 





IT 
Cy 





Ts 
其 他 的 一 


命令 最 主要 的 目的 就 是 生成 .config X 
HÉJ u-boot.bin 文件 和 























已， 有 些 内 容 我 们 没有 详细 、 深 入 的 去 研究 ， 因 为 














关于 uboot 的 顶层 Makefile 就 分 析 到 这 里 
我 们 的 重点 是 使 用 
体 的 实现 ， 有 兴趣 的 可 以 参考 一 下 其 他 资料 。 








uboot， 而 不 是 uboot 的 研究 者 ， 我 们 要 做 的 是 缕 清 











H uboot 的 流程 。 至 于 更 具 
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第 三 十 二 章 U-Boot 启动 流程 详解 


上 一 章 我 们 详细 的 分 析 了 uboot 的 顶层 Makefile, 理 清 了 uboot 的 编译 流程 。 本 章 我 们 来 详 











细 的 分 析 一 下 uboot 的 启动 流程 ， 理 清 uboot 是 如 何 启动 的 。 通 过 对 uboot 启动 流程 的 梳理 ,我 
们 就 可 以 掌握 一 些 外 设 是 在 哪里 被 初始 化 的 ， 这 样 当 我 们 需要 修改 这 些 外 设 驱 动 的 时 候 就 会 心 
里 有 数 。 另 外 ， 通 过 分 析 uboot 的 启动 流程 可 以 了 解 Linux. 内 核 是 如 何 被 启动 的 。 
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32.1 链接 脚本 u-boot.lds 详解 
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要 分 析 uboot 的 启动 流程 ， 首 先 要 找到 “入 口 ” 找到 第 一 行程 序 在 哪里 。 程 序 的 链接 是 由 




















链接 脚本 来 决定 的 ， 所 以 通过 链接 脚本 可 以 找到 程序 的 入 口 。 如 果 没 有 编译 过 uboot 的 话 链 接 
脚本 为 arch/arnvcpu/u-boot.lds。 但 是 这 个 不 是 最 终 使 用 的 链接 脚本 ， 最 终 的 链接 脚本 是 在 这 个 
链接 脚本 的 基础 上 4 
文件 








config.mk 


H © © 





S 
{ 


(Uo e oa a E WO IE 


e re hnPeHKHHEH 
50 N o 


S 
16 
JT 
18 
HS 
20 
2a 
22 
25 
24 
25 




















成 的 。 编 译 一 下 uboot, 编译 完成 以 后 就 会 在 uboot 根 目 录 下 生成 u-boot.lds 
图 32.1.1 所 示 : 


-boot .cfg 
Kbuild Makefile snapshot.commit -boot.imx 
Kconfig System.map -boot.lds 

-boot.map 

-boot-nodtb.bin 
Load .imx -boot.srec 
MAINTAINERS README u-boot.bin -boot .sym 








图 32.1.1 链接 脚本 


只 有 编译 u-boot 以 后 才 会 在 根 目录 下 出 现 u-boot.lds 文件 ! 
只 有 编译 u-boot 以 后 才 会 在 根 目录 下 出 现 u-boot.lds 文件 ! 
只 有 编译 u-boot 以 后 才 会 在 根 目录 下 出 现 u-boot.lds 文件 ! 
打开 u-boot.lds， 内 容 如 下 : 








示例 代码 32.1.1 u-boot.lds 文件 代码 


UTPUT FORMAT ("elf32-littlearm", "olf32-littlearm", "elf32-littlearm") 
UTPUT ARCH (arm) 

NTRY( start) 
ECTIONS 


0x00000000; 


ALIGN(4) 


.text : 


{ 


, 


*(. image copy start) 


*(.vectors) 


arch/arm/cpu/armv7/start.o (.text*) 
*(.text*) 


ALIGN(4) 


Riefofei- iot ERE | 





ALIGN(4) 


-data 8 { 
*(.data*) 


} 


D 


LIGN (4) 


ALIGN (4) 





, 


*(SORT BY ALIGNMENT(SORT BY NAME(.rodata*))) } 




















, 


了 


, 


,u boot list s d 


K 














EEP(*(SORT(.u boot list*))); 
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26 
2) 
28 
2 
30 
EI 
22 
33 
34 
35 
36 
m 
38 
99 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
Sil 
52 
53 
54 
59 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 


} 


= ALIGN(4); 


.image copy end 


{ 


} 


*(. image copy end) 


oil Cyn Start 


{ 


} 


w((. en ee) 


oe oon em 


*(.rel*) 


} 


sc edyn eng 


{ 


} 


S(- zel eyn enei) 


.end 


{ 


} 


BENE) 


image binary end -2 .; 


= ALIGN(4096); 


.mmutable : ( 


*(.mmutable) 


} 


BSS tert Yel cyn cesi (OVERLAY) 3 1 


} 


} 




















KEBE (S (2 b68 start) ))? 
— OSS Dase = o? 
.bss | bss base (OVERLAY) { 
*(.bss*) 
— LIEN) E 
99s limit c3 45 
ioca MN c M Limit (OVERLAX) ET 


} 





KEEP (* 














(. bss end)); 


.dynsym image binary end 


.dynbss ( *(.dynbss) } 
.dynstr ( *(.dynstr*) ) 
.dynamic : ( *(.dynamic*) i 
ple con Ra (ergeben aua 


{ *(.daynsym) } 
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(Oh  agalenEexws B "| *isabpedessow) p 
70 ees mas 
(om 
72. .ARM.exidx : { *(.ARM.exidx*) } 
73 .gnu.linkonce.armexidx : ( *(.gnu.linkonce.armexidx.*) ) 
74 } 
第 3 行为 代码 当然 入 口 点 :_start，_start 在 文件 arch/arm/lib/vectors.S 中 有 定义 , 如 图 32.1.2 
所 示 : 
Å vectorsS X 
26 .globl start 
27 
28  /* 
29 FKK K K K K K K K ook ok ok ok ok K K ck ok K FK K K K K K K ok 2K K K K K FK K oe o K K K K CE K CE OK CE OE CE OK K K FK K K K K FK K K K K K K K K K K K K K K K 
30 * 
31 * Vectors have their own section so linker script can map them easily 
32 " 
33 KK SK SK SK SK K K K CK K K K K K CK K K K K K K K K OK K K K CE K K K K K K K K K K K K K SE K K K OK K CE K SK K K CK K K K K K K K K K K K K OE K K K K K K 
34 x. 
35 
36 .section ".vectors", "ax" 
ay 
38 /* 
39 KK SK K SK SK K K K CK K K OK K K CK DK K K K OK K K K OK K o K CK DE K K K K CK K K SK K K K K SE K K K OK K CE K K ok K CK K K K K K K K K K K K K CE K K K K K K 
40 * 
41 * Exception vectors as described in ARM reference manuals 
42 * 
43 * Uses indirect branch to allow reaching handlers anywhere in memory. 
44 * 
45 KK SK SK SK K K K K CK K K OK K K CK K K K K K K K K K ok K K CK DE K K K K CK K K K K K CK K K K K ok K K K K K K K CK K K K K K K K K K K K K SE K K K K K K 
46 "y 
47 
48 _start: 
49 
50 #ifdef CONFIG SYS DV NOR BOOT CFG 
51 .word CONFIG SYS DV NOR BOOT CFG 
52 #endif 
53 
54 b reset 
55 ldr pc, undefined instruction 
56 ldr pc, software interrupt 
57 ldr pc, prefetch abort 
58 ldr pc, data abort 
59 ldr pc, not used 
60 ldr pc, irq 
61 ldr pc, fiq 


图 32.1.2. start A A 


从 图 32.1.1 可 以 看 出 ，_start 后 面 就 是 中 断 向 量 表 ， 从 图 中 的 “.section ".vectors", "ax” 可 以 
得 到 ， 此 代码 存放 在 .vectors 段 里 面 。 

第 10 行 ， 使 用 如 下 命令 在 uboot 中 查找 “ image copy start": 

grep-nR" image copy start" 
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搜索 结果 如 图 32.1.3 所 示 : 


memcpy ( (void *)gd- ; ; 
it * && 
&& val «- 





0x0000000087800000 








图 32.1.3 查找 结 
打开 u-boot.map， 找 到 如 图 32.1.4 所 示 位 置 : 
® u-bootmap X 


926 B .text 的 地 址 设置 为 ex87866666 





927 0x0000000000000000 = 0x0 

928 0x0000000000000000 . = ALIGN (0x4) 

929 

930 „text 0x0000000087800000 0x3e94c 

931 *(. image copy start) 

932 .. image copy start 

933 0x0000000087800000 0x0 arch/arm/lib/built-in.o 
934 0x0000000087800000 . image copy start 
935 *(.vectors) 

936 .Vectors 0x0000000087800000 0x300 arch/arm/lib/built-in.o 
937 0x0000000087800000 start 

938 0x0000000087800020 undefined instruction 
939 0x0000000087800024 software interrupt 
940 0x0000000087800028  prefetch abort 

941 0x000000008780002c data abort 

942 0x0000000087800030 not used 

943 0x0000000087800034  irq 

944 0x0000000087800038 -fig 

945 0x0000000087800040 IRQ STACK START IN 


图 32.1.4 u-boot.map 

u-boot.map 是 uboot 的 映射 文件 ,可 以 从 此 文件 看 到 某 个 文件 或 者 函数 链接 到 了 哪个 地 址 ， 
从 图 32.1.4 的 932 行 可 以 看 到 ”image copy. start 为 0X87800000， 而 .text 的 起 始 地 址 也 是 
0X87800000. 

第 11 行 是 vectors Et, vectors 段 保 存 中 断 向 量 表 ， 从 图 32.1.2 中 我 们 知道 了 vectors.S 的 代 
码 是 存在 vectors 段 中 的 。 从 图 32.1.4 可 以 看 出 ，vectors 段 的 起 始 地 址 也 是 0X87800000， 说 明 
整个 uboot 的 起 始 地 址 就 是 0X87800000， 这 也 是 为 什么 我 们 裸 机 例 程 的 链接 起 始 地 址 选择 
0X87800000 了 ， 目 的 就 是 为 了 和 uboot 一 致 。 

第 12 行将 arch/arm/cpu/armv 7/start.s 编译 出 来 的 代码 放 到 中 断 癌 量 表 后 面 。 

第 13 行为 text 段 ， 其 他 的 代码 段 就 放 到 这 里 

在 u-boot.lds 中 有 一 些 跟 地 址 有 关 的 “变量 ”需要 我 们 注意 一 下 ， 后 面 分析 u-boot 源码 的 
时 候 会 用 到 ， 这 些 变 量 要 最 终 编 译 完成 才能 确定 的 !!! 比如 我 编译 完成 以 后 这 些 “ 变 量 ” 的 值 
如 表 32.1.1 Bros: 





































































































Qizi HIA 
. image copy. start 0x87800000 uboot $Z UI f] E Hehi 
. image copy end 0x8785dd54 uboot 拷贝 的 结束 地 址 
. rel dyn start 0x8785dd54 
. rel dyn end 0x878668f4 
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image binary end 0x878668f4 
. bss start 0x8785dd54 
. bss end 0x878a8e74 




















表 32.1.1 uboot 相关 变量 表 

K 32.1.1 中 的 “变量 ” 值 可 以 在 u-bootmap 文件 中 查找 , X 32.1.1 中 除了 _image_copy_start 

以 外 ,其 他 的 变量 值 每 次 编译 的 时 候 可 能 会 变化 ， 如 果 修 改 了 uboot 代码 、 修 改 了 uboot 配置 、 
选用 不 同 的 优化 等 级 等 等 都 会 影响 到 这 些 值 。 所 以 ， 一 切 以 实际 值 为 准 ! 


32.2 U-Boot 启动 流程 详解 


32.2.1 reset 函数 源码 详解 


从 u-boot.lds 中 我 们 已 经 知道 了 入 口 点 是 arch/arm/lib/vectors.S 文件 中 的 _start， 代 码 如 下 : 
示例 代码 32.2.1.1 vectors.S 代码 段 











SORA 
39 kc Ck ck kk ck kk ck kk Ck ck ck ck kk ck kk ck ko kk ko ck kk Sk ok ko ck kk ck kk ck kk ck ko Sk Sk Mk Sk ke kx k ko ko ko koko ko ko 
40 * 

41 * Exception vectors as described in ARM reference manuals 

42 * 





43 * Uses indirect branch to allow reaching handlers anywhere in 


44 * memory. 


45 Ck CK Ck Ck Ck ck ck kk ok kk kk kk kk kk kk kk Kk kk kk ok Mk ko ok ko ko ko ko ko kc ko ko ko 


46 */ 

47 
Aerar tE 
49 


50 #ifdef CONFIG SYS DV NOR BOOT CFG 
51 .word  CONFIG SYS DV NOR BOOT CFG 





52 endif 

DS 

54 I!) sese 

55 lde pe, Unoerined instruction 
56 ldr pE, Software interrupt 

5 lde xe, prefetch abort 

58 lohe Pe, Cere bort 

59 ldr pe, nort usedl 

60 liebe EEC 

Sil lei De, EL 





第 48 行 start 开始 的 是 中 断 向 量 表 ,其 中 54-61 行 就 是 中 断 向 量 表 , 和 我 们 裸 机 例 程 里 面 一 样 
54 行 跳 转 到 reset 函数 里 面 ，reset 函数 在 arch/arm/cpu/armv7/start.S 里 面 ， 代 码 如 下 : 
示例 代码 32.2.1.2 start.S 代码 段 


29) J| KKCKCKCKCKCkCk kCkCk kCkCk kCkCk kCKCkCk KCkCk kCkCk kk kCKCk Ck kCkck k kk k kc k Ck kc k Ck kc k ck k kc k kckck kckckckckck ck ko 








o 














29e css 


24 * Startup Code (reset vector) 
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26 * Do important init only if we don't start from memory! 


27 * Setup memory and board specific bits prior to relocation. 





28 * Relocate armboot to ram. Setup stack. 

29) 

30 KOKCKCKCKCkCkCk ck k kk k kk Ck kk Ck kc k Ck k kc k k kk k k k Ck kc k Ck k kc k k kc k k kc k k kc k ck kck ck kck ck ckck ck ckckck kk e ke k / 
S 

32 .globl reset 


35: Gell eave IOXOO!t pereme Ter 


34 

ese 

36 /* Allow the board to save important registers */ 
27 b save boot params 


第 35 行 就 是 reset 函数 。 

第 37 行 从 reset 函数 跳 转 到 了 save boot params 函数 ， 而 save boot params 函数 同样 定义 
在 start.S 里 面 ， 定 义 如 下 : 

示例 代码 32.2.1.3 start.S 代码 段 

91 /*kkkkkkkěkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
92. S 
9S. = VOl ava boor parame (u32 0, 92 cly wi92, x2, WSA 13) 
9 9 carernmuas (weake 
95. * 
96 * Stack pointer is not yet initialized at this moment 
9 * Don't save anything to stack even if compiled with -O0 
ONES 


99 KCKCKCKCKCKCkCkCk ck k kk kCkCk Ck kk Ck kc k Ck k kc k k kc k Ck k Ck Ck kk k k kk k kc k k kc k kck ck ck kck ck kck ck ckck ck kokck kk e kx & 





100 ENTRY(save boot params) 
TOn b save boot params ret © back to my caller 
save boot params 函数 也 是 只 有 一 句 跳 转 语 句 ， 跳 转 到 save boot params ret 函数 ， 
save boot params ret 函数 代码 如 下 : 
示例 代码 32.2.1.4 stattS 代码 段 





JE eave boor params Ters 


29 js 

40 * disable interrupts (FIQ and IRQ), also set the cpu to SVC32 
41 * mode, except if in HYP mode already 

42 x 

43 mrs x. ejos 

44 and P ers On #0x1f 0 mask mode bits 

45 teq ai #0xla Q0 test for HYP mode 
46 bicne s, se, fOx1f Q clear all mode bits 
47 orme rO, 20, Polo @ set SVC mode 

48 Orr 3. 1 #0xc0 @ disable FIQ and IRQ 
49 msr Cue » e) 
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第 43 行 ， 读 取 寄 存 器 cpsr 中 的 值 ， 并 保存 到 r0 寄存 器 中 。 

第 44 行 ， 将 寄存 器 10 中 的 值 与 0X1F 进行 与 运算 ， 结 果 保 存 到 rl 寄存 器 中 ， 目 的 就 是 提 
取 cpsr 的 bit0-bit4 这 5 位 ， 这 5 位 为 M4M3 M2M1M0，MI[4:0] 这 五 位 用 来 设置 处 理 器 的 工作 


























模式 ， 如 表 32.2.1.1 所 示 : 





10000 User(usr) 



































10001 FIQ(fiq) 
10010 IRQ(irq) 
10011 Supervisor(svc) 
10110 Monitor(mon) 
10111 Abort(abt) 
11010 Hyp(hyp) 
11011 Undefined(und) 
11111 System(sys) 





表 32.2.1.1 Cortex-A7 工作 模式 

第 45 行 ， 判 断 rl 寄存 器 的 值 是 否 等 于 0XIA(Ob11010)， 也 就 是 判断 当前 处 理 器 模式 是 否 
处 于 Hyp 模式 。 

第 46 行 ， 如 果 rl 和 0X1A 不 相等 ， 也 就 是 CPU 不 处 于 Hyp 模式 的 话 就 将 r0 寄存 器 的 
bit0~5 进行 清 零 ， 其 实 就 是 清除 模式 位 

第 47 行 ， 如 果 处 理 器 不 处 于 Hyp 模式 的 话 就 将 10 的 寄存 器 的 值 与 0x13 进行 或 运算 ， 
0x13=0b10011， 也 就 是 设置 处 理 器 进入 SVC 模式 。 

第 48 行 ，r0 寄存 器 的 值 再 与 0xC0 进行 或 运算 ， 那 么 r0 寄存 器 此 时 的 值 就 是 OxD3. cpsr 
的 I 为 和 下 位 分 别 控制 IRQ 和 FIQ 这 两 个 中 断 的 开关 ， 设 置 为 1 就 关闭 了 FIQ M IRQ! 

第 49 行 ， 将 r0 寄存 器 写 回 到 cpsr 寄存 器 中 。 完 成 设置 CPU 处 于 SVC32 模式 ， 并 且 关 闭 
FIQ 和 IRQ 这 两 个 中 断 。 
继续 执行 执行 下 面 的 代码 : 






























































示例 代码 32.2.1.5 start.S 代码 段 
eb fes 
JA = Seti GUI CTS 
DS S (OMARA Sol MPM BASE 16 mor 52 Ee 
54 * Continue to use ROM code vector only in OMAP4 spl) 
SE A 
56 #if !(defined(CONFIG OMAP44XX) && defined(CONFIG SPL BUILD) ) 
Sm SSe WE soa CIETLS SICHER reoi Stor Eror VBARI COPINE 149 ecuer 5// 





58 we Dus. U., LO ei. eU. 0 Q Read CP15 SCTLR Register 
59 Dic x0, SOR y GeV=0 

60 mee ola, Oy 0r Clr c0 0 Q Write CP15 SCTLR Register 
61 

62 /* Set vector address in CP15 VBAR register */ 

63 lieke se), SEE 

64 wei Ds, 9, r0. en2. eU, 0 (Set WINE 

65 #endif 


第 56 行 ， 如 果 没 有 定义 CONFIG OMAPA44XX 和 CONFIG SPL BUILD 的 话 条 件 成 立 ， 
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此 处 条 件 成 立 。 

第 58 行 读 取 CP15 中 cl 寄存 器 的 值 到 r0 寄存 器 中 ， 根 据 17.1.4 小 节 可 知 ， 这 里 是 读 取 
SCTLR 寄存 器 的 值 。 

第 59 1T, CR V 在 arch/arm/include/asm/system.h 中 有 如 下 所 示 定 义 : 

#define CR. V (1 << 13)/* Vectors relocated to Oxffff0000 */ 

因此 这 一 行 的 目的 就 是 清除 SCTLR 寄存 器 中 的 bit13，SCTLR 寄存 器 结构 如 图 32.2.1.1 所 











ZN: 
31 30 29 28 27 26 25 24 21 20 19 18 14 13 12 11 10 9 3210 


L- WXN L_sw 
UWXN 
Reserved 





Reserved 
TRE 


Reserved 


图 32.2.1.1 SCTLR 寄存 器 结构 图 

从 图 32.2.1.1 可 以 看 出 ，bit13 为 V 位 ， 此 位 是 向 量 表 控 制 位 ， 当 为 0 的 时 候 向 量 表 基 地 址 
为 0X00000000， 软 件 可 以 重 定位 向 量 表 。 为 1 的 时 候 向 量 表 基地 址 为 0XFFFF0000， 软 件 不 能 
重 定位 向 量 表 。 这 里 将 V 清 零 ， 目 的 就 是 为 了 接 下 来 的 向 量 表 重 定 位 ， 这 个 我 们 在 第 十 七 章 有 
过 详细 的 介绍 了 。 

第 60 行将 r0 寄存 器 的 值 重 写 写 入 到 寄存 器 SCTLR 中 。 

第 63 行 设置 10 寄存 器 的 值 为 _start，start 就 是 整个 uboot 的 入 口 地 址 ,其 值 为 0X87800000， 
相当 于 uboot 的 起 始 地 址 ， 因 此 0x87800000 也 是 向 量 表 的 起 始 地 址 。 

第 64 行将 r0 寄存 器 的 值 (向 量 表 值 ) 写 入 到 CP15 的 c12 寄存 器 中 ， 也 就 是 VBAR 寄存 器 。 
因此 第 58~64 行 就 是 设置 向 量 表 重 定位 的 。 

代码 继续 往 下 执行 : 



















































































示例 代码 32.2.1.6 stattS 代码 段 
67 /* the mask ROM code should have PLL and others stable */ 
68 #ifndef CONFIG SKIP LOWLEVEL INIT 














69 |o. ejui init CIed5 
70 bl epi imit Erit 
71 pendit 

p? 


JS Toll main 

第 68 行 如 果 没 有 定义 CONFIG SKIP LOWLEVEL INIT 的 话 条 件 成 立 。 我 们 没有 定义 
CONFIG SKIP LOWLEVEL INIT， 因 此 条 件 成 立 ， 执 行 下 面 的 语句 。 

示例 代码 32.2.1.6 中 的 内 容 比较 简单 ， 就 是 分 别 调用 函数 cpu init cp15、cpu_init_crit 和 
maine 


函数 cpu init cp15 用 来 设置 CP15 相关 的 内 容 , 比如 关闭 MMU 喻 的 , 此 函数 同样 在 start.S 
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文件 中 定义 的 ， 代 码 如 下 : 





示例 代码 32.2.1.7 start.S 代码 段 
105 J[ KKCKCKCKCKCkCk KCkCk kCkCk kCKCKCkCKCkCk KCKCk KC KC kCKCKCkCKCkCkC ECC KC KCKCk KOC KC kCkCkCk kCk ck k ck ck kck ck kckck ck ckckck ko 
340 9. us 
LOT = cpu inite (6193.5 
TOR k 
OM Seu CEIS registers (cache, MMU, TEBS):- Theri cache iis turned on 
110 * unless CONFIG SYS ICACHE OFF is defined. 
JE Ts 


IoP KCKCKCKCKCkCkCkCk CK Ck k Ck k Ck kCk Ck kCkCk Ck Ck KCk Ck kCKCk Ck kCkCk Ck Ck kCk k Ck Ck k k Ck Ck k ck Ck ck k ck ck ckck ckck ckokckok ck sk X ke x & f 


iS ENTRY (Cou init ©6915) 

















114 7/5 

db * Invalidate L1 I/D 

TRIN E 

dig) mov r0, 40 Q set up for MCR 

118 (wes Ted. Or se, Cr ey. O Q invalidate TLBs 
3531) mene qeu. Or 20 (X. Cor 0 @ invalidate icache 
120 mera ekor 0. 0. ey. eE @ invalidate BP array 
JE wwe T5. 0 sU, ey, cei.) Q DSB 

T22 mee ols, (0. Or ey. Sp 4 Q ISB 

123 

124 A 

125 * disable MMU stuff and caches 

126 x 

1525 mee 1915, UL. se, ei. eU, 0 

128 IE) 
129 bxc r0, r0, £$0x00000007 8 clear bits 2:0 (-CAM) 
130 orr r0, r0, #0x00000002 @ set bit 1 (--A-) Align 
epil (onse Os FO0x00000800 QI S CS SM bit Z) BIEB 
132 &ifdef CONFIG SYS ICACHE OFF 

MSS Jositemere 0 0 se COTON (o ME et or Co x CI (cache 
134 £else 

1:838 Quee eO EO o0 ):d o XOIOIO)TE(00/0] -(G- ee Jours. (TN cachne 
136 fendif 

IES mMer T5, 1. se, cd. eU, 

138 

25 

256 WRON/ je ES Q back to my caller 





257 ENDPROC(cpu init cp15) 
函数 cpu init cp15 都 是 一 些 和 CP15 有 关 的 内 容 ， 我 们 不 用 关心 ， 有 兴趣 的 可 以 详细 的 看 
一 下 。 
函数 cpu init crit 也 在 是 定义 在 start.S 文件 中 ， 函 数 内 容 如 下 : 
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示例 代码 32.2.1.8 start.S 代码 段 


/大 大 大 大 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 火炎 大 大 炎炎 炎炎 炎炎 大 火炎 大 大 大大 大 大 大 大 大 大 大 大 大大 大 大 大 大 大 炎炎 大 大 大大 大 大 大 大 大 大 大 大 大 大 大 


260 
261 
202 
269 
264 
2165 
266 
267 
268 
269 
270 
2p 
2 E 
PS 
274 
240 
2/6 


* 
Ue ns es 
大 
* setup important registers 
* setup memory timing 
* 
KCKCKCKCKCKCkCkCkCk k kk k kk Ck kCkCk k kk k kc k k kk Ck k Ck Ck kCk Ck k kc k k kc k k kc k Ck k k ck kck ck kck ck ckck ck ckckck ke e kx f 
NEN abibit (exta) 
[5s 
rms tS Ges GUEST C GP REERT EMT TCI en 


* The Mask ROM will have already initialized 





* basic memory. Go here to bump up clock rate and handle 

* wake up conditions. 

2 

b lowlevel init Q go setup pll,mux,memory 
ENDPROC(cpu init crit) 


可 以 看 出 函数 cpu init. crit 内 部 仅仅 是 调用 了 函数 lowlevel_init， 接 下 来 就 是 详细 的 分 析 一 








下 lowlevel init 和 _main 这 两 个 函数 。 


32.2.2 lowlevel init 函数 详解 


14 
JUS 
156 
3b y) 
18 
JS 
20 
2 
22 
23 
24 
25 
26 
2) 
28 
29 
30 
Sul 
97 


函数 lowlevel init 在 文件 arch/arm/cpu/armv7/lowlevel init.S 中 定义 ， 内 容 如 下 : 
示例 代码 32.2.2.1 lowlevel init.S 代码 段 

finclude «asm-offsets.h» 

finclude «€config.h» 

finclude «linux/linkage.h» 


ENTRY (lowlevel init) 

/* 

* Setup a temporary stack. Global data is not available yet. 
i 

ldr sp, =CONFIG SYS INIT SP ADDR 





Die SL Sp 37 /* 8-byte alignment for ABI compliance */ 
#ifdef CONFIG SPL DM 
mov r9, $0 
felse 
/ * 
aset up oloballigata ror Doardsi that sti M mso UU MAR S 
* removed soon. 
x 
#ifdef CONFIG SPL BUILD 





ldr r9, zgdata 
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33 #else 

34 sülb sip, SP, GOD SIAR 

35 bie Sorp SL uw 

36 mov r9, sp 

37 fendif 

38 fendif 

EO pa 

40 * Save the old lr(passed in ip) and the current lr to stack 
41 v 

42 push qi Jem 

43 

44 e 

45 * Call the very early init function. This should do only the 
46 * absolute bare minimum to get started. It should not: 

47 A 

48 x — set up DRAM 

49 5 c gie oleis lene 

50 DE cde SS 

Sl Evy eo Starta Console 

52 "s 

53i * For boards with SPL this should be empty since SPL can do all 
54 = (ue tales imit chap the SPL Doare imit 3E) me ms 
55 * called immediately after this. 

56 5 

57 bl e imit 

58 pop (ip, pc) 


59 ENDPROC(lowlevel init) 
第 22 行 设置 sp 指向 CONFIG SYS INIT SP ADDR, CONFIG SYS INIT SP ADDR 在 

include/configs/mx6ullevk.h 文件 中 ， 在 mx6ullevk.h 中 有 如 下 所 示 定 义 : 
示例 代码 32.2.2.2 mx6ullevk.h 代码 段 



























































234 #define CONFIG SYS INIT RAM ADDR IRAM BASE ADDR 

235 #define CONFIG SYS INIT RAM SIZE IRAM SIZE 

236 

237 #define CONFIG SYS INIT SP OFFSET \ 

238 (CONFIG SYS INIT RAM SIZE - GENERATED GBL DATA SIZE) 
239 #define CONFIG SYS INIT SP ADDR \ 

240 (CONFIG SYS INIT RAM ADDR + CONFIG SYS INIT SP OFFSET) 








示例 代码 32222 中 的 IRAM BASE ADDR 和 IRAM SIZE 在 文件 
arch/arm/include/asm/arch-mx6/imx-regs.h 中 有 定义 ， 如 下 所 示 ， 其 实 就 是 IMX6ULVIM6ULL 内 
部 ocram 的 首 地 址 和 大 小 。 





示例 代码 32.2.2.3 imx-regs.h 代码 段 
71 #define IRAM BASE ADDR 0x00900000 
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408 $if '(defined(CONFIG MX6SX) || defined(CONFIG MX6UL) || i 
409 defined(CONFIG MX6SLL) || defined(CONFIG MX6SL)) 

410 $define IRAM SIZE 0x00040000 

411 #else 

412 $define IRAM SIZE 0x00020000 

413 #endif 


如 果 408 行 的 条 件 成 立 的 话 IRAM SIZE=0X40000， 当 定义 了 CONFIG MX6SX、 
CONFIG MX6U、CONFIG MX6SLL 和 CONFIG MX6SL 中 的 任意 一 个 的 话 条 件 就 不 成 立 ， 
在 .config 中 定义 了 CONFIG_MX6UL， 所 以 条 件 不 成 立 ， 因 此 IRAM. SIZE-0X20000-128KB. 
结合 示例 代码 32.2.2.2， 可 以 得 到 如 下 值 : 

CONFIG SYS INIT RAM ADDR = IRAM BASE ADDR = 0x00900000。 

CONFIG SYS INIT RAM SIZE = 0x00020000 =128KB。 

还 需要 知道 GENERATED GBL DATA SIZE 的 值 ,在 文件 include/generated/generic-asm-offsets.h 
有 定义 ， 如 下 : 























示例 代码 32.2.2.4 generic-asm-offsets.h 代码 段 






















































































1 #ifndef _ GENERIC ASM OFFSETS H _ 

2 4define GENERIC ASM OFFSETS H _ 
OA 

4 ADORNO TIMODTENS 

5 * 

6  * This file was generated by Kbuild 
go cy 

8 

9 4define GENERATED GBL DATA SIZE 256 
10 4define GENERATED BD INFO SIZE 80 
11 £$define GD SIZE 248 
12 detine CD BD 0 
13 #define GD MALLOC BASE 192 
14 $define GD RELOCADDR 48 
15 #define GD RELOC OFF 68 
16 #define GD START ADDR SP 64 
1571 

18 fendif 





GENERATED GBL DATA SIZE-256, GENERATED GBL DATA SIZE 的 含义 为 
(sizeof(struct global data) + 15) & ^15 . 
综 上 所 述 ，CONFIG SYS INIT SP ADDR 值 如 下 : 
CONFIG SYS INIT SP OFFSET = 0x00020000 - 256 = 0xlFF00。 
CONFIG SYS INIT SP ADDR = 0x00900000 + 0X1FF00 = 0X0091FF00, 
结果 如 下 图 所 示 : 
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0X00900000—— 
y. 020000 
(128KB) 


CONFIG SYS INIT SP 
2 —- 


ADDR (SP) 0X0091FF00——— 


256B 
0X0091FFFF— — 





图 32.22.1 sp 值 
此 时 sp 指向 0X91FF00， 这 属于 IMX6UL/IMX6ULL 的 内 部 ram。 
继续 回 到 文件 lowlevel initS， 第 23 行 对 sp 指针 做 8 字 节 对 齐 处 理 ! 
第 34 行 ，sp 指针 减 去 GD_SIZE，GD_SIZE 同样 在 generic-asm-offsets.h 中 定 了 ， 大 小 为 
248， 见 示例 代码 32.2.2.4 第 11 行 。 
第 35 行 对 sp 做 8 字 节 对 齐 ， 此 时 sp 的 地 址 为 0X0091FF00-248=0X0091FE08， 此 时 sp 位 
置 如 图 32.2.2.2 所 示 : 











H 











0X00900000— — 


> 0X20000 
(128KB) 


SP——————» 0X0091FE08— — 
248B 
———CONFIG SYS INIT SP ADDR—M»- 0X0091FF00—— — 
256B 
0X0091FFFF— — 





图 32.2.2.2 sp 值 
第 36 行将 sp 地 址 保存 在 r9 寄存 器 中 。 
第 42 fT ip AI Ir HT 
第 57 行 调用 函数 s init， 得 ， 又 来 了 一 个 函数 。 
第 58 行将 第 36 行 入 栈 的 ip 和 1 进行 出 栈 ， 并 将 工 赋 给 pc. 











32.23 s init 函数 详解 


在 上 一 小 节 中 ， 我 们 知道 lowlevel_init 函数 后 面 会 调用 s. init 函数 ，s_init 函数 定义 在 文件 
arch/arm/cpu/armv7/mx6/soc.c 中 ， 如 下 所 示 : 
示例 代码 32.2.3.1 soc.c 代码 段 
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808 void s init (void) 

809 ( 

810 struct mice rege vanat = (Cree ere mets TO Tegs 


*)ANATOP BASE ADDR; 


























































































































gi Struct me cem reg eem = (struct mse Cam rec w) CCM BASE ADDR 
812 u32 mask480; 

813 u32 mask528; 

814 u32 reg, periphl, periph2; 

815 

816 if (is cpu type(MXC CPU MX6SX) || is cpu type(MXC CPU MX6UL) |l 
817 is cpu type(MXC CPU MX6ULL) || is cpu type(MXC CPU MX6SLL)) 
818 return; 

819 

820 /* Due to hardware limitation, on MX6Q we need to gate/ungate 
821 * all PFDs to make sure PFD is working right, otherwise, PFDs 
822 * may not output clock after reset, MX6DL and MX6SL have added 
323 * 396M pfd workaround in ROM code, as bus clock need it 

824 Sf 

825 

826 mask480 = ANATOP PFD CLKGATE MASK(0) | 

92 ANATOP PFD CLKGATE MASK(1) | 

828 ANATOP PFD CLKGATE MASK (2) | 

829 ANATOP PFD CLKGATE MASK(3); 

830 mask528 = ANATOP PFD CLKGATE MASK(1) | 

831 ANATOP PFD CLKGATE MASK(2); 

832 

833 reg = readl (&ccm->cbcmr) ; 

834 periph2 = ((reg & MXC CCM CBCMR PRE PERIPH2 CLK SEL MASK) 

835 >> MXC CCM CBCMR PRE PERIPH2 CLK SEL OFFSET); 

836 periphl = ((reg & MXC CCM CBCMR PRE PERIPH CLK SEL MASK) 

837 >> MXC CCM CBCMR PRE PERIPH CLK SEL OFFSET); 

838 

Se)  J (imexelsüe; sias REMIZA Eno (exc RITZ 198707 Us ne or Per (edhoel 7 
840 if ((periph2 != 0x2) && (periphl != 0x2)) 

841 mask528 |= ANATOP PFD CLKGATE MASK(0); 

842 

843 if ((periph2 != 0x1) && (periphl != 0x!) && 

844 (periph2 != 0x3) && (periphl != 0x3)) 

845 mask528 |= ANATOP PFD CLKGATE MASK(2); 

846 

847 writel(mask480, &anatop-»pfd 480 set); 

848 writel(mask528, &anatop-»pfd 528 set); 

849 writel(mask480, &anatop-»pfd 480 clr); 
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850 writel(mask528, &anatop-»pfd 528 clr); 
usb 


在 第 816 行 会 判断 会 判断 当前 CPU 类 型 ， 如 果 CPU 为 MX6SX. MX6UL. MX6ULL 或 
MX6SLL 中 的 任意 一 种 ， 那 么 就 会 直接 返回 ， 相 当 于 sint 函数 什么 都 没 做 。 所 以 对 于 
LMX6UL/LMX6ULL 来 说 ,s_init 就 是 个 空 函数 。 从 s. init 函数 退出 以 后 进入 函数 lowlevel_init， 
但 是 lowlevel_init 函数 也 执行 完成 了 ， 返 回 到 了 函数 cpu_init crit; Æt cpu. init crit 也 执行 完 
成 了 ， 最 终 返 回 到 save boot params ret， 函 数 调用 路 径 如 图 32.2.3.1 所 示 : 


save boot params ret 

















cpu init crit 
LL lowlevel init 
E 


main 


图 32.2.3.1 uboot 函数 调用 路 径 
从 图 32.2.3.1 可 知 ， 接 下 来 要 执行 的 是 save boot params ret 中 的 main 函数 ， 接 下 来 分 析 
main 函数 。 




















32.2.4_main 函数 详解 


main 函数 定义 在 文件 arch/arnylib/crt0.S 中 ， 函 数 内 容 如 下 : 
示例 代码 32.2.4.1 crt0.S 代码 段 








G 

64 * entry point of crt0 sequence 

e ex 

66 

67 ENTRY( main) 

68 

porc ys 

9 = Set wo imitieal © runcis nv nm anc Cell boere imit 3E (0) 
qui y 

72 

73 4if defined(CONFIG SPL BUILD) && defined(CONFIG SPL STACK) 
74 ldr sp, -(CONFIG SPL STACK) 

DNE erse 

76 ldr sp, -(CONFIG SYS INIT SP ADDR) 

TI Hendif 


JS iE oe ned CONTO CPUV IM) V VIM forbids using SP as BIC 


destination */ 


TES) TOV 237 S 

80 pie to, ror W7 
81 mov sp, r3 

82 felse 
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83 bic sp, sp, 47 /* 8-byte alignment for ABI compliance */ 
84 #endif 

85 mov r0, sp 

86 lol ‘lds@arel init i£ alloc reserve 

87 mov sp, r0 

88 /* set up gd here, outside any C code */ 

89 MOV 369, ael 

90 bl lds@arze init f imit reserve 

Or 

92 mov r0, rO 

QS bl Baard imit dE 

94 

95 #if ! defined(CONFIG SPL BUILD) 

96 

e e 

98 * Set up intermediate environment (new sp and gd) and call 
29 = relocate ececke(eslehe mon Trick hera ig that un 
J(0(0 = nee but relocatecl, 

WOI = 

1O02 

103 RS eo E GDRSTARTSADDRSSP]O/* ee odee a a oo/ 





104 Hif defined(CONFIC CPU VIM) /* vM forbids using SP as BIC 


destination */ 

















OS MOVE OESE 

106 lone 389 3895 7 

107 mov sp, r3 

108 #else 

109 bic sp, sp, 47 /* 8-byte alignment for ABI compliance */ 
110 #endif 

Malal lar Or FOD BDI [= 109) = GO Sel 7 

dE 102 suo r9. rO, OD SIZE /* new GD is below bd */ 

TI 

114 adr lr, here 

TES lar ve, Tr9 FCD RELOC OFF] (5 s = gelee GE * 
116 exolo| din dixe. aed) 

117 #if defined(CONFIG CPU V7M) 

118 Quee dae. cl /* As required by Thumb-only */ 
119 £endif 

120 ldr r0, [r9, $GD RELOCADDR] 0 oa neloeaorme. 
IZ b relocate code 

122 here: 

12:9. yS 


124 * now relocate vectors 
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IDEAE eof 

126 

3527) lol zelocare vectors 

128 

1.2/9) Sec wo ciaal nnmens 5 7/ 

130 

IS piei oain (ju e /^ we sull call old routine here / 
132 #endif 

133 #if !defined(CONFIG SPL BUILD) |] defined(CONFIG SPL FRAMEWORK) 
134 # ifdef CONFIG SPL BUILD 

135 /* Use a DRAM stack for the rest of SPL, if requested */ 
T36 bil gpl relocare Stack gel 

3517) cmp rO, 40 

1S8 movne Smp se 

2159) movne r9, r0 

140 i endif 

141 lehe i0, = lege oto /* €his is auto-relocated! */ 
142 

143 #ifdef CONFIG USE ARCH MEMSET 

144 lee 3, = bss enel /* this is auto relocated */ 
145 mov rl, #0x00000000 /* prepare zero to clear BSS */ 
146 

147 subs i2. i35 sel ED = mangar lan ~/ 

148 bl memset 

149 #else 

165) lor ved, E pos en] /* this is auto-relocated! */ 
Sa mov r2, #0x00000000 /* prepare zero to clear BSS */ 
152 

se lscwp 0, zi SS 
154 #if defined(CONFIG CPU V7M) 

185 ite lo 

156 #endif 

开本 seclo z2; [z0] /* clear 32-bit BSS word */ 

158 addlo r0, r0, 44 /* move to next */ 

TES] pillom es sl 

160 #endif 

yl 

162 #if ! defined(CONFIG SPL BUILD) 

163 bl coloured LED INLE 

164 bil zeel lec! on 

165 fendif 

166 call poard init riga t id, ulong dest addr ~ 

167 mov ro, se e e 9$ 
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168 
169 
dE TRU) 
lal 
JL 752 
JUS) 
174 
TG 
S 
T 
ETHS 
10$; 





ldr r1, [r9, $GD RELOCADDR] /* dest addr */ 
M eall poard init 3e wy 
#if defined (CONFIG SYS THUMB BUILD) 
Igie le, Joore imie © /= timis is awro=reloceatecl =/ 
px lir 
felse 
lehe joe tdexweueel dbmune i6 — //5 adam 3g euuo-seloeeuesdl */ 
fendif 
/* we should not return here. */ 
fendif 


ENDPROC( main) 





第 76 行 ， 设 置 sp 指针 为 CONFIG SYS INIT SP ADDR， 也 就 是 sp 指向 0X0091FF00。 
第 83 fT, sp 做 8 字 节 对 齐 。 

第 85 行 ， 读 取 sp 到 寄存 器 r0 里 面 ， 此 时 r0=0X0091FF00。 

第 86 行 ， 调 用 函数 board init f alloc reserve， 此 函数 有 一 个 参数 ， 参 数 为 r0 中 的 值 ， 也 
就 是 0X0091FF00， 此 函数 定义 在 文件 common/init/board initc 中 ， 内 容 如 下 : 




















示例 代码 32.2.4.2 board_init.c 代码 段 


56 ulong boere) init le reserve(ulone top) 


57 
58 
59 
60 
61 
62 
63 


{ 


} 


/* Reserve early malloc arena */ 
#if defined(CONFIG SYS MALLOC F) 
top -= CONFIG SYS MALLOC F LEN; 
fendif 
/* LAST : reserve GD (rounded up to a multiple of 16 bytes) */ 











top = rounddown(top-sizeof(struct global data), 16); 


return top; 





函数 board init f alloc reserve 主要 是 留 出 早期 的 malloc 内 存 区 域 和 gd 内 存 区 域 ， 其 中 
CONFIG SYS MALLOC F LEN=0X400( 在 文件 include/generated/autoconfh 中 定义 )， 
sizeof(struct global data)-248(GD SIZE 值 )， 完 成 以 后 的 内 存 分 布 如 图 32.2.4.1 所 示 : 
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0X00900000— — 






0X20000 < 
(128KB) 


top 一 | 
global data 


248B*8B 
hable x 
! Za 0X0091FB00 一 一 一 


early malloc 
(CONFIG SYS MALLOC FL 0X400 


SP 
———CONFIG SYS INIT SP ADDR—M»e 





图 32.2.4.1 内 存 分 布 图 

函数 board init f alloc reserve 是 有 返回 值 的， 返回 值 为 新 的 top 值 ， 从 图 32.2.4.1 可 知 ， 
此 时 top=0X0091FA00。 

继续 回 到 示例 代码 32.2.4.1 中 ， 第 87 fT, TE ro 写 入 到 sp 里 面 ，r0 保存 着 函数 
board init f alloc reserve 的 返回 值 ， 所 以 这 一 句 也 就 是 设置 sp=0X0091FA00。 

第 89 行 ,将 0 寄存 器 的 值 写 到 寄存 器 19. 里面 , 因为 19 寄存 器 存放 着 全 局 变量 gd 的 地 址 ， 
在 文件 arch/arm/include/asm/global data.h 中 有 如 图 32.2.4.2 所 示 宏 定义 : 
83 #ifdef CONFIG ARM64 
































84 #define DECLARE GLOBAL DATA PTR register volatile gd t *gd asm ("x18") 
85 #else 
86  s&define DECLARE GLOBAL DATA PTR register volatile gd t *gd asm ("r9") 
87 #endif 
88 #endif 





图 32.24.2 DECLARE GLOBAL DATA PTR /Z 5E X. 

从 图 32.2.4.2 可 以 看 出 ，uboot 中 定义 了 一 个 指向 gd t 的 指针 gd; gd 存放 在 寄存 器 ro 里 
的 , 因此 gd 是 个 全 局 变量 。 gd t 是 个 结构 体 , 在 include/asm-generic/global data.h 里 面 有 定义 ， 
gd 定义 如 下 : 











ES 





























示例 代码 32.2.4.3 global data.h 代码 段 
27 typedef struct global data { 





28 lod ig Xoo 

29 unsigned long flags; 

30 unsigned int baudrate; 

EXT unsigned long cou clip  /* CEU gleci ibm ff A 

9 Unseen Llong Dus eliz 

29 /** Wis Cannoe bracket chis wici CONFIG ECI due Co peoks / 
34 masignecl long PEt elik? 

325 unsigned long mem clk; 
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36 #if defined(CONFIG LCD) || defined(CONFIG VIDEO) 

3:17 unsigned long fo base; /bsse eaddress of framebufifier mem */ 
Se yenc 


121 #ifdef CONFIG DM VID 





Ez 
E 


T22 ulong video top; /* Top of video frame buffer area */ 
2S ulong video bottom; /* Bottom of video frame buffer area */ 
124 #endif 

i25 i GE Ey 


因此 这 一 行 代 码 就 是 设置 gd 所 指向 的 位 置 ， 也 就 是 gd 指向 OX0091FAO00. 
继续 回 到 示例 代码 32.2.4.1 中 ， 第 90 行 调用 函数 board init f init reserve， 此 函数 在 文件 
common/init/board init.c 中 有 定义 ， 函 数 内 容 如 下 : 
示例 代码 32.2.4.4 board. init.c 代码 段 


110, void board init i init reserve(ulong base) 
































A 

T2 Seruec Global deta "eo DEE? 

1.1.5) patndet USE MEMCEY 

114 Te oe ep 

115 #endif 

116 

ay f 

Lale * clear GD entirely and set it up. 

dl) =< Use Gel prez, as ge mey now De properly Ser yers 

120 xy 

dL 

122 gd ptr —- (struct global data *)base; 

IAS /* zero the area */ 

124 #ifdef _USE_MEMCPY 

125 memset(gd ptr, 01, sizeof(*gd)); 

126 #else 

31220 fore(o c ((Guene *)gyel joxsep jowis «S (Gina v) ((gel pie «» 198 X 
128 woei E (07g 

129 #endif 

130 /* set GD unless architecture did it already */ 

131 $if !defined(CONFIG ARM) 

1512) arch setup gege DEE) p 

133 #endif 

134 /* next alloc will be higher by one GD plus 16-byte alignment */ 
ss base += roundup(sizeof(struct global data), 16); 

136 

SN Je 

T38 * record early malloc arena start. 

T9 * Use gd as it is now properly set for all architectures. 
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140 iu 

141 

142 #if defined(CONFIG SYS MALLOC F) 

143 /* go down one 'early malloc arena' */ 

144 gd-»malloc base = base; 

145 /* next alloc will be higher by one 'early malloc arena' size */ 
146 base += CONFIG SYS MALLOC F LEN; 

147 #endif 

148 } 














可 以 看 出 ， 此 函数 用 于 初始 化 gd， 其 实 就 是 清 零 处 理 。 男 外 ， 此 函数 还 设置 了 
gd->malloc base 为 gd 基地 址 +gd 大 小 =0X0091FA00+248=0X0091FAF8， 在 做 16 字 节 对 齐 ， 最 
终 gd->malloc_base=0X0091FB00， 这 个 也 就 是 early malloc 的 起 始 地 址 。 

继续 回 到 示例 代码 32.2.4.1 中 ， 第 92 行 设置 R0 为 0。 

第 93 行 ， 调 用 board init f 函 数 ， 此 函数 定义 在 文件 common/board fc P! 主要 用 来 初始 
化 DDR， 定 时 器 ， 完 成 代码 拷贝 等 等 ， 此 函数 我 们 后 面 在 详细 的 分 析 。 

第 103 行 , 重新 设置 环境 (sp 和 gd)、 获 取 gd->start_addr sp 的 值 赋 给 sp. 在 函数 board init f 
中 会 初始 化 gd 的 所 有 成 员 变 量 ， 其 中 gd->start addr sp=0X9EF44E90， 所 以 这 里 相当 于 设置 
sp=gd->start_addr sp=0X9EF44E90。0X9EF44E90 是 DDR 中 的 地 址 ， 说 明 新 的 sp 和 gd 将 会 存 
放 到 DDR 中 ， 而 不 是 内 部 的 RAM 了 。GD START ADDR SP=64， 参 考 示 例 代码 32.2.2.4。 

第 109 行 ，sp 做 8 字 节 对 齐 。 

第 111 行 ， 获取 gd->bd 的 地 址 赋 给 9， 此 时 ro 存放 的 是 老 的 gd， 这 里 通过 获取 gd->bd 的 
地 址 来 计算 出 新 的 gd 的 位 置 。GD_BD=0， 参 考 示 例 代码 32.2.2.4。 

第 112 行 , 新 的 gd 在 bd 下面, 所 以 r9 减 去 gd 的 大 小 就 是 新 的 gd 的 位 置 , 获取 到 新 的 gd 
的 位 置 以 后 赋值 给 r9。 

第 114 行 ,设置 I 寄存 器 为 here， 这 样 后面 执 行 其 他 函数 返回 的 时 候 就 返回 到 了 第 122 fr 
的 here 位 置 处 。 

第 115， 读 取 gd->reloc_off 的 值 复制 给 r0 寄存 器 ，GD_RELOC_OFF=68， 参 考 示 例 代码 
32.2.2.4。 

第 11647, r 寄存 器 的 值 加 上 r0 寄存 器 的 值 ， 重 新 赋值 给 r 寄存 器 。 因 为 接 下 来 要 重 定位 
代码 ， 也 就 是 把 代码 拷贝 到 新 的 地 方 去 (现在 的 uboot 存放 的 起 始 地 址 为 0X87800000， 下 面 要 
将 uboot 拷贝 到 DDR 最 后 面 的 地 址 空间 出 ， 将 0X87800000 开始 的 内 存 空 出 来 )， 其 中 就 包括 
here， 因 此 Ir 中 的 here 要 使 用 重 定 位 后 的 位 置 。 

第 120 行 ， 读 取 gd->relocaddr 的 值 赋 给 r0 寄存 器 ， 此 时 ro 寄存 器 就 保存 着 uboot HP Ul 
的 目的 地 址 ， 为 OX9FF47000. GD RELOCADDR=48， 参 考 示例 代码 32.2.2.4。 

第 121 行 ,调用 函数 relocate_code,， 也 就 是 代码 重 定位 函数 ， 此 函数 负责 将 uboot 拷贝 到 新 
的 地 方 去 ， 此 函数 定义 在 文件 arch/arm/lib/relocate.S 中 稍 后 会 详细 分 析 此 函数 。 

第 127 行 ， 调 用 函数 relocate_vectors， 对 中 断 向 量 表 做 重 定位 ， 此 函数 定义 在 文件 
arch/arm/lib/relocate.S 中 ， 稍 后 会 详细 分 析 此 函数 。 

第 131 行 , 调 用 函数 c_ runtime. cpu. setup, 此 函数 定义 在 文件 arch/arm/cpu/armv 7/start.S 中 ， 
函数 内 容 如 下 : 
































































































































































































































示例 代码 32.2.4.5 start.S 代码 段 
77 ENTRY(c runtime cpu setup) 
qr qe 
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79 * If I-cache is enabled invalidate it 

NO. moy 

81 4ifndef CONTIG SYS ICACHE OFF 

82 wes Tu. 0, i0, ey. c5, 0d) @ invalidate icache 
83 mcr jo. 0p sz, ey. eh. 2 i8 DS 

84 mMer ipis. O7 TO, ey, go, 4 Q ISB 

85 #endif 

86 

e lox di 

88 





89 ENDPROC(c runtime cpu setup) 
第 141-159 行 ， 清 除 BSS Et. 
第 167 行 ， 设 置 函数 board init r 的 两 个 参数 ， 函 数 board_init r 声明 如 下 : 
board init r(gd t *id, ulong dest addr) 
第 一 个 参数 是 gd， 因 此 读 取 切 保存 到 r0 里 面 。 
第 168 fT, 设置 函数 board_init r 的 第 二 个 参数 是 目的 地 址 ， 因 此 rl= gd->relocaddr。 
第 174 行 、 调 用 函数 board init r， 此 函数 定义 在 文件 common/board rc 中 ， 稍 后 会 详细 的 
分 析 pun 
个 就 是 main 函数 的 运行 流程 ， 在 main 函数 里 面 调用 了 board init f. relocate code. 
vns vectors 和 board init r ix 4 个 函数 ， 接 下 来 依次 看 一 下 这 4 个 函数 都 是 干 啥 的 。 















































32.2.5 board init f 函数 详解 


main 中 会 board init f 函数 ，board init f 函 数 主要 有 两 个 工作 : 

@、 初 始 化 一 系列 外 设 ， 比 如 串口 、 定 时 器 ， 或 者 打印 一 些 消息 等 。 

©, HUM gd 的 各 个 成 员 变 量 ，uboot 会 将 自己 重 定位 到 DRAM 最 后 面 的 地 址 区 域 ， 也 就 
是 将 自己 拷贝 到 DRAM 最 后 面 的 内 存 区 域 中 。 这 么 做 的 目的 是 给 Linux 腾 出 空间 ， 防 止 Linux 
kernel 覆盖 掉 uboot， 将 DRAM 前 面 的 区 域 完整 的 空 出 来 。 在 拷贝 之 前 肯定 要 给 uboot 各 部 分 
分 配 好 内 存 位 置 和 大 小 ， 比 如 gd 应 该 存放 到 哪个 位 置 ，malloc 内 存 池 应 该 存放 到 哪个 位 置 等 
等 。 这 些 信息 都 保存 在 gd 的 成 员 变 量 中 ， 因 此 要 对 gd 的 这 些 成 员 变 量 做 初始 化 。 最 终 形成 一 
个 完整 的 内 存 “ 分 配 图 ” 在 后 面 重 定位 uboot 的 时 候 就 会 用 到 这 个 内 存 “ 分 配 图 ”。 

此 函数 定义 在 文件 common/board £c 中 定义 ， 代 码 如 下 : 

示例 代码 32.2.5.1 boatd_fc 代码 段 

1035 void board init f(ulong boot flags) 




















































































































wec 

1037 #ifdef CONFIG SYS GENERIC GLOBAL DATA 

1038 PS 

1039 * For some archtectures, global data is initialized and used 
1040 * before calling this function. The data should be preserved. 
1041 * For others, CONFIG SYS GENERIC GLOBAL DATA should be defined 
1042 * and use the stack here to host global data until relocation. 
1043 x 

1044 ge © dara, 

1045 
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1046 gd = &data; 

1047 

1048 Je 

1049 * Clear global data before it is accessed at debug print 
1050 ^ im dmiceall rwa liest. Otherwise the Celw print prele 
MOS = get Hie wong veille ok ge->riave Consoles, 

1052 zy 


1053 zero global data(); 
1054 #endif 

1055 

1056 gd-»flags = boot flags; 
15097 gd-»have console = 0; 





1058 

180159 sos (imitcall run lisrt(init seguencs iy 

1060 hang () ; 

1061 

1062 #if !defined(CONFIG ARM) && !defined(CONFIG SANDBOX) && \ 
1063 !defined(CONEIG EET APP) 














1064 ai 
1065 hang (); 
1066 #endif 
1067 ) 
为 没有 定义 CONFIG SYS GENERIC GLOBAL DATA, 所 以 第 1037~1054 行 代码 无 效 。 
第 1056 行 ， 初 始 化 gd->flags=boot flags=0。 
第 1057 行 ， 设 置 gd->have_console=0。 
重点 在 第 1059 行 ! 通过 函数 initcall run list 来 运行 初始 化 序列 init sequence f 里 面 的 一 些 
列 函 数 ，init_ sequence f 里 面包 含 了 一 系列 的 初始 化 函数 ，init_ sequence f 也 是 定义 在 文件 
common/board fc F, HF init sequence f 的 内 容 比较 长 ， 里 面 有 大 量 的 条 件 编译 代码 ， 这 里 
为 了 缩小 篇 幅 ， 将 条 件 编 译 部 分 柚 除 掉 了 ， 去 掉 条 件 编译 以 后 的 init sequence f£ X AU F: 
示例 代码 32.2.5.1 board_f.c 代码 段 
J AKKA Ekk k kkk k kk k k debe] I init sequence f*eeeeecceoex / 




















mi 


H 












































Static init imne t init sequence ijj = d 
Serup mon Len, 
ioiei malloc, 


initi Console record, 


1 
2 
3 
4 
5 arch cpu imit, /* basic arch cpu dependent setup */ 
6 witi C, 

7 arch cpu imit cim, 

8 mark bootstage, /* need timer, go after init dm in 
9 loomurel early init dE, 

10 timer init, Me wdtralize timer i 
dal board!) en init, 

12 Get CLOCKS; 
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IS enw init, /* initialize environment id 
14 init baud rate, /* initialze baudrate settings A 
iiS serial init, /* serial communications setup a 
16 console inic f, /* stage 1 init of console E 
LF display options, /* say that we are here wl 
18 cdisplay text imio, /* show debugging info if required */ 
19 print cpuinfo, /* display cpu info (and speed) "o 
20 show board info, 

21 INIT FUNC WATCHDOG INIT 

22 INIT FUNC WATCHDOG RESET 

25 init tune 3128, 

24 announce dram init, 

25 IA TODOR unify cenese drami utens 

26 dram init, /* configure available RAM banks */ 
2 post imit i, 

28 INIT FUNC WATCHDOG RESET 

29 testdram, 

30 INIT FUNC WATCHDOG RESET 

2 INIT FUNC WATCHDOG RESET 

32 (= 

33 * Now that we have DRAM mapped and working, we can 

34 * relocate the code and continue running from DRAM. 

EIS ia 

36 * Reserve memory at end of RAM for (top down in that order): 
37 ES 
38 * -— kernel log buffer 

29 * - protected RAM 

40 * — LCD framebuffer 

41 * - monitor code 

42 = = loarel MaG SLETE 

43 a 

24 seruo dest idm 

45 reserve round 4k, 

46 reserve mmu, 

47 esca LECET 

48 reserve uboot, 

49 ineisemvegmosiilo cr 

50 reserve boarre, 

Sal setup machine, 

52 reserve global data, 

58 TESSE be 

54 reserve arch, 

55 Tesertye Stacks, 
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56 setup dram config, 

S show dram config, 

58 display new sp, 

59 INIT FUNC _ WATCHDOG RESET 

60 mese cac 

61 setup clo, 

62 NULL, 

53. R 


接 下 来 分 析 以 上 函数 执行 完 以 后 的 结果 : 

第 2 行 ，setup_mon len 函数 设置 gd 的 mon len 成 员 变 量 ， 此 处 为 “bss_end - start， 也 就 
是 整个 代码 的 长 度 。0X878A8E74-0x87800000=0XA8E74， 这 个 就 是 代码 长 度 

第 3 行 ，initf malloc 函数 初始 化 gd 中 跟 malloc 有 关 的 成 员 变量 ， 比 如 malloc limit, JERK 
数 会 设置 gd->malloc limit= CONFIG SYS MALLOC F LEN=0X400。malloc limit 表示 malloc 
内 存 池 大 小 。 

第 4 ÍT, initf console record ， 如 果 定 义 了 宏 CONFIG CONSOLE RECORD 和 安 
CONFIG SYS MALLOC F LEN 的 话 此 函数 就 会 调用 函数 console record init, 但 是 IMX6ULL 
的 uboot 没有 定义 宏 CONFIG. CONSOLE RECORD， 所 以 此 函数 直接 返回 0。 

第 5 fT, arch cpu init 函数 ， 初 始 化 架构 相关 的 内 容 ，CPU 级 别 的 操作 。 

第 6 行 ，initf dm 函数 ， 驱 动 模型 的 一 些 初始 化 。 

第 7 行 ，arch_ cpu init dm 函数 未 实现 。 

第 8 fT, mark bootstage 函数 应 该 是 和 啥 标记 有 关 的 

第 9 行 , board_early_init 了 函数 ,板子 相关 的 早期 的 一 些 初 始 化 设置 ， LMX6ULL 用 来 初始 
化 串口 的 IO 配置 
第 10 行 ，timer_init， 初 始 化 定时 器 ，Cortex-A7 内 核 有 一 个 定时 器 ， 这 里 初始 化 的 就 是 Cortex- 
A 内 核 的 那个 定时 器 。 通 过 这 个 定时 器 来 为 uboot 提供 时 间 。 就 跟 Cortex-M 内 核 Systick 定时 
器 一 样 。 关于 Cortex-A 内 部 定时 器 的 详细 内 容 , 请 参考 文档 《4YARM ArchitectureReference Manual 
ARMv7-A and ARMv7-R edition.pdf》 的 “Chapter B8 The Generic Timer” 章 节 。 

第 11 fT, board postclk init， 对 于 LMX6ULL 来 说 是 设置 VDDSOC 电压 。 

第 12 fT. get clocks 函数 用 于 获取 一 些 时钟 值 ， LMX6ULL 获取 的 是 sdhc_clk 时 钟 ， 也 就 
是 SD 卡 外 设 的 时 钟 。 

第 13 ÍT, env init 函数 是 和 环境 变量 有 关 的 ， 设 置 gd 的 成 员 变 量 env_addr， 也 就 是 环境 变 
量 的 保存 地 址 。 

第 14 行 ,init_baud_rate 函数 用 于 初始 化 波 特 率 , 根据 环境 变量 baudrate 来 初始 化 gd->baudrate。 

第 15 行 ，serial init， 初 始 化 串口 。 

第 16 fT, console init f， 设 置 gd->have_console 为 1， 表示 有 个 控制 台 ， 此 函数 也 将 前 
暂 存 在 缓冲 区 中 的 数据 通过 控制 台 打印 出 来 。 

第 17 行 、display_options， 通 过 串口 输出 一 些 信息 ， 如 图 32.2.5.1 所 示 : 
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U-Boot 2016.03 (Jul 14 2018 - 17:08:43 +0800) 





图 32.2.5.1 串口 信息 输出 
第 18 ÍF, display text info， 打 印 一 些 文 本 信息 ， 如 果 开 启 UBOOT 的 DEBUG 功能 的 话 就 
会 输出 text base. bss start、bss_end， 形 式 如 下 : 
debug("U-Boot code: 99081X -> 9908IX BSS: -> 9608IX n'",text base, bss start, bss end); 
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结果 如 图 32.2.5.2 所 示 : 





|u-Boot 2016.03 (Aug O1 2018 - 09:44:06 +0800) 





[u-Boot code: 87800000 -> 878665E0 BSS: -> 878B1EF8 





CPU: Freescale i.MX6ULL rev1.0 528 MHz (running at 396 MHz) 

CPU: commercial temperature grade (OC to 95c)malloc simple: size-10, pt 
uclass find device by seq: O -1 

uclass find device by seq: O O 


32.2.52 文本 信息 
第 19 fT, print cpuinfo 函数 用 于 打印 CPU 信息 ， 结 果 如 图 32.2.5.3 所 示 : 
CPU: Freescale i.MX6ULL rev1.0 528 MHz (running at 396 MHz) 


CPU: Commercial temperature grade (0C to 95C) at 47C 
Reset cause: WDOG . 








图 32.2.5.3 CPU 信息 
第 20 fT. show board info 函数 用 于 打印 板子 信息 ， 会 调用 checkboard 函数 ， 结 果 如 图 
32.2.5.4 所 示 : 


CPU: Freescale i.MX6ULL revi.O 528 MHz (running at 396 MHz 
CPU: Commercial temperature grade (OC to 95C) at 42C 


Board: MX6ULL 14x14 EVK 






IC: ready 
DRAM: 512 MiB 
MMC : FSI SDHC: 0. FSI SDHC: 1 


图 32.2.5.4 板子 信息 
第 21 fT, INIT FUNC WATCHDOG INIT, 初始 化 看 门 狗 ， 对 于 IMX6ULL 来 说 是 空 函 数 
第 22 行 , INIT FUNC WATCHDOG RESET, 复位 看 门 狗 ,对 于 IMX6ULL 来 说 是 空 函数 


第 23 fT, init func i2c 函数 用 于 初始 化 PC， 初始 化 完成 以 后 会 输出 如 图 32.2.5.5 所 示 信 
SP 






- - 


Reset cause: POR 
Board: MX6ULL 14x14 EVK 


[rzc: ready | 


DRAM: MTE 

MMC : FSL_SDHC: 0, FSL_SDHC: 1 
Display: TFT43AB (480x272) 
video: 480x272x24 


n 
ennia 


图 32.2.5.5 DC 初始 化 信息 输出 

第 24 fT, announce dram init， 此 函数 很 简单 ， 就 是 输出 字符 串 “DRAM:” 

第 26 ÍT, dram init， 并 非 真 正 的 初始 化 DDR， 只 是 设置 gd->ram size 的 值 ， 对 于 正点 原 
子 LMX6ULL 开发 板 EMMC 版 本 核心 板 来 说 就 是 512MB。 

第 27 行 ，post_init f， 此 函数 用 来 完成 一 些 测试 ， 初 始 化 gd->post_init f time 

第 29 行 ，testdram， 测 试 DRAM， 空 函数 。 

第 44 行 ,setup_dest_addr 函 数 , 设置 目的 地 址 ,设置 gd->ram size, gd-^ram top; gd->relocaddr 
这 三 个 的 值 。 接 下 来 我 们 会 遇 到 很 多 跟 数值 有 关 的 设置 ， 如 果 直 接 看 代码 分 析 的 话 就 太 费 时 间 
了 ， 我 可 以 修改 uboot 代码 ， 直 接 将 这 些 值 通过 串口 打印 出 来 ， 比 如 这 里 我 们 修改 文件 
common/board_f.c, 因为 setup_dest_addr 函数 定义 在 文件 common/board fc 中 ,在 setup_dest_addr 
函数 输入 如 图 32.2.5.6 所 示 内 容 : 
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358 | gd-»ram top += get effective memsize/;; 
359 gd-»ram top = board get usable ram top/gd-»mon len;; 
360 gd-»relocaddr = gd-»ram top; 
361 debug("Ram top: %081X\n", (ulong)gd-»ram top); 
362 sif defined(CONFIG MP) && (defined(CONFIG MPC86xx) || defined(CONFIG E500)) 
363 |? 
364 * We need to make sure the location we intend to put secondary core 
365 * boot code is reserved and not used by any part of u-boot 
366 / 
367 if (gd-»relocaddr > determine mp bootpg(NULL)) 
368 gd-»relocaddr = determine mp bootpg(/(NULL); 
369 debug("Reserving MP boot page to 4X0681xWMn", gd-»relocaddr); 
370 
371 #endif 
372 * *. — 
373 printf("gd-»ram size %#x\r\n", gd-»ram size); 通过 串口 输出 这 三 个 成 
374 printf("gd-»ram top %#x\r\n", gd->ram_top); 员 变 量 的 值 
375 printf("gd->relocaddr %#x\r\n",gd->relocaddr); 
376 
377 return 6; 
378 





图 32.2.5.6 添加 print 函数 打印 成 员 变 量 值 
设置 好 以 后 重新 编译 uboot， 然 后 烧 写 到 SD 卡 中 ， 选 择 SD 卡 启动 ， 
SecureCRT, uboot 会 输出 如 图 32.2.5.7 所 示 信 息 : 


DRAM: gd-»ram size 0x20000000 
gd-»ram top O0xa0000000 
ad-»relocaddr 0xa0000000 


图 32.2.5.7 信息 输出 





E 启 开发 板 ， 打 开 


limi 


























从 图 32.2.5.7 可 以 看 出 : 

gd->ram size = 0X20000000 //ram 大 小 为 0X20000000=512MB 

gd->ram top = 0XA0000000 //ram 最 高 地 址 为 0X80000000+0X20000000=0XA0000000 

gd->relocaddr = 0XA0000000 ”UW 重 定位 后 最 高 地 址 为 0XA0000000 

第 45 ÍT, reserve round 4k 函数 用 于 对 gd->relocaddr 做 4KB 对 齐 ， 为 
gd->relocaddr=0XA0000000， 己 经 是 4K 对 齐 了 ， 所 以 调整 后 不 变 。 

第 46 行 ，reserve mmu， 留 出 MMU 的 TLB 表 的 位 置 ， 分 配 MMU 的 TLB 表 内 存 以 后 会 
对 gd->relocaddr 做 64K 字 节 对 齐 。 完 成 以 后 gd->arch.tlb_size、gd->arch.tlb_addr 和 gd->relocaddr 
如 图 32.2.5.8 所 示 : 
gd-»arch.tlb size 0x4000 


gd-»arch.tlb add Ox9fffO0000 
gd-»relocaddr Ox9fff0000 


图 32.2.5.8 信息 输出 
































从 图 32.2.5.8 可 以 看 出 : 

gd->arch.tlb_size= 0X4000 //MMU 的 TLB 表 大 小 
gd->arch.tlb_addr=0X9FFF0000 //MMU 的 TLB 表 起 始 地 址 ，64KB 对 齐 以 后 
gd->relocaddr=0X9FFF0000 //relocaddr 地 址 


第 47 fT, reserve trace 函数 ， 留 出 跟踪 调试 的 内 存 ，LMX6ULL 没有 用 到 ! 

第 48 fT, reserve uboot, 留 出 重 定位 后 的 uboot 所 占用 的 内 存 区 域 ，uboot 所 占用 大 小 由 
gd-»mon len 所 指定 ， 留 出 uboot 的 空间 以 后 还 要 对 gd->relocaddr 做 4K 字 节 对 齐 ， 并 且 重 新 设 
置 gd-»start addr sp， 结果 如 图 32.2.5.9 所 示 : 
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gd->mon_len =0XA8EF4 
gd-»start addr sp =0X9FF47000 
gd-»relocaddr  -Ox9rFr47000 


图 32.2.5.9 信息 输出 








从 图 32.2.5.9 可 以 看 出 : 

gd->mon len= 0XA8EF4 

gd->start addr sp = OX9FF47000 

gd->relocaddr = OX9FF47000 

第 49 ÍT, reserve malloc， 留 出 malloc 区 域 ,调整 gd->start addr sp 位 置 ，malloc 区 域 由 宏 
TOTAL MALLOC LEN 定义 ， 宏 定义 如 下 : 

#define TOTAL MALLOC LEN (CONFIG SYS MALLOC LEN 二 
CONFIG ENV SIZE) 

mx6ull alientek emmc.h 文件 中 定义 宏 CONFIG SYS MALLOC LEN 为 16MB-0X1000000, 
宏 CONFIG ENV SIZE-8KB-0X2000. [AJ TOTAL MALLOC LEN=0X1002000。 调 整 以 后 
gd-»start addr sp 如 图 32.2.5.10 所 示 : 

| Huet -0x1002000 
gd-»start addr sp -Ox9EF45000 
图 32.2.5.10. 信息 输出 


























从 图 32.2.5.10 可 以 看 出 : 

TOTAL MALLOC LEN=0X1002000 

gd->start addr sp=0X9EF45000 //OX9FF47000-16MB-8K B-0X9EF45000 

第 50 fT, reserve board 函数 ， 留 出 板子 bd 所 占 的 内 存 区 ，bd 是 结构 体 bd_t，bd_t 大 小 为 
80 字 节 ， 结 果 如 图 32.2.5.11 所 示 : 


gd->bd = 0X9EF44FB0 
gd-»start addr sp = 0X9EF44FB0 


图 32.2.5.10 信息 输出 











从 图 32.2.5.11 可 以 看 出 : 
gd->start addr sp=0X9EF44FBO 
gd->bd=0X9EF44FB0 
第 51 行 ，setup_machine， 设 置 机 器 ID, linux 启动 的 时 候 会 和 这 个 机 器 ID 匹配 ， 如 果 匹 
配 的 话 linux 就 会 启动 正常 。 但 是 !! LMX6ULL 不 用 这 种 方式 了 ， 这 是 以 前 老 版 本 的 uboot 和 
linux 使 用 的 ， 新 版 本 使 用 设备 树 了， 因此 此 函数 无 效 。 
第 52 íT, reserve global data 函数 ， 保 留 出 gd t 的 内 存 区 域 , gd t 结构 体 大 小 为 248B， 结 
果 如 图 32.2.5.11 所 示 : 
gd->new_gd = Ox9ef44eb8 
gd->start_addr_sp = 0x9ef44eb8 
图 32.2.5.11 信息 输出 
gd-»start addr sp-0X9EF44EB8  //OX9EF44FB0-248=0X9EF44EB8 
gd-^new gd-0X9EF44EB8 
第 53 行 ，reserve_fdt， 留 出 设备 树 相关 的 内 存 区 域 ，LMX6ULL 的 uboot 没有 用 到 ， 因 此 
此 函数 无 效 。 
第 54 1T, reserve arch 是 个 空 函 数 。 
第 55 行 ，reserve_stacks， 留 出 栈 空间 ， 先 对 gd->start addr sp 减 去 16， 然 后 做 16 字 节 对 
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其 。 如 果 使 能 IRQ 的 话 还 要 留 出 IRQ 相应 的 内 存 ， 有 具体 工作 是 由 arch/arm/lib/stack.c 文件 中 的 
函数 arch reserve stacks 完成 。 结 果 如 图 32.2.5.12 所 示 : 
川 gd->start_addr_sp = Ox9ef44e90 
32.2.5.12 信息 输出 
在 本 uboot 中 并 没有 使 用 到 IRQ， 所 以 不 会 留 出 IRQ 相应 的 内 存 区 域 ， 此 时 ; 























gd->start addr sp=0X9EF44E90 

第 56 fT, setup dram config 函数 设置 dram 信息 ， 就 是 设置 gd->bd->bi_dram[0].start 和 
gd->bd->bi dram[0].size， 后 面 会 传递 给 linux 内 核 , 告诉 linux DRAM 的 起 始 地 址 和 大 小 。 结 果 
如 图 32.2.5.13 所 示 : 
| gd-»bd-»bi. dram[0].start = 0x80000000 

gd-»bd-»bi dram[0].size = 0x20000000 
32.2.5.13 信息 输出 

从 图 32.2.5.13 可 以 看 出 ,DRAM 的 起 始 地 址 为 0X80000000, 大 小 为 0X20000000(512MB)。 
第 57 fT, show dram config 函数 ， 用 于 显示 DRAM 的 配置 ， 如 图 32.2.5.14 所 示 : 


Board: MX6ULL 14X14 EVK 
IA read 














.FSL-SDHC: 1 
32.2.5.14. 信息 输出 
第 58 fT, display new sp 函数 ， 显 示 新 的 sp 位 置 ， 也 就 是 gd->start addr sp， 不 过 要 定义 

宏 DEBUG， 结 果 如 图 32.2.5.15 所 示 : 


KEDEL CdU»€C€. UIIKTIUWII FT CSOCL 
Board: MX6ULL 14x14 EVK 
I2C: ready 















[New Stack Pointer is: 
|Display: TFT43AB (480x272) 
Video: 480x272x24 
In: serial 
图 32.2.5.15 信息 输出 
32.2.5.15 中 的 gd->start_addr_sp 值 和 我 们 前 面 分 析 的 最 后 一 次 修改 的 值 一 致 。 
第 60 íF, reloc fdt 函数 用 于 重 定位 fdt， 没 有 用 到 。 
第 61 íT, setup reloc, 设置 gd 的 其 他 一 些 成 员 变 量 ， 供 后 面 重 定位 的 时 候 使 用 ， 并 且 将 以 
前 的 gd 拷贝 到 gd->new_gd 处 。 需 要 使 能 DEBUG 才能 看 到 相应 的 信息 输出 ， 如 图 32.2.5.16 所 
示 : 





















































DRAM: 512 MiB 
Relocation offset is: 18747000 
Relocating to 9ff47000, new gd at 9ef44eb8, sp at 9ef44e90 











32.2.5.16 信息 输出 

从 图 32.2.5.16 可 以 看 出 ，uboot 重 定位 后 的 偏 移 为 0X18747000， 
0X9FF4700， 新 的 gd 首 地 址 为 0X9EF44EB8， 最 终 的 sp 为 0X9EF44E90。 
至 此 ，board_init 函数 就 执行 完成 了 ， 最 终 的 内 存 分 配 如 图 32.2.5.16 所 示 : 


定位 后 的 新 地 址 为 


Im 
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0XA0000000—— 


reserve mmu-0x4000 


(64 字 节 对 齐 ) 


ATH 


reserve uboot-O0XASEF4 
(4K 字 节 对 齐 ) 


0X9FF47000—— gd->relocaddr 


reserve malloc-16MB-8KB 


reserve board-80B OX9EF45000— — 
0X20000000 (512MB)^ 0X9EF44FB0 一 gd-»bd 


reserve global data-248B 
gd(gd t) 
OX9EFA4EBS—— gd-?new gd 


16 字 节 对 齐 
reserve stacks 
16 字 节 对 齐 
< —0X9EF44E90 一 — gd->start_addr_sp 








0X80000000—— 
图 32.2.5.16 最 终 的 内 存 分 配 图 


32.2.6 relocate code 函数 详解 


relocate code 函数 是 用 于 代码 拷贝 的 ,此 函数 定义 在 文件 arch/arm/lib/relocate.S 中 ,代码 如 
F: 











示例 代码 32.2.6.1 relocate.S 代码 段 
* 
= VEC relocare Coce sec mema) 


* This function relocates the monitor code. 


Som: 





* To prevent the code below from containing references with an 


= RAM ABSS2 relocation Scorel tyde, We never reter to linker- 
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* defined symbols directly. 


Instead, 


论坛 :www.opendev.com 


we declare literals which 


comoediis oa omnes ee relocats Coce, 


* and at run time, 


es 
80 
81 
82 
83 
84 
85 
86 
87 
88 
S 
90 
gial 
92 
93 
94 
95 
96 
9 
98 
99 
100 
101 
102 
103 
104 
HOS 
106 
107 
108 
1108) 
AERE 
Wai 
D 
1:35) 
114 
es 
116 


a 


ENTRY (relocate code) 





eicicemeleca eee» cid oT. 


lohe i1, c»  ibuegye copy tor/ x1 «— SINC ma Gl Seu "/ 

subs i4. sz, zi /* r4 «— relocation offset */ 

beq relocate done kipi re locat renis 

ldr r2, = image copy end [^ r2 «— SINE: ($$ image copy end */ 
copy loop: 

ldmia  r1!, (ri10-r11) /* copy from source address [r1] * 


eneete — OU. elsi /* copy to target address [r0] w 


cmo zl, r2 usm ource endkadares S [2] */ 


blo copy loop 


/* 
* fix .rel.dyn relocations 
5 
lehe 1:2, £2  xel cya art :2 «— SRC & xel cwm sue */ 
lor 159, = rel dyn end /rr =<- SRC è rel dyn end */ 
fixloop: 
lomda YOU Qqu-unp S CO «x (SEXO locer om Ebano) = 


and rl, r1, 40xff 


emp rl, $23 /* relative fixup? */ 


bne fixnext 


/* relative fix: increase location by offset */ 


ewolel ic), ael. 18d 

teke iy soy 

ewe! icd, ael ied 

ene ile [De] 
fixnext: 

En 2 23 


blo fixloop 


relocate done: 


#ifdef — XSCALI 
/ * 





Ea] 


* On xscale, icache must be invalidated and write buffers 


* drained, even with cache disabled - 4.2.7 of xscale core 
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Tay developer's manual */ 

118 mer Tobi O veo en xe /* invalidate icache */ 

TIS) mer plop O 07 G7, cd, 4 / ciam waa) lowutiese = / 

120 #endif 

TE 


122 /* ARMv4- don't know bx lr but the assembler fails to see that */ 
123 

124 #ifdef ARM ARCH 4 

2S moy Pe, LE 

126 #else 

LAT los diiz 

128 #endif 





130 ENDPROC(relocate code) 

第 80 fT. rl= image copy _ start， 也 就 是 rl 寄存 器 保存 源 地 址 ， 由 表 31.4.1.1 可 知 ， 
. image copy start-0X87800000. 

第 81 行 ，r0=0X9FF47000, 这 个 地 址 就 是 uboot 拷贝 的 目标 首 地 址 。r4=r0-r1=OX9FF47000- 
0X87800000=0X18747000， 因 此 r4 保存 偏 移 量 。 

第 82 行 ， 如 果 在 第 81 中 ，r0-rl SET 0, 说明 r0 和 rl 相等 ， 也 就 是 源 地 址 和 目的 地 址 是 
一 样 的 ， 那 肯定 就 不 需要 拷贝 了 ! 执行 relocate done 函数 

第 83 fT, I2=_image_copy_end，r2 中 保存 拷贝 之 前 的 代码 结束 地 址 ， 由 表 31.4.1.1 可 知 ， 
. image copy end =0x8785dd54. 

第 84 行 ， 函 数 copy loop 完成 代码 拷贝 工作 ! 从 rl, QE image copy start JT 48, iX 
取 uboot 代码 保存 到 rl0 和 Trll 中 ， 一 次 就 只 拷贝 这 2 个 32 位 的 数据 。 找 贝 完成 以 后 rl 的 值 会 
更 新 ， 保 存 下 一 个 要 拷贝 的 数据 地 址 。 

第 87 行 ， 将 rl0 F rll 的 数据 写 到 r0 开始 的 地 方 ， 也 就 是 目的 地 址 。 写 完 以 后 r0 的 值 会 
更 新 ， 更 新 为 下 一 个 要 写 入 的 数据 地 址 。 

第 88 行 ， 比 较 rl 是 否 和 1 相等， 也 就 是 检查 是 否 找 贝 完 成 ， 如 果 不 相等 的 话说 明 没有 找 
贝 完成 ， 没 有 拷贝 完成 的 话 就 跳 转 到 copy loop REHIN, EEH INER 

接 下 来 的 第 94 行 ~109 行 是 重 定位 .rel.dyn Et; .rel.dyn 段 是 存放 .text 段 中 需要 重 定位 地 址 的 
集合 。 重 定位 就 是 uboot 将 自身 拷贝 到 DRAM 的 另 一 个 地 放 去 继续 运行 DRAM 的 高 地 址 处 )。 
我 们 知道 ， 一 个 可 执行 的 bin 文件 ， 其 链接 地 址 和 运行 地 址 要 相等 ， 也 就 是 链接 到 哪个 地 址 ， 
在 运行 之 前 就 要 拷贝 到 哪个 地 址 去 。 现 在 我 们 重 定位 以 后 ， 运 行 地 址 就 和 链接 地 址 不 同 了 ， 这 
样 寻 址 的 时 候 不 会 出 问题 吗 ? 为 了 分 析 这 个 问题 ， 我 们 需要 在 mx6ull_ alientek_emmc.c 中 输入 
如 下 所 示 内 容 : 











i 
























































示例 代码 32.2.6.2 mx6ull. alientek. emmc.c 新 添 代码 段 


starie ime zel mt = (Up 


il 

2 
Se ne ral eene (Tole) 

& d 

5 zel aa 100} 

oor ine (eed iex ve Ns P 
To 
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最 后 还 需要 在 mx6ullevk.c 文件 中 的 board. init 函数 里 面 调用 rel test 函数 , 否则 rel reset 不 
会 被 编译 进 uboot。 修 改 完成 后 的 mx6ullevk.c 如 图 32.2.6.1 所 示 : 
826 static int rel a = 6; 






































827 

828 void rel test(void) 

829 

830 rel a - 100; 

831 printf("rel test\r\n"); 
832 

833 

834 int board init(void) 

835 

836 rel test(); 





图 32.2.6.1 加 入 rel 测试 相关 代码 
board init 函数 会 调用 rel test, rel test 会 调用 全 局 变量 rel a， 使 用 如 下 命令 编译 uboot: 
./mx6ull alientek emmc.sh 
编译 完成 以 后 ， 使 用 arm-linux-gnueabihf-objdump 将 u-boot 进行 反 汇 编 ， 得 到 u-boot.dis 这 
个 汇编 文件 ， 命 令 如 下 : 
arm-linux-gnueabihf-objdump -D -m arm u-boot > u-boot.dis 
在 u-boot.dis 文件 中 找到 rel a. rel rest 和 board. init， 相 关内 容 如 下 所 示 : 
示例 代码 32.2.6.3 汇编 文件 代码 段 









































Eee 

2 87804184: e59f300c lee x9. Mer UA 7 GIGUAIISS. cweedL testir ilds 
3 87804188: e3a02064 mov r2, 4100 ; 0x64 

ZO Sc. e59f0008 ldr r0, [pc, $8] 2 ema Srel testa iL 
SO e5832000 Su x2, [31 

6 87804194: ea00d668 b  87839b3c Xprintf» 

T CS vtrex OA 8785da50 ; «UNDEFINED» instruction: 0x8785da50 
8 8780419c: 87842622 SEN — 352.5 lue. se2, ams i515 

9 

10 878041a0 «board init»: 

11 878041a0: e92d4010 push (aga. Jess 

12 878041a4: ebfffff6 bl 87804184 «rel test» 

T3 

IA sasae 

dL 

16 8785da50 «rel a»: 

UO IO eai 00000000 andeq r0, r0, r0 





第 12 行 是 borad init 调用 rel test 函数 ， 用 到 了 bl 指令， 而 bl 指令 时 位 置 无 关 指令 ，bl 指 
令 是 相对 寻 址 的 (pctoffset)， 因 此 uboot 中 函数 调用 是 与 绝对 位 置 无 关 的 。 

再 来 看 一 下 函数 rel test 对 于 全 局 变量 rel a 的 调用 , 第 2 行 设置 r3 的 值 为 pc+12 地 址 处 的 
值 ,因为 ARM 流 水 线 的 原因 ,pc 寄存 器 的 值 为 当前 地 址 +8, 因此 pc=0X87804184+8=0X8780418C， 
13-0X8780418C-12-0X87804198, $% 7 行 就 是 0X87804198 这 个 地 址 ，0X87804198 处 的 值 为 
0X8785DA50. 根据 第 17 行 可 知 , 0X8785DA50 正 是 变量 rel a 的 地 址 , 最 终 r13-0X8785DA50. 
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第 3 1T. 12-100. 

*8 5T, TE I2 ARESE r3 地 址 处 ， 也 就 是 设置 地 址 0X8785DA50 的 值 为 100， 这 不 就 
是 示例 代码 代码 32.2.6.2 中 的 第 5 fT: rel a= 100. 

总 结 一 下 rel a-100 的 汇编 执行 过 程 : 





























D, ERX rel test 末尾 处 有 一 个 地 址 为 0X87804198 的 内 存 空 间 ( 示 例 代 码 32.2.6.3 第 7 
行 )， 此 内 存 空 间 保 存 着 变量 rel a 的 地 址 。 
©, RŽ rel test 要 想 访 问 变量 rel_ a， 首 先 访问 末尾 的 0X87804198 来 获取 变量 rel a 的 地 
址 ， 而 访问 0X87804198 是 通过 偏 移 来 访问 的 ， 很 明显 是 个 位 置 无 关 的 操作 。 
©, I 0X87804198 获取 到 变量 rel a 的 地 址 ， 对 变量 rel a 进行 操作 。 
O, UAH, KA rel test 对 变量 rel a 的 访问 没有 直接 进行 ， 而 是 使 用 了 一 个 第 三 方 偏 
移 地 址 0X87804198， 专 业 术语 叫做 Label。 这 个 第 三 方 偏 移 地 址 就 是 实现 重 定位 后 运行 不 会 出 
普 的 重要 原因 ! 
uboot 重 定 位 后 偏 移 为 0X18747000， 那 么 重 定 位 后 函数 rel test. 的 首 地 址 就 是 
0X87804184+0X18747000=0X9FF4B184 . 保存 变量 rela 地 址 的 Label 就 是 
0X9FF4B184+8+12=0X9FF4B198( 既 : 0X87804198+0X18747000)， 变 量 rel a 的 地 址 就 为 
0X8785DA50+0X18747000=0X9FFA4A50。 重 定位 后 函数 rel test 要 想 正 常 访问 变量 rel a 就 得 
设置 0X9FF4B198( 重 定位 后 的 LabeD) 地 址 出 的 值 为 0X9FFA4A50( 重 定位 后 的 变量 rel a 地 址 )。 
这 样 就 解决 了 重 定位 后 链接 地 址 和 运行 地 址 不 一 致 的 问题 。 
可 以 看 出 ，uboot 对 于 重 定位 后 链接 地 址 和 运行 地 址 不 一 致 的 解决 方法 就 是 采用 位 置 无 关 
码 ， 在 使 用 ld 进行 链接 的 时 候 使 用 选项 “-pie” 生 成 位 置 无 关 的 可 执行 文件 。 在 文件 
arch/arm/config.mk 下 有 如 下 代码 : 
示例 代码 32.2.6.4 config.mk 文件 代码 段 
82 4 needed for relocation 
83 LDFLAGS U-boot 3S -pie 
第 83 行 就 是 设置 uboot 链接 选项 ， 加 入 了 “-pie” 选 项 , 编译 链接 uboot 的 时 候 就 会 使 用 到 
“-pie”， 如 图 32.2.6.2 所 示 : 
arm-Linux-gnueabihf-Ld.bfd -pie )--gc-sections -Bstatic -Ttext 0x87800000 -o u-boot -T u-boot.lds arc 
h/arm/cpu/armv7/start.o --start-group arch/arm/cpu/built-in.o arch/arm/cpu/armv7/built-in.o arch/arm/i 
mx-common/built-in.o arch/arm/lib/built-in.o board/freescale/common/built-in.o board/freescale/mx6ull_ 
alientek_emmc/built-in.o cmd/built-in.o common/built-in.o disk/built-in.o drivers/built-in.o drivers 
/dma/built-in.o drivers/gpio/built-in.o drivers/i2c/built-in.o drivers/mmc/built-in.o drivers/mtd/bui 
lt-in.o drivers/mtd/onenand/built-in.o drivers/mtd/spi/built-in.o drivers/net/built-in.o drivers/net/ 
phy/built-in.o drivers/pci/built-in.o drivers/power/built-in.o drivers/power/battery/built-in.o drive 
rs/power/fuel gauge/built-in.o drivers/power/mfd/built-in.o drivers/power/pmic/built-in.o drivers/powe 
r/regulator/built-in.o drivers/serial/built-in.o drivers/spi/built-in.o drivers/usb/dwc3/built-in.o d 
rivers/usb/emul/built-in.o drivers/usb/eth/built-in.o drivers/usb/gadget/built-in.o drivers/usb/gadget 
/udc/built-in.o drivers/usb/host/built-in.o drivers/usb/musb-new/built-in.o drivers/usb/musb/built-in. 
o drivers/usb/phy/built-in.o drivers/usb/ulpi/built-in.o fs/built-in.o lib/built-in.o net/built-in.o 
test/built-in.o test/dm/built-in.o --end-group arch/arm/lib/eabi compat.o -L /usr/local/arm/gcc-linar 
0-4.9.4-2017.01-x86 64 arm-linux-gnueabihf/bin/../lib/gcc/arm-linux-gnueabihf/4.9.4 -lgcc -Map u-boot.map 


arm-linux-gnueabihf-objcopy --gap-fill-Oxff -j .text -j .secure text -j .rodata -j .hash -j .data -j . 
got -j .got.plt -j .u boot list -j .rel.dyn -0 binary u-boot u-boot-nodtb.bin 


图 32.2.6.2 链接 命令 
使 用 “-pie” 选 项 以 后 会 生成 一 个 .rel.dyn 段 ，uboot 就 是 靠 这 个 :rel.dyn 来 解决 重 定位 问题 
HJ, TE u-bot.dis 的 .rel.dyn 段 中 有 如 下 所 示 内 容 : 
示例 代码 32.2.6.5 .rel.dyn 段 代 码 段 
1 Disassembly of section .rel.dyn: 
2 
3 8785da44 « rel dyn end-0x8ba0»: 
4 8785da44: 87800020 sermi — 07 [ue se, iles $25 
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5 8785da48: 00000017 andeq 3x30. se, 3e. Joel xe 


DS 
8. 8 


785dfb4: 87804198 ; XUNDEFINED» instruction: 0x87804198 
Wis foo kaosi OOOO andega OS Oc PST 


先 来 看 一 下 .rel.dyn 段 的 格式 ， 类 似 第 7 行 和 第 8 行 这 样 的 是 一 组 ， 也 就 是 两 个 4 字 节 数据 























为 一 组 。 高 4 字 节 是 Label 地 址 标识 0X17， 低 4 字 节 就 是 Label 的 地 址 ， 首 先 判 断 Label 地 址 
标识 是 否 正 确 ， 也 就 是 判断 高 4 字 节 是 否 为 0X17， 如 果 是 的 话 高 4 字 节 就 是 Label fü. 























第 7 行 值 为 0X87804198， 第 8 行为 0X00000017， 说 明 第 7 行 的 0X87804198 是 个 Label, 





这 个 正 是 示例 代码 32.2.6.3 中 存放 变量 rel a 地 址 的 那个 Label。 根 据 前 面 的 分 析 ， 只 要 将 地 址 
0X87804198+offset 处 的 值 改 为 重 定位 后 的 变量 rel a 地 址 即 可 。 我 们 猜测 的 是 否 正确 ， 看 一 下 
uboot 对 .rel.dyn 段 的 重 定位 即 可 (示例 代码 代码 32.2.6.1 中 的 第 94~109 行 )，.rel.dyn 段 的 重 定位 





















































代码 如 下 : 
示例 代码 32.2.6.6 relocate.S 代码 段 
91 [5 
92 acer eee re locations 
9S E 
94 lehe 1:2, £3 sel chym aa e aaa a */ 
95 lor 9, = rel dyn eod — /* i3) =<- (SEC & rel dyn end "7 
SiS ELOD 
977 ldmia 152. heo sed A CO «x (USING ocer aom Ebano 7 
98 andiari Osccrir 
99 cmp rl, $23 /* relative fixup? */ 
100 bne fixnext 
MOA 
ENS /* relative fix: increase location by offset */ 
MOS acel 0y 0p 4 
104 te sil, [re 
IOS acid 号 Te ael ied 
106 enex seil Eeo] 
107 fixnext: 
108 (emo rS 
109 blo fixloop 


第 94 1T, r2— rel dyn_start， 也 就 是 .rel.dyn 段 的 起 始 地 址 。 
第 95 fT, r3— rel dyn end， 也 就 是 .rel.dyn 段 的 终止 地 址 。 



























































第 97 行 ， 从 .rel.dyn 段 起 始 地 址 开始 ， 每 次 读 取 两 个 4 字 节 的 数据 存放 到 r0 和 rl 寄存 器 
中 , r0 存放 低 4 字 节 的 数据 ， 也 就 是 Label 地 址 ; rl 存放 高 4 字 节 的 数据 ， 也 就 是 Label 标志 。 

第 98 行 ，rl 中 给 的 值 与 0xff 进行 与 运算 ， 其 实 就 是 取 rl 的 低 8 位 。 

第 99 行 ， 判 断 r1 中 的 值 是 否 等 于 23(0X17)。 

第 100 行 ， 如 果 rl 不 等 于 23 的 话 就 说 明 不 是 描述 Label 的 ， 执 行 函数 fixnext， 否 则 的 话 
继续 执行 下 面 的 代码 。 








第 103 fT. r0 保存 着 Label 值 ，r4 保存 着 重 定位 后 的 地 址 偏 移 ，r0+r4 就 得 到 了 重 定位 后 的 











Label 值 。 此 时 r0 保存 着 重 定 位 后 的 Label 值 ,相当 于 0X87804198+0X18747000=0X9FF4B198。 





第 104， 读 取 重 定位 后 Label 所 保存 的 变量 地 址 ， 此 时 这 个 变量 地 址 还 是 重 定位 前 的 (相当 
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T rel a 重 定位 前 的 地 址 0X8785DA50)， 将 得 到 的 值 放 到 rl 寄存 器 中 。 

第 105 行 ，rltr4 即 可 得 到 重 定 位 后 的 变量 地 址 ， 相 当 于 rel a 重 定位 后 的 
0X8785DA50+0X18747000=0X9FFA4A 50. 




















第 106 fr, 重 定位 后 的 变量 地 址 写 入 到 重 定位 后 的 Label 中 , 相等 于 设置 地 址 OX9FFABI98 
处 的 值 为 0X9FFA4A50。 

第 108 47, LUE 12 和 13， 查 看 .rel.dyn 段 重 定位 是 否 完成 。 

第 109 fT, WÈ r2 F r3 不 相等 ,说 明 .rel.dyn 重 定 位 还 未 完成 ， 因 此 跳 到 fixloop 继续 重 定 
位 .rel.dyn 段 。 

可 以 看 出 ，uboot 中 对 .rel.dyn 段 的 重 定位 方法 和 我 们 猜想 的 一 致 。.rel.dyn 段 的 重 定位 比较 
复杂 一 点 ， 有 点 绕 ， 因 为 涉及 到 链接 地 址 和 运行 地 址 的 问题 。 
































32.2.7 relocate_vectors 函数 详解 


函数 relocate vectors 用 于 重 定位 向 量 表 ， 此 函数 定义 在 文件 函数 源码 如 下 ; 
示例 代码 32.2.7.1 relocate.S 代码 段 
27 ENTRY(relocate vectors) 





























28 

29 #ifdef CONFIG CPU V7M 

30 je 

E * On ARMv7-M we only have to write the new vector address 

31 * to VTOR register. 

ES p 

34 ldr r0, [r9, $GD RELOCADDR] /* r0 —- gd-»relocaddr x 

35 ldr r1, =V7M_SCB_BASE 

36 SEO [El1, VIM SCE VIORI 

37 #else 

38 #ifdef CONFIG HAS VBAR 

39 [5 

40 * If the ARM processor has the security extensions, 

41 * use VBAR to relocate the exception vectors. 

42 i 

43 lar r0, [r9, £GD RELOCADDR] /* r0  gd-»relocaddr ir 

44 mcr plop UU, 70; ei2. eU), 0  J* Su WINE E 

45 #else 

46 f 

47] * Copy the relocated exception vectors to the 

48 = COrreCt eXlohs eS 

49 = Chla (uL y loke ene is wig locari Qi Tie wieXelosss s 

50 * 0x00000000 or OxFFFF0000. 

Sil 57, 

52 ldr r0, [r9, $GD RELOCADDR] /* r0 - gd-»relocaddr E 
5S meS pls, Üp 525 el, eO, 0 A xr dee Marelle im CHS el — 
54 ands E2 posco) 

55 ldreq r1, =0x00000000 /* If V-0 fo 
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56 

SA Vomi omron 
58 stmia ED 
59 lema — sU. 
60 stmia seue 
61 endif 

62 endif 

63 loz Jiz 

64 





(362—168 5181.01) 
(382—360 181.0) 
(362 31689 5181.01) 
(362) eer e 1.00) 


65 ENDPROC(relocate vectors) 
第 29 行 ， 如 果 定 义 了 CONFIG CPU V7M 的 话 就 执行 第 30-36 行 的 代码 ， 这 是 Cortex-M 
内 核 单 片 机 执行 的 语句 ， 因 此 对 于 IMX6ULL 来 说 是 无 效 的 。 














论坛 :Www.opendev.com 
/* Tf 三 下 i 














第 38 行 ,如 果 定 义 了 CONFIG_HAS_VBAR 的 话 就 执行 此 语句 , 这 个 是 向 量 表 偏 移 , Cortex- 
A7 是 支持 向 量 表 偏 移 的 。 而 且 ， 在 .config 里 面 定义 了 CONFIG HAS_VBAR， 因 此 会 执行 这 个 


分 支 。 
第 43 行 ，r0=gd->relocaddr， 也 就 是 寻 





始 存放 的 。 


第 44 行 ， 将 r0 的 值 写 入 到 CPIS 的 VBAR 寄存 器 中 ， 也 就 是 将 新 的 向 量 表 首 地 址 写 入 到 


寄存 器 VBAR 中 ， 设 置 向 














量 表 偏 移 。 





32.2.8 board init r 函数 详解 


第 322.5 小 节 讲 解 了 board init f 函 数 ,在 此 函数 里 面 会 调用 一 系列 的 函数 来 初始 化 一 些 外 
设 和 gd 的 成 员 变量 。 但 是 board_init 了 并 没有 初始 化 所 有 的 外 设 ， 还 需要 做 一 些 后 续 工作 ， 这 


























定位 后 uboot 的 首 地 址 ， 向 量 表 衣 定 是 从 这 个 地 址 开 





F 















































HPAZ board init r 来 完成 的 ，board init r 函数 定义 在 文件 common/board r.c 


示例 代码 32.2.8.1 board, r.c 代码 段 
void board init r(gd t *new gd, ulong dest addr) 














mmo init r(dest adar}, 


些 后 续 工作 就 是 上 

中 ， 代 码 如 下 : 

OS 

Oo? 

993 4ifdef CONFIG N 
994 stia "ab 

995 #endif 

996 

So CIC CONEIG AVRS2 
998 

999 dendif 

1000 


EEDS MANUAL RELOC 





1001 £4if !defined(CONFIG X86) && !defined(CONFIG ARM) 
&& 'defined(CONFIG ARM64) 


1002 
1003 
1004 
1005 
1006 


gd = new gd; 
fendif 





*ifdef CONFIG N 
for (i - 0; i « ARRAY SIZI 




















EEDS MANUAL RELOC 


(cn seguence rhe 1r) 
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1007 ialt geguence Tii "= gelzxelece eui 

1008 #endif 

1009 

1010 sus (QGueaseem lli run lisrt{init seguence i£)) 

EDITT hang(); 

ALES 

EIOS //** NOTREACHED — run main ovp) ele not ecurn / 











1014 hang(); 


ONES pn 


第 1010 行 调用 initcall run list 函数 来 执行 初始 化 序列 init sequence r, init sequence r 是 
一 个 函数 集合 ，init sequence T 也 定义 在 文件 common/board r.c F, 由 于 init sequence f 的 内 容 














比较 长 ， 里 面 有 大 量 的 条 件 编译 代码 ， 这 里 为 了 缩小 篇 幅 ， 将 条 件 编译 部 分 删除 挥 了 ， 去 掉 
































牛 编译 以 后 的 init_sequence r 定义 如 下 : 


示例 代码 32.2.8.2 board, t.c 代码 段 




































































l imit fne t init eeguence rii = q 
2 inite trace; 

B) imite reloge, 

4 inite CacheS,; 

5 imiter reloe globel (leues. 

6 inite barrier, 

y oer malloc, 

8 inite Console iecore, 

9 booeseaec relocate 

10 inite bootetagep 

下 站 board init, /* Setup chipselects */ 
12 stodio init tables, 

IS inite serial, 

14 initr announce, 

35) INIT FUNC WATCHDOG RESET 

16 INIT FUNC WATCHDOG RESET 

17 INIT FUNC WATCHDOG RESET 

Is, power init board, 

T9 inite ilash, 

20 INIT FUNC WATCHDOG RESET 

2l initr nand, 

22 Inite Te 

25 imiter Guy. 

24 INIT FUNC WATCHDOG RESET 

25 imu eomelen Cou, 

26 INIT _ FUNC WATCHDOG RESET 

27 stdio add devices, 

28 inite wage elle; 

29 console inic T, /* fully init console as a device */ 
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30 INIT FUNC WATCHDOG RESET 
el interrupt init, 

32 inite enable interrupts, 
23 inite Snadaele ;; 

34 board) late init, 

35 INIT FUNC WATCHDOG RESET 
36 INIT FUNC WATCHDOG RESET 
9 INIT FUNC WATCHDOG RESET 
38 imite Ner, 

39 INIT FUNC WATCHDOG RESET 
40 run main loop, 

aal De 














第 2 fT, initr trace 函数 ， 如 果 定 义 了 宏 CONFIG TRACE 的 话 就 会 调用 函数 trace. init, 
初始 化 和 调试 跟踪 有 关 的 内 容 。 

第 3 fT, initr reloc 函数 用 于 设置 gd->flags， 标 记 重 定位 完成 。 

第 4 行 ，initr_caches 函数 用 于 初始 化 cache， 使 能 cache. 

第 54T, initr reloc global data 函数 ， 初 始 化 重 定位 后 gd 的 一 些 成 员 变 量 。 

第 6 行 ，initr_barrier 函数 ，LMX6ULL 未 用 到 。 

第 7 行 ，initr_malloc 函数 ， 初 始 化 malloc。 

第 8 行 , initr_console record 函数 , 初始 化 控制 台 相 关 的 内 容 , LMX6ULL 未 用 到 , TRAL 

第 9 1T, bootstage relocate 函数 ， 启 动 状态 重 定 位 。 

第 10 行 ，initr_bootstage 函数 ， 初 始 化 bootstage 什么 的 。 

第 1147, board init 函数 ， 板 级 初始 化 ， 包 括 74XX 芯片 ，DPC、FEC、USB 和 QSPI 等 。 
这 里 执行 的 是 mx6ull alientek emmc.c 文件 中 的 board. init 函数 。 

第 12 行 ，stdio_init tables 函数 ，stdio 相关 初始 化 。 

第 13 1T, initr serial 函数， 初始 化 串口 。 

第 14 1T, initr announce 函数 ， 与 调试 有 关 ， 通 知已 经 在 RAM 中 运行 。 

第 18 ÍT, power init board 函数 ， 初 始 化 电源 芯片 ， 正 点 原子 的 LIMX6ULL 开发 板 没 有 用 
到 。 

第 19 行 ，initr_flash 函数 ， 对 于 工 MX6ULL 而 言 ， 没 有 定义 宏 CONFIG_SYS_NO_FLASH 
的 话 函数 initr_flash 才 有 效 。 但 是 mx6_common.h 中 定义 了 宏 CONFIG SYS NO FLASH, 所 以 
此 函数 无 效 。 

第 21 行 ，initr_nand 函数 ， 初 始 化 NAND， 如 果 使 用 NAND 版 本 核心 板 的 话 就 会 初始 化 
NAND. 

第 22 fT, initr mmc 函数 ， 初 始 化 EMMC， 如 果 使 用 EMMC 版 本 核心 板 的 话 就 会 初始 化 
EMMC， 串 口 输出 如 图 32.2.8.1 所 示 信 息 : 

512 MiB 
MMC: FSL SDHC: 0, FSL SDHC: 1 
图 32.2.8.1 EMMC 信息 输出 

从 图 32.2.8.1 可 以 看 出 ， 此 时 有 两 个 EMCM 设备 ，FSL _ SDHC:0 和 FSL SDHC:1. 

第 23 行 ，initr_env 函数 ， 初 始 化 环境 变量 。 

第 25 行 ，initr_secondary_cpu 函数 ， 初 始 化 其 他 CPU 核 ，LMX6ULL 只 有 一 个 核 ， 因 此 此 
函数 没 用 。 
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第 27 fT. stdio add devices 函数 ， 各 种 输入 输出 设备 的 初始 化 ， 如 LCD driver; LMX6ULL 
使 用 drv_video_init 函数 初始 化 LCD。 会 输出 如 图 32.2.8.2 所 示 信 息 : 
Display: ATK-LCD-7-1024x600 (1024x600) 
Video: 1024x600x24 
图 32.2.8.2 LCD 信息 
第 28 行 ，initr jumptable 函数 ， 初 始 化 跳 转 表 。 
第 29 ÍT, console init r 函数 ， 控 制 台 初始 化 ， 初 始 化 完成 以 后 此 函数 会 调用 
stdio print current devices 函数 来 打印 出 当前 的 控制 台 设 备 ， 如 图 32.2.8.3 所 示 ; 
In: serial 
Out: serial 
Err: serial 
322.8.3 控制 台 信 息 
第 31 fT, interrupt init 函数 ， 初 始 化 中 断 。 
第 32 4T, initr enable interrupts 函数 ， 使 能 中 断 。 
第 33 行 ，initr_ethaddr 函数 ， 初 始 化 网 络 地 址 ， 也 就 是 获取 MAC 地 址 。 读 取 环 境 变量 
“ethaddr” 的 值 。 
第 34 行 ,board late init 函数 , 板子 后 续 初 始 化 , 此 函数 定义 在 文件 mx6ull alientek emmc.c 
中 , 如 果 环 境 变量 存储 在 EMMC 或 者 SD 卡 中 的 话 此 函数 会 调用 board late mmc env init 函数 
初始 化 EMMC/SD。 会 切换 到 正在 时 候 用 的 emme 设备 ， 代 码 如 图 32.2.8.4 所 示 : 


36 void board late mmc env init(void) 


















































31 

32 char cmd[32]; 

33 char mmcblk[|32]; 

34 u32 dev no = mmc get env dev/); 

35 

36 if (lcheck mmc autodetect()) 

37 return; 

38 

39 setenv ulong/"mmcdev", dev no); 

40 

41 /* Set mmcblk env */ 

42 sprintf(mmcblk, "/dev/mmcblk?dp2 rootwait rw", 
43 mmc map to kernel blk(dev no)); 
44 setenv("mmcroot", mmcblk); 

45 

46 sprintf(cmd, "mmc dev Xd", dev no); 
47 run command/cmd, 9); 

48 


图 32.2.8.4 board late mmc env init 函数 
图 32.2.8.4 中 的 第 46 行 和 第 47 行 就 是 运行 “mmc dev xx” 命 令 ， 用 于 切换 到 正在 使 用 的 
EMMC 设备 ， 串 口 输出 信息 如 图 32.2.8.5 所 示 : 
to partitions £0, OK 
mmcl(part 0) is current device 
图 32.2.8.5 切换 mmc 设备 
第 38 ÍT, ，initr net 函数 ， 初始化 网 络 设 备 ， 函数 调用 顺序 为 : 
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initr_net->eth_initialize->board_eth init0， 趾 口 输出 如 图 32.2.8.6 所 示 信 息 : 





l|Net: FEC1 
图 32.2.8.6 网 络 信 息 输出 


第 40 行 ，run_main loop 行 ， 主 循环 ， 处 理 命 令 。 


32.2.9 run main loop 函数 详解 


uboot 启动 以 后 会 进入 3 秒 倒计时 ， 如 果 在 3 秒 倒计时 结束 之 前 按 下 按 下 回 车 键 ， 那 么 就 
会 进入 uboot 的 命令 模式 , 如 果 倒 计时 结束 以 后 都 没有 按 下 回 车 键 , 那么 就 会 自动 启动 Linux 内 














核 ， 这 个 功能 就 是 由 























run main loop 函数 来 完成 的 。run main loop 函数 定义 在 文件 





common/board rc 中 ， 函 数 内 容 如 下 : 


示例 代码 32.2.9.1 board. r.c 文件 代码 段 


753 static int run main loop (void) 


754 ( 
TES #ifdef CONFIG SANDBOX 
756 sandbox main loop init(); 


TEN #endif 


758 /* main loop) can return to retry autoboot, if so Just runm it 


again */ 


759 Tore) 


760 


main loop(); 


Fel return 0; 


TKA 


T 


第 7 行 和 第 8 行 是 个 死 循环 , “for(G)” 和 “while()” 功 能 一 样 ， 死 循环 里 面 就 一 个 
main loop 函数 ，main loop 函数 定义 在 文件 common/main.c 里 面 ， 代 码 如 下 : 














示例 代码 32.2.9.2 main.c 文件 代码 段 


43 /* We come here after U-Boot is initialised and ready to process 


commands */ 


44 void main loop(void) 





45 ( 

46 const Char teg 

47 

48 bootstage mark name(BOOTSTAGE ID MAIN LOOP, "main loop"); 
49 














50 #ifndef CONFIG SYS GENERIC BOARD 


Sr pu 


readNn"); 


52 pu 
59 pu 
54 #endif 
ES 


56 £fifdef CONFIG VERSION VARIABLE 


ts("Warni 





ng: Your board does not use generic board. Please 











ts("doc/README.generic-board and take action. Boards notn”), 


ts("upgraded by the late 2014 may break or be removed. Nn"); 











57 soren wer, version SExiUaG) p / sce version wesuielbue */ 


58 4endif /* CONFIG VERSION VARIABLE */ 
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59 

60 cli inic) 

61 

62 run preboot environment command (); 
63 

64 dif defined(CONFIG UPDATE TFTP) 

65 update tftp(0UL, NULL, NULL); 

66 #endif /* CONFIG UPDATE TFTP */ 

67 

68 S — bootdelay process(); 

69 sus (eli procese ih (Cus) ) 

70 Cli SEEUEE boot cundis) 

qat 

72, autoboot command (s); 

TS) 

74 ei eo) 

78. 3 


第 48 ÍT, WJ bootstage mark name 函数 ， 打 印 出 启动 进度 。 

第 57 行 ， 如 果 定 义 了 宏 CONFIG VERSION VARIABLE 的 话 就 会 执行 函数 setenv, WA 
换 将 变量 ver 的 值 为 version_string， 也 就 是 设置 版 本 号 环境 变量 。version_string 定义 在 文件 
cmd/version.c 中 ， 定 义 如 下 : 

constchar weak version string[] = U BOOT VERSION STRING; 

U BOOT VERSION STRING 是 个 宏 ， 定 义 在 文件 include/version.h, All F: 

#define U BOOT VERSION STRINGU BOOT VERSION"("U BOOT DATE"-"\ 

U BOOT TIME""U BOOT TZ ")" CONFIG IDENT STRING 
U BOOT VERSION 定义 在 文件 include/generated/version autogenerated.h 中 ， 文 件 
version autogenerated.h 内 如 如 下 : 
示例 代码 32.2.9.4 version_autogenerated.h 文件 代码 
i #define PLAIN VERSION GS 
2 #define U BOOT VERSION "U-Boot " PLAIN VERSION 
Snme (C(C. WIBIEXSULONY (SHDEUHNKG, Nae me gee en ee 
20 ETE s COSI ete orca 
4 $define LD VERSION STRING "GNU ld (nae Sness 2 0 
2528 O AOO nea AO E S-xpsbie 
可 以 看 出 ，U_BOOT VERSION 为 “U-boot 2016.03”, 
U BOOT DATE . U BOOT TIME 和 UBOOTTZ 这 Æ X 在 x H 
include/generated/timestamp autogenerated.h 中 ， 如 下 所 示 : 
示例 代码 32.2.9.5 timestamp. autogenerated.h 文件 代码 
1 4define U BOOT DATE "Apr 25 2019" 
2 detine U BOOT amus VZISI0853" 
3 &define U BOOT TZ "40800" 
4 #define U BOOT DMI DATE HoA 2) 65 77 2/9) )1 











ni 





























Tt 
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宏 CONFIG IDENT STRING 为 空 , 所 以 U BOOT VERSION STRING 73 ^U-Boot 2016.03 




















(Apr 25 2019 - 21:10:53 +0800)”， 进 入 uboot 命令 模式 ， 输 入 命令 “version” 查 看 版 本 号 ， 如 图 
32.2.9.1 所 示 : 


U-Boot 2016.03 (Apr 25 2019 - 21:10:53 +0800) 
arm-linux-gnueabihf-gcc (Linaro GCC 4.9-2017.01) 4.9.4 
GNU ld (Linaro Binutils-2017.01) 2.24.0.2014101/ Linaro 2014 11-3-git 


=> 
图 32.2.9.1 版 本 查询 

图 32.2.9.1 中 的 第 一 行 就 是 uboot 版 本 号 ， 和 我 们 分 析 的 一 致 。 

接着 回 到 示例 代码 32.2.9.2 中 ， 第 60 行 ，cli_init 函数 ， 跟 命令 初始 化 有 关 ， 初 始 化 hush 
shell 相关 的 变量 。 

第 62 íT, run preboot environment command 函数 ， 获 取 环 境 变量 perboot 的 内 容 ，perboot 
是 一 些 预 启动 命令 ， 一 般 不 使 用 这 个 环境 变量 。 

第 68 行 ，bootdelay_process 函数 ， 此 函数 会 读 取 环境 变量 bootdelay 和 bootemd 的 内 容 ， 
然后 将 bootdelay 的 值 赋值 给 全 局 变量 stored_bootdelay， 返 回 值 为 环境 变量 bootemd 的 值 。 

第 69 行 ， 如 果 定 义 了 CONFIG OF CONTROL 的 话 函 数 cli process fdt 就 会 实现 ， 如 果 
没有 定义 CONFIG OF CONTROL 的 话 函 数 cli_process_fdt 直接 返回 一 个 false。 在 本 uboot 中 
没有 定义 CONFIG OF CONTROL， 因 此 cli process fdt 函数 返回 值 为 false。 

第 72 行 ，autoboot_command 函数 ， 此 函数 就 是 检查 倒计时 是 否 结束 ? 倒计时 结束 之 前 有 
没有 被 打 断 ”此 函数 定义 在 文件 common/autoboot.c 中 ， 内 容 如 下 : 

示例 代码 32.2.9.5 aubobootc 文件 代码 段 


380 void autoboot command(const char *s) 

































































Sud d 

382 debug ("### main loop: bootcmd-V"$sN"Nn", s ? s : "XUNDEFINED»?"); 
383 

384 if (stored bootdelay !- -1 && s && 'abortboot(stored bootdelay)) 
( 





385 dif defined(CONFIG AUTOBOOT KEYED) 

&& 'defined(CONFIG AUTOBOOT KEYED CTRLC) 

386 iat prey = disable erriei) y /* disable Control C checking 
gn 

387 tendif 

388 

389 run Commence Joe (S, =l; 09g 

390 

3.9 #1£ defined(CONFIG AUTOBOOT KEYED) 

&& 'defined(CONFIG AUTOBOOT KEYED CTRLC) 













































































392 disable ile (prev), /*— restore Control C checking */ 
393 #endif 

394 } 

395 

396 #ifdef CONFIG_MENUKEY 

Son if (menukey == CONFIG MENUKEY) ( 

E S = getenv("menucmd"); 
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i99 if (s) 

400 ium Comman) lists, =L, "yp 

401 } 

a02 memei EN CONFIG_MENUKEY */ 

403 ) 














可 以 看 出 ，autoboot command 函数 里 面 有 很 多 条 件 编译 ， 条 件 编 译 一 多 就 不 利于 我 们 阅读 
程序 (所 以 正点 原子 的 例 程 基 本 是 不 用 条 件 编译 的 ， 就 是 为 了 方便 大 家 阅读 源码 )! K 
CONFIG AUTOBOOT KEYED 、 CONFIG AUTOBOOT KEYED CTRLC 和 
CONFIG MENUKEY 这 三 个 宏 在 LMX6ULL 里 面 没 有 定义 ， 所 以 讲 示 例 代码 32.2.9.5 进行 精 
简 ， 得 到 如 下 代码 : 












































示例 代码 32.2.9.6 autoboot_command 函数 精简 版 本 


1 void autoboot command(const char *s) 

2 { 

3 if (stored bootdelay != -i && s && 'abortboot(stored bootdelay)) ( 
4 run Commend List(s, =L; U)? 

5S p 

CEN 





当 一 下 三 条 全 部 成 立 的 话 ， 就 会 执行 函数 run command list. 

(D. stored bootdelay 不 等 于 -1。 

D, s 不 为 空 。 

©, PA abortboot 返回 值 为 0。 

stored bootdelay 等 于 环境 变量 bootdelay 的 值 ，s 是 环境 变量 bootcmd 的 值 ， 一 般 不 为 空 ， 
因此 前 两 个 成 立 ， 就 剩 下 了 函数 abortboot 的 返回 值 ，abortboot 函数 也 定义 在 文件 
common/autoboot.c 中 ， 内 容 如 下 : 

示例 代码 32.2.9.7 abortboot 函数 

283 static int abortboot(int bootdelay) 

















lim] 
































DENT 

285 #ifdef CONFIG AUTOBOOT KEYED 

286 return abortboot keyed(bootdelay); 
287 #else 

288 return abortboot normal (bootdelay); 
289 #endif 

DIOE) 


因为 宏 CONFIG AUTOBOOT KEYE 未 定义 ， 因 此 执行 函数 abortboot normal, 4E, £e 
来 绕 去 的 ! 接着 来 看 函数 abortboot normal， 此 函数 也 定义 在 文件 common/autoboot.c 中 ， 内 容 
如 下 : 
示例 代码 32.2.9.8 abortboot_normal 函数 
225 static int abortboot normal(int bootdelay) 


PIS 

22 int abort = 0; 
299 unsigned long ts; 
ZO 





230 £$ifdef CONFIG MENUPROMPT 
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Sl joyesimeat (CONFIG MENUPROMPT) z 

232 #else 

DIS if (bootdelay >= 0) 

234 printf("Hrt any key to stop autoboot: $2d ", bootdelay); 
235 rendi f 

236 

237 dif defined CONFIG ZERO BOOTDELAY CHECK 

238 /< 

230 * Check if key already pressed 

240 * Don't check if bootdelay « 0 

241 zy 

242 if (bootdelay >= 0) { 

243 sus (Reese) /* we got a key press  */ 
244 (i viodid)y)gersec)r Ta eons tne IMEUT E 
245 joies NN ee (QUE 

246 abort = lz /= dome ate boot =/ 

247 } 

248 } 

249 #endif 

250 

2l while ((bootdelay > 0) && ('abort)) ( 

207 --bootdelay; 

PII /* delay 1000 ms */ 

254 ts > get timer(0); 

255 do { 

256 aus (sue) 4 /* we got a key press  */ 
P abore = ig /= don?t eo boor / 
258 bootdelay = 0; /* no more delay EA 
259 4 ifdef CONFIG MENUKEY 

260 menukey = getc(); 

261 4 else 

262 (void) getc(); /* consume input */ 
Do cms 

264 break; 

265 } 

266 udelay(10000); 

267. } while ('!abort && get _ timer (ts) < 1000); 
268 

269 ee Ne 2o U. ec 

270 } 

21 

2g joie (e (C xar) p 


209 
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274 difdef CONFIG SILENT CONSOLE 

Zi if (abort) 

276 gd->flags &= "GD FLG SILENT; 

277 #endif 

218 

219 return abort; 

280 ) 





函数 abortboot normal 同样 很 多 条 件 编译 , 删除 掉 条 件 编译 相关 代码 后 abortboot normal FR 
数 内 容 如 下 : 
示例 代码 32.2.9.9 abortboot normal 函数 精简 
1 static int abortboot normal(int bootdelay) 


PEE 
3 int abort 2 0; 
4 unsigned long ts; 
5 
6 if (bootdelay >= 0) 
7 printf("Hit any key to stop autoboot: $2d ", bootdelay); 
8 
9 while ((bootdelay > 0) && ('!abort)) ( 
100) --bootdelay; 
dit /* delay 1000 ms */ 
12 ts —- get timer(0); 
TES] do ( 
14 if (ts cc O) i /* we got a key press */ 
15 aperee LM ccs NNI) C (SA 
16 bootdelay = 0; /* no more delay A 
Ty) (Creme ageree (r2 s rereaten brass ue */ 
18 break; 
19 } 
20 udelay (10000); 
2al } while (!abort && get timer(ts) < 1000); 
217 
23 m2 or 
24 } 
25 EGR yg 
26 return abort; 
27 ) 
第 3 行 的 变量 abort 是 函数 abortboot normal 的 返回 值 ， 默 认 值 为 0。 








AAA 


第 7 行 通 过 串口 输出 “Hit any key to stop autoboot” 字 样 ， 如 图 32.2.9.2 所 示 : 
l|Hit any key to stop autoboot: 0 
图 32.2.9.2 倒计时 
第 9~21 行 就 是 倒计时 的 具体 实现 。 
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第 14 行 判断 键盘 是 否 有 按 下 ,也 就 是 是 否 打 断 了 倒计时 ， 如 果 键 盘 按 下 的 话 就 执行 相应 的 
分 支 。 比 如 设置 abort 为 1， 设置 bootdelay 为 0 等 ， 最 后 跳出 倒计时 循环 。 

第 26 íT, 返回 abort 的 值 ， 如 果 倒 计时 自然 结束 ， 没 有 被 打 断 abort 就 为 0， 否则 的 话 abort 
的 值 就 为 1。 

回 到 示例 代码 32.2.9.6 的 autoboot command 函数 中 ， 如 果 倒 计时 自然 结束 那么 就 执行 函数 
run command list， 此 函数 会 执行 参数 s 指定 的 一 系列 命令 ， 也 就 是 环境 变量 bootcmd 的 命令 ， 
bootemd 里 面 保存 着 默认 的 启动 命令 ， 因 此 linux 内 核 启动 ! 这 个 就 是 uboot 中 倒计时 结束 以 后 
自动 启动 linux 内 核 的 原理 。 如 果 倒 计时 结束 之 前 按 下 了 键盘 上 的 按键 ,那么 run command list 
函数 就 不 会 执行 ， 相 当 于 autoboot command 是 个 空 函 数 。 

回 到 “遥远 ”的 示例 代码 32.2.9.2 main loop 函数 中 ， 如 果 倒 计时 结束 之 前 按 下 按键 ， 
那么 就 会 执行 第 74 行 的 cli loop 函数 ， 这 个 就 是 命令 处 理 函 数 ， 负 责 接收 好 处 理 输入 的 命令 。 













































































32.2.10 cli loop 函数 详解 


cli loop 函数 是 uboot 的 命令 行 处 理 函 数 ， 我 们 在 uboot 中 输入 各 种 命令 ， 进 行 各 种 操作 就 
是 有 cli loop 来 处 理 的 ， 此 函数 定义 在 文件 common/cli.c 中 ， 函 数 内 容 如 下 : 
示例 代码 32.2.10.1 cli.c 文件 代码 段 























202 void cli loop(void) 
20ST 
204 #ifdef CONFIG SYS HUSH PARSER 








205 parese tile outer (|)? 

206 /* This point is never reached */ 
2:0) form e 

208 #else 

209 Eli simple liom, 

210 #endif / “CONFIG SYS HUSH PARSER®/ 
eue 





在 文件 include/configs/mx6 common.h 中 有 定义 宏 CONFIG SYS HUSH PARSER, 而 正点 
原子 的 LIMX6ULL 开发 板 配置 头 文 件 mx6ullevk.h 里 面 会 引用 mx_common.h 这 个 头 文件 ， 因 此 
宏 CONFIG SYS HUSH PARSER 有 定义 。 

第 205 行 调用 函数 parse file outer. 

第 207 行 是 个 死 循环 ， 永 远 不 会 执行 到 这 里 。 

函数 parse file outer 定义 在 文件 common/cli_hush.c F, 去 掉 条 件 编译 内 容 以 后 的 函数 内 容 
如 下 : 

































































示例 代码 32.2.10.2 parse. file outer 函数 精简 


il imt parse iile outer (roci) 














2 { 

3 int rcode; 

4 EEC E alm (WESS abapxe p 

5 

6 setup file in str(&input); 

7 rcode - parse stream outer(&input, FLAG PARSE SEMICOLON); 
8 return rcode; 

PE 
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第 3 行 调 用 函数 setup file in str 初始 化 变量 input 的 成 员 变 量 。 
第 4 行 调 用 函数 parse_stream_outer， 这 个 函数 就 是 hush shell 的 命令 解释 器 ， 负 责 接收 命 
令 行 输 入 , 然后 解析 并 执行 相应 的 命令 , 函数 parse. stream. outer 定义 在 文件 common/cli hush.c 
中 ， 精 简 版 的 函数 内 容 如 下 : 
示例 代码 32.2.10.3 parse. stream. outer 有 函数 精简 


static int parse eevee gte nes 














il. 

2 A 

3 Setrmuee een eee 

4 o string temp=NULL O STRING; 
EET SII 
6 

5 

8 




















int code = 1; 
do ( 
9 rcode = parse stream(&temp, &ctx, inp, 
10 flag & FLAG CONT ON NEWLINE ? -1 : 'WMn'); 
PO 
11 if (rcode !2 1 && ctx.old flag == 0) ( 
i cU 
14 run lier (eux. bene nsec); 
TT 
16 ) else ( 
417200 
18 } 
19 b free(&temp); 
20m moop onis ynta enrremns eu oni KORS 
21 } while (rcode != -1 && !(flag & FLAG EXIT FROM LOOP) && 
22 (inp->peek IS etetic pesk || b pesk(inph) ihe 


23 return 0; 
24 } 
第 7~21 行 中 的 do-while 循环 就 是 处 理 输入 命令 的 。 
第 9 行 调 用 函数 parse. stream 进行 命令 解析 
第 14 行 调 用 调用 run. list 函数 来 执行 解析 出 来 的 命令 。 
函数 run list 会 经 过 一 系列 的 函数 调用 ， 最 终 通 过 调用 cmd process 函数 来 处 理 命令 ， 过 和 
如 下 : 








o 


























HI 








示例 代码 32.2.10.4 run_list 执行 流程 


IE 
2 d 

3 int rcodez0; 

4 

5 reote -3 rum list real (pi)? 

6E cre 

T return rcode; 

S g 
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9 

3/0) otatic int rum list real(struct pipe Ug 

ai 

12 char *save_name = NULL; 

JN 

14 int if codez0, next if codez0; 

TS e tes 

16 rcode - run pipe real(pi); 

d Me xe. 

18 return rcode; 

39 

20 

ZI! static lnt run pipe seeedl(sscowweur pipe SPL) 

Zza 

25 Iie. Ly 

24 

25 int nextin; 

26 usi irliexej —3 co i&ejxeenc eM 

29 SrvuerE Child prog vieil 

28 Caste tp 

GO. ssec 

30 if (pi-»num progs -- 1) child - & (pi-»progs[0]):; 
Su me 

22 return rcode; 

BS } else if (pi->num progs == 1 && pi->progs[0].argv != NULL) { 
340 下 

S5 /* Process the command */ 

36 return cmd process(flag, child-»argc, child-»argv, 
Be &flag_repeat, NULL); 

38 } 

S9 

40 return -1; 

41 ] 





第 5 fT, run list 调用 run list real 函数 。 

第 16 1T, run list real 函数 调用 run. pipe real 函数 。 

第 36 íT, run pipe real 函数 调用 cmd process 函数 。 

最 终 通过 函数 cmd process 来 处 理 命令 ， 接 下 来 就 是 分 析 cmd process 函数 。 


32.2.11 cmd_process 函数 详解 


在 学 习 cmd_process 之 前 先 看 一 下 uboot 中 命令 是 如 何 定 义 的 -uboot 使 用 宏 U_BOOT_CMD 
来 定义 命令 ， 宏 U_ BOOT CMD 定义 在 文件 include/command.h 中 ， 定 义 如 下 : 

示例 代码 32.2.11.1 U_BOOT_CMD X X 
melee Ns MP Mame massam ee see ne D 
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WEBOOmECNDEECOMENEHERIame p i maxa roS ep Cd Sacer MEI etr 
NULL) 

可 以 看 出 U BOOT CMD 是 U BOOT CMD COMPLETE 的 特例 ， 将 
U BOOT CMD COMPLETE 的 最 后 一 个 参数 设置 成 NULL 就 是 U BOOT_CMD 。 安 
U BOOT CMD COMPLETE 如 下 : 

示例 代码 32.2.11.2 U_BOOT_CMD_COMPLETE /z X 3: 

perine U BOOT CND eover nems, asd Sp, Eme usage, _ helg, 








eomp) i 
H emery Ceclars (ened Hol ty neme, Eme = N 
U BOOT CMD MKENT COMPLETE( name,  maxargs, rep, —emd, N 




















Nussge meo Canay 
ŽŽ  U BOOT CMD COMPLETE X 用 到 了 ll entry declare 和 
U BOOT CMD MKENT COMPLETE. 1l entry declar 定义 在 文件 include/linker lists.h 中 ， 定 
XP: 
示例 代码 32.2.11.3 1l entry. declare 宏 定义 


ole nl ne ye, ie, xs) N 
type u boot list 2 44 list## 2 ## name — aligned(4) b 
_ attribute  ((unused, \ 


execalom ("m boot Ligt 2 "ge ligt 2 Usb nane))) 

_type 为 cmd tbl t, 因此 1 entry. declare 就 是 定义 了 一 个 cmd tbl t 变量 , 这 里 用 到 了 C 语 
APH A ERR. HPI H list” KH list PIECE S, H4 name" WUEH] name 的 
ERE. 

宏 U_BOOT CMD MKENT_COMPLETE 定义 在 文件 include/command.h 中 ， 内 容 如 下 : 

示例 代码 32.2.11.4U_BOOT_CMD_MKENT_COMPLETE /Zz X 3L 






































*define U BOOT CMD MKENT COMPLETE( name,  maxargs, rep, cmd, N 
usage comp) N 
(| sj mes,  mexergs, reo, Cwe ee \ 








 CMD HELP( help) CMD _COMPLETH (comp) } 
上 述 代 码 中 的 “#” 表 示 将 name 传递 过 来 的 值 字 符 串 化 ， 
U BOOT CMD MKENT COMPLETE 又 用 到 了 宏 _CMD_HELP fll CMD COMPLETE, 这 两 个 
宏 的 定义 如 下 : 











示例 代码 32.2.11.5_CMD_HELP 和 _CMD_COMPLETE 宏 定 义 





















































1 4ifdef CONFIG AUTO COMPLETE 
2 *4 define  CMD COMPLETE(x) x, 
3 felse 

4 4 define CMD COMPLETE (x) 

5 #endif 

6 difdef CONFIG SYS LONGHELP 

7 # define CMD HELP(x) x, 

8 felse 

9 4 define  CMD HELP (x) 

10 #endif 


可 以 看 出 ， 如 果 定 义 了 宏 CONFIG AUTO COMPLETE 和 CONFIG SYS LONGHELP 的 
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i, CMD COMPLETE 和 CMD HELP 就 是 取 自 身 的 值 ， 然 后 在 加 上 一 个 “，。 
CONFIG AUTO COMPLETE 和 CONFIG SYS LONGHELP 这 两 个 宏 有 定义 在 文件 
mx6 common.h 中 。 

U_BOOT_CMD 宏 的 流程 我 们 已 经 清楚 了 (一 个 U_BOOT_CMD 宏 就 如 此 的 绕 来 绕 去 的 ， 
我 们 就 以 一 个 具体 的 命令 为 例 ， 来 看 一 下 U_BOOT_CMD 经 过 展开 以 后 究竟 是 个 什么 模样 的 。 
以 命令 dhcp 为 例 ，dhcp 命令 定义 如 下 : 

示例 代码 32.2.11.6 dhcp 命令 宏 定义 























U BOOT CMD( 
UOI, 35 dg (eo Ches, 
"boot image via network using DHCP/TFTP protocol", 
"[loadAddress] [[hostlIPaddr:]bootfilename]" 





将 其 展开 ， 结 果 如 下 : 
示例 代码 32.2.11.7 dhcp 命令 展开 
U BOOT CMD( 
dhcp, Sg 1g dO dhep, 
"boot image via network using DHCP/TFTP protocol", 
"[l1oadAddress] [[hostIPaddr:]bootfilename]" 


DET 


1、 将 U BOOT CMD 展开 后 为 : 
U BOOT CMD COMPLETE (Gimeno, 3, 1, do dhcp, 











"boot image via network using DHCP/TFTP protocol", 
'[loadAddress] [[hostiPaddr:]bootfilename]", 
NULL) 





2、 将 U BOOT CMD COMPLETE 展开 后 为 : 
ll entry declare(cmd tol t, dhcp, cmd) - b 
U BOOT CMD MKENT COMPLETE(dhcp, 3, 1, do dhcp, V 




















"boot image via network using DHCP/TFTP protocol", wN 
"[l1oadAddress] [[hostIPaddr:]bootfilename]", \ 
NULL); 


3. Tf 11 entry declare 和 U BOOT CMD MKENT COMPLETE 展开 后 为 : 
cmd tol t u boot list 2 cmd 2 dhcp  — aligned(4) Y 








. əttribute — ((((wmanbisexl,sexceibeu (uu boor list 2 cmd 2 dhoph)) 
( "eimep", S a 

"boot image via network using DHCP/TFTP protocol", N 
"[loadAddress] [[hostIPaddr:]bootfilename]",WN 

NULL) 

从 示例 代码 32.2.11.7 可 以 看 出 ，dhcp 命令 最 终 展 开 结果 为 : 
示例 代码 32.2.11.8 dhcp 命令 最 终结 果 
1. ee tol e u boot list 2 cme! 2 clwejo el b 
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Re) 
do dhcp, V 
"boot image via network using DHCP/TFTP protocol", 
"[loadAddress] 
NULL) 

第 1 行 定义 了 一 个 cmd tbl tZ 
字 节 对 齐 。 

第 2 行 ， 





2 


Si 
4 
5 
6 


在 .u boot list 2 cmd 2 dhcp 段 中 。u-boot.lds 链接 脚本 中 有 一 个 名 为 “.u_ boot list” WE, Pr 


{ 








[[hostIPaddr:]bootfilename]",N 


类 型 的 变量 ， 变 量 名 为 u boot list 2 cmd 2 dhcp， 此 变量 4 
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. attribute 关键 字 设 置 变 量 _u boot list 2 cmd 2 dhcp 存储 








有 .u_boot_list 开头 的 段 都 存放 到 .u_boot.list 中 ， 如 图 32.2.11.1 所 示 : 


员 变 


B00 EeuetE CE Hl Gy d 


Sal 
E 
33 
34 
35 
36 
3 
38 
E 
40 
41 
42 


.u boot list : 
KEEP(*(SORT(.u boot list*))); 


因此 ， 第 2 行 
第 3~6 ÍT, cmd tbl t 是 


char 
NE 


TE 


NE 
char 
#ifdef 
char 
fendif 
Kifdef CONFIG AUTO COMPLETE 


E 





图 32.2.11.1 u-boot.lds 中 的 .u boot list Ez 
BE u boot list 2 cmd 2 dhcp 的 存储 位 置 。 

















repeatable; 





结构 体 ， 因 此 第 3-6 行 是 初始 化 cmd tbl t3 
cmd tbl t 结构 体 定 eius include/command.h 中 ， 内 容 如 下 : 
示例 代码 32.2.11.9 cmd. tbl t 结构 体 


/* Command Name 


/* maximum number of arguments 


/* autorepeat allowed? 


/* Implementation function */ 


(Weme (struct cme wol e w, Imt, ime, (lese w Conse [DE 


/* Usage message (short) 


CONFIG SYS LONGHELP 





/* Help message (long) 














/* do auto completion on the arguments */ 


(*complete) (int argc, char * const argv[], char 


least Char, iot mazýy;, Char viene hi] p 


43 
44 
45 
46 





enoii 


typedef struct cmd tbl s cmd tbl t; 
吉 合 实例 代码 32.2.11.8， 可 以 得 出 变量 u boot list 2 cmd 2. dhep 的 各 个 成 员 的 值 如 下 所 








_u boot list 2 cmd 2 dhcp.name = "dhcp" 
.u boot list 2 cmd 2 dhcp.maxargs = 3 
.u boot list 2 cmd 2 dhcp.repeatable = 1 


这 个 结构 体 的 各 个 成 
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.u boot list 2 cmd 2 dhcp.cmd = do dhcp 
.u boot list 2 cmd 2 dhcp.usage = "boot image via network using DHCP 
.u boot list 2 cmd 2 dhcp.help =  "[loadAddress] [[hostIPaddr:]bootfile 
u boot list 2 cmd 2 dhcp.complete - NULL 





/TFTP protocol" 


name]" 


当 我 们 在 uboot 的 命令 行 中 输入 “dhcp” 这 个 命令 的 时 候 ， 最 终 执行 的 是 do dhep 这 个 函 














数 。 总 结 一 下 ，uboot 中 使 用 U BOOT CMD 来 定义 一 个 命令 ， 最 终 的 目的 就 是 为 了 定义 一 个 
cmd tbl t 类 型 的 变量 , 并 初始 化 这 个 变量 的 各 个 成 员 。uboot 中 的 每 个 命令 都 存储 在 .u_boot list 
段 中 ， 每 个 命令 都 有 一 个 名 为 do_xxx(xxx 为 具体 的 命令 名 ) 的 函数 ， 这 个 do_xxx 函数 就 是 具体 




















的 命令 处 理 函 数 。 

















H 














THET uboot 中 命令 的 组 成 以 后 ， 再 来 看 一 下 cmd process 函数 的 处 到 
函数 定义 在 文件 common/command.c 中 ， 函 数 内 容 如 下 : 
示例 代码 32.2.11.10 command.c 文件 代码 段 


500 enum commene) ret © me rs e ST eie Me Tmt arge, 





























过 程 ，cmd process 


5O char * const argv[],int *repeatable, ulong *ticks) 
502 ( 

509 enum command ret t rc — CMD RET SUCCESS; 
504 Emel wol cme 

505 

506 /* Look up command in command table */ 

SOR cmdtp = find cmd (argv[0]); 

508 if (cmdtp == NULL) ( 

509 peace ("Unknown command "ss! ne rw, 
d return |; 

EXIT } 

SIE? 

513 round enceek imaz args s 

514 if (argc > cmdtp->maxargs) 

SiS EE = T CMDIRETRUSACE; 

516 

SUE It defined(CONFIG CMD BOOTD) 

518 Woven oe sexes 

519 else if (cmdtp-»cmd == do bootd) ( 

520 if (flag & CMD FLAG BOOTD) ( 

S puts("'bootd' recursion detected'Nn"); 
522 rc = CMD RET FAILURE; 

52/3 ) else { 

524 flag |= CMD FLAG BOOTD; 

525 } 

526 } 

527 #endif 

528 

529 VIS OR se rar then do ne e ITem 

530 If (Ure) 
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S3 
992 
598 
534 
SE 
DD 
Se 
S38 
S9 
540 
541 


118 
aS) 
TAO 
32238 
122 
123 


if (ticks) 
让 CR = crest s 7 
rc = cmd call(cmdtp, flag, arge, argv); 
if (ticks) 
whüpdeles c get timer (es 
*repeatable &- cmdtp-»repeatable; 
} 
if (rc == CMD RET USAGE 








~ 


rc = cmd usage (cmdtp) ; 
return rc; 


} 
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第 507 行 ， 调 用 函数 find cmd 在 命令 表 中 找到 指定 的 命令 ，find_cmd 函数 内 容 如 下 : 


示例 代码 32.2.11.10 command.c 文件 代码 段 


Gmel tol eem clem e (i om Sr tr rm) 

{ 
Emel tol t vertart 5 Lil entry starr (cme tol t, EME)? 
Conste lnt len = JLIL entry Count (cme tol t, cme) p 
return find cmd tbl(cmd, start, len); 

} 


参数 cmd 就 是 所 查找 的 命令 名 字 ，uboot 中 的 命令 表 其 实 就 是 cmd tbl t 结构 体 数组 ， 通 
过 函数 II entry start 得 到 数组 的 第 一 个 元 素 ， 也 就 是 命令 表 起 始 地 址 。 通 过 函数 1L_entry_count 
得 到 数组 长 度 ， 也 就 是 命令 表 的 长 度 。 最 终 通过 函数 find cmd tbl 在 命令 表 中 找到 所 需 的 命 
每 个 命令 都 有 一 个 name 成 员 ， 所 以 将 参数 cmd 与 命令 表 中 每 个 成 员 的 name 字段 都 对 比 
一 下 ， 如 果 相 等 的 话 就 说 明 找 到 了 这 个 命令 ， 找 到 以 后 就 返回 这 个 命令 。 
回 到 示例 代码 32.2.11.10 的 cmd. process 函数 中 ， 找 到 命令 以 后 肯定 就 要 执行 这 个 命令 了 ， 
第 533 行 调 用 函数 cmd. call 来 执行 具体 的 命令 ，cmd_call 函数 内 容 如 下 : 












































示例 代码 32.2.11.11 command.c 文件 代码 段 


[00 oratie int cme! call'(ene tol t vemdto, ine tlag, Ime arge; Chen v 


const argv[l) 


491 
492 
493 
494 
495 
496 
497 
498 





{ 
ine result, 
result = (cmdtp-»cmd) (cmdtp, flag, argc, argv); 
if (result) 
debug ("Command failed, result-$dn", result); 
return result; 
} 
在 前 面 的 分 析 中 我 们 知道 , cmd. tbl t 的 cmd 成 员 就 是 具体 的 命令 处 理 函 数 ， TAA 











调用 cmdtp 的 cmd 成 员 来 处 理 具体 的 命令 ， 返 回 值 为 命令 的 执行 结果 。 














cmd process 中 会 检测 cmd tbl 的 返回 值 ， 如 果 返 回 值 为 CMD RET USAGE 的 话 就 会 调用 


























cmd usage 函数 输出 命令 的 用 法 ， 其 实 就 是 输出 cmd tbl t 的 usage 成 员 变 量 。 
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32.3 bootz 启动 Linux 内 核 过 程 


32.3.1 images 全 局 变量 


不 管 是 bootz 还 是 bootm 命令 ， 在 启动 Linux 内 核 的 时 候 都 会 用 到 一 个 重要 的 全 局 变量 : 

images, images 在 文件 cmd/bootm.c 中 有 如 下 定义 : 
示例 代码 32.3.1.1 images 全 局 变量 

43 bootm headers t images; /* pointers to os/initrd/fdt images */ 

images 是 bootm headers t 类 型 的 全 局 变量 ，bootm_ headers t 是 个 boot 头 结构 体 ， 在 文件 
include/image.h 中 的 定义 如 下 (删除 了 一 些 条 件 编译 代码 ): 

示例 代码 32.3.1.2 bootm_headers_t 结构 体 

304 typedef struct bootm headers { 


























205 "s 

306 * Legacy os image header, if it is a multi component image 
307 ehen boot oee omcassis emeret wemne onde 
308 * data from second and third component accordingly. 

309 ef 

s10 image header t “legacy hdr os; /* image header pointer */ 
Eli image Reader ic legacy Imole om copy? / header copy / 

7 ulong legacy halir alie 

Surg 

295 

334 $ifndef USE HOSTCC 

SISIS image info t os; /* OS 镜像 信息 let 
336 ulong ep; /:* (IS 全 A 
33 

338 ulong rd start, rd end; /* ramdisk 开始 和 结束 位 置 */ 
EE 

340 char *ft addr; /* 设备 树 地 址 ey 
341 ulong ft len; /* 设备 树 长 度 a 
342 

343 ulong initrd Start; /* initrd 开始 位 置 */ 
344 ulong initrd end; /* initrd 结束 位 置 A 
345 ulong cmdline start; /* cmdline 开始 位 置 */ 
346 ulong cmdline end; /* cmdline 结束 位 置 tA 
347 lol ic *kbd; 

348 #endif 

349 

350 INE verify; /* getenv("verify")[0] != 'n' */ 

SS 

352 #define BOOTM STATE START (0x00000001) 

353 #define BOOTM STATE FINDOS (0x00000002) 

354 #define BOOTM STATE FINDOTHER (0x00000004) 
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355 #define BOOTM STATE LOADOS (0x00000008) 

356 #define BOOTM STATE RAMDISK (0x00000010) 

357 4define BOOTM STATE FDT (0x00000020) 

358 #define BOOTM STATE OS CMDLINE (0x00000040) 

359 #define BOOTM STATE OS BD T (0x00000080) 

360 4define BOOTM STATE OS PREP (0x00000100) 

361 $define BOOTM STATE OS FAKE GO (0x00000200)/*'Almost' run the OS*/ 
362 #define BOOTM STATE OS GO (0x00000400) 

363 abinde, state; 

364 


365 #ifdef CONFIG LMB 
366 struct lmb mb; /* 内 存 管理 相关 ， 不 深入 研究 */ 
367 tendif 
368 } bootm headers p 

第 335 行 的 os 成 员 变 量 是 image info t 类 型 的 ， 为 系统 镜像 信息 。 

第 352~362 行 这 11 个 宏 定义 表示 BOOT 的 不 同 阶段 。 

接 下 来 看 一 下 结构 体 image info t， 也 就 是 系统 镜像 信息 结构 体 ， 此 结构 体 在 文 从 
include/image.h 中 的 定义 如 下 : 

示例 代码 32.3.1.3 image. info. t 结构 体 

292 typedef struct image info { 




















293 ulong start, end; /* blob 开始 和 结束 位 置 */ 

294 ulong image start, image len; /* 镜像 起 始 地 址 (包括 blob) MKE */ 
295 ulong load; /* 系统 镜像 加 载 地 址 */ 

296 vinte E COND, EYE, O87 /* RAE RA, os 类 型 */ 

297 uint8 t arch; /* CPU 架构 */ 


295 ] Image into ij 


全 局 变量 images 会 在 bootz 命令 的 执行 中 频繁 使 用 到 ， 相 当 于 Linux 内 核 启 动 的 “灵魂 ” 














32.3.2 do bootz 函数 





bootz 命令 的 执行 函数 为 do_bootz， 在 文件 cmd/bootm.c 中 有 如 下 定义 : 
示例 代码 32.3.2.1 do_bootz 函数 
622 imt dO looo (Cnel tol t vendito, mt ileg, iua arge; Ghar w Const 








argv[]) 

523 

624 int ret; 

625 

626 "1e onsumemloo ot z =/ 
62 OC==2 eue 

628 

629 if (bootz start(cmdtp, flag, argc, argv, &images)) 
630 return |; 

631 

632 Js 
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633 < We are Coiling the BOOI STU ASINI SA» (o SMS ttt MEINT TIS SS sonusE 
634 * disable interrupts ourselves 

635 E 

636 bootm disable interrupts(); 

637 

638 images.os.os - IH OS LINUX; 

639 ret = do looo Suse (cult, ilag, arge, argy, 

640 BOOTM STATE OS PREP | BOOTM STATE OS FAKE GO | 
641 BOOTM STATE OS GO, 

642 &images, 1); 

643 

644 return ret; 

645 } 


第 629 行 ， 调 用 bootz start 函数 ，bootz start 函数 执行 过 程 参考 32.3.3 小 节 。 

第 636 行 ， 调 用 函数 bootm disable interrupts 关闭 中 断 。 

第 638 行 ， 设 置 images.0s.0s 为 IH _OS_LINUX， 也 就 是 设置 系统 镜像 为 Linux， 表 示 我 们 
要 启动 的 是 Linux 系统 ! 后 面 会 用 到 images.os.os 来 挑选 具体 的 启动 函数 。 

第 639 行 ， 调 用 函数 do bootm states 来 执行 不 同 的 BOOT 阶段 ， 这 里 要 执行 的 BOOT 阶 
段 有 :BOOTM STATE OS PREP ,BOOTM STATE OS FAKE GO 和 BOOTM STATE OS GO. 



































32.3.3 bootz start 函数 


bootz srart 函数 也 定义 在 文件 cmd/bootm.c 中 ， 函 数 内 容 如 下 : 
示例 代码 32.3.3.1 bootz_statt 函数 
378 Statie sumit loot stert (eme wol t vemdip, nt ileg, inm arge, 





El 











579 Char w conet argyll; Doorn headers © wimages)) 
Seo 

581 int ret; 

502 ulong gai start, zi enel; 

583 

584 ie = do bootm stetes(cndtpo, ilag, arge, argv, 

585 BOOTM STATE START， images, 1); 

586 

587 /* Setup Linux kernel zImage entry point */ 

588 sus (large) lt 

589 images-»ep = load addr; 

590 debug("* kernel: default image load address = 0x$081x'n", 
Son load addr); 

597 ) else ( 

593 images-»ep - simple strtoul(argv[0], NULL, 16); 

594 debug("* kernel: cmdline image address = 0x$081x^n", 
595 images-»ep); 

596 ) 

SOn 
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598 ret = bootz setup(images-»ep, &zi start, &zi end); 

599 if (ret != 0) 

600 return |; 

601 

602 Jsulo izzeewe(cumweges-lslo, immages-cep, za duel — zi Suet); 
603 

604 VAS 

605 ^ Menchie rie BOOMI SPANT EN OL strece Olrselwes as we clo ow 
606 * have a header that provide this informaiton. 

607 *y 

608 if (bootm find images(flag, argc, argv)) 

609 return |; 

610 

619 return 0; 

208) 


第 584 行 ， 调 用 函数 do_bootm_ states, TT BOOTM STATE START 阶段 。 

第 593 行 ， 设 置 images 的 ep 成 员 变 量 ， 也 就 是 系统 镜像 的 入 口 点 ， 使 用 bootz 命令 启动 
系统 的 时 候 就 会 设置 系统 在 DRAM 中 的 存储 位 置 ， 这 个 存储 位 置 就 是 系统 镜像 的 入 口 点 ， 
此 images->ep=0X80800000。 

第 598 行 ， 调 用 bootz setup 函数 ， 此 函数 会 判断 当前 的 系统 镜像 文件 是 否 为 Linux 的 镜 
像 文 件 ， 并 且 会 打印 出 镜像 相关 信息 ，bootz setup 函数 稍 后 会 讲解 。 

第 608 行 ， 调 用 函数 bootm find images 查找 ramdisk 和 设备 树 (dtb) 文 件 ， 但 是 我 们 没有 
用 到 ramdisk， 因 此 此 函数 在 这 里 仅仅 用 于 碍 找 设备 树 (dtb) 文 件 ， 此 函数 稍 后 也 会 讲解 。 
先 来 看 一 下 bootz setup 函数 ， 此 函数 定义 在 文件 arch/arm/lib/bootm.c 中 ， 函 数 内 容 如 





















































F: 
示例 代码 32.3.3.2 bootz_setup 函数 
370 #define LINUX ARM ZIMAGE MAGIC 0x016f2818 
3al 
S2 int bootz setup(ulong image, Ulong vstart, ulong venci) 
SUIS 








374 struct zimages header wzi; 

SIS 

SIG zi © (struct zimage header *)map sysmem(image, 0); 
337 if (zi-»zi magic !- LINUX ARM ZIMAGE MAGIC) ( 

2o. puts("Bad Linux ARM zlImage magic!Nn"); 

DIO return |; 

380 ) 

381 

382 vastare S B21 Tarr} 

383 wene = zi->zi enel 

384 

SUD printf("Kernel image @ $4081x [ $4$081x - $4081x ]\n", image, 
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386 *start, *end); 

387 

388 return 0; 

SIS J) 


第 370 íf, "E LINUX ARM ZIMAGE MAGIC 就 是 ARM Linux 系统 魔术 数 。 

第 376 行 ， 从 传递 进来 的 参数 image( 也 就 是 系统 镜像 首 地 址 ) 中 获取 zimage ko zImage 3k 
结构 体 为 zimage header. 

第 377-380 行 ， 判 断 image 是 否 为 ARM 的 Linux 系统 镜像 ， 如 果 不 是 的 话 就 直接 返回 
并 且 打 印 出 “Bad Linux ARM zImage magic!”， 比 如 我 们 输入 一 个 错误 的 启动 命令 : 

bootz 80000000 - 900000000 

因为 我 们 并 没有 在 0X 80000000 处 存放 Linux 镜像 文件 (zImage)， 因 此 上 面 的 命令 肯定 会 
执行 出 错 的 ， 结 果 如 图 32.3.3.1 所 示 : 
=> bootz 80000000 - 90000000 


Bad Linux ARM zImage magic! 
=> 

















` 




















图 32.3.3.1 启动 出 错 
第 382、383 行 初 始 化 函数 bootz setup 的 参数 start 和 end. 
第 385 行 ， 打 印 启动 信息 ， 如 果 Linux 系统 镜像 正常 的 话 就 会 输出 图 32.3.3.2 所 示 的 信 











Bn 


[Kernel image @ 0x80800000 [ 0x000000 - Ox65ef68 ] 
图 32.3.3.3 Linux 镜像 信息 

接 下 来 看 一 下 函数 bootm_find_images， 此 函数 定义 在 文件 common/bootm.c F, KAA 
如 下 : 








示例 代码 32.3.3.3 bootm_find_images $ žk 


22/5 suene lexoxowam tine images (ini lag, ini arge, Ghar w Const suse [ly 





22 N 

22:7] int ret; 

228 

229 /* find ramdisk */ 

230 ret = boot get ramdisk(argc, argv, &images, IH INITRD ARCH, 
2S &images.rd start, &images.rd end); 

292 if (ret) ( 

259 puts("Ramdisk image is corrupt or invalidNin"); 

ES return 1; 

295 } 

296 

237 $if defined(CONFIG OF LIBFDT) 

238 /* find flattened device tree */ 

239 ret = boot get dil(filad, arge, argy, IH ARCH DEFAULT, Mimeges, 
240 &images.ft addr, &images.ft len); 

241 Tf (ret) { 

242 puts ("Could not find a valid device treeWn"); 

243 return |; 
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244 ) 

245 set working fdt addr((ulong)images.ft addr); 

246 #endif 

258 return 0; 

2590) 





第 230-235 行 是 跟 和 查找 ramdisk， 但 是 我 们 没有 用 到 ramdisk， 因 此 这 部 分 代码 不 用 管 。 

第 237-244 行 是 查找 设备 树 (dtb) 文 件 ， 找 到 以 后 就 将 设备 树 的 起 始 地 址 和 长 度 分别 写 到 
images 的 ft addr fI ft len 成 员 变 量 中 。 我 们 使 用 bootz 启动 Linux 的 时 候 已 经 指明 了 设备 树 在 
DRAM 中 的 存储 地 址 ， 因 此 images.ft addr=0X83000000， 长 度 根据 具体 的 设备 树 文 件 而 定 ， 比 
如 我 现在 使 用 的 设备 树 文件 长 度 为 0X8C81， 因 此 images.ft len=0X8C81。 

bootz start 函数 就 讲解 到 这 里 ，bootz start 主要 用 于 初始 化 images 的 相关 成 员 变 量 。 









































32.3.4 do bootm states 函数 


























do bootz 最 后 调用 的 就 是 函数 do bootm states, m H. TE bootz start 中 也 调用 了 
do bootm states 函数 ， 看 来 do bootm states 函数 还 是 个 香 馆 狮 。 此 函数 定义 在 文件 
common/bootm.c 中 ， 函 数 代 码 如 下 : 

示例 代码 32.3.4.1 do_bootm_states 函数 
591L int ek bootm states(cmel tol t vendito, imc tlag, iu arge, clem 9 

















eGomst ome 

















592 iat States, bootm headers t “images, inc looot progress) 
SA 

594 boot 0s in vb00t Enp 

595 ulong iflag - 0; 

596 dump ret = (0L meed boor imp 

597 

SIS images-»state |= states; 

EX 

600 s 

601 * Work through the states and see how far we get. We stop on 
602 = QUON on 

603 a 

604 if (states & BOOTM STATE START) 

605 ret = bootm start (endte, tlag, arge, argy)? 

606 

607 if (!ret && (states & BOOTM STATE FINDOS)) 

608 ier c3 boorm iine gue((ewwelep, tlag, arge, arw)? 
609 

610 if (!ret && (states & BOOTM STATE FINDOTHER)) { 

611 ret c3 boown iine other (cmeto, ileg, erge, eusgw) i 
612 arge = 0; /* consume the args */ 

|o e } 

614 
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615 / Toad Ehe Os */ 

616 if (!ret && (states & BOOTM STATE LOADOS)) ( 

617 ulong load end; 

618 

619 iflag 5 bootm disable interrupts(); 

620 ret © bootm load os(images, &load end, 0); 
621 if (ret == 0) 

622 lmb reserve(&images-»lmb, images-»os.load, 
623 (load end = images-»0os.load)); 

624 else if (ret && ret !- BOOTM ERR OVERLAP) 

625 goto err; 

626 else if (ret == BOOTM ERR OVERLAP) 

627 Ee = 0 


628 #if defined(CONFIG SILENT CONSOLE) 
&& !defined(CONFIG SILENT U BOOT ONLY) 

















[Es 











629 if (images-»0s.os == IH OS LINUX) 

630 SEE linw) p 

631 #endif 

632 } 

633 

634 /* Relocate the ramdisk */ 

635 #ifdef CONFIG SYS BOOT RAMDISK HIGH 

636 if (!ret && (states & BOOTM STATE RAMDISK)) ( 

SB ulong rd len = images-»rd end - images-»rd start; 

638 

6399 ret o boot ramdisk high(&images-»l1mb, images-»rd start, 
640 rd len, Sneades->inltee M start, Cimages->1imitrel emne) y 
641 if (!ret) ( 

642 Gi; nek (nn stert", Imeages->imitrol StraArT)) 
643 setenv hex("initrd end", images-»initrd end); 

644 } 

645 } 

646 #endif 

647 #if defined(CONFIG OF LIBFDT) && defined(CONFIG LMB) 

648 if (!ret && (states & BOOTM STATE FDT)) ( 

649 boot fdt add mem reyv regions(&images-»lmb, images-»ft addr); 
650 ret = boot relocate fdt(&images-»1mb, &images-»ft addr, 
651 &images-»ft len); 

652 } 

DSc pendii 

654 

655 /* From now on, we need the OS boot function */ 

656 If (ret) 
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S17) return ret; 

658 boot fn = bootm os get boot func(images-»0s.0s); 

59 need boot fn 2 states & (BOOTM STATE OS CMDLINE | 

660 BOOTM STATE OS BD T | BOOTM STATE OS PREP | 

661 BOOTM STATE OS FAKE GO | BOOTM STATE OS GO); 

662 if (boot fn == NULL && need boot fn) ( 

663 if (iflag) 

664 enable interrupts(); 

665 printe UERROR oo un os SS (es no SuporEeonm 
666 genimg get os name(images-»0s.0s), images-»0s.0os); 
667 bootstage error(BOOTSTAGE ID CHECK BOOT OS); 

668 return |; 

669 } 

670 

GEI /* Call various other states that are not generally used */ 
672 if (!ret && (states & BOOTM STATE OS CMDLINE)) 

673 ret = boot fn(BOOTM STATE OS CMDLINE, arge, argv, images); 
674 if (!ret && (states & BOOTM STATE OS BD T)) 

GS ret = boot fn(BOOTM STATE OS BD T, arge, argv, images); 
676 if (!ret && (states & BOOTM STATE OS PREP)) 

GI ret = boot fn(BOOTM STATE OS PREP, arge, argv, images); 
678 

679 £fifdef CONTIG TRACH 

680 JI ieretendi tco run ehe OS then run a user conmnand s 

681 if (!ret && (states & BOOTM STATE OS FAKE GO)) { 

682 char *cmd list = getenv("fakegocmd"); 

683 

684 ret 5 boot selected os(argc, argy, BOOTM STATE OS FAKE GO, 
685 images, boot fn); 

686 sus (Uret me eme list) 

687 pet = run Command) list (eme list, =p ilag) y 

688 } 

689 pemci 

690 

c9 /* Check for unsupported subcommand. */ 

692 if (ret) ( 

693 puts("subcommand not supported Wn"); 

694 return ret; 

695 ) 

696 

697 /* Now run the OS! We hope this doesn't return */ 

698 if (!ret && (states & BOOTM STATE OS GO)) 

699 ret 5 boot selected os(argc, argv, BOOTM STATE OS GO, 
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700 images, boot fn); 


qua return ret; 
miea 

函数 do bootm states 根据 不 同 的 BOOT 状态 执行 不 同 的 代码 段 ， 通 过 如 下 代码 来 判断 
BOOT 状态 : 

states & BOOTM STATE XXX 
在 do bootz 函数 中 会 用 到 BOOTM STATE OS PREP ,BOOTM STATE OS FAKE GO 和 
BOOTM STATE OS GO 这 三 个 BOOT 状态 ,bootz start 函数 中 会 用 到 BOOTM STATE START 
这 个 BOOT 状态 。 为 了 精简 代码 ， 方 便 分 析 ， 因 此 我 们 将 示例 代码 32.3.4.1 中 的 函数 
do bootm states 进行 精简 ， 只 留 下 下 面 这 4 个 BOOT 状态 对 应 的 处 理 代 码 : 

BOOTM STATE OS PREP 

BOOTM STATE OS FAKE GO 

BOOTM STATE OS GO 

BOOTM STATE START 

精简 以 后 的 do bootm states 函数 如 下 所 示 : 

示例 代码 32.3.4.2 精简 后 的 do_bootm_states 函数 

59 int elo bootm states (cmo tol t vendito, Imt tlag, ina arge, clue 9 
































eremitae cns ena [lr 






































592 Lat States, looo headers i: “images, int Boot progress) 
Soe N 

594 boot 0s in vboor 1p 

595 ulong iflag 2 0; 

596 dise get = 0, meed boor zm» 

SION 

5S images-»state |= states; 

Sg) 

600 fiz 

601 * Work through the states and see how far we get. We stop on 
602 sany Seon 

603 a 

604 if (states & BOOTM STATE START) 

605 ret = bootm start(cmdtp, flag, arge, argv); 

654 

655 /* From now on, we need the OS boot function */ 
656 if (ret) 

657 return ret; 

658 boot fn = bootm os get boot func(images-»0s.0s); 
S39 need boot fn —- states & (BOOTM STATE OS CMDLINE | 
660 BOOTM STATE OS BD T | BOOTM STATE OS PREP | 
661 BOOTM STATE OS FAKE GO | BOOTM STATE OS GO); 
662 if (boot fn == NULL && need boot fn) ( 
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663 if (iflag) 

664 enable interrupts(); 

665 printet BRRORSOSEno (ox YY Sno sm peortEeeom. 
666 genimg get os name(images-»0s.0s), images-»0os.os); 
667 bootstage error(BOOTSTAGE ID CHECK BOOT OS); 

668 return |; 

669 ) 

670 

676 if (!ret && (states & BOOTM STATE OS PREP)) 

677 Tet c boot in(BOOIM STATE OS PREP, Arge, argy, mages)? 
678 

679 #ifdef CONFIG TRACE 

680 petend to run Che OS then run a user command </ 

681 if (!ret && (states & BOOTM STATE OS FAKE GO)) { 

682 char *cmd list = getenv("fakegocmd"); 

683 

684 ret © boot selected os(argc, argy, BOOTM STATE OS FAKE GO, 
685 images, boot fn); 

686 if (!ret && cmd list) 

687 ret = rum Command) lbenc((ewasl list, =l; ilag) z 

688 } 

689 t$endif 

690 

691 /* Check for unsupported subcommand. */ 

692 if (ret) ( 

59S puts("subcommand not supported\n"); 

694 return ret; 

695 } 

696 

697 /* Now run the OS! We hope this doesn't return */ 

698 if (!ret && (states & BOOTM STATE OS GO)) 

699 ret = boot selected os(argc, argy, BOOTM STATE OS GO, 
700 images, Door imp 

al return ret; 

qas 





mE 


第 604. 605 行 ， 处 理 BOOTM STATE START 阶段 ，bootz_start 会 执行 这 一 段 代 码 ， 这 上 
调用 函数 bootm start， 此 函数 定义 在 文件 common/bootm.c F, KZA RU TF: 
示例 代码 32.3.4.2 bootm_statt 函数 
$9 genie int boota Susie (eue tol t wendo, init tlag, int arge, 





70 Char Aeons muse i 
mE 
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"8 memset((void *)&images, 0, sizeof(images)); /* 7T images */ 
TS images.verify = getenv yesno("verify");/* PRM verfify FERA */ 
74 

Ws boot start lmb(&images); 

76 

go bootstage mark name(BOOTSTAGE ID BOOTM START, "bootm start"); 
78 images.state = BOOTM STATE START;/* 设置 状态 为 BOOTM STATE START */ 
79 

80 return 0; 

xl 


接着 回 到 示例 代码 32.3.4.2 F, 4E: 4) TER do bootm states. $8 658 行 非常 重要 ! 通过 
数 bootm os get boot func 来 查找 系统 启动 函数 ， 参 数 images->os.os 就 是 系统 类 型 ， 根 据 这 
系统 类 型 来 选择 对 应 的 启动 函数 ， 在 do bootz 中 设置 images.os.os= IH OS LINUX. Pio 
值 就 是 找到 的 系统 启动 函数 ， 这 里 找到 的 Linux 系统 启动 函数 为 do bootm linux, XF HEK 
查找 系统 启动 函数 的 过 程 请 参考 32.3.5 小 节 。 因 此 boot fn=do_bootm linux, 后 面 执行 boot fn 
数 的 地 方 实际 上 是 执行 的 do bootm linux 函数 。 

第 676 行 ,处 理 BOOTM_STATE_OS_PREP 状态 , 调用 函数 do_bootm linux, do bootm linux 
也 是 调用 boot prep linux 来 完成 具体 的 处 理 过 程 。boot prep_linux 主要 用 于 处 理 环 境 变 量 
bootargs，bootargs 保存 着 传递 给 Linux kernel 的 参数 。 

第 679~689 行 是 处 理 BOOTM_STATE_OS_FAKE GO 状态 的 ,但 是 要 我 们 没 用 使 能 TRACE 
功能 ， 因 此 宏 CONFIG TRACE 也 就 没有 定义 ， 所 以 这 段 程 序 不 会 编译 。 
第 699 行 ， 调 用 函数 boot selected os 启动 Linux 内 核 ， 此 函数 第 4 个 参数 为 Linux 系统 镜 
k, B 5 个 参数 就 是 Linux 系统 启动 函数 do bootm linux. boot selected os 函数 定义 在 文件 
common/bootm os.c F, KAAR TF: 
示例 代码 32.3.4.3 boot_selected_os 函数 


41$ int boot selected oslint arge, Ghar w Const argyll; ijs state, 
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477 looo headers ic vimagee, loot oe im vboot iu 
478 ( 

479 areh jexeloooet OS 

480 boot inm((encaste, arge, argy, images)? 

490 return BOOTM ERR RESET; 

491 ) 





第 480 行 调用 boot fn 函数 ， 也 就 是 do_bootm linux 函数 来 启动 Linux 内 核 。 





32.3.5 bootm os get boot func 函数 





do bootm states 会 调用 bootm os get boot func 来 查找 对 应 系统 的 启动 函数 ， 此 函数 定义 
在 文件 common/bootm os.c F, KNU TF: 
示例 代码 32.3.5.1 bootm os get boot func 函数 


295 boot 6s im vocor OS Get boot ue (ey) 























494 ( 
495 #ifdef CONFIG NEEDS MANUAL RELOC 
496 static bool relocated; 
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497 

498 if (!relocated) ( 

499 stet aLg 

500 

SONi /* relocate boot function table */ 

502 for (i = 0; i < ARRAY SIZE(boot os); i++) 
503 if (boot os[i] != NULL) 

504 boot osi ve gye-cuselee oit; 

505 

506 relocated - true; 

507 } 

508 #endif 

509 return boot_os[os]; 

510 ] 





第 495-508 行 是 条 件 编译 , 在 本 uboot 中 没有 用 到 , 因此 这 段 代 码 无 效 , 只 有 509 行 有 效 。 
在 509 行 中 boot os 是 个 数组 ， 这 个 数组 里 面 存 放 着 不 同 的 系统 对 应 的 启动 函数 。boot os 也 定 
义 在 文件 common/bootm os.c 中 ， 如 下 所 示 : 
示例 代码 32.3.5.2 boot os 数组 
45/5 statie boot Gier itm 'eloxoxoe OL — s 


























436 [IH OS U BOOT] = do bootm standalone, 
437 $ifdef CONFIG BOOTM LINUX 

438 [IH OS LINUX] 2 do bootm linux, 

439 #endif 


465 $ifdef CONFIG BOOTM OPENRTOS 
466 [IH OS OPENRTOS] = do bootm openrtos, 
467 $endif 
468 ); 
第 438 行 就 是 Linux 系统 对 应 的 启动 函数 : do bootm linux. 








32.3.6 do bootm linux 函数 


经 过 前 面 的 分 析 ， 我 们 知道 了 do bootm linux 就 是 最 终 启动 Linux 内 核 的 函数 ， 此 函数 定 
义 在 文件 arch/arm/lib/bootm.e, KANUN TF : 
示例 代码 32.3.6.1 do. bootm linux 函数 


3:399) ine CO lexoxoncun Jisuewsex (bene ilag, int arge, Char w Conert eue [D 



































340 bootm headers t *images) 

341 ( 

342 /* No need for those on ARM */ 

343 if (flag & BOOTM STATE OS BD T || flag & BOOTM STATE OS CMDLINE) 
344 return -1; 

345 

346 if (flag & BOOTM STATE OS PREP) ( 

347 boot prep linux(images); 
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348 
349 
3150) 
Sx 
252 
059 
354 
E 
356 
3:5] 
358 
IIO 





的 话 














2a 


return 0; 


if (flag & (BOOTM STATE OS GO 
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| BOOTM STATE OS FAKE GO)) { 


boot jump linux(images, flag); 


return 0; 


boot prep linux 


(images); 


boot jump linux(images, flag); 


return 0; 


} 








第 351 行 ,如 果 参 数 flag 等 于 BOOTM STATE OS GO 或 者 BOOTM STATE OS FAKE GO 
就 执行 boot jump linux PAZ. boot selected os 函数 在 调用 do_bootm linux 的 时 候 会 将 flag 
设置 为 BOOTM STATE OS GO. 
第 352 行 ， 执 行 函数 boot jump_linux( 又 来 了 一 个 函数 ， 绕 啊 绕 啊 ! 心 累 ! )， 此 函数 定义 
在 文件 arch/arm/lib/bootm.c F, KAUNA TF: 
示例 代码 32.3.6.2 boot jump. linux 函数 


212 Statie void boot jomo linux (bc0tm headers © vimeges, mte ilag) 


{ 


274 #ifdef CONFIG ARM64 


PD 
299 
294 
2/95 
296 
ZO 
298 
299 
300 
301 
302 
S09 
304 
305 
306 
307 
308 
309 
SIN 
SL 
32 


#else 

















unsigned long machid 2 gd-»bd-»bi arch number; 


chatri ep 


wieso] (Vkermel entry) (int zero, int archa, uint params) ? 


unsigned long r2; 


int fake — (flag & BOOTM STATI 


kernel entry - 








(ordi) (GNE, 


s = getenv("machid"); 


if (s) ( 





E OS FAK 


EEEO) 


int, uint))images->ep; 


da (rriet Strtoulls;, 55 Cmachich < 99 i 
depui Gs Aeee eee ou en 


return; 
} 
printf("Using machid Ox$l1x from environment'n", machid); 
} 
debug ("## Transferring control to Linux (at address $081x)" \ 


ISP (ulong) kergel entry); 





bootstage mark( 





BOOTSTAGE ID RUN OS); 


833 


LMX6U SA XR Linux 驱动 开发 指南 O ERAF 




















原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
S15 announce and cleanup(fake); 

314 

315 if (IMAGE ENABLE OF LIBFDT && images-»ft len) 
S16 r2 —- (unsigned long)images-»ft addr; 

Suy else 

318 r2 — gd-»bd-»bi boot params; 

EIE 

929 kermel entry(0, machicd, 152) 5 

9219 ) 

S30 pendii 

SOUS) 


第 274-292 113& 64 位 ARM 芯片 对 应 的 代码 ，Cortex-A7 是 32 位 芯片 ， 因 此 用 不 到 。 





第 293 ÍT, 变量 machid 保存 机 器 ID, 如 果 不 使 用 设备 树 的 话 这 个 机 器 ID 会 被 传递 给 Linux 
内 核 , Linux 内 核 会 在 自己 的 机 器 ID 列表 里 面 查 找 是 否 存在 与 uboot 传递 进来 的 machid 匹配 的 
项 目 ， 如 果 存 在 就 说 Linux 内 核 文 持 这 个 机 器 ， 那 么 Linux 就 会 启动 ! 如 果 使 用 设备 树 的 话 这 
个 machid 就 无 效 了 ， 设 备 树 存 有 一 个 “兼容 性 ”这 个 属性 ，Linux 内 核 会 比较 “兼容 性 ”属性 


















































的 值 (字符 串 ) 来 查看 是 否 支 持 这 个 机 器 。 





第 295 T, AŽ kernel entry， 看 名 字 “ 内 核 进入 ” 说 明 此 函数 是 进入 Linux 内 核 的 ， 也 
就 是 最 终 的 大 boos!! 此 函数 有 三 个 参数 : zero，arch，params， 第 一 个 参数 zero 同样 为 0， 第 














二 个 参数 为 机 器 ID; 第 三 个 参数 ATAGS 或 者 设备 树 (DTB) 首 地 址 ，ATAGS 是 传统 的 方法 ， 月 








于 传递 一 些 命令 行 信息 喻 的 ， 如 果 使 用 设备 树 的 话 就 要 传递 设备 树 (DTB)。 





H 


第 299 行 ， 获 取 kernel entry ŽL, PŽ kernel entry 并 不 是 uboot 定义 的 ， 而 是 Linux 内 
核定 义 的 , Linux 内 核 镜像 文件 的 第 一 行 代码 就 是 函数 kernel entry; 而 images->ep 保存 着 Linux 











内 核 镜像 的 起 始 地 址 ， 而 起 始 地 址 保存 的 不 正 是 Linux 内 核 第 一 行 代码 ! 











第 313 行 ， 调 用 函数 announce and cleanup 来 打印 一 些 信息 并 做 一 些 清理 工作 ， 此 函数 定 





义 在 文件 arch/arm/lib/bootm.c F, KAN AU TF: 
示例 代码 32.3.6.3 announce and. cleanup $% žk 


J2 takie void ennouncs and tre mm Bim rte ue) 





BH 

74 printf("NnStarting emma 

5, ER 

76 bootstage mark name(BOOTSTAGE ID BOOTM HANDOFF, "start kernel"); 
87 eleanvp etc ns MNT m (g 

OON 





第 74 行 ， 在 启动 Linux 之 前 输出 “Starting kernel ...” 信 息 ， 如 图 32.3.6.1 所 示 : 


Kernel image @ Ox80800000 [ Ox000000 - Ox65ef68 ] 
## Flattened Device Tree blob at 83000000 
Booting using the fdt blob at Ox83000000 
Using Device Tree in place at 83000000, end 8300bc80 


starting kernel ... 











Booting Linux on physical CPU 0x0 


Linux version 4.1.15 (zuozhongkaiQubuntu) (gcc version 4.9.4 (Linaro GCC 4. 


t May 25 12:32:15 CST 2019 
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图 32.3.6.1 系统 启动 提示 信息 














第 87 行 调 用 cleanup before linux 函数 做 一 些 清 理工 作 。 

继续 回 到 示例 代码 32.3.6.2 的 函数 boot jump linux, $8 315-318 行 是 设置 寄存 器 12 的 值 ? 
为 什么 要 设置 12 HAIE? Linux 内 核 一 开始 是 汇编 代码 ， 因 此 函数 kernel entry 就 是 个 汇编 函 
数 。 向 汇编 函数 传递 参数 要 使 用 r0、rl 和 I2( 参 数 数量 不 超过 3 个 的 时 候 )， 所 以 r2 寄存 器 就 是 
函数 kernel entry 的 第 三 个 参数 。 

第 316 fr, 如 果 使 用 设备 树 的 话 , r2 应 该 是 设备 树 的 起 始 地 址 , 而 设备 树 地 址 保存 在 images 
的 ftd addr 成 员 变 量 中 。 

第 317 行 ， 如 果 不 使 用 设备 树 的 话 ，r2 应 该 是 uboot 传递 给 Linux 的 参数 起 始 地 址 ， 也 就 
是 环境 变量 bootargs 的 值 ， 

第 328 行 ， 调 用 kernel entry 函数 进入 Linux 内 核 ， 此 行将 一 去 不 复 返 ，uboot 的 使 命 也 就 
完成 了 ， 它 可 以 安息 了 ! 

总 结 一 下 bootz 命令 的 执行 过 程 ， 如 图 32.3.6.2 Bron: 


bootz 命 令 

























































































v 
do bootz() BOOT3k A:BOOTM. STATE, START 


p> do. bootm states() 
bootm start() 


> bootz start() 


获取 Linux 镜 像 (zImage)， 保 


I—P»images- »ep = load_addr--------- Ld 存在 images 成 员 变 量 ep 中 。 





——pbootm find images() 


oot get fdt () LE » 获取 设备 树 , 设 备 树 首 地 址 保存 
a Ts dEimagesJA, Ji 3E X-ft. adde 


—»bootm disable interrupts() 


BOOT4X&:BOOTM STATE OS PREP 
BOOTM STATE OS FAKE GO 
BOOTM STATE, OS GO 
—»do bootm states() 
DOOtIT-os-get-Doot tune() es etie oeedeeceer 


—R 





» 获取 Linux 系 统 启 动 函数 : 
do bootm linux() 


boot selected os() 
boot fn() Pp ÁO d 基 实 际 运行 函数 do_bootm_linux0 


启动 Linux 之 前 做 一 些 其 他 处 
理 ， 比 如 在 设备 树 的 chosen 
节点 下 添加 子 节点 bootatgs ， 
bootargs 子 节点 存放 bootargs 


环境 变量 


boot prep Inuk = are > 


boot jump linux() 


announce and cleanup()----» f 9 “Staring kernel .. 


qoi ee rd 
kernel entry(---------------- > 启动 Linux 内 核 ! ! ! ! 

图 32.3.6.2 bootz 命令 执行 过 程 

到 这 里 uboot 的 启动 流程 我 们 就 讲解 完成 了 ， 加 上 uboot 顶层 Makefile 的 分 析 ， 洋 洋酒 酒 
100 多 页 ， 还 是 不 少 的 ! 这 也 仅仅 是 uboot 启动 流程 分 析 ， 当 缕 清 了 uboot 的 启动 流程 以 后 ， 后 
面 移植 uboot 就 会 轻松 很 多 。 其 实在 工作 中 我 们 基本 不 需要 这 么 详细 的 去 了 解 upoot， 半 导体 厂 
商 提供 给 我 们 的 uboot 一 般 是 可 以 直接 用 的 ， 只 要 能 跑 起 来 ， 可 以 使 用 就 可 以 了 。 但 是 作为 学 
习 ， 我 们 是 必须 去 详细 的 了 解 一 下 uboot 的 启动 流程 ， 否 则 如 果 在 工作 中 遇 到 问题 我 们 连 解决 
的 方法 都 没有 ， 都 不 知道 该 从 哪里 看 起 。 但 是 呢 ， 如 果 第 一 次 就 想 弄 懂 uboot 的 整个 启动 流程 
还 是 有 点 困难 的 ， 所 以 如 果 没 有 看 懂 的 话 ， 不 要 紧 ! 不 要 气 馏 ， 大 多 数 人 第 一 次 看 uboot 启动 
流程 基本 都 有 各 种 各 样 的 问题 。 

题 外 话 : 

相信 大 家 看 完 本 章 以 后 基本 都 有 一 个 感觉 : 长 、 复杂、 绕 ! 没 错 ， 2 uboot 的 
时 候 看 到 uboot 启动 流程 的 时 候 也 是 这 个 感觉 , 当时 我 也 一 m 怎么 这 么 复杂 , 这 么 长 呢 ? 



































































































































835 


I.MX6U RAR Linux 驱动 开发 指南 


O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 





尤其 前 面 的 汇编 代码 部 分 ， 还 要 涉及 到 ARM 处 到 
这 一 块 的 料 。 不 过 好 在 自己 坚持 下 来 了 ，uboot 的 




















论坛 :Www.opendev.com 
器 架构 的 内 容 ， 当 时 也 怀疑 过 自己 是 不 是 搞 
启动 流程 我 至 少 分 析 过 7,8 遍 ， 各 种 版 本 的 ， 














零 几 年 很 古老 的 ，12 年 、14 年 比较 新 的 等 等 很 多 个 版 本 的 uboot。 就 LMX6ULL 使 用 的 这 个 
2016.03 版 本 uboot 我 至 少 详细 的 分 析 了 2 遍 ， 直 至 写 完 本 章 ， 大 概 花 了 1 个 月 的 时 间 。 这 期 间 








相信 很 多 朋友 看 完 本 章 可 能 会 想 : 我 什么 时 候 





查阅 了 各 种 资料 ， 看 了 不 知道 多 少 篇 博客 ， 在 这 里 感谢 那些 无 私 奉献 的 网 友 们 。 


也 能 这 么 厉害 , 能 够 这 么 详细 的 分 析 uboot Jr 





动 流 程 。 甚 至 可 能 会 有 挫败 感 ， 还 是 那 句 话 : MEAR! 千里 之 行 始 于 足下 ， 所 有 你 羡慕 的 人 
都 曾经 痛苦 过 ， 挫 败 过 。 脚 踏实 地 ， 一 步 一 个 脚印 ， 一 点 一 滴 的 积累 ， 最 终 你 也 会 成 为 你 所 次 
WA. ERAR Linux 这 条 道路 上 ， 有 众多 的 学 习 者 陪 着 你 ， 大 家 相互 换 扶 ， 终 能 踏 出 一 条 

















康 庄 大 道 ， 祝 所 有 的 同学 终 有 所 获 ! 
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第 三 十 三 章 U-Boot 移植 


上 一 章节 我 们 详细 的 分 析 了 uboot 的 启动 流程 ， 对 uboot 有 了 一 个 初步 的 了 解 。 前 两 章 我 








们 都 是 使 用 的 正点 原子 提供 的 uboot， 本 章 我 们 就 来 学 习 如 何 将 NXP 官方 的 uboot 移植 到 正点 
原子 的 LIMX6ULL 开发 板 上 ， 学 习 如 何在 uboot 中 添加 我 们 自己 的 板子 。 
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33.1 NXP 官方 开发 板 uboot 编译 测试 


33.1.1 查找 NXP 官方 的 开发 板 默认 配置 文件 


uboot 的 移植 并 不 是 说 我 们 完 完全 全 的 从 零 开始 将 uboot 移植 到 我 们 现在 所 使 用 的 开发 板 
或 者 开发 平台 上 。 这 个 对 于 我 们 来 说 基本 是 不 可 能 的 ， 这 个 工作 一 般 是 半导体 厂商 做 的 ， 半 导 
体 厂商 负责 将 uboot 移植 到 他 们 的 蕊 片上， 因此 半导体 厂商 都 会 自己 做 一 个 开发 板 ， 这 个 开发 
板 就 叫做 原 厂 开发 板 , 比如 大 家 学 习 STM32 的 时 候 听 说 过 的 discover 开 发 板 就 是 ST 自己 做 的 。 
半导体 厂商 会 将 uboot 移植 到 他 们 自己 的 原 三 开发 板 上 ， 测 试 好 以 后 就 会 将 这 个 uboot 发 布 出 
去 ， 这 就 是 大 家 常 说 的 原 厂 BSP 包 。 我 们 一 般 做 产品 的 时 候 就 会 参考 原 厂 的 开发 板 做 硬件 ， 然 
后 在 原 厂 提供 的 BSP 包 上 做 修改 ， 将 uboot 或 者 linux kernel 移植 到 我 们 的 硬件 上 。 这 个 就 是 
uboot 移植 的 一 般 流程 : 

(D. f£ uboot 中 找到 参考 的 开发 平台 ， 一 般 是 原 厂 的 开发 板 。 

@、 参 考 原 厂 开 发 板 移植 uboot 到 我 们 所 使 用 的 开发 板 上 。 

正点 原子 的 LMX6ULL 开发 板 参 考 的 是 NXP 官方 的 LMX6ULL EVK 开发 板 做 的 硬件 ， 因 
此 我 们 在 移植 uboot 的 时 候 就 可 以 以 NXP 官方 的 LIMX6ULL EVK 开发 板 为 蓝 

本 章 我 们 是 将 NXP 官方 的 uboot 移植 到 正点 原子 的 LMX6ULL 开发 板 上 ，NXP 官方 的 
uboot 放 到 了 开发 板 光盘 中 ， 路 径 为 : 1、 例 程 源码 ->4、NXP 官方 原版 Uboot 和 Linux->uboot- 
imx-rel imx 4.1.15 2.1.0_ga.tar.bz2。 将 uboot-imx-rel imx 4.1.15 2.1.0 ga.tar.bz2 发 送 到 Ubuntu 
中 并 解压 ， 然 后 创建 VSCode 工程 。 

在 移植 之 前 , 我 们 先 编译 一 下 NXP 官方 LIMX6ULLEVK 开发 板 对 应 的 uboot， 首 先是 配置 
uboot, configs 目录 下 有 很 多 跟 LMX6UL/6ULL 有 关 的 配置 如 图 33.1.1.1 所 示 ， 
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IX 6UL » IMX6UL NXP UBOOT And Linux » IMX6UL > uboot » uboot-imx-rel imx 4.1.15 2.1.0 ga » configs vo 
名 称 ^ 修改 日 期 类 型 大 小 
] mx6ul 9x9 evk qspi1 defconfig 2017/5/2 10:45 文件 1 KB 
|] mx6ul 14x14 ddr3 arm2 defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ul 14x14 ddr3 arm2 eimnor defconfig 2017/5/2 10:45 文件 1 KB 
|.) mx6ul 14x14 ddr3 arm2 emmc defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ul 14x14 ddr3 arm2 nand defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ul 14x14 ddr3 arm2 qspi1 defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ul 14x14 ddr3_arm2_spinor defconfig 2017/5/2 10:45 文件 1 KB 
| | mx6ul 14x14 evk ddr eol brillo defconfig 2017/5/2 10:45 文件 1 KB 
| | mx6ul 14x14 evk ddr eol defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ul 14x14 evk ddr eol qspi1 defconfig 2017/5/2 10:45 文件 1 KB 
|.] mx6ul 14x14 evk defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ul 14x14 evk emmc defconfig 2017/5/2 10:45 文件 1 KB 
| | mx6ul 14x14 evk nand defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ul 14x14 evk qspi1 defconfig 2017/5/2 10:45 文件 1 KB 
mx6ul 14x14 Ipddr2 arm2 defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ul 14x14 Ipddr2 arm2 eimnor defconf.. 2017/5/2 10:45 文件 1 KB 
|.) mx6ull 9x9 evk defconfig 2017/5/2 10:45 文件 1 KB 
|. mx6ull 9x9 evk qspi1 defconfig 2017/5/2 10:45 文件 1 KB 
|_| mx6ull 14x14 ddr3 arm2 defconfig 2017/5/2 10:45 文件 1 KB 
|. ] mx6ull 14x14 ddr3 arm2 emmc defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ull 14x14 ddr3 arm2 epdc defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ull 14x14 ddr3 arm2 nand defconfig 2017/5/2 10:45 文件 1 KB 
] mx6ull 14x14 ddr3 arm2 qspi1 defconfig 2017/5/2 10:45 文件 1 KB 
|] mx6ull 14x14 ddr3 arm2 spinor defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ull 14x14 ddr3 arme? tsc defconfig 2017/5/2 10:45 文件 1 KB 
| | mx6ull 14x14 evk defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ull 14x14 evk emmc defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ull 14x14 evk nand defconfig 2017/5/2 10:45 文件 1 KB 
| mx6ull 14x14 evk qspil defconfig 2017/5/2 10:45 文件 1 KB 





图 33.1.1.1 NXP 官方 LMX6UL/6ULL 默认 配置 文件 





从 图 33.1.1.1 可 以 看 出 有 很 多 的 默认 配置 文件 ， 其 中 以 mx6ul 开头 的 是 LMX6UL 芯片 的 ， 


mx6ull 开头 的 是 LMX6ULL 开发 板 的 。 ILMX6UL/6ULL 有 9x9mm 和 14x14mm 两 种 尺寸 的 ， 所 
以 我 们 可 以 看 到 会 有 mx6ull 9x9 和 mx6ull 14x14 开头 的 默认 配置 文件 。 我 们 使 用 的 是 14x 14mm 


的 芯片 ， 所 以 关注 mx6ull 14x14 开头 的 默认 配置 文件 。 了 




















E 点 原子 的 LMX6ULL 有 EMMC 和 





NAND 两 个 版 本 的 ， 此 我 们 最 终 只 需要 关注 mx6ull 14x14 evk_emmc defconfig 和 
mx6ull 14x14 evk nand defconfig 这 两 个 配置 文件 就 行 了 。 本 章 我 们 讲解 EMMC 版 本 的 移植 
(NAND 版 本 移植 很 多 类 似 ), 所 以 使 用 mx6ull 14x14_evk_emmc_defconfig 作为 默认 配置 文件 。 

















33.1.2 编译 NXP 官方 开发 板 对 应 的 uboot 


找到 NXP 官方 LMX6ULL EVK 开发 板 对 应 的 默认 配置 文件 以 后 就 可 以 编译 一 下 ， 使 用 如 下 
命令 编译 uboot: 
make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- mx6ull 14x14 evk emmc defconfig 
make V-1 ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- -j16 
编译 完成 以 后 结果 如 图 33.1.2.1 所 示 : 




















839 


LMX6U 嵌入 式 Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


arm-linux-gnueabihf-objcopy --gap-fill=0xff -j .text -j .secure text -j .rodata -j .hash 
-j -data -j .got -j .got.plt -j .u boot list -j .rel.dyn -0 binary u-boot u-boot-nodtb.bin 
arm-linux-gnueabihf-objcopy --gap-fill-zOxff -j .text -j .secure text -j .rodata -j .hash 
-j .data -j .got -j .got.plt -j .u boot list -j .rel.dyn -0 srec u-boot u-boot.srec 
arm-linux-gnueabihf-objdump -t u-boot » u-boot.sym 
cp u-boot-nodtb.bin u-boot.bin 
make -f ./scripts/Makefile.build objzarch/arm/imx-common u-boot.imx 
-p board/freescale/mx6ullevk/ 
./tools/mkimage -n board/freescale/mx6ullevk/imximage.cfg.cfgtmp -T imximage -e 0x87800000 
-d u-boot.bin u-boot.imx 
Freescale IMX Boot Image 
2 (i.MX53/6/7 compatible) 
DCD 
425984 Bytes = 416.00 kB = 0.41 MB 
Load Address: 877ff420 
Entry Point: 87800000 





图 33.1.2.1 编译 结果 
从 图 33.1.2.1 可 以 看 出 , 编译 成 功 .我们 在 编译 的 时 候 需 要 输入 ARCH 和 CORSS_COMPILE 
这 两 个 变量 的 值 ， 这 样 太 麻烦 了 。 我 们 可 以 直接 在 顶层 Makefile 中 直接 给 ARCH 和 
CORSS COMPILE 赋值 ， 修 改 如 图 33.1.2.2 所 示 : 


Me 















































245 # set default to nothing for native builds 
246 ifeq ($(HOSTARCH), $ (ARCH) ) 

247 CROSS COMPILE ?= 

248 endif 


250 ARCH = arm 
251 CROSS COMPILE = arm-linux-gnueabihf- 


图 33.1.2.2 添加 ARCH fill CROSS COMPILE 值 

图 33.1.2.2 中 的 250. 251 行 就 是 直接 给 ARCH 和 CROSS. COMPILE 赋值 ， 这 样 我 们 就 可 
以 使 用 如 下 简短 的 命令 来 编译 uboot 了 : 

make mx6ull 14x14 evk emmc defconfig 

make V-1 -j16 

如 果 既 不 想 修改 uboot 的 顶层 Makefile， 又 想 编译 的 时 候 不 用 输入 那么 多 ， 那 么 就 直接 创 
建 个 shell 脚本 就 行 了 ，shell 脚本 名 为 mx6ull 14x14. emmc.sh， 然 后 在 shell 脚本 里 面 输入 如 下 
内 容 : 
























































示例 代码 33.1.2.1 mx6ull_14x14_emmc.sh 文件 
1 #!/bin/bash 
2 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- distclean 











3 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- 
mx6ull 14x14 evk emmc defconfig 
4 make V=1 ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- -j16 

记得 给 mx6ull 14x14 emmc.sh 这 个 文件 可 执行 权限 ， 使 用 mx6ull. 14x14. emmc.sh 脚本 编 
译 uboot 的 时 候 每 次 都 会 清理 一 下 工程 ， 然 后 全 部 重新 编译 ， 编 译 的 时 候 直接 执行 这 个 脚本 就 
行 了 ， 命 令 如 下 : 

./mx6ull 14x14 evk emmc.sh 

编译 完成 以 后 会 生成 u-boot.bin, u-boot.imx 等 文件 , 但 是 这 些 文件 是 NXP 官方 LMX6ULL 
EVK 开饭 。 能 不 能 用 到 正点 原子 的 LIMX6ULL 开发 板 上 呢 ? 试 一 下 不 就 知道 了 ! 
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33.1.3 烧 写 验证 与 驱动 测试 





将 imxdownload 软件 拷贝 到 uboot 源码 根 目 录 下 ， 然 后 使 用 imxdownload 软件 将 u-boot.bin 
烧 写 到 SD 卡 中 ， 烧 写 命令 如 下 : 

chmod 777 imxdownload /给 予 imxdownload 可 执行 权限 

/imxdownload u-boot.bin /dev/sdg // 烧 写 u-boot.bin 到 SD 卡 中 

烧 写 完成 以 后 将 SD 卡 搬入 LMX6U-ALPHA 开发 板 的 TF 卡 槽 中 ， 最 后 设置 开发 板 从 SD 
卡 启动 。 打 开 SecureCRT， 设 置 好 开发 板 所 使 用 的 串口 并 打开 ,复位 开发 板 ，SecureCRT 接收 到 
如 下 图 33.1.3.1 所 示 信 息 : 


U-Boot 2016.03 (May 11 2019 - 15:52:17 +0800) 





























CPU: Freescale i.MX6ULL rev1.1 528 MHz (running at 396 MHz) 
CPU: Industrial temperature grade (-40C to 105C) at 45C 
Reset cause: POR 

Board: MX6ULL 14x14 EVK 

I2C: ready 

DRAM: 512 MiB 

MMC: FSL SDHC: 0, FSL SDHC: 1 

unsupported panel TFT7016 


In: serial 
Out: serial 
Err: serial 


switch to partitions £0, OK 

mmcO is current device 

Net: Board Net Initialization Failed 
No ethernet found. 

Normal Boot 

Hit any key to stop autoboot: 0 

No ethernet found. 

No ethernet found. 

Bad Linux ARM zImage magic! 

=> 


图 33.1.3.1 uboot 启动 信息 
从 图 33.1.3.1 可 以 看 出 ，uboot 启动 正常 ， 虽 然 我 们 用 的 是 NXP 官方 IMX6ULL 开发 板 的 
uboot， 但 是 在 正点 原子 的 LIMX6ULL 开发 板 上 是 可 以 正常 启动 的 。 而 且 DRAM 识别 正确 ， 为 
512MB, 如 果 用 的 NAND 版 本 的 核心 版 的 话 uboot 启动 会 失败 ! 因 为 NAND 核心 版 用 的 256MB 
的 DRAM。 


1. SD EÑ EMMC 驱动 检查 


检查 一 下 SD FRA EMMC 驱动 是 否 正 常 ， 使 用 命令 mme list 列 出 当前 的 MMC 设备 ， 结 
如 图 33.1.3.2 所 示 : 
































=> mmc list 
FSL_SDHC: 0 (SD) 
FSL. SDHC: 1 
=> 
图 33.1.3.2 emme 设备 检查 
从 图 33.1.3.2 可 以 看 出 当前 有 两 个 MMC 设备 , 检查 每 个 MMC 设备 信息 , 先 检 查 MMC 设 
备 1， 输 入 如 下 命令 : 


mmc dev 0 











mmc info 


结果 如 图 33.1.3.3 所 示 : 
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=> mmc dev 0 

switch to partitions £0, OK 
mmcO is current device 

=> mmc info 

Device: FSL. SDHC 
Manufacturer ID: 3 

OEM: 5344 

Name: SC16G 

Tran Speed: 50000000 

Rd Block Len: 512 

SD version 3.0 

High Capacity: Yes 
Capacity: 14.8 GiB 

Bus Width: 4-bit 

Erase Group Size: 512 Bytes 


33.1.3.3 mmc 设备 0 信息 
从 图 33.1.3.3 可 以 看 出 ，mme 设备 0 是 SD F, SD 卡 容量 为 14.8GB， 这 个 和 我 所 使 用 的 
SD 卡 信息 相符 ， 说 明 SD 卡 驱动 正常 。 再 来 检查 MMC 设备 1， 输 入 如 下 命令 : 


mmc dev 1 











mmc info 
吉 果 如 图 33.1.3.4 所 示 : 


=> mmc dev 1 

switch to partitions £0, OK 
|mmcl(part 0) is current device 
=> mmc info 

Device: FSL. SDHC 
Manufacturer ID: 15 

OEM: 100 

Name: 4FTE4 

Tran Speed: 52000000 

Rd Block Len: 512 

MMC version 4.0 

High Capacity: Yes 
|Capacity: 3.6 GiB 

|Bus width: 8-bit 

Erase Group Size: 512 KiB 
=> 





X 





33.1.3.4 mme 设备 1 信息 
从 图 33.1.3.4 可 以 看 出 , mme 设备 1 为 EMMC, 容量 为 3.6GB, 说 明 EMMC 驱动 也 成 功 ， 
SD 卡 和 EMMC 的 驱动 都 没 问 题 。 
2. LCD 驱动 检查 
如 果 uboot 中 的 LCD 驱动 正确 的 话 ， 启 动 uboot 以 后 LCD 上 应 该 会 显示 出 NXP 的 logo, 
如 下 图 33.1.3.5 所 示 : 
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33.1.3.5 uboot LCD 界面 

如 果 你 用 的 不 是 正点 原子 的 4.3 T 480x272 分 辨 率 的 屏幕 的 话 ， 那 么 LCD 就 不 会 显示 
33.1.3.5 所 示 logo 界面 。 因 为 NXP 官方 LMX6ULL 开发 板 的 屏幕 就 是 4.3 寸 480x272 分 辨 率 
的 ， 所 以 uboot 默认 LCD 驱动 是 4.3 寸 480x272 分 辨 率 的 。 如 果 使 用 其 他 分 辩 率 的 LCD 就 需 
要 修改 LCD 驱动 ， 这 里 我 们 先 不 修改 LCD 驱动 了 ， 稍 后 我 们 在 讲解 如 何 修改 uboot 中 的 LCD 
驱动 ， 我 们 只 需要 记得 ，uboot 的 LCD 需要 修改 就 行 了 。 

3、 网 络 驱 动 

uboot 启动 的 时 候 提 示 “Board Net Initialization Failed” 和 “No ethernetfound.” 这 两 行 ， 说 
明 网 络 驱 动 也 有 问题 ， 正 常情 况 下 应 该 是 如 图 33.1.3.6 所 示 提 示 : 


switch to partitions #0, OK 
mmcO is current device 


























Hit any key to stop autoboot: 0 
=> 





33.1.3.6 网 络 信息 

现在 没有 图 33.1.3.6 中 的 信息 ， 那 更 别 说 ping 一 下 ubuntu 主机 了 ， 说 明 当 前 uboot 的 网 络 
部 驱动 也 是 有 问题 的 ， 这 是 因为 正点 原子 开发 板 的 网 络 芯 片 复 位 引 脚 和 NXP 官方 开发 板 不 一 
样 ， 因 此 需要 修改 驱动 。 

总 结 一 下 NXP 官方 LMX6ULL EVK 开发 板 的 uboot 在 正点 原子 EMMC 版 本 LMX6ULL 
开发 板 上 的 运行 情况 : 

©, uboot 启动 正常 ，DRAM 识别 正确 ，SD 卡 和 EMMC 驱动 正常 。 

Q). uboot 里 面 的 LCD 驱动 默认 是 给 4.3 寸 480x272 分 辨 率 的 ， 如 果 使 用 的 其 他 分 辩 率 的 











屏幕 需要 修改 驱动 。 
包 、 网 络 不 能 工作 ， 识 别 不 出 来 网 络 信息 ， 需 要 修改 驱动 。 
接 下 来 我 们 要 做 的 工作 如 下 : 





Q@、 前 面 我 们 一 直 使 用 着 uboot 中 NXP 官方 开发 板 的 配置 ， 接 下 来 需要 在 uboot 中 添加 我 
们 自己 的 开发 板 ， 也 就 是 正点 原子 的 LIMX6ULL 开发 板 。 
©, ffi LCD 驱动 和 网 络 驱动 的 问题 。 


33.2 在 U-Boot 中 添加 自己 的 开发 板 


NXP 官方 uboot 中 默认 都 是 NXP 自己 的 开发 板 ， 虽 说 我 们 可 以 直接 在 官方 的 开发 板 上 直 
接 修 改 ， 使 uboot 可 以 完整 的 运行 在 我 们 的 板子 上 。 但 是 从 学 习 的 角度 来 讲 ， 这 样 我 们 就 不 能 
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了 解 到 uboot 是 如 何 添加 新 平台 的 。 接 下 来 我 们 就 参考 NXP 官方 的 LIMX6ULL EVK 开发 板 ， 


























学 习 如 何在 uboot 中 添加 我 们 的 开发 板 或 者 开发 平台 。 





33.2.1 添加 开发 板 默认 配置 文件 


H 


先 在 configs 目录 下 创建 默认 配置 文件 ， 复 制 mx6ull 14x14_evk emme defconfig， 然 后 重 
命名 为 mx6ull alientek emme defconfig， 命 令 如 下 : 


cd configs 























cp mx6ull 14x14 evk emmc defconfig mx6ull alientek emmc defconfig 
然后 将 文件 mx6ull alientek emmc defconfig 中 的 内 容 改 成 下 面 的 : 
示例 代码 33.2.1.1 mx6ull_alientek_emmc_defconfig 文件 
1 CONFIG SYS EXTRA OPTIONSS"IMX_ CONFIG=board/freescale/mx6ull alientek_ 
emmc/imximage.cfg,MX6ULL EVK EMMC REWORK" 
CONFIG ARM=y 
CONFIG ARCH MX6=y 
CONFIG TARGET MX6ULL ALIENTEK EMMC=y 
CONFIG CMD GPIO-y 
可 以 看 出 ，mx6ull alientek emmc defconfig 基本 和 mx6ull 14x14 evk emmc defconfig 中 

的 内 容 一 样 ， 只 是 第 1 行 和 第 4 行 做 了 修改 。 












































CU WW N 











33.2.2 添加 开发 板 对 应 的 头 文 件 


在 目录 include/configs 下 添加 LMX6ULL-ALPHA 开发 板 对 应 的 头 文 件 ， 复 制 
include/configs/mx6ullevk.h， 并 重 命名 为 mx6ull alientek emmc.h, áp A P: 

cp include/configs/mx6ullevk.h mx6ull alientek emmc.h 

拷贝 完成 以 后 将 : 

#ifndef MX6ULLEVK CONFIG H 

#define MX6ULLEVK CONFIG H 

改 为 : 

#ifndef MX6ULL ALIENTEK EMMC CONFIG H 

#define MX6ULL ALIENTEK EMMC CONFIG H 

mx6ull_alientek_emmc.h 里 面 有 很 多 宏 定义 ， 这 些 宏 定 义 基 本 用 于 配置 uboot， 也 有 一 些 
LMXeULL 的 配置 项 目 。 如 果 我 们 自己 要 想 使 能 或 者 禁止 uboot 的 某 些 功能 ， 那 就 在 
mx6ull alientek emmc.h 里 面 做 修改 即 可 。mx6ull alientek emmc.h 里 面 的 内 容 比较 多 ， 去 掉 一 
些 用 不 到 的 配置 ， 精 简 后 的 内 容 如 下 : 
示例 代码 33.2.2.1 mx6ull alientek_emmc.h 文件 









































Pe oraret nhe (G0 MEG meeseae SS eneonaueror me 


* Configuration settings for the Freescale i.MX6UL 14x14 EVK board. 


* SPDX-License-Identifier: GPL-2.0- 

rA 

&ifndef ^ MX6ULL ALEITENK EMMC CONFIG H 
&define ^ MX6ULL ALEITENK EMMC CONFIG H 











"ONU EEG CH HE 
* 
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10 
IHl 
32 
1.3) 
14 
ilis 
16 


#include 
#include 
#include 


#include 


<asm/arch/imx-regs.h> 


cl/ 


"mx6 common.h" 


«asm/imx-common/gpio.h» 





&define is mx6ull 9x9 evk() CONFIG IS ENABLED (TARG 











论坛 :www.opendev.com 








&ifdef CONFIG TARGET MX6ULL 9X9 EVK 
PHYS SDRAM SIZE SZ 256M 


fdefine 
fdefine 
ftelse 

fdefine 
fdefine 
js DEDE 


CONFIG : 














BOOTARGS CMA SIZ] 





rs] 


"cma-96M " 


PHYS SDRAM SIZE SZ 512M 
CONFIG BOOTARGS CMA SIZE  "" 


used on 








Wosia ayik Da ENE. y 


*undef CONFIG LDO BYPASS CHECK 


dendif 





2S eems 

/* We default not support SPL 

* #define CONFIG SPL LIBCOMMON SUPPORT 
* $define CONFIG SPL MMC SUPPORT 


= dsabexelbwreke  "abus($ Soim” 


z 


#define 


ddefine 
ddefine 


ME SLE 


#define 


#define 
FEELS 


ddefine 
#define 


CONFIG | 


CONFIG 
CONFIG 





ENV VARS UBOOT RUNTIME CONFIG 


DISPLAY CPUINFO 
DISPLAY BOARDINFO 














(e Srelbdbexe ()) TeXexodb y 
CONFIG SYS MALLOC LEN (16 * SZ 1M) 








CONFIG BOARD EARLY INIT F 


CONFIG : 











BOARD LATE INIT 





CONFIG MXC UART 








CONFIG MXC UART BAS] 











[e] 


UART1 BAS 





ial 


V= MNE Comiiga es 
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63 #ifdef CONFIG FSL USDHC 
64 #define CONFIG SYS FSL ESDHC ADDR USDHC2 BASE ADDR 














65 

66 7/* NAND pim conflicts with usdhc2 */ 
67 #ifdef CONFIG SYS USE NAND 

68 #define CONFIG SYS FSL USDHC NUM 1 
69 #else 
70 4define CONFIG SYS FSL USDHC NUM 2 
71  $endif 

72 #endif 








quai S 2C Comtica 1*7 

75 #define CONFIG CMD I2C 

76 #ifdef CONFIG CMD I2C 

77 seeziue CONFTG SXS I2C 

78 4define CONFIG SYS I2C MXC 




















79 $define CONFIG SYS I2C MXC I2Cl1 /* enable I2C bus 1 */ 
SOME petine CONFIG SYE T2C MC T2C2 /* enable I2C bus 2 */ 
81 4define CONFIG SYS I2C SPEED 100000 

82 

89 

90 4define CONFIG SYS MMC IMG LOAD PART 1 

91 


92 #ifdef CONFIG SYS BOOT NAND 
93 ddefine CONFIG MFG NAND PARTITION "mtdparts-gpmi- 
nand:64m(boot),l16m(kernel),16m(dtb),1m(misc),-(rootfs) " 














94 #else 

95 sd4define CONFIG MFG NAND PARTITION "" 

96 dendif 

e 

98 #define CONFIG MFG ENV SETTINGS V 

99 Muniiscytsc ol eie Ss ellsenvloc olas console =- consolei o ac asc NN 
A "bootemd mfg-run mfgtool args;bootz $(loadaddr) S$(initrd addr] 
RE p WO 

JEU 


113 fif defined(CONFIG SYS BOOT NAND) 
114 #define CONFIG EXTRA ENV SETTINGS V 
































115 CONFIG MFG ENV SETTINGS V 
116 "panel-TFT43ABNO" N 
126 Doo tros = Arce rel cin NO 
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d 

128 felse 

129 £4define CONFIG EXTRA ENV SETTINGS V 
130 CONFIG MFG ENV SETTINGS \ 

ISI verip- Hook SCENOM 

202 SE NO N 

203 

204 #define CONFIG BOOTCOMMAND N 

205 rena aE Nhe Cie p N 

26 "else run netboot; fi" 

217 kendi f 

218 


219 /* Miscellaneous configurable options */ 
220 #define CONFIG CMD MEMTEST 
221 define CONFIG SYS MEMTEST START .0x80000000 























































































































222 d4define CONFIG SYS MEMTEST END (CONFIG SYS MEMTEST START T 
0x8000000) 

223 

224 #define CONFIG SYS LOAD ADDR CONFIG LOADADDR 

225 define CONFIG SYS HZ 1000 

226 

227 #define CONFIG STACKSIZE SZ 128K 

228 

ZO Eph Saca Memory Mapa 

230 4define CONFIG NR DRAM BANKS 1 

231 #define PHYS SDRAM MMDCO ARB BASE ADDR 
282 

233 #define CONFIG SYS_SDRAM BASE PHYS SDRAM 

234 #define CONFIG SYS INIT RAM ADDR IRAM BASE ADDR 

235 4define CONFIG SYS INIT RAM SIZE IRAM SIZE 

286 

237 #define CONFIG SYS_INIT_SP_OFFSET \ 

238 (CONFIG SYS INIT RAM SIZE - GENERATED GBL DATA SIZE) 
239 #define CONFIG SYS INIT SP ADDR V 

240 (CONFIG SYS INIT RAM ADDR t CONEUGESYSEEUNIEIESPEOERSEN) 
241 


242 /* FLASH and environment organization */ 
243 #define CONFIG SYS NO FLASH 
244 
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256 #define CONFIG SYS MMC ENV DEV 1 /* USDHC2 */ 
257 define CONFIG SYS MMC ENV PART 0 /* user area */ 
258 S£define CONFIG MMCROOT "/dev/mmcblk1p2" /* USDHC2 */ 























E 


260 #define CONFIG CMD BMOD 


276 /* NAND stuff */ 

277 #ifdef CONFIG SYS USE NAND 

278 #define CONFIG CMD NAND 

279 #define CONFIG CMD NAND TRIMFFS 

















280 

281 #define CONFIG NAND MXS 

282 #define CONFIG SYS_MAX NAND DEVICE 1 

283 #define CONFIG SYS NAND BASE 0x40000000 





284 #define CONFIG SYS NAND 5 ADDR CYCL 
285 #define CONFIG SYS NAND ONFI DETECTION 





[ets] 




















287 /* DMA stuff, needed for GPMI/MXS NAND support */ 
288 $define CONFIG APBH DMA 
289 #define CONFIG APBH DMA BURST 
290 #define CONFIG APBH DMA BURST8 























































































































ZION peneli 

292 

293 #define CONFIG ENV SIZE SZ 8K 

294 #if defined(CONFIG ENV IS IN MMC) 

295 #define CONFIG ENV OFFSET (12 * SZ 64K) 

296 £elif defined(CONFIG ENV IS IN SPI FLASH) 

297 #define CONFIG ENV OFFSET (768 * 1024) 

298 #define CONFIG ENV SECT SIZE (64 * 1024) 

299 #define CONFIG ENV SPI BUS CONFIG SF DEFAULT BUS 
300 £4define CONFIG ENV SPI CS CONFIG SF DEFAULT CS 
301 £4define CONFIG ENV SPI MODE CONFIG SF DEFAULT MODE 
302 4define CONFIG ENV SPI MAX HZ CONFIG SF DEFAULT SPEED 
303 #elif defined(CONFIG ENV IS IN NAND) 

304 £undef CONFIG ENV SIZE 

305 #define CONFIG ENV OFFSET (60 «« 20) 

306 £4define CONFIG ENV SECT SIZE (128 << 10) 

307 4define CONFIG ENV SIZE CONFIG ENV SECT SIZE 
308 fendif 

309 

310 


848 


LMX6U RAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


SH 4/5 USD Confids 9 
312 #define CONFIG CMD USB 
ENS ECONO MDRUSE 
314 #define CONFIG U 








D 

SB EHCI 
315 #define CONFIG USB EHCI MX6 

S 

H 

S 





316 #define CONFIG USB STORAGE 
317 £4define CONFIG EHCI HCD INIT AFTER RESET 
318 4define CONFIG USB HOST ETHER 


319 $define CONTIG USB ETHER ASIX 




































































320 $define CONFIG MXC USB PORTSC (PORT PTS UTMI | PORT PTS PTW) 
321 4define CONFIG MXC USB FLAGS 0 

322 #define CONFIG USB MAX CONTROLLER COUNT 2 

323 tendif 

324 


325 4ifdef CONFIG CMD NET 
326 #define CONFIG CMD PING 
327 #define CONFIG CMD DHCP 
328 £define CONFIG CMD MII 
329 #define CONFIG FEC MXC 
330 #define CONFIG MII 

331 #define CONFIG FEC ENET DEV il 
332 
333 #if (CONFIG FEC ENET_DEV == 0) 

334 #define IMX FEC BASE ENET BASE ADDR 
335 #define CONFIG FEC MXC PHYADDR 0x2 
336 4define CONFIG FEC XCV TYP 
337 #elif (CONFIG FEC ENET DEV == 1) 
338 £define IMX FEC BASE ENET2 BASE ADDR 
339 £define CONFIG FEC MXC PHYADDR 0x1 
340 #define CONFIG FEC XCV TYP 
341 fendif 
342 #define CONFIG ETHPRIME PECH 
343 
344 #define CONFIG PHYLIB 

345 #define CONFIG PHY MICREL 
346 fendif 

347 

348 #define CONFIG IMX THERMAL 
349 
350 4ifndef CONFIG SPL BUILD 
351 #define CONFIG VID 
352 4ifdef CONFIG VIDE 
353 4define CONFIG CFB CONSOL 

































































Es 
E 
i-i 
H 






























































Es 
E 
S 
S 
































O H| 
© 
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354 #define CONFIG VIDEO MXS 

355 #define CONFIG VIDEO LOGO 

356 #define CONFIG VIDEO SW CURSOR 








357 #define CONFIG VGA AS SINGLE DEVICE 
358 #define CONFIG SYS CONSOLE IS IN ENV 
359 £define CONFIG SPLASH SCREEN 
360 £4define CONFIG SPLASH SCREEN ALIGN 
361 £define CONFIG CMD BMP 
362 #define CONFIG BMP 16BPP 

363 £define CONFIG VIDEO BMP RLE8 
364 #define CONFIG VIDEO BMP LOGO 
365 #define CONFIG IMX VIDEO SKIP 
366 fendif 

367 tendif 

































































369 $define CONTIG IOMUX LPSR 


375 #endif 

从 示例 代码 33.2.2.1 可 以 看 出 ，mx6ull alientek emmc.h 文件 中 基本 都 是 “CONFIG ”开头 
的 宏 定 义 ， 这 也 说 明 mx6ull_alientek_emmc.h 文件 的 主要 功能 就 是 配置 或 者 裁剪 uboot。 如 果 需 
要 某 个 功能 的 话 就 在 里 面 添加 这 个 功能 对 应 的 CONFIG XXX 宏 即 可 ， 如 果 不 需 要 某 个 功能 的 
话 就 删除 掉 对 应 的 宏 即 可 。 我 们 以 示例 代码 33.2.2.1 为 例 , 详细 的 看 一 下 mx6ull alientek emmc.h 
这 些 宏 都 是 什么 功能 。 

第 14 行 ， 添 加 了 头 文件 mx6_common.h， 如 果 在 mx6ull alientek emmc.h 中 没有 发 现 有 配 
置 某 个 功能 或 命令 ， 但 是 实际 却 存在 的 话 ， 可 以 到 mx6_common.h 文件 里 面 去 找 一 下 。 

第 29~39 行 ， 设 置 DRAM 的 大 小 ， 宏 PHYS SDRAM SIZE 就 是 板子 上 DRAM 的 大 小 ， 
如 果 用 的 NXP 官方 的 9X9EVK 开 发 板 的 话 DRAM 大 小 就 为 256MB .否则 的 话 默 认为 512MB， 
正点 原子 的 LIMX6U-ALPHA 开发 板 用 的 是 512MB DDR3. 

第 50 行 ， 定义 宏 CONFIG. DISPLAY CPUINFO, uboot 启动 的 时 候 可 以 输出 CPU 信息 。 

第 51 行 ,定义 宏 CONFIG DISPLAY BOARDINFO,uboot 启动 的 时 候 可 以 输出 板子 信息 。 

第 S4 行 ，CONFIG SYS MALLOC LEN X malloc 内 存 池 大 小 ， 这 里 设置 为 16MB。 

第 56 fT, SE SLE. CONFIG BOARD EARLY INIT F， 这 样 board init f 函数 就 会 调用 
board early init 了 函数 。 

第 57 行 ， 定 义 宏 CONFIG BOARD LATE INIT， 这 样 board init r. 函数 就 会 调用 
board late init 函数 。 

第 59. 60 行 ， 使 能 ILMX6ULL 的 串口 功能 ， 宏 CONFIG MXC UART BASE 表示 串口 寄 
存 器 基地 址 ， 这 里 使 用 的 串口 1， 基 地 址 为 UARTI BASE, UARTI BASE 定义 在 文件 
arch/arm/include/asm/arch-mx6/imx-regs.h 中 ，imx-regs.h 是 LMX6ULL 寄存 器 描述 文件 ， 根 据 
imx-regs.h 可 得 到 UART1 BASE 的 值 如 下 : 

UARTI BASE= (ATZ1 BASE ADDR + 0x20000) 

=AIPS1 ARB BASE ADDR + 0x20000 
=0x02000000 + 0x20000 
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=0X02020000 
查阅 LMX6ULL 参考 手册 , UARTI 的 寄存 器 基地 址 正 是 0X02020000, 如 图 33.2.2.1 所 示 : 
202 0000 |UART Receiver Register (UART1 URXD) 32 R 0000 0000h poe 
202 0040 |UART Transmitter Register (UART1 UTXD) 0000 0000h 
202 0080 |UART Control Register 1 (UART1. UCR1) 32 RW | 0000. 0000h jg rw 
202 0084 |UART Control Register 2 (UART1. UCR2) 32 | RW | oooo 0001n | 55154 

















3620 





图 33.22.1 UARTI 寄存 器 地 址 表 

第 63.64 行 ，EMMC 接 在 LIMX6ULL 的 USDHC2 上 , 宏 CONFIG SYS FSL ESDHC ADDR 
为 EMMC 所 使 用 接口 的 寄存 器 基地 址 ， 也 就 是 USDHC2 的 基地 址 。 

第 67~72 行 ， 跟 NAND 相关 的 宏 ， 因 为 NAND 和 USDHC2 的 引 脚 冲突 ， 因 此 如 果 使 用 
NAND 的 只 能 使 用 一 个 USDHSC 设备 (SD 卡 )。 如 果 没 有 使 用 NAND， 那么 就 有 两 个 USDHC X 
备 (EMMC 和 SD 卡 ), 宏 CONFIG SYS FSL USDHC NUM 表示 USDHC 数量 。EMMC 版 本 的 
核心 版 没有 用 到 NAND， 所 以 CONFIG SYS FSL USDHC NUM=2. 

第 75~81， 和 I2C 有 关 的 宏 定义 ， 用 于 控制 使 能 哪个 12C，I2C 的 速度 为 多 少 。 

第 92-96 ÍT, NAND 的 分 区 设置 ， 如 果 使 用 NAND 的 话 ， 默 认 的 NAND 分 区 为 : 
"mtdparts=gpmi-nand:64m(boot),16m(kernel),16m(dtb),1m(misc),-(rootfs)", 分 区 结果 如 表 33.2.2.1 
所 示 : 































































































0~63M 64M boot(uboot) 
64~79M 16M kernel(linux 内 核 ) 
80~94M 16M dtb( 设 备 树 ) 
95M 1M misc( 杂 项 ) 
96M — end 剩余 的 所 有 空间 rootfs( 根 文件 系统 ) 
表 33.2.2.1 NAND 分 区 设置 
NAND 的 分 区 是 可 以 调整 的 , 比如 boot 分 区 我 们 用 不 了 64M 这 么 大 , 因此 可 以 将 其 改 小 ， 


其 他 的 分 区 一 样 的 。 

第 98-111 fT, X CONFIG MFG ENV SETTINGS 定义 了 一 些 环境 变量 ， 使 用 MfgTool 烧 
写 系统 时 候 会 用 到 这 里 面 的 环境 变量 。 

第 113-202 行 ， 通 过 条 件 编译 来 设置 宏 CONFIG EXTRA ENV SETTINGS, ^X 
CONFIG EXTRA ENV SETTINGS 也 是 设置 一 些 环境 变量 ， 此 宏 会 设置 bootargs 这 个 环境 变 
量 ， 后 面 我 们 会 详细 分 析 这 个 宏 定义 。 

第 204-217 行 ， 设 置 宏 CONFIG BOOTCOMMAND， 此 宏 就 是 设置 环境 变量 bootcmd 的 
值 。 后 面 会 详细 的 分 析 这 个 宏 定 义 。 

第 220-222 ÍT, 设置 命令 memtest 相关 宏 定义 ， 比 如 使 能 命令 memtest, 设置 memtest 测试 
的 内 存 起 始 地 址 和 内 存 大 小 。 

第 224 行 ， 宏 CONFIG_SYS_LOAD_ADDR 表示 linux kernel 在 DRAM 中 的 加 载 地 址 ， 也 
就 是 linux kernel 在 DRAM 中 的 存储 首 地 址 ，CONFIG LOADADDR-0X80800000 . 

第 225 ÍT, Z CONFIG_SYS_HZ 为 系统 时 钟 频率 ， 这 里 为 1000Hz。 

第 227 行 ， 宏 CONFIG_STACKSIZE 为 栈 大 小 ， 这 里 为 128KB。 

第 120 fT. 7E CONFIG NR DRAM BANKS 为 DRAM BANK 的 数量 ，LMX6ULL 只 有 一 
个 DRAM BANK， 我 们 也 只 用 到 了 一 个 BANK， 所 以 为 1。 
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第 231 fT, 7E PHYS SDRAM 为 IMX6ULL 的 DRAM 控制 器 MMDCO 所 管辖 的 DRAM 范 
大 其 实地 址 ， 也 就 是 0X80000000。 

第 233 fT, "E CONFIG SYS SDRAM BASE 为 DRAM 的 其 实地 址 。 

第 234 fT, "E CONFIG SYS INIT RAM ADDR 为 IMX6ULL 内 部 IRAM 的 起 始 地 址 (也 


























就 是 OCRAM 的 起 始 地 址 )， 为 0X00900000。 

第 235 fT, "E CONFIG SYS INIT RAM SIZE 为 LMX6ULL 内 部 IRAM 的 大 小 (OCRAM 
的 大 小 )， 为 0X00040000=128KB。 

第 237~240 ÍT, Æ CONFIG SYS INIT SP OFFSET 和 CONFIG SYS INIT SP ADDR 与 
初始 SP 有 关 ， 第 一 个 为 初始 SP 偏 移 ， 第 二 个 为 初始 SP 地 址 。 

第 256 行 , 宏 CONFIG SYS MMC ENV DEV 为 默认 的 MMSC 设备 ,这 里 默认 为 USDHC2， 
也 就 是 EMMC. 

第 257 行 ， 宏 CONFIG SYS MMC ENV PART 为 模式 分 区 ， 默 认为 第 0 个 分 区 。 

第 258 íT, "E CONFIG MMCROOT 设置 进入 linux 系统 的 根 文件 系统 所 在 的 分 区 , 这 里 设 
置 为 dewmmcblklp2"， 也 就 是 EMMC 设备 的 第 2 个 分 区 。 第 0 个 分 区 保存 uboot， 第 1 个 分 
区 保存 linux 镜像 和 设备 树 ， 第 2 个 分 区 为 Linux 系统 的 根 文件 系统 。 

第 277~291 行 ， 与 NAND 有 关 的 宏 定义 ， 如 果 使 用 NAND 的 话 。 

第 293 行 ， 宏 CONFIG ENV SIZE 为 环境 变量 大 小 ， 默 认为 8KB。 

第 294-308 ÍT; Z CONFIG ENV OFFSET 为 环境 变量 偏 移 地 址 ， 这 里 的 偏 移 地 址 是 相对 
于 存储 器 的 首 地 址 。 如 果 环 境 变 量 保 存在 EMMC 中 的 话 ， 环 境 变 量 偏 移 地 址 为 12*64KB 。 如 
果 环 境 变 量 保存 在 SPI FLASH 中 的 话 ， 偏 移 地 址 为 768*1024。 如 果 环 境 变 量 保存 在 NAND 中 
的 话 ， 偏 移 地 址 为 60<<20(60MB)， 并 且 重 新 设置 环境 变量 的 大 小 为 128KB。 

第 312~323 行 ， 与 USB 相关 的 宏 定 义 。 

第 325-342 行 ， 与 网 络 相关 的 宏 定 义 ， 比 如 使 能 dhep, ping 等 命令 。 第 331 行 的 宏 
CONFIG FEC ENET DEV 指定 uboot 所 使 用 的 网 口 ，I.MX6ULL 有 两 个 网 口 ， 为 0 的 时 候 使 
用 ENET1， 为 1 的 时 候 使 用 ENET2。 宏 IMX FEC BASE 为 ENET 接口 的 寄存 器 首 地 址 ， 宏 
CONFIG FEC MXC PHYADDR 为 网 口 PHY 芯片 的 地 址 。 宏 CONFIG FEC XCV TYPE 为 
PHY 芯片 所 使 用 的 借口 类 型 ，LMX6U-ALPHA 开发 板 的 两 个 PHY 都 使 用 的 RMII 接口 。 

第 344~END， 剩 下 的 都 是 一 些 配置 宏 ， 比 如 CONFIG VIDEO 宏 用 于 开启 LCD, 
CONFIG VIDEO LOGO 使 能 LOGO 显示 ，CONFIG CMD BMP 使 能 BMP 图 片 显示 指令 。 这 
样 就 可 以 在 uboot 中 显示 图 片 了 ， 一 般 用 于 显示 logo。 

关于 mx6ull_alientek_emmc.h 就 讲解 到 这 里 ， 其 中 以 CONFIG. CMD 开头 的 宏 都 是 用 于 使 
能 相应 命令 的 ， 其 他 的 以 CONFIG 开头 的 宏 都 是 完成 一 些 配置 功能 的 。 以 后 会 频繁 的 和 
mx6ull alientek emmc.h 这 个 文件 打交道 。 
















































































































































































































































































33.2.3 添加 开发 板 对 应 的 板 级 文件 夹 


uboot 中 每 个 板子 都 有 一 个 对 应 的 文件 夹 来 存放 板 级 文件 ， 比 如 开发 板 上 外 设 驱 动 文 件 等 
等 。NXP 的 LMX 系列 芯片 的 所 有 板 级 文件 夹 都 存放 在 board/freescale 目录 下 ， 在 这 个 目录 下 
有 个 名 为 mx6ullevk 的 文件 来， 这 个 文件 夹 就 是 NXP H7; LMX6ULL EVK 开发 板 的 板 级 文件 
来。 复制 mx6ullevk， 将 其 重 命名 为 mx6ull alientek_emmc， 命 令 如 下 : 

cd board/freescale/ 









































cp mx6ullevk/ -r mx6ull alientek emmc 
进入 mx6ull alientek emme 目录 中 ， 将 其 中 的 mx6ullevk.c 文件 重 命 名 为 


mx6ull alientek_emmc.c， 命 令 如 下 : 
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cd mx6ull alientek emmc 


mv mx6ullevk.c mx6ull alientek emmc.c 
我 们 还 需要 对 mx6ull alientek emmc 目录 下 的 文件 做 一 些 修 改 : 
1、 修 改 mx6ull alientek emme 目录 下 的 Makefile 文件 


将 mx6ull alientek emmc 下 的 Makefile 文件 内 容 改 为 如 下 所 示 : 
示例 代码 33.2.3.1 Makefile 文件 
4t (C) Copyright 2015 Freescale Semiconductor, Inc. 


t SPDX-License-Identifier: GPL-2 .0+ 
# 








extra-$(CONFIG USE PLUGIN) := plugin.bin 





il 
2 
S 
4 
5 
GNE or C MN nul alientek emme. © 
3 
8 
9 $(obj)/plugin.bin: $(obj)/plugin.o 
10 (OB —O losweucy —-geg-iild (xc: Ss 9 
重点 是 第 6 行 的 obj-y, 改 为 mx6ull alientek emmec.o, 这样 才 会 编译 mx6ull alientek emmc.c 
这 个 文件 。 
2、 修 改 mx6ull alientek emmc 目录 下 的 imximage.cfg 文件 
将 imximage.cfg 中 的 下 面 一 句 : 
PLUGIN board/freescale/mx6ullevk/plugin.bin 0x00907000 
改 为 : 
PLUGIN board/freescale/mx6ull alientek emmc /plugin.bin 0x00907000 
3、 修 改 mx6ull alientek emmc 目录 下 的 Kconfig 文件 
修改 Kconfig 文件 ， 修 改 后 的 内 容 如 下 : 
示例 代码 33.2.3.2 Kconfig 文件 
if TARGET MX6ULL ALIENTEK EMMC 



































config SYS BOARD 





default "mx6ull alientek emmc" 





config SYS VENDOR 


default "freescale" 


O eo 


Ko) 


config SYS SOC 
default "mx6" 


e re rB 
N Be o 


config SYS CONFIG NAME 





ES 
Ww 


default "mx6ull alientek emmc" 


E a 
a e 


endif 


853 


LMX6U RAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


4、 修 改 mx6ull alientek emmc 目录 下 的 MAINTAINERS 文件 
修改 MAINTAINERS 文件 ， 修 改 后 的 内 容 如 下 : 























1 MX6ULL ALIENTEK EMMC BOARD 

2 M: Peng Fan Xpeng.fan(ünxp.com» 

ENS Maintained 

4 F: board/freescale/mx6ull alientek emmc/ 
5 include/configs/mx6ull alientek emmc.h 


33.2.4 修改 U-Boot 图 形 界 面 配 置 文件 


uboot 是 支持 图 形 界 面 配 置 ， 关 于 uboot 的 图 形 界 面 配置 下 一 章 会 详细 的 讲解 。 修 改 文件 
arch/arm/cpu/armv7/mx6/Kconfig( ll RHAI LMX6UL 的 话 ， 应 该 修改 arch/arm/Kconfig 这 个 文 
件 )， 在 207 行 加 入 如 下 内 容 : 








示例 代码 33.2.4.1 Kconfig 文件 
config TARGET MX6ULL ALIENTEK EMMC 




















il 
2 bool "Support mx6ull alientek emmc" 
3 select MX6ULL 
4 select DM 
5 select DM THERMAL 
在 最 后 一 行 的 endif 的 前 一 行 添加 如 下 内 容 : 
示例 代码 33.2.4.2 Kconfig 文件 
1 source "board/freescale/mx6ull alientek emmc/Kconfig" 


添加 完成 以 后 的 Kconfig 文件 如 图 33.2.4.1 所 示 : 


261 config TARGET_MX6ULL_9X9_EVK 











202 bool "Support mx6ull 9x9 evk" 
203 select MX6ULL 

204 select DM 

205 select DM THERMAL 


config TARGET MX6ULL ALIENTEK EMMC 
bool "Support mx6ull alientek emmc" 
select MX6ULL 


select DM 
select DM THERMAL 





284 source "board/warp/Kconfig" 
285 source "board/freescale/mx6dqscm/Kconfig" 
286 source "board/freescale/mx6sxscm/Kconfig" 


287 

288 source "board/freescale/mx6ul alientek emmc/Kconfig" 
289 

290  endif 

291 





图 33.2.4.1 修改 后 的 Kconfig 文件 
到 此 为 止 ，LMX6U-ALPHA 开发 板 就 已 经 添加 到 uboot 中 了 ， 接 下 来 就 是 编译 这 个 新 添加 
的 开发 板 。 
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33.2.5 使 用 新 添加 的 板子 配置 编译 uboot 











在 uboot 根 目录 下 新 建 一 个 名 为 mx6ull alientek emmc.sh 的 shell 脚本 ， 在 这 个 shell 脚本 
里 面 输入 如 下 内 容 : 

















示例 代码 33.2.5.1 mx6ull alientek_emmc.sh 脚本 文件 
1 $!/bin/bash 
2 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- distclean 











3 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- 








mx6ull alientek  emmc defconfig 





4 make V=1 ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- -j16 

第 3 行 我 们 使 用 的 默认 配置 文件 就 是 33.2.1 节 中 新 建 的 mx6ull_ alientek_emmc_defconfig 这 
个 配置 文件 。 给 予 mx6ll alientek emmce.sh 可 执行 权限 , 然后 运行 脚本 来 完成 编译 , 命令 如 下 : 

chmod 777 mx6ull alientek emmc.sh /给 予 可 执行 权限 ， 一 次 即 可 

/mx6ull alientek emmc.sh /运行 脚本 编译 uboot 

等 待 编译 完成 ， 编 译 完成 以 后 输入 如 下 命令 ， 查 看 一 下 33.2.2 小 节 中 添加 的 
mx6ull_alientek_emmc.h 这 个 头 文件 有 没有 被 引用 。 

grep -nR "mx6ull alientek emmc.h" 

如 果 有 很 多 文件 都 引用 了 mx6ull alientek emmc.h 这 个 头 文件 , 那 就 说 明 新 板子 添加 成 功 ， 
如 图 33.2.5.1 所 示 : 
































$ grep -nR "mx6ull alientek emmc.h" 
include/configs/ 
include/configs/ 
include/configs/ 
include/configs/ 
include/configs/ 
include/configs/ 


include/configs/ 
include/configs/ 
include/configs/ 
include/configs/ 





图 33.2.5.1 查找 结果 
编译 完成 以 后 就 使 用 imxdownload 将 新 编译 出 来 的 u-boot.bin 烧 写 到 SD 卡 中 测试 ， 
SecureCRT 输出 结果 如 图 33.2.5.2 所 示 : 


** serial-com12 x 














U-Boot 2016.03 (May 12 2019 - 22:17:47 +0800) 


CPU: Freescale i.MX6ULL revl.1 528 MHz (running at 396 MHz) 
CPU: Industrial temperature grade (-40C to 105C) at 48C 
Reset cause: POR 

Board: MX6ULL 14x14 EVK 

$2€5 ready. 


MMC: FSL_SDHC: 0, FSL_SDHC: 1 
unsupported panel TFT7016 


In: serial 
Out: serial 
Err: serial 


switch to partitions £0, OK 

mmcO is current device 

Net: Board Net Initialization Failed 
No ethernet found. 

Normal Boot 

Hit any key to stop autoboot: 0 

=> 





图 33.2.5.1 uboot 启动 过 程 

从 图 33.2.5.1 可 以 看 出 ， 此 时 的 Board 还 是 “MX6ULL 14x14 EVK”, 因为 我 们 参考 的 NXP 
官方 的 LIMX6ULL 开发 板 来 添加 自己 的 开发 板 。 如 果 接 了 LCD 屏幕 的 话 会 发 现 LCD 屏幕 并 没 
有 显示 NXP 的 logo， 而 且 从 图 33.2.5.1 可 以 看 出 此 时 的 网 络 同 样 也 没 识别 出 来 。 前 面 已 经 说 
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了 ,默认 uboot 中 的 LCD 驱动 和 网 络 驱动 在 正点 原子 的 LMX6U-ALPHA 开发 板 上 是 有 问题 的 ， 


需要 修改 。 








33.2.6 LCD 驱动 修改 


一 般 uboot 中 修改 驱动 基本 都 是 在 xxx.h 和 xxx.c 这 两 个 文件 中 进行 的 ，xxx 为 板子 名 称 ， 
比如 mx6ull alientek emmc.h 和 mx6ull alientek emmc.c 这 两 个 文件 。 

一 般 修改 LCD 驱动 重点 注意 一 下 几 点 : 

(QD. LCD 所 使 用 的 GPIO, 1 uboot 中 LCD 的 IO 配置 是 否 正确 。 

©, LCD 背光 引 脚 GPIO 的 配置 。 

(3. LCD 配置 参数 是 否 正 确 。 

正点 原子 的 LIMX6U-ALPHA 开发 板 LCD 原理 图 和 NXP H7; LMX6ULL 开发 板 一 致 ， 也 
就 是 LCD 的 IO 和 背光 IO 都 一 样 的 , 所 以 IO 部 分 就 不 用 修改 了 。 需要 修改 的 之 后 LCD 参数 ， 
打开 文件 mx6ull alientek emmc.c， 找 到 如 下 所 示 内 容 : 

示例 代码 33.2.6.1 LCD 驱动 参数 




























































































i exeun: oolav inito © cCongt Cisplaysii = Wu 
2 .bus = MX6UL_LCDIF1 BASE ADDR, 

S .addr = O0, 

4 .pixfmt = 24, 

5 .detect = NULL, 

6 enable = do enable parallel Lecl, 

F .mode = { 

8 . name = "TFT43AB", 

9 .Xres = 480, 

10 .yres = 2712, 

ial .pixclock = 108695, 

3022 ode merem = 8, 

ls .right margin = 4, 

14 .upper margin = 27 

15 .lower margin = 4, 

16 Sissi = 41, 

sy oveyne len = 10, 

18 .Sync = 0, 

19 .vmode — FB VMODE NONINTERLACED 
20 p ) E 





示例 代码 33.2.6.1 中 定义 了 一 个 变量 displays, 257873 display info t， 这 个 结构 体 是 LCD 
信息 结构 体 ， 其 中 包括 了 LCD 的 分 辨 率 ， 像 素 格式 ，LCD 的 各 个 参数 等 。display_info t 定义 
在 文件 arch/arm/include/asm/imx-common/video.h 中 ， 定 义 如 下 : 

示例 代码 33.2.6.2 display_info 结构 体 

1 gtruct cnsolay into EE d 
2 Lime DSF 
3 imne acele, 
4 Lae OLENES 
5 


imt (elec ue cisplay inio t Const wdev)) p 
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6 void (emarle (struct ebispple inio 1 const wder) s 

1 struct fb videomode mode; 

gs 

















pixfmt 是 像素 格式 ， 也 就 是 一 个 像素 点 是 多 少 位 ， 如 果 是 RGB565 的 话 就 是 16 位 ， 如 果 
是 888 的 话 就 是 24 位 ， 一 般 使 用 RGB888。 结 构 体 display info t 还 有 个 mode 成 员 变 量 ， 此 
成 员 变量 也 是 个 结构 体 ， 为 fb_videomode， 定 义 在 文件 include/linux/fb.h 中 ， 定 义 如 下 : 
示例 代码 33.2.6.3 fb. videomode 结构 体 





















































1 errüct io vicdeomode d 

2 const char *name; /Go Leona “3/ 
3 u32 refresh; IE (suaque */ 
4 u32 xres; 

5 u32 yres; 

6 532 pizeclocky 

Jj u32 lert marga, 

8 u2 rignt margini 

9 n32 upper mergim; 

10 u32 lower margin; 

TA u32 nseyne len; 

32 132 veyne len; 

TS 51512. Syne? 

14 u32 vmode; 

1115) p MEN e 

16 }; 








结构 体 fb_videomode 里 面 的 成 员 变 量 为 LCD 的 参数 ， 这 些 成 员 变 量 函 数 如 下 : 
name: LCD 名 字 ， 要 和 环境 变量 中 的 panel 相等 。 
xres, yres: LCD X fll Y 轴 像 素数 量 。 
pixclock: 像素 时 钟 ， 每 个 像素 时 钟 周期 的 长 度 ， 单 位 为 皮 秒 。 
left margin: HBP， 水 平 同步 后 肩 。 
right margin: HFP， 水 平 同步 前 肩 。 
upper margin: VBP， 垂 直 同步 后 肩 。 
lower margin: VFP, ÆA FÆ} HiS o 
hsync len: HSPW， 行 同步 脉 宽 。 
vsync len: VSPW， 垂 直 同 步 脉 宽 。 
vmode: 大 多 数 使 用 FB VMODE NONINTERLACED， 也 就 是 不 使 用 隔行 扫描 。 
可 以 看 出 ， 这 些 参 数 和 我 们 第 二 十 四 章 讲解 RGB LCD 的 时 候 参数 基本 一 样 ， 唯 一 不 同 的 
像素 时 钟 pixclock 的 含义 不 同 ， 以 正点 原子 的 7 寸 1024*600 分 辨 率 的 屏幕 (ATIK7016) 为 例 ， 
屏幕 要 求 的 像素 时 钟 为 51.2MHz， 因 此 : 
pixclock-(1/51200000)*10^12-19531 
在 根据 其 他 的 屏幕 参数 ， 可 以 得 出 ATK7016 屏幕 的 配置 参数 如 下 : 
示例 代码 33.2.6.4 ATK7016 屏幕 配置 参数 
l gkruce es yt © Const Cispleavshii) = 
2 .bus = MX6UL LCDIF1 BASE ADDR, 
S .addr = O0, 
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4 .pixfmt = 24, 

5 .detect = NULL, 

6 enable = do enable parallel leg; 

E .mode = { 

8 . name = OTEEIOTEM, 

9 .Xres = 1024, 

10 .yres = 600, 

11 Eee = 19531, 

112 .left margin = 140, / /HBPD 
13 .right margin = J60, / /HFPD 
14 .upper margin = 20, / /NBPD 
ls .lower margin = 12, / /NFBD 
16 Syne lem - 20, / /HSPW 
Jg .vsync len = 3, / /NSPW 
18 .Sync -0, 

19 .vmode — FB VMODE NONINTERLACED 




















eU b Jj gp 

使 用 示例 代码 33.2.6.4 中 的 屏幕 参数 蔡 换 掉 mx6ull alientek emmc.c 中 uboot 默认 的 屏幕 
参数 。 

打开 mx6ull alientek_emmc.h， 找 到 所 有 如 下 语句 : 

panel=TFT43AB 

将 其 改 为 : 

panel=TFT7016 

也 就 是 设置 panel 为 TFT7016，panel 的 值 要 与 示例 代码 33.2.6.4 中 的 .name 成 员 变 量 的 值 
一 致 。 修 改 完成 以 后 重新 编译 一 裔 uboot 并 烧 写 到 SD 中 启动 。 

重启 以 后 LCD 驱动 一 般 就 会 工作 正常 了 ,LCD 上 回 显 示 NXP 的 logo. 但 是 有 可 能 会 过 到 
LCD 并 没有 工作 ， 还 是 黑屏 ， 这 是 什么 原因 呢 ? 在 uboot 命令 模式 输入 “printf” 来 查看 环境 变 
量 panel 的 值 ， 会 发 现 panel 的 值 要 是 TFT43AB( 或 其 他 的 ， 反 正 不 是 TFT7016)， 如 图 33.2.6.1 
所 示 : 

pane1=TFT43AB 


script-boot.scr 
serverip-192.168.1.250 










































































Environment size: 2639/8188 bytes 
二 





图 33.2.6.1 panel 的 值 

这 是 因为 之 前 有 将 环境 变量 保存 到 EMMC 中 ，uboot 启动 以 后 会 先 从 EMMC 中 读 取 环境 
变量 ， 如 果 EMMC 中 没有 环境 变量 的 话 才 会 使 用 mx6ull alientek emmc.h 中 的 默认 环境 变量 。 
如 果 EMMC 中 的 环境 变量 panel 不 等 于 TFT7016， 那 么 LCD 显示 肯定 不 正常 ， 我 们 只 需要 在 
uboot 中 修改 panel 的 值 为 TFT7016 即 可 ， 在 uboot 的 命令 模式 下 输入 如 下 命令 : 

setenv panel TFT7016 


saveenv 
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上 述 命令 修改 环境 变量 panel 为 TFT7016， 然 后 保存 ， 重 启 uboot， 此 时 LCD 驱动 就 工作 








正常 了 。 如 果 LCD 还 是 没有 正常 了 


有 修改 。 
33.2.7 网 络 驱动 修改 


论坛 :www.opendev.com 

















1. LMX6U-ALPHA 开发 板 网 络 简介 
LMX6UL/ULL 内 部 有 个 以 太 网 MAC 外 设 ， 也 就 是 ENET， 需 要 外 接 一 个 PHY 芯片 来 实 


现 网 络 通信 功能 ， 也 就 是 内 部 MAC+ 外 部 PHY 芯片 的 方案 。 











[ 作 的 ， 那 就 要 检查 自己 哪里 有 没有 改 错 ， 或 者 还 有 哪里 没 


大 家 可 能 听 过 DM9000 这 个 网 络 





芯片 ， 在 一 些 没 有 内 部 MAC 的 CPU 中 ， 比 如 三 星 的 2440，4412 等 ， 就 会 采用 DM9000 来 实 
现 联 网 功能 。DM9000 提供 了 一 个 类 似 SRAM 的 访问 接口 ， 主 控 CPU 
DM9000 进行 通信 ，DM9000 就 是 一 个 MAC+PHY 芯片 。 这 个 方案 就 相当 于 外 部 MAC+ 外 部 
PHY, 那么 LMX6U 这 样 的 内 部 MAC+PHY 芯片 与 DM9000 方案 比 有 什么 优势 吗 ? 那 优 势 打 的 
去 了 ! 首先 就 是 通信 效率 和 速度 ， 一 般 CPU 内 部 的 MAC 是 带 有 一 个 专用 DMA 的 ， 专 门 用 于 
处 理 网 络 数据 包 ， 采 用 SRAM 来 读 写 DM9000 的 速度 是 压根 就 没 法 和 内 部 MAC+ 外 部 PHY o 
片 的 速度 比 。 采 用 外 部 DM9000 完全 是 无 奈 之 举 ， 谁 让 2440, 4412 这 些 蕊 片 内 部 没有 以 太 网 
外 设 呢 ， 现 在 又 想 用 有 线 网 络 ， 没 有 办 法 只 能 找 个 DM9000 的 方案 。 从 这 里 也 可 以 看 出 ， 三 星 
的 2440. 4412 这 些 忆 片 设 计 之 初 就 不 是 给 工业 产品 用 的 ,他 们 是 给 消费 类 电子 使 用 的 ， 比 如 手 
机 、 平 板 等 ， 手 机 或 平板 要 上 网 网 ， 可 以 通过 WIFI 或 者 4G， 我 是 没有 见 过 哪个 手机 或 者 平板 
上 网 是 要 接 根 网 线 的 。 正 点 原子 的 LIMX6U-ALPHA 开发 板 也 可 以 通过 WIFI 或 者 4G 上 网 ， 这 









































个 是 后 话 了 。 


LMX6UL/ULL 有 两 个 网 络 接口 
供 了 这 两 个 网 络 接口 ， 其 中 ENET. 和 ENET2 都 使 月 
I.MX6ULL EVK 开发 板 使 用 KSZ8081 这 颗 PHY 芯片 ，LAN8720A 相 比 KSZ8081 具有 体积 小 、 









































通过 这 个 接口 即 可 与 

































































ENET1 和 ENET2， 正 点 原子 的 LIMX6U-ALPHA 开发 板 提 
H LAN8720A 作为 PHY 芯片 。NXP 官方 的 























外 围 器 件 少 、 价 格 便宜 等 优点 。 直 接 使 用 KSZ8081 固然 可 以 , 但 是 我 们 在 实际 的 产品 中 不 一 定 
氏 成 本 会 选择 其 他 的 PHY 芯片 ， 这 个 时 候 就 有 个 问题 : 换 了 
PHY 芯片 以 后 网 络 驱动 怎么 办 ? 为 此 , 正点 原子 的 LMX6U-ALPHA 开发 板 将 ENETI 和 ENET2 
的 PHY 换 为 了 LAN8720A， 这 样 就 可 以 给 大 家 讲解 更 换 PHY 六 片 以 后 如 何 调整 网 络 驱动 ， 使 








会 使 用 KSZ8081， 有 时候 为 了 降 











网 络 工作 正常 。 








LMX6U-ALPHA FRIR ENETI1 的 网 络 原理 图 如 
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21 ENETI 


















23 ENETI 
ENETI 22 ENETI 
TXDI 7 
ENETI TXEN LEDI/REGOFF NETL TED) 
SENT PEDIS — —ENETL LED? 
RXD0/MODEO 
aiok ENETLRXDL 77 OMM 19 VENET 35 
OK ENETI RXER 10 , 1 VENET 3V3 
GND 川 上 DNSB ENET CRS vir] RXER/PHYADO VDD2A | VENET AS 
CSR_DV/MODENWDDIO 
R63 1K ENETI INT TREEA4 - VDDCR =$ tok 
VENET 3V3 全 一 -ENETLRST is] nINT/REFCLKO GND 49 (C50 | C51|C52753 
C EERI l 
R65 IK R66 XTALI/CLKIN — 104 [100g104/04 104 
[-—] IAS LT 一 一 
ENETI TX CLK = 
== ZIK  LAN8720A cud 
GND 
PHY ADDR:0xO DCDC 3V3 He- |VENET 3V3 
220R2.0A,0.05DCR 
1o. lOuF 
GND 
ENETI VENET 3V3 
9 


SNVS TAMPER7 ENETI RST 
SNVS TAMPERS ENETI INT TREE? 11 


J2 45 GPIO 7 R74 
J2 44 GPIO 6 R75 FF] 


ENET MDC 
ENET MDIO 





5 
55 E56 ENETI RXN 6 


ENETI TXP 1 
4 








ENETI TXN 2 


ENETI RXP 3 


2 








04 [104 — NC 
== HR911105A 二 
GND GND 
图 33.2.7.1 ENETI 原理 图 


ENETI 的 网 络 PHY 芯片 为 LAN872 





0A， 通 过 RMI 接口 与 LMX6ULL 相连 ， 正 点 原子 








LMX6U-ALPHA 开发 板 的 ENET1 引 脚 与 NXP 官方 的 LIMX6ULL EVK 开发 板 基 本 一 样 ， 唯 独 





复位 引 脚 不 同 。 从 图 33.2.7.1 可 以 看 出 ，] 








FE 点 原子 LMX6U-ALPHA 开发 板 的 ENET1 复位 引 脚 


ENET1_RST 接 到 了 LM6ULL 的 SNVS_TAMPER7 这 个 引 脚 上 。 


LAN8720A 内 部 是 有 寄存 器 的 ，I.MX 


6ULL 会 读 取 LAN8720 内 部 寄存 器 来 判断 当前 的 物 


理 链接 状态 、 连 接 速 度 (10M 还 是 100M) 和 双 工 状态 ( 半 双 工 还 是 全 双 工 )。LMX6ULL 通过 MDIO 


接口 来 读 取 PHY 芯片 的 内 部 寄存 器 ，MDIO 接口 
行 














ENET MDC 提供 时 钟 ，ENET_MDIO j 





有 两 个 引 脚 ，ENET_MDC 和 ENET MDIO, 
数据 传输 。 一 个 MDO 接口 可 以 管理 32 个 PHY i 

















片 ， 同 一 个 MDIO 接口 下 的 这 些 PHY 使 用 不 同 的 器 件 地 址 来 做 区 分 ，MIDO 接口 通过 不 同 的 














器 件 地 址 即 可 访问 到 相应 的 PHY 芯片 。L 
器 件 地 址 为 0X0， 所 示 我 们 要 修改 ENETI 





GD、ENET1 复位 引 脚 初始 化 。 
@、LAN8720A 的 器 件 ID。 
QS. LANS8720 驱动 
再 来 看 一 下 ENET2 的 原理 


H 








图 ， 如 图 





3 





MX6U-ALPHA 开发 板 ENET1 上 连接 的 LAN8720A 
网 络 驱 动 的 话 重点 就 三 点 : 











3.2.7.2 所 示 : 
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ENET MDIO 
ENET MDC 








ENET2 TXD0 
ENET2 TXDI 
ENET2 TXEN 






3. ENET2 LEDI 


TXEN  LEDI/REGOFF [ENET LED2 


LED2/nINTSEL 
RXD0/MODEO 
RXDI/MODEI VDDIA 
RXER/PHYADO VDD2A 


CSR. DV/MODEXDDIO 2 VENET 3V3 
VDDCR 25 
E e Eres 59 [60 [c61 
nRST : 
4 
ENET2 TX CLK 


ENET2 RXDO 
ENET2 RXDI 19 VENET 3V3 


1 VENET 3V3 








RBIAS XTAL2 04 Jl0uFl104 1104 1104 





GND GND 
PHY ADDR:0X1 ENET2 VENET 3V3 
9 


39 SNVS TAMPER6 ENET2 INT TREE: 
ENET2 RXDO 
ENET2 RXDI 
ENET2 TXDO 
ENET2 TXDI 


ENET2 RXER zA d SEER 
ENET2 CRS DV 
ENET2 TXEN 


31 ENET2 TX CLK 
SNVS TAMPER8 ENET2 RST 








图 33.2.7.2 ENET2 原理 图 
关于 ENET2 网 络 驱动 的 修改 也 注意 一 下 三 点 : 
GD、ENET2 的 复位 引 脚 ， 从 图 33.2.7.2 可 以 看 出 ，ENET2 的 复位 引 脚 ENET2_RST 接 到 了 
LMXGULL 的 SNVS TAMPERS 上 。 
©, ENET2 所 使 用 的 PHY 芯片 器 件 地 址 ,从 图 33.2.7.2 可 以 看 出 , PHY 器 件 地 址 为 0X1。 
(S). LAN8720 驱动 ，ENET1 和 ENET2 都 使 用 的 LAN8720， 所 以 驱动 肯定 是 一 样 的 。 


2、 网 络 PHY 地 址 修改 


首先 修改 uboot 中 的 ENETI 和 ENET2 的 PHY 地 址 和 了 驱动， 打开 mx6ull alientek emmc.h 
这 个 文件 ， 找 到 如 下 代码 : 














示例 代码 33.2.7.1 网 络 默认 ID 配置 参数 
325 #ifdef CONFIG CMD NET 
326 #define CONFIG CMD PING 
327 $define CONFIG CMD DHCP 
328 #define CONFIG CMD MII 
329 #define CONFIG FEC MXC 
330 £$define CONFIG MII 








































































































331 £define CONFIG FEC ENET DEV 1 

S9 

333 4if (CONFIG FEC ENET DEV == 0) 

334 #define IMX FEC BASE ENET BASE ADDR 
335 #define CONFIG FEC MXC PHYADDR 0x2 

336 £4define CONFIG FEC XCV TYPE RMII 

337 #elif (CONFIG FEC ENET DEV == 1) 

338 £define IMX FEC BASE ENET2 BASE ADDR 
339 #define CONFIG FEC MXC PHYADDR 0x1 
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340 #define CONEIG BEC XCV TYPh RMII 

341 £endif 
342 #define CONFIG ETHPRIME SERES 
343 
344 #define CONFIG PHYLIB 

345 #define CONFIG PHY MICREL 
346 #endif 

第 331 行 的 宏 CONFIG FEC ENET DEV 用 于 选择 使 用 哪个 网 口 ， 默 认为 1， 也 就 是 选择 
ENET2。 第 335 行为 ENETI1 的 PHY 地 址 ， 默 认 是 0X2， 第 339 行为 ENET2 的 PHY 地 址 ， 默 
认为 0x1。 根 据 前 面 的 分 析 可 知 ， 正 点 原子 的 LMX6U-ALPHA 开发 板 ENETI 的 PHY 地 址 为 
0X0, ENET2 的 PHY 地 址 为 0X1， 所 以 需要 将 第 335 行 的 宏 CONFIG. FEC MXC PHYADDR 
改 为 0x0。 

第 345 行 定 了 一 个 宏 CONFIG PHY MICREL， 此 宏 用 于 使 能 uboot 中 Micrel 公司 的 PHY 
驱动 , KSZ8081 XAN PHY 蕊 片 就 是 Micrel 公司 生产 的 , 不 过 Micrel 已 经 被 Microchip 收购 了 。 
如 果 要 使 用 LAN8720A， 那 么 就 得 将 CONFIG PHY MICREL 改 为 CONFIG PHY SMSC, 也 
就 是 使 能 uboot 中 的 SMSC 公司 中 的 PHY 驱动 ， 因 为 LAN8720A 就 是 SMSC 公司 生产 的 。 所 
以 示例 代码 33.2.7.1 有 三 处 要 修改 : 

D, MENETI 网 络 PHY 的 地 址 。 

@、 修 改 ENET2 网 络 PHY 的 地 址 。 

©, IERE SMSC 公司 的 PHY 驱动 。 

修改 后 的 网 络 PHY 地 址 参数 如 下 所 示 : 

示例 代码 33.2.7.2 网 络 PHY 地 址 配置 参数 
325 #ifdef CONFIG CMD NET 
326 #define CONFIG CMD PING 
327 #define CONFIG CMD DHCP 
328 #define CONFIG CMD MII 
329 #define CONEIG FEC MXC 
330 £$define CONFIG MII 





































































































































































































331 £define CONFIG FEC ENET DEV 1 

332 

333 #if (CONFIG FEC ENET_DEV == 0) 

334 #define IMX FEC BASE ENET BASE ADDR 
335 £define CONFIG FEC MXC PHYADDR 0x0 

336 £4define CONFIG FEC XCV TYPE RMII 

337 #elif (CONFIG FEC ENET DEV == 1) 

338 £define IMX FEC BASE ENET2 BASE ADDR 
339 £define CONFIG FEC MXC PHYADDR 0x1 

340 £4define CONFIG FEC XCV TYPE RMII 

341 pendii 

342 #define CONFIG ETHPRIME Pure d 

343 

344 #define CONFIG PHYLIB 

345 £define CONFIG PHY SMSC 
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346 #endif 


3. MK uboot 中 74LV595 的 驱动 代码 
uboot 中 网 络 PHY 芯片 地 址 修改 完成 以 后 就 是 网 络 复位 引 脚 的 驱动 修改 了 ， 打 开 








mx6ull alientek emmc.c， 找 到 如 下 代码 : 


示例 代码 33.2.7.3 74LV595 引 脚 


&define IOX SDI  IMX GPIO NR(5, 10) 
&define IOX STCP IMX GPIO NR(5, 7) 
&define IOX SHCP IMX GPIO NR(5, 11) 
&define IOX OE IMX GPIO NR(5, 8) 











示例 代码 33.2.7.3 中 以 IOX 开头 的 宏 定 义 是 7ALV595 的 相关 GPIO， 因 为 NXP 官方 


LMX6ULL EVK 开发 板 使 用 74LV595 来 扩展 IO ， 两 个 网 络 的 复位 引 脚 就 是 由 74LV595 来 控制 


的 。 








正点 原子 的 LIMX6U-ALPHA 开发 板 并 没有 使 用 74LV595， 因 此 我 们 将 示例 代码 33.2.6.6 中 











的 代码 删除 控 ， 替 换 为 如 下 所 示 代 码 : 


示例 代码 33.2.7.4 修改 后 的 网 络 引 脚 





#define ENET1 RESET IMX GPIO NR(5, 7) 
&define ENET2 RESET IMX GPIO NR(5, 8) 


接 到 SNVS TAMPERS 上 ， 对 应 GPIO5 1008. 























ENETI1 的 复位 引 脚 连接 到 SNVS_TAMPER7 上 ， 对 应 GPIO5 IO07，ENET2 的 复位 引 脚 连 





继续 在 mx6ull alientek emmc.c 中 找到 如 下 代码 : 
示例 代码 33.2.7.5 74LV595 引 脚 配置 


Seenre tomus ys Cro 1E Const ox padesi = y 


Dg 


^ TOX SDI */ 

MX6 PAD BOOT MODEO GPIO5 IO10 | MUX PAD CTRL(NO PAD CTRL), 
(^ dO SEQQ wj 
MX6 PAD BOOT MODEI GETOS TOLI | MUX PAD CTRL(NO PAD CTRL), 
(S TOX STEE uw 
MX6 PAD SNVS TAMPER7  GPIO5 IO07 | MUX PAD CTRL(NO PAD CTRL), 
] TOX xm */ 
MX6 PAD SNVS TAMPER8 GPIO5 IO08 | MUX PAD CTRL(NO PAD CTRL), 






























































同 理 ， 示 例 代 码 33.2.7.5 是 74LV595 的 IO 配置 参数 结构 体 ， 将 其 删除 掉 。 继 续 在 

















mx6ull alientek emmc.c 中 找到 函数 iox74lv_init， 如 下 所 示 : 


示例 代码 33.2.7.6 74LV595 初始 化 函数 


static void iox741v init (void) 


{ 


aote 3L 





gpio direction output(IOX OE, 0); 


Eorm (i ME E) NET 
gpio direction output(IOX SHCP, 0); 
golo direction output (TOX SDIT, sealen owtpouwe hiii LN e 
udelay(500); 
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golo chirection Output (IO SHCE, 19g 
udelay (500); 


[= 
* shift register will be output to pins 
Xy 
geio direction owtput (TOX STEE, 1) 7 
}; 


void iox74l1v set(int index) 


{ 


Taie aA 


fora E ME ME NE 
golo chirection Output (I0 SECIP, 0» 


if (i == index) 

gopio Cirection output (I0 SDI, segan Gxenejsxne hiti i f 
else 

gpio direction output(IOX SDI, seq[gn output[i]]I11); 
udelay (500); 
gopio Chirection output (IO SHCE, 1» p 
udelay (500); 


* shift register will be output to pins 
S 
gpic cirection owtpout (TOX STEE, i» 
}; 








iox74lv init 函数 是 74LV595 的 初始 化 函数 ，iox74lv_set 函数 用 于 控制 74LV595 的 IO 输出 
电 平 ， 将 这 两 个 函数 全 部 删除 掉 ! 
在 mx6ull alientek emmc.c 中 找到 board init 函数 ， 此 函数 是 板子 初始 化 函数 ， 会 被 
board init r 调用 ，board init 函数 内 容 如 下 : 
示例 代码 33.2.7.7 board, init 函数 








int board init (void) 





imx iomux v3 setup multiple pads(iox pads, ARRAY SIZE(iox pads)); 
iox74lv init(); 
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return 0; 





board init 会 调用 imx iomux v3 setup multiple pads 和 iox74lv init 这 两 个 函数 来 初始 化 





741v595 的 GPIO， 将 这 两 行 删除 掉 。 至 此 ，mx6ull alientek emmc.c 中 关于 74LV595 芯片 的 驱 


动 代码 都 删除 掉 了 ， 接 下 来 就 是 添加 LMX6U-ALPHA 开发 板 两 个 网 络 复位 引 脚 了 。 
4、 添 加 LMX6U-ALPHA 开发 板 网 络 复位 引 脚 驱动 


在 mx6ull alientek emmc.c 中 找到 如 下 所 示 代 码 : 
示例 代码 33.2.7.8 默认 网 络 IO 结构 体 数 组 








x 














































































































































































































GAO gterie romi vI ctg č Const Tecil pace = 4 
641 MX6 PAD GPIOI IO06  ENET1 MDIO | MUX PAD CTRL(MDIO PAD CTRL), 
642 MX6 PAD GPIO1 IO07  ENET1 MDC | MUX PAD CTRL(ENET PAD CTRL), 
649 MX6 PAD ENET1 RX ER ENET1 RX ER | MUX PAD CTRL(ENET PAD CTRL) ， 
650 MX6 PAD ENETI1 RX EN  ENETI1 RX EN | MUX PAD CTRL(ENET PAD CTRL), 
GONE 
557 
8/55, tarie omw: v3 ctg it Const rec? wes = 
654 MOMP- ET 0 SERENE MDIO | MUX PAD CTRL(MDIO PAD CTRL), 
655 MX6 PAD GPIO1 IO07 ENET2 MDC | MUX PAD CTRL(ENET PAD CTRL), 
664 MX6 PAD ENET2 RX EN ENET2 RX EN | MUX PAD CTRL(ENET PAD CTRL), 
665 MX6 PAD ENET2 RX ER  ENET2 RX ER | MUX PAD CTRL(ENET PAD CTRL), 
666 ); 

结构 体 数 组 fecl pads 和 fec2 pads 是 ENET1 和 ENET2 这 两 个 网 口 的 IO 配置 参数 ， 在 这 

















两 个 数组 中 添加 两 个 网 口 的 复位 IO 配置 参数 ， 完 成 以 后 如 下 所 示 : 
示例 代码 33.2.7.9 添加 网 络 复位 IO 后 的 结构 体 数组 


G4 gratie tomi: eS (Cung č coms: recl wee 


{ 











































































































641 MX6 PAD GPIO1 IO06 ENET1 MDIO | MUX PAD CTRL(MDIO PAD CTRL), 
642 MX6 PAD GPIO1 IO07  ENET1 MDC | MUX PAD CTRL(ENET PAD CTRL), 
649 MX6 PAD ENET1 RX ER ENET1 RX ER | MUX PAD CTRL(ENET PAD CTRL), 
650 MX6 PAD ENET1 RX EN  ENET1 RX EN | MUX PAD CTRL(ENET PAD CTRL), 
651 MX6 PAD SNVS TAMPER7 GPIO5 IO07 | MUX PAD CTRL(NO PAD CTRL), 
652 hr 

653 


954 gtatie om v3 Cig ib Concoct Tee? padej 


{ 

















































































































655 MX6 PAD GPIO1 IO06 ENET2 MDIO | MUX PAD CTRL(MDIO PAD CTRL), 
656 MX6 PAD GPIO1 IO07 ENET2 MDC | MUX PAD CTRL(ENET PAD CTRL), 
665 MX6 PAD ENET2 RX EN ENET2 RX EN | MUX PAD CTRL(ENET PAD CTRL), 
666 MX6 PAD ENET2 RX ER ENET2 RX ER | MUX PAD CTRL(ENET PAD CTRL), 
667 MX6 PAD SNVS TAMPER8 GPIO5 IO08 | MUX PAD CTRL(NO PAD CTRL), 
Siem. Jg 
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示例 代码 33.2.7.9 中 , 第 651 行 和 667 行 分 别 是 ENETI 和 ENET2 的 复位 IO 配置 参数 。 继 
续 在 文件 mx6ull alientek emmc.c 中 找到 函数 setup_iomux_fec， 此 函数 默认 代码 如 下 : 
示例 代码 33.2.7.10 setup. iomux fec 函数 默认 代码 


peb gtetic vore! setup iomu SEE Tee 1e) 














S 

670 if (fec id == 0) 

S7 imx iomux v3 setup multiple pads(fecl pads, 
GUI ARRAY SIZE (fecil pads) ES 

VIS else 

674 imx iomux v3 setup multiple pads(fec2 pads, 
675 ARRAY SIZE(fec2 pads)); 

676 ) 





函数 setup iomux fec 就 是 根据 fecl pads 和 fec2 pads 这 两 个 网 络 IO 配置 数组 来 初始 化 
LILMX6ULL 的 网 络 IO 。 我 们 需要 在 其 中 添加 网 络 复位 IO 的 初始 化 代码 ， 并 且 复位 一 下 PHY S 
片 ， 修 改 后 的 setup iomux fec 函数 如 下 : 

示例 代码 33.2.7.11 修改 后 的 setup iomux fec 函数 


GSE statie volc getup lomus Teeni tee 1e) 



































































































































669 { 

670 if (fec id == 0) 

671 { 

672 

673 imx iomux v3 setup multiple pads(fecl pads, 
674 ARRAY SIZE(fecl pads)); 
675 

676 golo  rebiseexeneshewm ioxbhejsyUhe (ENEtTi RESET, JP 
671 gpio set value(ENET1 RESET, 0); 

678 mdelay (20); 

679 golo set velus (ENET RESSE, 11) p 

680 } 

681 else 

682 { 

683 imx iomux v3 setup multiple pads(fec2 pads, 
684 ARRAY SIZE(fec2 pads)); 
685 gpio direction output(ENET2 RESET, 1); 
686 gpio set value(ENET2 RESET, 0); 

687 mdelay (20); 

688 gpio set value(ENET2 RESET, 1); 

689 ) 

690 } 


示例 代码 33.2.7.11 中 第 676 行 ~679 行 和 第 685 行 ~688 行 分 别 对 应 ENETI 和 ENET2 的 复 
位 IO 初始 化 ， 将 这 两 个 IO 设置 为 输出 并 且 硬 件 复位 一 下 LAN8720A， 这 个 硬件 复位 很 重要 ! 
否则 可 能 导致 uboot 无 法 识别 LAN8720A。 


S、 修 改 drivers/net/phy/phy.c 文件 中 的 函数 genphy update link 
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大 功 基 本 上 告 成 ， 还 差 最 后 一 步 ，uboot 中 的 LAN8720A 驱动 有 点 问题 ， 打 开 文 件 
drivers/net/phy/phy.c， 找 到 函数 genphy update link， 这 是 个 通用 PHY 驱动 函数 ， 此 函数 用 于 更 
































新 PHY 的 连接 状态 和 速度 。 使 用 LAN8720A 的 时 候 需 要 在 此 


函数 genphy update link 如 下 所 示 : 





坛 :www.opendev.com 











函数 中 添加 一 些 代 码 ， 修 改 后 的 





示例 代码 33.2.7.12 修改 后 的 genphy_update_link $ žk 
221 int genphy update link(struct phy device *phydev) 















































2221 4] 

ZI 而 ES int miri reg; 

224 

225 #ifdef CONFIG PHY SMSC 

226 static int lan8720 flag = 0; 

2an int bmcr reg = 0; 

228 if (lan8720_flag == 0) { 

2 bmcr reg - phy read(phydev, MDIO DEVAD NONE, MII BMCR); 
230 phy write(phydev, MDIO DEVAD NONE, MII BMCR, BMCR RESET); 
231 while(phy read(phydev, MDIO DEVAD NONE, MII BMCR) & 0X8000) ( 
DEED udelay(100); 

299 } 

234 phy write(phydev, MDIO DEVAD NONE, MII BMCR, bmcr reg); 
2/815 lan8720 flag = 1; 

236 } 

237 #endif 

238 

2939 > 

240 * Wait if the link is up, and autonegotiation is in progress 
241 * (ie - we're capable and it's not done) 

242 zy 

243 mii reg - phy read(phydev, MDIO DEVAD NONE, MII BMSR); 

Zeon 

PD return 0; 

ZIOSM 








225 11-2371 行 就 是 新 添加 的 代码 ， 为 条 件 编译 代码 段 ， 只 
代码 才 会 执行 (目前 只 测试 了 LAN8720A，SMSC 公司 其 他 的 




















cj 





有 使 用 SMSC 公司 的 PHY 这 上 段 
芯片 还 未 测试 )。 第 229 行 读 取 














LAN8720A 的 BMCR 寄存 器 (寄存 器 地 址 为 0)， 此 寄存 器 为 LAN8720A 的 配置 寄存 器 ， 这 里 先 
读 取 此 寄存 器 的 默认 值 并 保存 起 来 。230 行 向 寄存 器 BMCR 寄存 器 写 入 BMCR_RESET( 值 为 
0X8000)， 因 为 BMCR 的 bit15 是 软件 复位 控制 位 ， 因 此 230 行 就 是 软件 复位 LAN8720A， 复 位 
完成 以 后 此 位 会 自动 清 零 。 第 231~233 行 等 待 LAN8720A 软件 复位 完成 ， 也 就 是 判断 BMCR 














的 bitl5 位 是 否 为 1， 为 1 的 话 表示 还 没有 复位 完成 。 第 234 行 重新 向 BMCR 寄存 器 写 入 以 前 








的 值 ， 也 就 是 229 行 读 出 的 那个 值 。 








启动 ，uboot 启动 信息 如 图 33.2.7.3 所 示 : 
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至 此 网 络 的 复位 引 脚 驱动 修改 完成 ， 重 新 编译 uboot， 然 后 将 u-boot.bin 烧 写 到 SD 卡 中 并 
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U-Boot 2016.03 (May 13 2019 - 16:33:05 +0800) 


CPU: Freescale i.MX6ULL revl1.1 528 MHz (running at 396 MHz) 
CPU: Industrial temperature grade (-40C to 105C) at 47C 
Reset cause: POR 

Board: MX6ULL 14x14 EVK 

I2C: ready 

DRAM: 512 MiB 

MMC: FSL. SDHC: FSL. SDHC: 1 

Display: TFT7016 002 和 550 

Video: 1024x600x24 


In: serial 
Out: serial 
Err: serial 


switch to partitions #0, OK 

mmcO is current device 

Net: FECI 

Normal Boot 

Hit any key to stop autoboot: 0 


33.2.7.3 uboot 启动 信息 
从 图 33.2.6.4 中 可 以 看 到 “Net: FEC1” 这 一 行 ， 提 示 当 前 使 用 的 FEC1 这 个 网 口 ， 也 就 
是 ENET2。 在 uboot 中 使 用 网 络 之 前 要 先 设 置 几 个 环境 变量 ， 命 令 如 下 : 








setenv ipaddr 192.168.1.55 /开发 板 IP 地 址 

setenv ethaddr 00:04:9f:04:d2:35 /开发 板 网 卡 MAC 地 址 

setenv gatewayip 192.168.1.1 /开发 板 默认 网 关 

setenv netmask 255.255.255.0 ID ABC d ER 

setenv serverip 192.168.1.250 /服务 器 地 址 ， 也 就 是 Ubuntu 地 址 
saveenv /保存 环境 变量 





设置 好 环境 变量 以 后 就 可 以 在 uboot 中 使 用 网 络 了 ,用 网 线 将 LIMX6U-ALPHA 上 的 ENET2 
与 电脑 或 者 路 由 器 连接 起 来 ， 保 证 开发 板 和 电脑 在 同一 个 网 段 内 ， 通 过 ping 命令 来 测试 一 下 网 
络 连 接 ， 命 令 如 下 : 

ping 192.168.1.250 
结果 如 图 33.2.7.4 所 示 : 


=> ping 192.168.1.250 

FECl waiting for PHY auto negotiation to complete.... done 
Using FEC1 device 

host 192.168.1.250 is alive 


=> 





























33.2.7.4 ping 命令 测试 
从 图 33.2.7.4 可 以 看 出 ， 有 “host 192.168.1.250 is alive” 这 句 ， 说 明 ping 主机 成 功 ， 说 明 
ENET2 网 络 工 作 正 常 。 再 来 测试 一 下 ENETI1 的 网 络 是 否 正 常 工作 ,打开 mx6ull alientek emmc.h， 
将 CONFIG FEC ENET DEV 改 为 0, 然后 重新 编译 一 下 uboot 并 烧 写 到 SD 卡 中 重启 。 重启 开 
发 板 ，uboot 输出 信息 如 图 33.2.7.5 所 示 : 























868 


LMX6U HAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
U-Boot 2016.03 (May 13 2019 - 16:53:48 +0800) 


CPU: Freescale i.MX6ULL rev1.1 528 MHz (running at 396 MHz) 
CPU: Industrial temperature grade (-40C to 105C) at 50c 
Reset cause: POR 

Board: MX6ULL 14x14 EVK 

I2C: ready 

DRAM : 512 MiB 

MMC: FSL. SDHC: 0, FSL SDHC: 1 

Display: TFT/016 (1024x600) 

Video: 1024x600x24 


In: serial 
Out: serial 
Err: serial 


switch to partitions £0, OK 

mmcO is current device 

Net: FECO 

Normal Boot 

Hit any key to stop autoboot: 0 
=> 


33.2.7.5 uboot 启动 信息 
从 图 33.2.7.5 可 以 出 ， 有 “Net: FEC0” 这 一 行 ， 说 明 当 前 使 用 的 FEC0 这 个 网 卡 ， 也 就 是 
ENET1， 同 样 的 ping 一 下 主机 ， 结 果 如 图 33.2.7.5 所 示 : 


=> ping 192.168.1.250 

FECO waiting for PHY auto negotiation to complete.... done 
Using FECO device 

host 192.168.1.250 is alive 


=> 








图 33.2.7.6 ping 命令 测试 
从 图 33.2.7.6 可 以 看 出 ，ping 主机 也 成 功 ， 说 明 ENETI 网 络 也 工作 正常 ， 至 此 ，LMX6U- 
ALPHA 开发 板 的 两 个 网 络 都 工作 正常 了 ， 建 议 大 家 将 ENET2 设置 为 uboot 的 默认 网 卡 ! 也 就 
是 将 宏 CONFIG FEC ENET DEV 设置 为 1。 





33.2.8 其 他 需要 修改 的 地 方 


在 uboot 启动 信息 中 会 有 “Board: MX6ULL 14x14 EVK” 这 一 句 ， 也 就 是 说 板子 名 字 为 
“MX6ULL 14x14 EVK”， 要 将 其 改 为 我 们 所 使 用 的 板子 名 字 ， 比 如 “MX6ULL ALIENTEK 
EMMC” 或 者 “MX6ULL ALIENTEK NAND ”。 打 开 文 件 mx6ull alientek emmc.c， 找 到 函数 
checkboard， 将 其 改 为 如 下 所 示 内 容 : 

示例 代码 33.2.8.1 修改 后 的 checkboard 函数 











int checkboard (void) 
{ 
if (is mx6ull 9x9 evk()) 
puts("Board: MX6ULL 9x9 EVKNin"); 
else 
puts("Board: MX6ULL ALIENTEK EMMCn"); 


























return 0; 


修改 完成 以 后 重新 编译 uboot 并 烧 写 到 SD 卡 中 验证 ，uboot 启动 信息 如 图 33.2.8.1 所 示 : 
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U-Boot 2016.03 (May 21 2019 - 10:42:19 +0800) 


CPU: Freescale i.MX6ULL revl1.1 528 MHz (running at 396 MHz) 
CPU: Industrial temperature grade (-40C to 105C) at 54C 
Reset cause: POR 

Board: MX6ULL ALIENTEK EMMC 

I2C: ready 

DRAM : 512 MiB 

MMC: FSL SDHC: 0, FSL SDHC: 1 

Display: TFT7/016 (1024x600) 

Video: 1024x600x24 


In: serial 
Out: serial 
Err: serial 


switch to partitions £0, OK 

mmcO is current device 

Net: FECI 

Normal Boot 

Hit any key to stop autoboot: 0 
=> 


图 33.2.8.1 uboot 启动 信息 
从 图 33.2.8.1 可 以 看 出 ，Board 变 成 了 “MX6ULLALIENTEK EMMC”。 至 此 uboot 的 驱动 
部 分 就 修改 完成 了 ，uboot 移植 也 完成 了 ，uboot 的 最 终 目 的 就 是 启动 Linux 内 核 ， 所 以 需要 通 
过 启动 Linux 内 核 来 判断 uboot 移植 是 否 成 功 。 在 启动 Linux 内 核 之 前 我 们 先 来 学 习 两 个 重要 
的 环境 变量 bootcmd 和 bootargs。 























33.3 bootcmd 和 bootargs 环境 变量 


uboot 中 有 两 个 非常 重要 的 环境 变量 bootcmd 和 bootargs， 接 下 来 看 一 下 这 两 个 环境 HEE. 
bootcmd 和 bootagrs 是 采用 类 似 shell 脚本 语言 编号 的 ， 里 面 有 很 多 的 变量 引用 ， 这 些 变量 其 实 
都 是 环境 变量 ， 有 很 多 是 NXP 自己 定义 的 。 文 件 mx6ull alientek emmch 中 的 安 
CONFIG EXTRA ENV SETTINGS 保存 着 这 些 环境 变量 的 默认 值 ， 内 容 如 下 ; 
示例 代码 33.3.1.1 Æ CONFIG. EXTRA, ENV. SETTINGS 默认 值 
113 #if defined(CONFIG SYS BOOT NAND) 
114 4define CONFIG EXTRA ENV SETTINGS \ 

































































E15 CONFIG MFG ENV SETTINGS \ 

inig “pane IZ- BERNSTEIN 

Lala "fdt addr-0x83000000N0" N 

dl) hele a (0 E XE ETE dE E dE E NN O N 

126 "bootz $(loadaddr) - S$(fdt addr]N0" 
WAN 

128 #else 

129 #define CONFIG EXTRA ENV SETTINGS V 
130 CONFIG MFG ENV SETTINGS \ 

131 ON 

Jd "image-zImageNO" N 

1S3 "console=ttymxc0\0" \ 

134 Waele  Imbcjmes(O eee eein eE ENO N 

195 Aail a oae e eee NO N 
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ISe "fdt file-undefinedNO" \ 
194 EEEN 
JL YS "if test $fdt file = undefined; then " N 
196 "if test $board name = EVK && test $board rev = 9X9; then " N 
IES T "setenv fdt file imx6ull-9x9-evk.dtb; fi; " N 
JL SIS "if test S$board name = EVK && test $board rev = 14X14; then " N 
199 "setenv fdt file imx6ull-14x14-evk.dtb; fi; "AN 
200 "if test $fdt file = undefined; then " N 
20m "echo WARNING: Could not determine dtb to use; fi; " N 
202 ef WU 
"E CONFIG EXTRA ENV SETTINGS 是 个 条 件 编译 语句 ， 使 用 NAND 和 EMMC 的 时 候 














宏 CONFIG EXTRA ENV SETTINGS 的 值 是 不 同 的 。 


33.3.1 环境 变量 bootcmd 


bootemd 在 前 面 已 经 说 了 很 多 次 了 ，bootcmd 保存 着 uboot 默认 命令 ，uboot 倒计时 结束 以 
后 就 会 执行 bootcmd 中 的 命令 。 这 些 命 令 一 般 都 是 用 来 启动 Linux 内 核 的 ， 比 如 读 取 EMMC 或 
者 NAND Flash 中 的 Linux 内 核 镜像 文件 和 设备 树 文 件 到 DRAM 中 ， 然 后 启动 Linux 内 核 。 可 
以 在 uboot 启动 以 后 进入 命令 行 设 置 bootemd 环境 变量 的 值 。 如 果 EMMC 或 者 NAND 中 没有 
保存 bootemd 的 值 ， 那 么 uboot 就 会 使 用 默认 的 值 ， 板 子 第 一 次 运行 uboot 的 时 候 都 会 使 用 默 
认 值 来 设置 bootemd 环境 变量 。 打 开 文 件 include/env_default.h， 在 此 文件 中 有 如 下 所 示 内 容 : 

示例 代码 33.3.1.1 默认 环境 变量 





































































































14 env t environment X PPCENV Sl 

L5; ENV CRC, /* CRC Sum */ 

16 #ifdef CONFIG SYS REDUNDAND ENVIRONMENT 

37 ip f BE vede = 

18 pencli 

19 { 

20 pelii defined(DEFAULT ENV INSTANCE STATIC) 

21 static char default environment[] = ( 

22 #else 

253 Congt ela eu enyi ronment = d 

24 #endif 

25 #ifdef CONFIG ENV CALLBACK LIST DEFAULT 

26 ENV _ CALLBACK VAR "=" CONFIG ENV _ CALLBACK LIST DEFAULT "\0" 
27 #endif 

28 #ifdef CONFIG ENV FLAGS LIST DEFAULT 

29 ENV FLAGS VAR "=" CONFIG ENV FLAGS LIST DEFAULT "\0" 
S0 pencit 

C e CONFIG BOOTAREGS 

97 "bootargs-" CONFIG BOOTARGS PANNI 

SS yendi 





34 d4ifdef CONFIG BOOTCOMMAND 
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25 
36 
2l 
38 
29 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
Sil 
52 
39 
54 
59 
56 
5m 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
Pal 
Tg 
p 
74 
Je 
76 
TER 


"bootcmd-" CONFIG BOOTCOMMAND 
dfendif 
#ifdef CONFIG RAMBOOTCOMMAND 



























































NOT 





























e31E B B 
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LU 














"ramboot-" CONFIG RAMBOOTCOMMAND NION 
#endif 
#ifdef CONFIG NFSBOOTCOMMAND 
"nfsboot-" CONFIG NFSBOOTCOMMAND P 
fendif 
#if defined(CONFIG BOOTDELAY) && (CONFIG BOOTDELAY >= 0) 
"bootdelayz" . Stringify(CONFIG BOOTDELAY) TAOS 
#endif 
#if defined(CONFIG BAUDRATE) && (CONFIG BAUDRATE >= 0) 
"baudrate-" X stringify(CONFIG BAUDRATE) Sn gud 
fendif 
difdef CONFIG LOADS ECHO 
"loads echo=" Ering ICON LOADS ECHO) TOT 
#endif 
#ifdef CONFIG ETHPRIME 
Memorie CONFIG EDEN WO 
#endif 
#ifdef CONFIG IPADDR 
"ipaddr-"  stringify(CONFIG IPADDR) "X0" 
fendif 
#ifdef CONFIG SERVERIP 
"SGPverio ringifty( ONETGSSERVERIE) ONOR 
#endif 
#ifdef CONFIG SYS AUTOLOAD 
"autoload-" CONFIG SYS AUTOLOAD AIN (OR 
fendif 
#ifdef CONFIG PREBOOT 
"preboot-" CONFIG PREBOOT Uwe 
fendif 
difdef CONFIG ROOTPATH 
"rootpath-" CONFIG ROOTPATH HANON 
#endif 
#ifdef CONFIG_GATEWAYIP 
"gatewayip-" | Stringify(CONFIG GATEWAYIP) DNO 
fendif 
difdef CONFIG NETMASK 
"netmask-" . stringify(CONFIG NETMASK) "NO" 
fendif 
#ifdef CONFIG HOSTNAME 
"hostname-" — stringify(CONFIG HOSTNAME) TAOS 
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了 

TOF AEF CONFIG BOOTFILE 

80 Moe erste M ( NTEBIKC MEE) 9 TETTE UN SG 

81 pencli 

82 difdef CONFIG LOADADDR 

83 "loadaddr-" X stringify(CONFIG LOADADDR) AS QUU 
84 dendif 

85 #ifdef CONFIG CLOCKS IN MHZ 

86 veoek Son AO 

87 dendif 

88 dif defined(CONFIG PCI BOOTDELAY) && (CONFIG PCI BOOTDELAY 2-280) 
89 "pcidelay=" OUCONETC PCT BOOTDELAY) "ANOT 
90 renda 

91 4ifdef CONFIG ENV VARS UBOOT CONFIG 

92 EON CONFIG SYS ARCH mos 

SS "ioni CONFIG SYS CPU SUN (QU 

94 "board-" CONFIG SYS BOARD ue og 

95 Boos Ine CONFIG SYS BOARD QN 

96 difdef CONFIG SYS VENDOR 

9 "vendor=" CONFIG SYS VENDOR DEO 

oS pendii 

99 ifdef CONFIG SYS SOC 

100 "socz" CONFIG SYS SOC US guo 

101 #endif 

102 #endif 

103 4ifdef CONFIG EXTRA ENV SETTINGS 

104 CONFIG EXTRA ENV SETTINGS 

105 £endif 

106 SS uo 

107 #ifdef DEFAULT ENV INSTANCE EMBEDDED 

108 } 

109 #endif 

TEOSE 





environment 是 个 env t 类 型 的 变量 ，env t 类 型 如 下 : 
示例 代码 33.3.1.2 env_t 结构 体 
156 typedef struct environment s { 
J ine E (eG /* CRC32 over data bytes m 
158 #ifdef CONFIG SYS REDUNDAND ENVIRONMENT 











159 unsigned char flags; /* active/obsolete flags SY 
160 #endif 
161 unsigned char  data[ENV SIZE]; /* Environment data a 








1652 p enw w 
env t 结 构 体 中 的 crc 为 CRC 值 ,flags 是 标志 位 ,data 数组 就 是 环境 变量 值 .因此 ,environment 
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就 是 用 来 保存 默认 环境 变量 的 ， 在 示例 代码 33.3.1.1 中 指定 了 很 多 环境 变量 的 默认 值 ， 比 如 
bootcmd 的 默认 值 就 是 CONFIG BOOTCOMMAND ， bootargs Bj EA iA fü ub x 
CONFIG BOOTARGS 。 我 们 可 以 在 mx6ull alientek emmch X: fF rp 38 xt Wt BOX 
CONFIG BOOTCOMMAND 来 设置 bootcmd 的 默认 值 ，NXP 官方 设置 的 
CONFIG BOOTCOMMAND 值 如 下 : 

示例 代码 33.3.1.3 CONFIG. BOOTCOMMAND 默认 值 
204 £$define CONFIG BOOTCOMMAND N 




















205 Wawona larvelaelleaW N 
206 "mmc dev $ímmedewv];" N 
207 "mmc dev Simmedev); uf mme rescan; then " N 
208 Wie cwn Moelle eo caem UN 
209 Irun oo se 
210 "else " N 
ZLA "if run loadimage; then " N 
22 aTa esto e ore UM 
ZAPS "else run netboot; " N 
214 人 
NES Iur as 
216 "else run netboot; fi" 
看 起 来 很 复杂 的 样子 ! 因为 uboot 使 用 了 类 似 shell 脚本 语言 的 方式 来 编写 的 ， 我 们 一 行 一 
行 来 分 析 。 











第 205 ÍF, run findfdt; 使 用 的 是 uboot 的 run 命令 来 运行 findfdt，findfdt 是 NXP 自行 添加 
的 环境 变量 。findfdt 是 用 来 查找 开发 板 对 应 的 设备 树 文件 (.dtb)。IMX6ULL EVK 的 设备 树 文件 
为 imx6ull-14x14-evk.dtb，findfdt 内 容 如 下 : 
"findfdt="\ 
"if test $fdt_file = undefined; then " \ 
"if test $board name = EVK && test $board rev= 9X9; then "^ 
"setenv fdt file imx6ull-9x9-evk.dtb; fi; " V 
"if test $Sboard name = EVK && test $board rev = 14X14; then " V 
"setenv fdt file imx6ull-14x14-evk.dtb; fi; " V 
"if test $fdt file = undefined; then " V 
"echo WARNING: Could not determine dtb to use; fi; " V 
"fi;\0" \ 
findfdt 里 面 用 到 的 变量 有 fdt file, board name, board rev， 这 三 个 变量 内 容 如 下 : 
fdt file=undefined, board name-EVK, board rev-14X14 
findfdt 做 的 事情 就 是 判断 ，fdt_ file 是否 为 undefined， 如 果 fdt file 为 undefined 的 话 那 就 要 
根据 板子 信息 得 出 所 需 的 .dtb 文件 名 。 此 时 fdt file 为 undefined， 所 以 根据 board name 和 
board rev 来 判断 实际 所 需 的 .dtb 文件 ,如 果 board name 为 EVK 并 且 board. rev-9x9 的 话 fdt file 
就 为 imx6ull-9x9-evk.dtb。 如 果 board name 为 EVK 并 且 board rev-14x14 的 话 fdt file 就 设置 
为 imx6ull-14x14-evk.dtb。 因 此 IMX6ULL EVK 板子 的 设备 树 文件 就 是 imx6ull-14x14-evk.dtb， 
因此 run findfdt 的 结果 就 是 设置 fdt_file 为 imx6ull-14x14-evk.dtb。 
第 206 fT, mmc dev ${fmmcdev} 用 于 切换 mme 设备 ，mmcedev 为 1， 因此 这 行 代码 就 是 : mmc 
dev 1， 也 就 是 切换 到 EMMC 上 。 
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第 207 行 ， 先 执行 mmc dev ${fmmcdev} 切 换 到 EMMC 上 ， 然 后 使 用 命令 mme rescan 14 


























看 有 没有 SD 卡 或 者 EMMC 存在 ， 如 果 没 有 的 话 就 直接 跳 到 216 行 ， 执 行 runnetboot，netboot 
也 是 一 个 自 定义 的 环境 变量 ， 这 个 变量 是 从 网 络 启动 Linux 的 。 如 果 mmc 设备 存在 的 话 就 从 
mme 设备 启动 。 
第 208 行 ， 运 行 loadbootscript 环境 变量 ， 此 环境 变量 内 容 如 下 : 
loadbootscript=fatload mmc $ {mmcdev}:$ {mmcpart} $ {loadaddr} $ {script}; 
其 中 mmcedev=1, mmcpart=1, loadaddr=0x80800000, script= boot.scr， 因 此 展开 以 后 就 是 : 
loadbootscript=fatload mmc 1:1 0x80800000 boot.scr; 
loadbootscript 就 是 从 mmcl 的 分 区 1 中 读 取 文件 boot.sre $| DRAM 的 0X80800000 处 。 但 
是 mmcl 的 分 区 1 中 没有 bootsre 这 个 文件 ， 可 以 使 用 命令 “ls mmc 1:1” 查 看 一 下 mmcl 分 区 
1 中 的 所 有 文件 ， 看 看 有 没有 bootsre 这 个 文件 。 
第 209 行 ， 如果 加 载 boot.src 文件 成 功 的 话 就 运行 bootscript 环境 变量 ,bootscript 的 内 容 如 
F: 


bootscript=echo Running bootscript from mmc ...; 













































































source 
因为 boot'src 文件 不 存在 ， 所 以 bootscript 也 就 不 会 运行 。 
第 211 行 ， 如 果 loadbootscript 没有 找到 bootsrc 的 话 就 运行 环境 变量 loadimage， 环 境 变 量 
loadimage 内 容 如 下 : 

loadimage-fatload mmc $ {mmcdev}:$ (mmcpart) $ (loadaddr) $ (image) 
其 中 mmedev-1, mmcpart=1, loadaddr-0x80800000, image = zImage， 展 开 以 后 就 是 : 

loadimage-fatload mmc 1:1 0x80800000 zImage 

可 以 看 出 loadimage 就 是 从 mmcl 的 分 区 中 读 取 zImage 到 内 存 的 0X80800000 处 ,而 mmc 
的 分 区 1 中 存在 zImage. 

第 212 行 ， 加 载 linux 镜像 文件 zImage 成 功 以 后 就 运行 环境 变量 mmcboot， 否 则 的 话 运行 
netboot 环境 变量 。mmcboot 环境 变量 如 下 : 

示例 代码 33.3.1.4 mmcboot 环境 变量 
























































154 "mmcboot-echo Booting from mmc ...; LN 

1551 Wawa eeen e N 

S "if test $(boot Cier — yes || test $(boot fdt) = try; then " N 
LS ume mwa dixexelitole p. casn 4 Ñ 

ISS "lex. P loececeki ~ iret ecerip S N 
T9 "else " N 

160 "if test $(boot fdt) = try; then " N 
We woo 

162 "else " N 

WES "echo WARN: Cannot load the DT; " \ 
164 WE MU ix 

T65 E AN 

166 "else " N 

167 HOER A N 

168 DEIT QU. 8 


第 154 行 ， 输 出 信息 “Booting from mmc ...". 
第 155 行 ， 运 行 环境 变量 mmcargs, mmcargs 用 来 设置 bootargs， 后 面 分 析 bootargs 的 时 候 
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在 学 习 。 

第 156 行 ,判断 boot fdt 是 否 为 yes 或 者 try, 根据 uboot 输 出 的 环境 变量 信息 可 知 boot fdt=try。 
因此 会 执行 157 íT 的 语句 。 














第 157 行 ， 运 行 环 境 变 量 loadfdt， 环 境 变量 loadfdt 定义 如 下 : 
loadfdt=fatload mmc $ (mmedev]:$ {mmcepart} ${fdt_addr} $ {fdt file) 
展开 以 后 就 是 : 
loadfdt-fatload mmc 1:1 0x83000000 imx6ull-14x14-evk.dtb 
因此 loadfdt 的 作用 就 是 从 mmel 的 分 区 1 中 读 取 imx6ull-14x14-evk.dtb 文件 并 放 到 0x83000000 
处 。 
第 158 行 ， 如 果 读 取 .dtb 文件 成 功 的 话 那 就 调用 命令 bootz 启动 linux， 调 用 方法 如 下 : 
bootz $ (loadaddr) - $ {fdt addr}; 
展开 就 是 : 
bootz 0x80800000 - 0x83000000 (注意 “-” 前 后 要 有 空格 ) 
至 此 Linux 内 核 启 动 ， 如 此 复杂 的 设置 就 是 为 了 从 EMMC 中 读 取 zImage 镜像 文件 和 设备 
树 文件 。 经 过 分 析 ， 浓 缩 出 来 的 仅仅 是 4 行 精华 : 

































































mmc dev 1 /切换 到 EMMC 

fatload mmc 1:1 0x80800000 zImage // 读 取 zImage 到 0x80800000 处 
fatload mmc 1:1 0x83000000 imx6ull-14x14-evk.dtb V/ 读 取 设 备 树 到 0x83000000 处 
bootz 0x80800000 - 0x83000000 /启动 Linux 




















NXP 官方 将 CONFIG BOOTCOMMAND 写 的 这 么 复杂 只 有 一 个 目的 : 为 了 兼容 多 个 板子 ， 
所 以 写 了 个 很 复杂 的 脚本 。 当 我 们 明确 知道 我 们 所 使 用 的 板子 的 时 候 就 可 以 大 幅 简 化 宏 
CONFIG BOOTCOMMAND 的 设置 ， 比 如 我 们 要 从 EMMC EJ, WAK 
CONFIG BOOTCOMMAND 就 可 简化 为 : 
#define CONFIG BOOTCOMMAND V 
"mmc dev 1;" ^ 
"fatload mmc 1:1 0x80800000 zImage;" \ 
"fatload mmc 1:1 0x83000000 imx6ull-alientek-emmc.dtb;" V 
"bootz 0x80800000 - 0x83000000;" 
或 者 可 以 直接 在 uboot 中 设置 bootemd 的 值 ， 这 个 值 就 是 保存 到 EMMC 中 的 ， 命 令 如 下 : 
setenv bootcmd 'mmc dev 1; fatload mmc 1:1 80800000 zImage; fatload mmc 1:1 83000000 imx6ull- 
alientek-emmc.dtb; bootz 80800000 - 83000000; 











33.3.2 环境 变量 bootargs 


bootargs 保存 着 uboot 传递 给 Linux 内 核 的 参数 ， 在 上 一 小 节 讲 解 bootemd 的 时 候 说 过 ， 
bootargs 环境 变量 是 由 mmcargs 设置 的 ，mmcargs 环境 变量 如 下 : 

mmcargs-setenv bootargs console-$ (console),$ {baudrate} root-$ (mmcroot] 
其 中 console-ttymxc0, baudrate-115200, mmceroot-/dev/mmcblk1p2 rootwait rw， 因 此 将 
mmcargs 展开 以 后 就 是 : 

mmcargs-setenv bootargs console= ttymxc0, 115200 root- /dev/mmcblk1p2 rootwait rw 

可 以 看 出 环境 变量 Doe 就 是 设置 bootargs 的 值 为 “ GE ttymxc0, 115200 root- 
/dev/mmcbIk1p2 rootwait rw", bootargs 就 是 设置 了 很 多 的 参数 的 值 ， 这 些 参数 Linux 内 核 会 使 
用 到 ， 常 用 的 参数 有 : 


1l. console 
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console 用 来 设置 linux 终端 (或 者 叫 控制 台 )， 也 就 是 通过 什么 设备 来 和 Linux 进行 交互 , 是 
串口 还 是 LCD 屏幕 ? 如 果 是 串口 的 话 应 该 是 串口 几 等 等 。 一 般 设 置 串口 作为 Linux 终端 ， 这 样 
我 们 就 可 以 在 电脑 上 通过 SecureCRT 来 和 linux 交互 了 。 这 里 设置 console 为 ttymxc0, 因为 linux 
启动 以 后 LMX6ULL 的 串口 1 在 linux 下 的 设备 文件 就 是 /dev/ttymxc0， 在 Linux F, ~U EX 
件 o 
ttymxc0 后 面 有 个 “,115200” 这 是 设置 串口 的 波 特 率 ，console=ttymxc0,115200 综合 起 来 就 是 设 
置 tymxc0( 也 就 是 串口 1) 作为 Linux 的 终端 ， 并 且 串 口 波 特 率 设置 为 115200。 
2、root 


root 用 来 设置 根 文 件 系 统 的 位 置 ，root=/dev/mmcblk1p2 用 于 指明 根 文 件 系统 存放 在 
mmcblkl 设备 的 分 区 2 中 。EMMC 版 本 的 核心 板 启动 linux 以 后 会 存在 /devmmcblk0、 
/dev/mmcblk1、 /dev/mmcbIkOp1. /dev/mmcbIk0p2. /dev/mmcblk1pl 和 /dev/mmcblk1p2 这 样 的 文 
件 ， 其 中 /dev/mmcblkx(x=0~n) 表 示 mme 设备 ， 而 /dev/immcblkxpy(x=0~n,y=1~n) 表 示 mmc 设备 
x 的 分 区 y. TE LMX6U-ALPHA 开发 板 中 /dev/mmcblk1 表示 EMMC， 而 /dev/mmcblk1p2 表示 
EMMC 的 分 区 2。 

root 后 面 有 “rootwaitrw” rootwait 表示 等 待 mme 设备 初始 化 完成 以 后 再 挂 载 ， 否 则 的 话 
mme 设备 还 没 初始 化 完成 就 挂 载 根 文件 系 统 会 出 错 的 。 rw 表示 根 文件 系统 是 可 以 读 写 的 , 不 加 
rw 的 话 可 能 无 法 在 根 文件 系统 中 进行 写 操 作 ， 只 能 进行 读 操 作 。 
3、rootfstype 


此 选项 一 般配 置 root 一 起 使 用 ，rootfstype 用 于 指定 根 文件 系统 类 型 ， 如 果 根 文件 系统 为 
ext 格式 的 话 此 选项 无 所 谓 。 如 果 根 文件 系统 是 yaffs、jffs 或 ubifs 的 话 就 需要 设置 此 选项 ， 指 
定 根 文件 系统 的 类 型 。 

bootargs 常设 置 的 选项 就 这 三 个 ， 后 面 遇 到 其 他 选项 的 话 再 讲解 。 










































































































































































































































































33.4 uboot 启动 Linux 测试 

uboot 已 经 移植 好 了 ，bootcmd 和 bootargs 这 两 个 重要 的 环境 变量 也 讲解 了 ， 接 下 来 就 要 测 
试 一 下 uboot 能 不 能 完成 它 的 工作 : 启动 Linux 内 核 。 我 们 测试 两 种 启动 Linux 内 核 的 方法 , 一 
种 是 直接 从 EMMC 启动 ， 一 种 是 从 网 络 启动 。 





























33.4.1 从 EMMC 启动 Linux 系统 


从 EMMC 启动 也 就 是 将 编译 出 来 的 Linux 镜像 文件 zImage 和 设备 树 文 件 保 存在 EMMC 
中 ，uboot 从 EMMC 中 读 取 这 两 个 文件 并 启动 ， 这 个 是 我 们 产品 最 终 的 启动 方式 。 但 是 我 们 目 
前 还 没有 讲解 如 何 移植 linux 和 设备 树 文 件 ， 以 及 如 何 将 zImage 和 设备 树 文 件 保存 到 EMMC 
中 。 不 过 大 家 拿 到 手 的 ILMX6U-ALPHA 开发 板 (EMMC 版 本 ) 已 经 将 zImage 文件 和 设备 树 文件 
烧 写 到 了 EMMC 中 ， 所 以 我 们 可 以 直接 读 取 来 测试 。 先 检查 一 下 EMMC 的 分 区 1 中 有 没有 
zlmage 文件 和 设备 树 文 件 ， 输 入 命令 “ls mmc 1:1”， 结 果 如 图 33.4.1.1 所 示 : 
=> ls mmc 1:1 


6073416 zimage 
37331 imx6ull-alientek-emmc.dtb 


2 file(s), 0 dir(s) 


=> 
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图 33.4.1.1 EMMC 分 区 1 文件 


从 图 33.4.1.1 中 可 以 看 出 ， 此 时 EMMC 分 区 1 中 存在 zimage 和 imx6ull-alientek-emmc.dtb 
这 两 个 文件 ,所 以 我 们 可 以 测试 新 移植 的 uboot 能 不 能 启动 linux 内 核 。 设 置 bootargs 和 bootcmd 





这 两 个 环境 变量 ， 设 置 如 下 : 
setenv bootargs 'console-ttymxc0,115200 root=/dev/mmcblk1p2 rootwait rw' 


setenv bootcmd 'mmc dev 1; fatload mmc 1:1 80800000 zImage; fatload mmc 1:1 83000000 


imx6ull-alientek-emmc.dtb; bootz 80800000 - 83000000;' 

saveenv 

设置 好 以 后 直接 输入 boot, 或 者 run bootemd 即 可 启动 Linux 内 核 ， 如 果 Linux 内 核 启 
功 的 话 就 会 输出 如 图 33.4.1.2 所 示 的 启动 信息 : 


switch to partitions #0, OK 
mmcl(part 0) is current device 
reading zlImage 
6073416 bytes read in 150 ms (38.6 MiB/s) 
reading imx6ull-alientek-emmc.dtb 
37331 bytes read in 18 ms (2 MiB/s) 
Kernel image @ 0x80800000 [ 0x000000 - 0x5cac48 ] 
## Flattened Device Tree blob at 83000000 
Booting using the fdt blob at 0x83000000 
Using Device Tree in place at 83000000, end 8300c1d2 























Starting kernel ... 


Booting Linux on physical CPU 0x0 


动 成 


Linux version 4.1.15 (zuozhongkaiQubuntu) (gcc version 4.9.4 (Linaro GCC 4.9-201 


7.01) ) £10 SMP PREEMPT Mon Apr 22 15:21:47 csT 2019 

CPU: ARMv/ Processor [410fc075] revision 5 (ARMv7), cr-10c5387d 

CPU: PIPT / VIPT nonaliasing data cache, VIPT aliasing instruction cache 
Machine model: Freescale i.MX6 UltraLite 14x14 EVK Board 

Reserved memory: created CMA memory pool at 0x8c000000, size 320 MiB 
Reserved memory: initialized node Lus ,cma, compatible id shared-dma-pool 
Memory policy: Data cache writeallo 

PERCPU: Embedded 12 pages/cpu Q8bb31000 s17280 r8192 d23680 u49152 

Built 1 zonelists in Zone order, mobility grouping on. Total pages: 130048 
Kernel command line: console- ttymxcO, 115200 root-/dev/mmcblklp2 rootwait rw 
PID hash table entries: 2048 (order: 1, 8192 bytes) 

Dentry cache hash table entries: 65536 (order: 6, 262144 bytes) 

Inode-cache hash table entries: 32768 (order: 5, 131072 bytes) 


Memory: 179900K/524288K available (7510K kernel code, 368K rwdata, 2596K rodata, 


412K init, 442K bss, rebas reserved, 327680K cma-reserved, OK highmem) 
virtual kernel memory layout: 

vector : Oxffff0000 - Oxffff1000 ( 4 kB) 

fixmap : Oxffc00000 - Oxfff00000 (3072 kB) 


图 33.4.12 linux 内 核 启 动 成 功 
33.4.2 从 网 络 启动 Linux 系统 





从 网 络 启动 linux. 系统 的 唯一 目的 就 是 为 了 调试 ! 不 管 是 为 了 调试 linux 系统 还 是 linux 下 
的 驱动 。 每 次 修改 linux 系统 文件 或 者 linux 下 的 某 个 驱动 以 后 都 要 将 其 烧 写 到 EMMC 中 去 测 
试 ， 这 样 太 麻烦 了 。 我 们 可 以 设置 linux 从 网 络 启动 ， 也 就 是 将 linux. 镜像 文件 和 根 文件 系统 都 
放 到 Ubuntu 下 某 个 指定 的 文件 夹 中 ， 这 样 每 次 重新 编译 linux. 内 核 或 者 某 个 linux 驱动 以 后 只 
需要 使 用 cp 命令 将 其 拷贝 到 这 个 指定 的 文件 夹 中 即 可 ， 这 样 就 不 用 需要 频繁 的 烧 写 EMMC， 
这 样 就 加 快 了 开发 速度 。 我 们 可 以 通过 nfs 或 者 tftp 从 Ubuntu F FE zImage 和 设备 树 文件 ， 
根 文 件 系 统 的 话 也 可 以 通过 nfs ER, 不 过 本 小 节 我 们 不 讲解 如 何 通 过 nfs 挂 载 根 文件 系统 ,这 
个 在 讲解 根 文件 系统 移植 的 时 候 再 讲解 。 这 里 我 们 使 用 tftp 从 Ubuntu 中 下 载 zImage 和 设备 树 







































































文件 ， 前 提 是 要 将 zImage el Ubunut 下 的 tftp 目录 中 ， 具 体 方法 在 30.4.4 
讲解 tftp 命令 的 时 候 已 经 详细 的 介绍 过 了 。 
设置 bootargs 和 bootcmd 这 两 个 环境 变量 ， 设 置 如 下 : 


setenv bootargs 'console-ttymxc0,115200 root=/dev/mmcblk1p2 rootwait rw' 
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setenv bootcmd 'tftp 80800000 zImage; tftp 83000000 imxóull-alientek-emmc.dtb; bootz 
80800000 - 83000000' 


saveenv 

一 开始 是 通过 tftp P X zImage fll imx6ull-alientek-emmc.dtb 这 两 个 文件 , 过程 如 下 图 33.4.1.3 
所 示 : 
FEC1 Waiting for PHY auto negotiation to complete.... done 


Using FEC1 device 

|TFTP from server ,192. 168.1.250; our IP address is 192.168.1.251 

|Filename 'zImage 

[Load address: 0x80800000 

|Loading: ZZZZZASHHHHHHHHHHHHHHHHHRHRHRR HERR RR RR RR RR R ERR RRRR ERE ERR RETE E A n 

| ===- 
BESHESHHESHESSHHESHESSHSHEHTHEESTHEUDEEHHEUPDEEHSEESEESHTHEHUSTEESHTHEHSUSTHESTE 
BESHHSHHHSHESHHHHHEHSHREHESEETREESEESREESEESREUSEESHEHUSEUSTEHUSEESTE 
BESHSHSSSHSESSHESHESSHEHBEESSEHSEESHEEEBEESHEHEDREESREESEESSEHUDSEESTEHS 
BESHSSHSESHSESSEHESHESESHESPHESESHESBEESHESEBEESHESPHEESESHESEBEESHESEDEESTES 
BESHSSESSTHESHESSHHEESEESZE 
2.3 MiB/s 

[done 


Bytes transferred = 6073416 (5cac48 hex) 

Using FEC1 device 

TFTP from server 192.168.1.250; our IP address is 192.168.1.251 
|Filename 'imx6ull-alientek-emmc.dtb'. 

Load address: 0x83000000 

|Loading: SER 

| 2.1 MiB/s 

{done 


[Bytes transferred = 37331 (91d3 hex) 
33.4.1.3 下 载 过程 
下 载 完成 以 后 就 是 启动 Linux 内 核 ， 启 动 过 程 如 图 33.4.1.4 所 示 : 


starting kernel 





Booting Linux on physical CPU 0x0 
Linux version 4.1.15 (zuozhongkai@ubuntu) (gcc version 4.9.4 (Linaro GCC 4.9-201 
7.01) ) #10 SMP PREEMPT Mon Apr 22 15:21:47 CST 2019 
CPU: ARMv/ Processor [410fc075] revision 5 (ARMv7), cr-10c5387d 
CPU: PIPT / VIPT nonaliasing data cache, VIPT aliasing instruction cache 
Machine model: Freescale i.MX6 UltraLite 14x14 EVK Board 
Reserved memory: created CMA memory pool at 0x8c000000, size 320 MiB 
Reserved memory: initialized node linux,cma, compatible id shared-dma-pool 
Memory policy: Data cache writealloc 
PERCPU: Embedded 12 pages/cpu 8bb31000 s17280 r8192 d23680 u49152 
Built 1 zonelists in Zone order, mobility grouping on. Total pages: 130048 
Kernel command line: console-ttymxc0,115200 root-/dev/mmcblklp2 rootwait rw 
PID hash table entries: 2048 (order: 1, 8192 bytes) 
Dentry cache hash table entries: 65536 (order: 6, 262144 bytes) 
Inode-cache hash table entries: 32768 (order: 5, 131072 bytes) 
Memory: 179900K/524288K available (7510K kernel code, 368K rwdata, 2596K rodata, 
412K init, 442K bss, 16708K reserved, 327680K cma-reserved, OK highmem) 
Virtual kernel memory layout: 

vector : Oxffff0000 - Oxffff1000 4 kB) 

fixmap : Oxffc00000 - Oxfff00000 63072 kB) 

vmalloc : 0xa0800000 Oxff000000 (1512 MB) 


lowmem : 0x80000000 - 0xa0000000 ( 512 MB) 
pkmap : Ox7fe00000 - 0x80000000 C 2 MB) 
modules : 0x7f000000 - Ox7fe00000 ( 14 MB) 
.text : 0x80008000 - 0x809e6c20 (10108 kB) 
.init : 0x809e7000 - 0x80a4e000 ( 412 kB) 
.data : 0x80a4e000 - 0x80aaa220 ( 369 kB) 
.bss : 0x80aad000 - 0x80blba24 ( 443 kB) v 


图 33.4.1.5 Linux 启动 过 程 
uboot 移植 到 此 结束 ， 简 单 总 结 一 下 uboot 移植 的 过 程 : 
QD、 不 管 是 购买 的 开发 权 还 是 和 己 做 的 开发 板 ， 基 本 都 是 参考 半导体 厂商 的 dmeo Bx. m 

# 导体 三 商会 在 他 们 自己 的 开发 板 上 移植 好 uboot、 linux kernel 和 systemfs 等 ,最终 制作 好 BSP 
包 提 供给 用 户 。 我 们 可 以 在 官方 提供 的 BSP 包 的 基础 上 添加 我 们 的 板子 ， 也 就 是 俗称 的 移植 。 
包 、 我 们 购买 的 开发 板 或 者 自己 做 的 板子 一 般 都 不 会 原封 不 动 的 照抄 半导体 广 商 的 demo 板 ， 


出 








长 
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都 会 根据 实际 的 情况 来 做 修改 ， 既 然 有 修改 就 必然 涉及 到 uboot 下 驱动 的 移植 。 

@、 一 般 uboot 中 需要 解决 串口 、NAND、EMMC 或 SD 卡 、 网 络 和 LCD 驱动 ， 因 为 uboot 的 
主要 目的 就 是 启动 Linux 内 核 ， 所 以 不 需要 考虑 太 多 的 外 设 驱 动 。 

(@、 在 uboot 中 添加 自己 的 板子 信息 ， 根 据 自己 板子 的 实际 情况 来 修改 uboot 中 的 驱动 。 
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第 三 十 四 章 U-Boot 图 形 化 配置 及 其 原理 


在 前 两 章 中 我 们 知道 uboot 可 以 通过 mx6ull alientek emmc defconfig 来 配置 ， 或 者 通过 文 














TF mx6ull alientek emmc.h 来 配置 uboot。 还 有 另外 一 种 配置 uboot 的 方法 ， 就 是 图 形 化 配置 ， 
以 前 的 uboot 是 不 支持 图 形 化 配置 ， 只 有 Linux 内 核 才 支 持 图 像 化 配置 。 不 过 不 知道 从 什么 时 
候 开始 ，uboot 也 支持 图 形 化 配置 了 ， 本 章 我 们 就 来 学 习 一 下 如 何 通过 图 形 化 配置 uboot， 并 且 
学 习 一 下 图 形 化 配置 的 原理 ， 因 为 后 面 学 习 Linux 驱动 开发 的 时 候 可 能 要 修改 图 形 配置 文件 。 
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34.1 U-Boot 图 形 化 配置 体验 


uboot 或 Linux 内 核 可 以 通过 输入 “make menuconfig” 来 打开 图 形 化 配置 界面 ，menuconfig 
是 一 套图 形 化 的 配置 工具 ， 需 要 ncurses 库 支 持 。ncurses 库 提 供 了 一 系列 的 API 函数 供 调用 者 
生成 基于 文本 的 图 形 界面 ， 因 此 需要 先 在 Ubuntu 中 安装 ncurses 库 ， 命 令 如 下 : 


sudo apt-get install build-essential 
























































sudo apt-get install libncurses5 

sudo apt-get install libncurses5-dev 

menuconfig 重点 会 用 到 两 个 文件 : .config 和 Kconfig, .config 文件 前 面 已 经 说 了 ， 这 个 文 
件 保存 着 uboot 的 配置 项 ， 使 用 menuconfig 配置 完 uboot 以 后 肯定 要 更 新 .config 文件 。Kconfig 
文件 是 图 形 界面 的 描述 文件 ， 也 就 是 描述 界面 应 该 有 什么 内 容 ， 很 多 目录 下 都 会 有 Kconfig X 
件 。 



















































































在 打开 图 形 化 配置 界面 之 前 , 要 先 使 用 “make xxx_defconfig” 对 uboot 进行 一 次 默认 配置 ， 
只 需要 一 次 即 可 。 如 果 使 用 “make clean ”清理 了 工程 的 话 就 那 就 需要 重新 使 用 “make 
XXX_defconfig” 再 对 uboot 进行 一 次 配置 。 进 入 uboot 根 目录 ， 输 入 如 下 命令 : 

make ARCH-arm CROSS COMPILE=arm-linux-gnueabihf- mx6ull alientek emmc defconfig 

make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- menuconfig 

如 果 已 经 在 uboot 的 顶层 Makefile 中 定义 了 ARCH 和 CROSS COMPILE 的 值 ， 那 么 上 
命令 可 以 简化 为 : 


make mx6ull alientek emmc defconfig 













































































T 


述 








Imake menuconfig 


打开 后 的 图 形 化 界面 如 图 34.1.1 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/uboot-imx-rel_imx_4.1.15_2.1.0_ga_alientek 

















U-Boot 2016.03 Configuration 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). Highlighted 
letters are hotkeys. Pressing «Y» includes, <N> excludes, «M» modularizes features. Press 
«Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in [ ] excluded «M» module 
« » module capable 


rchitecture select (ARM architecture)  ---» 
> 


ARM architecture --- 
General setup ---> 
Boot images ---» 
Boot timing ---» 
Console recording 
Command line interface ---» 
Device Tree Control ---» 
- Networking support ---> 

Device Drivers ---» 
File systems ---- 
Library routines 

[ ] Unit tests ---- 


< Exit» «Help»  Á «Save» < Load > 





图 34.1.1 uboot 图 形 化 配置 界面 
图 34.1.1 就 是 主 界面 ， 主 界面 上 方 的 英文 就 是 简单 的 操作 说 明 ， 操 作 方 法 如 下 ; 
通过 键盘 上 的 “1 ”和 “ |} ” 键 来 选择 要 配置 的 菜单 ， 按 下 “Enter” 刍 进入 子 菜单 。 羔 单 
中 高 亮 的 字母 就 是 此 菜单 的 热 键 , 在 键盘 上 按 下 此 高 亮 字母 对 应 的 键 可 以 快速 选中 对 应 的 荣 单 。 
选中 子 菜单 以 后 按 下 “Y” 键 就 会 将 相应 的 代码 编译 进 Uboot P, KAMMEN <*>”, 按 下 
“N” 键 不 编译 相应 的 代码 , 按 下 M” 键 就 会 将 相应 的 代码 编译 为 模块 , 菜单 前 面 变 为 “<M >”. 
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按 两 下 “Esc” 键 退出 ， 也 就 是 返回 到 上 一 级 ， 按 下 “?” 键 查看 此 菜单 的 帮助 信息 ， 按 下 “/” 
键 打开 搜索 框 ， 可 以 在 搜索 框 输 入 要 搜索 的 内 容 。 

在 配置 界面 下 方 会 有 五 个 按钮 ， 这 五 个 按钮 的 功能 如 下 : 

«Select*: 选中 按钮 ， 和 “Enter” 键 的 功能 相同 ， 负 责 选 中 并 进入 某 个 沫 单 。 

«Exit: 退出 按钮 ， 和 按 两 下 “Esc” 键 功能 相同 ， 退 出 当前 菜单 ， 返 回 到 上 一 级 。 

«Helps: 帮助 按钮 ， 查 看 选中 菜单 的 帮助 信息 。 

<Save>: 保存 按钮 ， 保 存 修改 后 的 配置 文件 。 

«Load»: 加 载 按钮 ， 加 载 指定 的 配置 文件 。 
在 图 34.1.1 中 共有 13 个 配置 主 配置 项 , 通过 键盘 上 的 上 下 键 调节 配置 项 ,后面 跟着 “--->” 
表示 此 配置 项 是 有 子 配置 项 的 ， 按 下 回 车 键 就 可 以 进入 子 配置 项 。 

我 们 就 以 如 何 使 能 dns 命令 为 例 ， 讲 解 一 下 如 何 通 过 图 形 化 界面 来 配置 uboot。 进 入 
“Command line interface ”--->” 这 个 配置 项 ， 此 配置 项 用 于 配置 uboot 的 命令 ， 进 入 以 后 如 图 
34.1.2 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/uboot-imx-rel_imx_4.1.15_2.1.0_ga_alientek 


























Command line interface 
Arrow keys navigate the menu. <Enter> selects submenus ---> (or empty submenus ----). Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded «M» module 
« » module capable 


[| Use hush shety 

(=> ) Shell prompt 
Autoboot options --- 
*** Commands *** 
info commands ---> 
Boot commands ---> 
Environment commands --- 
Memory commands  ---» 
Device access commands ---> 
Shell scripting commands  ---» 
Network commands ---> 
Misc commands ---> 
Power commands ---- 
Security commands ---- 


« Exit » «Help» <Save > < Load > 





图 34.1.2 Command line interface 配置 项 
从 图 34.1.2 可 以 看 出 , 有 很 多 配置 项 , 这 些 配 置 项 也 有 子 配置 项 , 选择 “Network commands 
--->” 进入 网 络 相关 命令 配置 项 ， 如 图 34.1.3 所 示 : 
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zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/temp/uboot-imx-rel_imx_4.1.15_2.1.0_ga 


Network commands 
Arrow keys navigate the menu. «Enter» selects submenus ---> (or empty submenus ----). Highlighted 
letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes features. Press «Esc»«Esc» 
to exit, «?» for Help, </> for Search. Legend: [*] built-in [ ] excluded «M» module < > module 
capable 


Wl! bootp, tftpboot| 


tftp put 


ilinklocal 


< Exit» «Help» «Save» < Load > 





图 34.1.3 Network commands 配置 项 
从 图 34.1.3 可 以 看 出 ，uboot 中 有 很 多 和 网 络 有 关 的 命令 ， 比 如 bootp. tftpboot, dhcp 等 
等 。 选 中 dns， 然 后 按 下 键盘 上 的 “Y” 键 ， 此 时 dns 前 面 的 “[]” 变 成 了 “[*]”， 如 图 34.1.4 
所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/temp/uboot-imx-rel_imx_4.1.15_2.1.0_ga 





Network commands 

Arrow keys navigate the menu. <Enter> selects submenus ---> (or empty submenus ----). Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> 
to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded «M» module < > module 
capable 

1(-) 

[ ] ping 

[ ] cdp 

[ ] sntp 


[ ] !inklocal 


< Eit» «Help» «Save» < Load > 





图 34.1.4 选中 dns 命令 

每 个 选项 有 3 中 编译 选项 : 编译 进 uboot 中 (也 就 是 编译 进 u-boot.bin 中 )、 取消 编译 (也 就 是 
不 编译 这 个 功能 模块 )、 编译 为 模块 。 按 下 “Y” 键 表示 编译 进 uboot 中 , 此 时 “[]” 变 成 了 “[*]”; 
按 下 “N” 表 示 不 编译 ,“[]” 默 认 表示 不 编译 ， 有 些 功 能 模块 是 支持 编译 为 模块 的 ， 这 个 一 般 
在 Linux 内 核 里 面 很 常用 , uboot 下 面 不 使 用 ， 如果 要 将 某 个 功能 编译 为 模块 ， 那 就 按 下 “M”， 
此 时 “[]” 就 会 变 为 “< M >”。 

细心 的 朋友 应 该 会 发 现 ， 在 mx6ull alientek emmc.h 里 面 我 们 配置 使 能 了 dhep 和 ping 命 
令 ， 但 是 在 图 34.1.3 中 dhep 和 ping 前 面 的 “[]” 并 不 是 “[*]”， 也 就 是 说 不 编译 dhep 和 ping 
命令 ， 这 不 是 冲突 了 吗 ? 实际 情况 是 dhep 和 ping 命令 是 会 编译 的 。 之 所 以 在 图 34.1.3 中 没有 
体现 出 来 时 因为 我 们 是 直接 在 mx6ull alientek emmc.h 中 定义 的 宏 CONFIG. CMD PING 和 
CONFIG CMD DHCP. mi menuconfig 是 通过 读 取 .config 文件 来 判断 使 能 了 哪些 功能 ，.config 
里 面 并 没有 宏 CONFIG CMD PING Ñ CONFIG CMD _DHCP ,所 以 menuconfig 就 会 识别 出 错 。 

选中 dns， 然 后 按 下 “H” 或 者 “?” 键 可 以 打开 dns 命令 的 提示 信息 ， 如 图 34.1.5 所 示 : 
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zuozhongkai@ubuntu: -/linux/IMX6ULL/uboot/temp/uboot-imx-rel imx 4.1.15 2.1.0 ga 


| CONFIG CMD DNS: 


| Lookup the IP of a hostname 
| Symbol: CMD DNS [=y] 
Type : boolean 
| Prompt: dns 
Location: 
| -» Command line interface 
-» Network commands 
Defined at cmd/Kconfig:453 


(100%) 


Exit > 





图 34.1.5 dns 命令 提示 信息 
按 两 下 ESC 键 即 可 退出 提示 界面 ， 相当 于 返回 上 一 层 。 选 择 dns 命令 以 后 , 按 两 下 ESC 键 
( 按 两 下 ESC 键 相 当 于 返回 上 一 层 )， 退 出 当前 配置 项 ， 进 入 到 上 一 层 配置 项 。 如 果 没 有 要 修 
改 的 就 按 两 下 ESC 键 ， 退 出 到 主 配 界面 ， 如 果 也 没有 其 他 要 修改 的 ， 那 就 再 次 按 两 下 ESC 键 
退出 menuconfig 配置 界面 。 如 果 修 改过 配置 的 话 ， 在 退出 主 界面 的 时 候 会 有 如 图 34.1.6 所 示 提 





Do you wish to save your new configuration? 
(Press <ESC><ESC> to continue kernel configuration.) 


: TE =< No > 





34.1.6 是 否 保存 新 的 配置 文件 对 话 框 
图 34.1.6 询问 是 否 保存 新 的 配置 文件 ， 通 过 键盘 的 一 或 一 键 来 选择 “Yes” 项 ， 然 后 按 下 键 
盘 上 的 回 车 键 确认 保存 .至 此 , 我 们 就 完成 了 通过 图 形 界面 使 能 了 uboot 的 dns 命令 , 打开 .config 
文件 ， 会 发 现 多 了 “CONFIG_CMD_DNS=y” 这 一 行 ， 如 图 34.1.7 中 的 323 行 所 示 : 
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zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/temp/uboot-imx-rel_imx_4.1.15_2.1.0_ga 


CONFIG CMD DNS-y 


CONFIG CMD MISC-y 





图 34.1.7 .config 文件 

使 用 如 下 命令 编译 uboot: 

make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- -j16 

于 万 不 能 使 用 如 下 命令 ; 

./mx6ull alientek emmc.sh 

因为 mx6ull alientek emmc.sh 在 编译 之 前 会 清理 工程 ， 会 删除 掉 .config 文件 ! 通过 图 形 化 
界面 配置 所 有 配置 项 都 会 被 删除 ， 结 果 就 是 竹 篮 打 水 一 场 空 

编译 完成 以 后 烧 写 到 SD 卡 中 , 重启 开发 板 进入 uboot 命令 模 式 , 输入“?” 查 看 是 否 有 “dns” 
命令 ,一 般 肯 定 有 的 。 测 试 一 下 dns 命令 工作 是 否 正常 ， 使 用 dns 命令 来 查看 一 下 百度 官网 

“www.baidu.com” 的 IP 地 址 。 要 先 设置 一 下 dns 服务 器 的 IP 地址 ， 也 就 是 设置 环境 变量 dnsip 

的 值 ， 命 令 如 下 : 

setenv dnsip 114.114.114.114 

saveenv 

设置 好 以 后 就 可 以 使 用 dns 命令 查看 百度 官网 的 IP 地 址 了 ， 输 入 命令 

dns www.baidu.com 
结果 如 图 34.1.8 所 示 : 


=> dns www.baidu.com 
FEC1 waiting for PHY auto negotiation to complete.... done 
14.215.1/7 38 


=> 
















































































































































































图 34.1.78dns 命令 

从 图 34.1.7 可 以 看 出 ,，“www.baidu.com” 的 IP 地址 为 14.215.177.38， 说 明 dns 命令 工作 正 
常 。 这 个 就 是 通过 图 形 化 命令 来 配置 uboot, 一 般 用 来 使 能 一 些 命令 还 是 很 方便 的 ， 这 样 就 不 需 
要 到 处 找 命令 的 配置 宏 是 什么 ， 然 后 在 到 配置 文件 里 面 去 定义 。 


34.2 menuconfig 图 形 化 配置 原理 



































34.2.1 make menuconfig 过 程 分 析 


当 输 入 make menuconfig 以 后 会 匹配 到 顶层 Makefile 的 如 下 代码 : 
示例 代码 34.2.1.1 顶层 Makefile 代码 段 
em ese 
490 S (Q) $ (MAKE) $ (build)=scripts/kconfig $@ 
这 个 在 31.3.13 小 节 已 经 详细 的 讲解 过 了 ， 其 中 build=-f ./scripts/Makefile.build obj， 将 490 
行 的 规则 展开 就 是 : 
@ make -f ./scripts/Makefile.build obj=scripts/kconfig menuconfig 
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Makefile.build 会 读 取 scripts/kconfig/Makefile 中 的 内 容 ， 在 scripts/kconfig/Makefile 中 可 以 
找到 如 下 代码 : 


示例 代码 34.2.1.2 scripts/kconfig/Makefile 代码 段 
36 menuconfig: $(0bj)/mconf 
S $« S(silent) S$(Kconfig) 
其 中 obj= Scripts/kconfig,silent 是 设置 静默 编译 的 ,在 这 里 可 以 忽略 不 计 ,Kconfig=Kconfig， 
因此 扩展 以 后 就 是 : 


menuconfig: scripts/kconfig/mconf 








scripts/kconfig/mconf Kconfig 
目标 menuconfig 依赖 scripts/kconfig/mconf， 因 此 scripts/kconfig/mconf.c 这 个 文件 会 被 编 

VE, 生成 mconf 这 个 可 执行 文件 ,目标 menuconfig 对 应 的 规则 为 scripts/kconfig/mconfKconfig， 
也 就 是 说 mconf 会 调用 uboot 根 目录 下 的 Kconfig 文件 开始 构建 图 形 配置 界面 。 























34.2.2 Kconfig 语法 简介 


上 一 小 节 我 们 已 经 知道 了 scripts/kconfig/mconf 会 调用 uboot 根 目 录 下 的 Keonfig 文件 开始 
构建 图 形 化 配置 界面 ， 接 下 来 简单 学 习 一 下 Kconfig 的 语法 。 因 为 后 面 学 习 Linux 驱动 开发 的 
时 候 可 能 会 涉及 到 修改 Kconfig， 对 于 Kconfig 语法 我 们 不 需要 太 深 入 的 去 研究 ， 关 于 Kconfig 
的 详细 语法 介绍 ， 可 以 参考 linux 内 核 源 码 ( 不 知 为 何 uboot 源码 中 没有 这 个 文件 ) 中 的 文件 
Documentation/kbuild/kconfig-language.txt， 本 节 我 们 大 概 了 解 其 原理 即 可 。 打 开 uboot 根 目 录 下 
的 Kconfig, 这 个 Kconfig 文件 就 是 顶层 Kconfig, 我 们 就 以 这 个 文件 为 例 来 简单 学 习 一 下 Kconfig 
语法 。 


1. mainmenu 


故 名 思议 mainmenu 就 是 主 菜单 ， 也 就 是 输入 “make menuconfig” 以 后 打开 的 默认 界面 ， 
在 顶层 Kconfig 中 有 如 下 代码 : 
示例 代码 34.2.2.1 顶层 Kconfig 代 码 段 
5 mainmenu "U-Boot S$UBOOTVERSION Configuration" 

上 述 代 码 就 是 定义 了 一 个 名 为 “U-Boot$UBOOTVERSION Configuration ”的 主 菜 单 ， 其 中 
UBOOTVERSION=2016.03， 因 此 主 菜单 名 为 “U-Boot 2016.03 Configuration", mf 34.2.2.1 所 
ZN: 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/temp/uboot-imx-rel_imx_4.1.15_2.1.0_ga 








































































































U-Boot naa 一 TT 


Arrow keys navigate the menu. «Enter» ects su -> Mor empty submenus ----). 
Highlighted letters are hotkeys. prenas d includes, «N» excludes, «M» modularizes 
features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search . Legend: [*] built-in [ ] 
excluded «M» module < > module capable 


|| rchitecture select Lu architecture) 主 菜单 名 字 


ARM architecture 
General setup ---» 
+(+) 


< Exit > < Help > < Save > < Load > 





图 34.2.2.1 主 菜单 名 字 
2、 调 用 其 他 目录 下 的 Kconfig 文件 
和 makefile 一 样 ，Kconfig 也 可 以 调用 其 他 子 目 录 中 的 Keonfig 文件 ， 调 用 方法 如 下 : 
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source "xxx/Kconfig" — //xxx 为 具体 的 目录 名 ， 相 对 路 径 
在 顶层 Kconfig 中 有 如 下 代码 : 
示例 代码 34.2.2.2 顶层 Kconfig 代码 段 


12 source "arch/Kconfig" 











2:215 

226 source "common/Kconfig" 
22 

228 source "cmd/Kconfig" 
229 

230 Sou cc iss AI OLEI S 
AS 

232 source "net/Kconfig" 
299 

234 source "drivers/Kconfig" 
299 

2B SO eC em 

Zn 


2S BEES OUT Cc UNS A ODE 





240 source "test/Kconfig" 


从 示例 代码 342.2.2 中 可 以 看 出 ， 顶 层 Kconfig 文件 调用 了 很 多 其 他 子 目 录 下 的 Keofig X 
件 ， 这 些 子 目 录 下 的 Kconfig 文件 在 主 菜 单 中 生成 各 自 的 菜单 项 。 


3. menu/endmenu Z& H 


menu 用 于 生成 菜单 ，endmenu 就 是 菜单 结束 标志 ， 这 两 个 一 般 是 成 对 出 现 的 。 在 顶层 
Kconfig 中 有 如 下 代码 : 























示例 代码 34.2.2.3 顶层 Kconfig 代码 段 
14 menu "General setup" 
lS 
16 config LOCALVERSION 























15 string "Local version - append to U-Boot release" 

18 help 

JL Append an extra string to the end of your U-Boot version. 

20 This will show up on your boot log, for example. 

Al The string you set here will be appended after the contents of 
2 any files with a filename matching localversion* in your 

23 object and source tree, in that order. Your total string can 
24 be a maximum of 64 characters. 

25 

100 endmenu # General setup 

101 


102 menu "Boot images" 
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103 

104 config SUPPORT SPL 

105 bool 

106 

224 endmenu # Boot images 


示例 代码 34.2.2.3 中 有 两 个 menu/endmenu 代码 块 ， 这 两 个 代码 块 就 是 两 个 子 菜单 ， 第 14 
行 的 “menu "General setup"” 表 示 子 菜单 “General setup”。 第 102 行 的 “menu "Boot images" " 
表示 子 菜单 “Boot images”。 体 现在 主 菜单 界面 中 就 如 图 34.2.2.2 所 示 : 


zuozhongkai@ubuntu: -/linux/IMX6ULL/uboot/temp/uboot-imx-rel imx 4.1.15 2.1.0 ga 

















U-Boot 2016.03 Configuration 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes 
features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in [ ] 
excluded «M» module < > module capable 


Architecture select (ARM architecture)  ---» 
RM architecture 
General setup General Setup 和 
Boot images 2 
Boot timing ---> Boot images 子 菜单 
[ ] Console recording 
i(*) 


< Eit» «Help» «Save» < Load > 





图 34.2.2.2 子 菜单 

在 “General setup ”菜单 上 面 还 有 “Architecture select (ARM architecture) ”和 “ARM 
architecture ”这 两 个 子 菜单 ， 但 是 在 顶层 Kconfig 中 并 没有 看 到 这 两 个 子 菜单 对 应 的 
menu/endmenu 代码 块 ， 那 这 两 个 子 菜单 是 怎么 来 的 呢 ? 这 两 个 子 菜单 就 是 arch/Kconfig 文件 生 
成 的 。 包 括 主 界面 中 的 “Boottiming”“Console recording” 等 等 这 些 子 菜单 ， 都 是 分 别 由 顶层 
Kconfig 所 调用 的 common/Kconfig. cmd/Kconfig 等 这 些 子 Kconfig 文件 来 创建 的 。 

3. config 4& H 

顶层 Kconfig PHJ “General setup” 子 菜单 内 容 如 下 : 

示例 代码 34.2.2.4 顶层 Kconfig 代码 段 

14 menu "General setup" 
155) 
16 config LOCALVERSION 






































3b y) string "Local version - append to U-Boot release" 

1e help 

JS Append an extra string to the end of your U-Boot version. 

20 This will show up on your boot log, for example. 

2a The string you set here will be appended after the contents of 
22 any files with a filename matching localversion* in your 

DES object and source tree, in that order. Your total string can 
24 be a maximum of 64 characters. 

25 


26 config LOCALVERSION AUTO 
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2p bool "Automatically append version information to the version 
Gere 

28 default y 

29. help 

45 

46 config CC OPTIMIZE FOR SIZE 

47 bool "Optimize for size" 

48 default y 

49 help 

54 

35 CONG SYS MALLOC P 

56 bool "Enable malloc() pool before relocation" 

5f default y if DM 

58 help 

63 

64 config SYS MALLOC F LEN 

65 hex "Size of malloc() pool before relocation" 

66 depends on SYS MALLOC F 

67 default 0x400 

68 help 

TSi 

74 menuconfig EXPERT 

TS bool "Configure standard U-Boot features (expert users)" 
76 default y 

77 help 

82 

SOTE REXER 

84 config SYS MALLOC CLEAR ON INIT 

9:5 bool "Init with zeros the memory reserved for malloc (slow)" 
86 default y 

87 help 

99 endif 

100 endmenu # General setup 


可 以 看 出 ， 在 menu/endmenu 代码 块 中 有 大 量 的 “config xxxx” 的 代码 块 ， 也 就 是 config 条 
Ho config 条 目 就 是 “General setup ”菜单 的 具体 配置 项 ， 如 图 34.2.2.3 所 示 ; 
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zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/temp/uboot-imx-rel_imx_4.1.15_2.1.0_ga 


General setup 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus 


ev.com 


sessjs 


Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes 


features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] 
excluded «M» module < > module capable 


[b ocal version - append to U-Boot release 

[*] ^utomatically append version information to the version string 
[*] optimize for size 

[*] Enable malloc() pool before relocation 

(0x400) Size of malloc() pool before relocation 

[*] configure standard U-Boot features (expert users) ---» 


< Exit» «Help» «Save» < Load > 


图 34.2.2.3 General setup 配置 项 


built-in [ ] 





“configLOCALVERSION” 对 应 着 第 一 个 配置 项 ,“configLOCALVERSION_ AUTO” 对 应 
着 第 二 个 配置 项 ， 以 此 类 推 。 我 们 以 “config LOCALVERSION ”和 “ config 











LOCALVERSION _ AUTO” 这 两 个 为 例 来 分 析 一 下 config 配置 项 的 语法 : 
示例 代码 34.2.2.5 顶层 Kconfig 代码 段 
16 config LOCALVERSION 





17 string "Local version - append to U-Boot release" 

18 help 

ERE Append an extra string to the end of your U-Boot vers 
24 be a maximum of 64 characters. 

25 


26 config LOCALVERSION AUTO 





MONE 


27 bool "Automatically append version information to the version 


Slane, 

28 default y 

29 help 

30 This will try to automatically determine if the curr 


iie EE is a 





2i release tree by looking for git tags that belong to t 


44 which is done within the script "scripts/setlocalvers 





he current 


TOOR) 


第 16 和 26 行 ， 这 两 行 都 以 config 关键 字 开 头 ， 后 面 跟着 LOCALVERSION 和 
LOCALVERSION AUTO， 这 两 个 了 驶 是 配置 项 名 字 。 假 如 我 们 使 能 了 LOCALVERSION AUTO 





这 个 功能 ， 那 么 就 会 下 .config 文件 中 生成 CONFIG LOCALVERSION. AUTO 





， 这 个 在 上 一 小 节 


讲解 如 何 使 能 dns 命令 的 时 候 讲 过 了 。 由 此 可 知 ，.config 文件 中 的 “CONFIG xxx" (xxx 就 是 














具体 的 配置 项 名 字 ) 就 是 Kconfig 文件 中 config 关键 字 后 面 的 配置 项 名 字 加 .] 
4. 


config 关键 字 下 面 的 这 几 行 是 配置 项 属性 ，17~24 行 是 LOCALVERSION 

















上 “CONFIG ”前 


的 属性 ，27~44 fT 


是 LOCALVERSION_AUTO 的 属性 。 属 性 里 面 描述 了 配置 项 的 类 型 、 输 入 提示 、 依 赖 关系 、 才 
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助 信息 和 默认 值 等 。 

第 17 行 的 string 是 变量 类 型 , 也 就 是 “<CONFIG LOCALVERSION” 的 变量 类 型 。 可 以 为 : 
bool、tristate、string、hex 和 int， 一 共 5 种 。 最 常用 的 是 bool、tristate 和 string 这 三 种 ，bool 类 
型 有 两 种 值 : y Mn, XA y 的 时 候 表示 使 能 这 个 配置 项 ， 当 为 n 的 时 候 就 禁止 这 个 配置 项 。 
tristate 类 型 有 三 种 值 : y. m fll n, HF yM n 的 涵义 与 bool 类 型 一 样 ，m 表示 将 这 个 配置 项 编 
译 为 模块 。string 为 字符 串 类 型 ， 所 以 LOCALVERSION 是 个 字符 串 变 量 ， 用 来 存储 本 地 字符 
串 ， 选 中 以 后 即 可 输入 用 户 定 义 的 本 地 版 本 号 ， 如 图 34.2.2.4 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/temp/uboot-imx-rel_imx_4.1.15_2.1.0_ga 











Local version - append to U-Boot release 
Please enter a string value. Use the «TAB» key to moyé from the input 





图 34.22.4 本 地 版 本 号 配置 

string 后 面 的 “Local version - append to U-Boot release ”就 是 这 个 配置 项 在 图 形 界面 上 的 显 
示 出 来 的 标题 。 

第 18 fT, help 表示 帮助 信息 ， 告 诉 我 们 配置 项 的 含义 ， 当 我 们 按 下 “h” 或 “?” 弹 出 来 的 
帮助 界面 就 是 help 的 内 容 。 

第 27 行 ， 说明 “CONFIG LOCALVERSION AUTO” 是 个 bool 类 型 ， 可 以 通过 按 下 Y 或 
N 键 来 使 能 或 者 禁止 CONFIG LOCALVERSION AUTO. 

第 28 fT, "default y” 表 示 CONFIG LOCALVERSION AUTO 的 默认 值 就 是 y， 所 以 这 一 
行 默 认 会 被 选中 。 

4、depends on 和 select 

打开 arch/Kconfig 文件 ， 在 里 面 有 这 如 下 代码 : 

示例 代码 34.2.2.6 arch/Kconfig 代码 段 

7 config SYS GENERIC BOARD 











8 bool 

9 depends on HAVE GENERIC BOARD 
10 

11 choice 

212 prompt "Architecture select" 
1,3) default SANDBOX 

14 

la contig ARG 

16 bool "ARC architecture" 

y select HAVE PRIVATE LIBGCC 
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18 select HAVE GENERIC BOARD 
JL select SYS GENERIC BOARD 
20 select SUPPORT OF CONTROL 


第 9 fT," depends on ”说 明 “SYS GENERIC BOARD "项 依赖 于 HAVE GENERIC BOARD", 
也 就 是 说 “HAVE_GENERIC BOARD” 被 选中 以 后 “SYS_GENERIC _ BOARD” 才能 被 选中 。 
第 17-20 行 ,“select” 表 示 方 向 依赖 , 当选 中 “ARC” 以 后 ,“HAVE_PRIVATE LIBGCC", 
“HAVE GENERIC BOARD", *SYS GENERIC BOARD” 和 “SUPPORT OF CONTROL" 3x 
四 个 也 会 被 选中 。 
4. choice/endchoice 


在 arch/Kconfig 文件 中 有 如 下 代码 : 
示例 代码 34.2.2.7 arch/Kconfig 代码 段 

















mele ee 


312 prompt "Architecture select" 
JS] default SANDBOX 

14 

5 (exuti; ARC 

16 bool "ARC architecture" 

2m 

22 config ARM 

29 bool "ARM architecture" 

29 

SORE On JI 

Sel bool "AVR32 architecture" 

25 

36 config BLACKFIN 

93 bool "Blackfin architecture" 
40 

41 config MOSIK 

42 bool "M68000 architecture" 
117 


118 endchoice 

choice/endchoice 代码 段 定义 了 一 组 可 选择 项 ， 将 多 个 类 似 的 配置 项 组 合 在 一 起 ， 供 用 户 单 
选 或 者 多 选 。 示 例 代 码 34.2.2.7 就 是 选择 处 理 器 架构 ， 可 以 从 ARC, ARM, AVR32 等 这 些 架构 
中 选择 , 这 里 是 单 选 。 在 uboot 图 形 配置 界面 上 选择 “Architecture select", 进入 以 后 如 图 34.2.2.5 
所 示 : 
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zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/temp/uboot-imx-rel_imx_4.1.15_2.1.0_ga 


Architecture select 
Use the arrow keys to navigate this window or press the 
hotkey of the item you wish to select followed by the «SPACE 
BAR». Press «?» for additional information about this 


) ARC architecture 


RM architecture 


AVR32 architecture 


Blackfin architecture 
M68000 architecture 
MicroBlaze architecture 
+(+) 


< Help > 





34.2.2.5 架构 选择 界面 
可 以 在 图 34.2.2.5 中 通过 移动 光标 来 选择 所 使 用 的 CPU 架构 。 第 12 行 的 prompt 给 出 这 个 
choice/endchoice 段 的 提示 信息 为 “Architecture select". 





S、menuconfig 
menuconfig 和 menu 很 类 似 ， 但 是 menuconfig 是 个 带 选项 的 菜单 ， 其 一 般 用 法 为 : 
示例 代码 34.2.2.8 menuconfig 用 法 
menuconfig MODULES 
bool "菜单 " 
if MODULES 


(Qj] iE qe) je9 | [— 


endif # MODULES 
第 1 行 ， 定 义 了 一 个 可 选 的 菜单 MODULES， 只 有 选中 了 MODULES 第 3-5 47 if #l endif 
之 间 的 内 容 才 会 显示 。 在 顶层 Kconfig 中 有 如 下 代码 : 
示例 代码 34.2.2.9 顶层 Kconfig 代 码 段 
14 menu "General setup" 


74 menuconfig EXPERT 





5 bool "Configure standard U-Boot features (expert users)" 

76 default y 

EE help 

ES This option allows certain base U-Boot options and settings 
38 to be disabled or tweaked. This is for specialized 

80 environments which can tolerate a "non-standard" U-Boot. 
81 Only use this if you really know what you are doing. 

82 

83 if EXPERT 

84 config SYS MALLOC CLEAR ON INIT 

95 bool "Init with zeros the memory reserved for malloc (slow)" 
86 default y 

87 help 
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88 This setting is enabled by default. The reserved malloc 
89 memory is initialized with zeros, so first malloc calls 
98 should be replaced by calloc - if expects zeroed memory. 
99  endif 
100 endmenu # General setup 

第 74-99 行使 用 menuconfig 实现 了 一 个 菜单 ， 路 径 如 下 : 

General setup 


-> Configure standard U-Boot features (expert users) ---> 
如 图 34.2.2.6 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/temp/uboot-imx-rel_imx_4.1.15_2.1.0_ga 


General setup 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes 
features. Press «Esc»«Esc» to exit, <?> for Help, </> for Search. Legend: [*] built-in 
excluded «M» module < > module capable 


() Local version - append to U-Boot release 

[*] Automatically append version information to the version string 
[*] optimize for size 

[*] Enable malloc() pool before relocation 


< Exit» «Help» «Save» < Load > 








图 34.2.2.6 菜单 Configure standard U-Boot features (expert users) 
从 图 34.2.2.6 可 以 看 到 ,前面 有 “[]” 说 明 这 个 菜单 是 可 选 的 ， 当 选中 这 个 菜单 以 后 就 可 以 
入 到 子 选项 中 , 也 就 是 示例 代码 34.2.2.9 中 的 第 83-99 行 所 描述 的 菜单 , 如 图 34.2.2.7 Bron: 


zuozhongkai@ubuntu: -/linux/IMX6ULL/uboot/temp/uboot-imx-rel imx 4.1.15 2.1.0 ga 

















Configure standard U-Boot features (expert users) 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes 
features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in [ ] 
excluded «M» module < > module capable 


--- Configure standard U-Boot features (expert users) 


ni nit with zeros the memory reserved for malloc (slow) 


< Exit» «Help» < Save> < Load > 





图 34.2.2.7 菜单 Init with zeros the memory reserved for malloc (slow) 
如 果 不 选择 “Configure standard U-Boot features (expert users)", 那么 示例 代码 34.2.2.9 中 的 
第 83~99 行 所 描述 的 菜单 就 不 会 显示 出 来 ， 进 去 以 后 是 空白 的 。 
6. comment 
comment 用 于 注释 ， 也 就 是 在 图 形 化 界面 中 显示 一 行 注释 ， 打 开 文 件 
drivers/mtd/nand/Kconfig， 有 如 下 所 示 代 码 : 


示例 代码 34.2.2.10 drivers/mtd/nand/Kconfig 代 码 段 
74 config NAND ARASAN 
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TS bool “Configure Arasan Nand" 

76 help 

80 


81 comment "Generic NAND options" 
第 81 行使 用 comment 标注 了 一 行 注释 ， 注 释 内 容 为 :“Generic NAND options”， 这 行 注释 
在 配置 项 NAND ARASAN 的 下 面 。 在 图 形 化 配置 界面 中 按照 如 下 路 径 打开 : 
-> Device Drivers 
-> NAND Device Support 
结果 如 图 34.2.2.8 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/uboot/temp/uboot-imx-rel_imx_4.1.15_2.1.0_ga 























o 











NAND Device Support 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes 
features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in [ ] 
excluded «M» module < > module capable 


Support Denali NAND controller 
Support for Freescale NFC for VF610/MPC5125 
Support for NAND on PXA3xx and Armada 370/XP/38x 


SEXIE > < Help > < Save > < Load > 





图 34.2.2.8 注释 “Generic NAND options” 
从 图 34.2.2.8 可 以 看 出 ， 在 配置 项 “Configure Arasan Nand” 下 面 有 一 行 注释 ， 注 释 内 容 为 
“*** Generic NAND options *** ", 














"4. source 


source 用 于 读 取 男 一 个 Kconfig， 比 如 : 

source "arch/Kconfig" 

这 个 在 前 面 已 经 讲 过 了 。 

Kconfig 语法 就 讲解 到 这 里 ， 基 本 上 常用 的 语法 就 是 这 些 ， 因 为 uboot 相 比 Linux 内 核 要 小 
很 多 ， 所 以 配置 项 也 要 少 很 多 ， 所 以 建议 大 家 使 用 uboot 来 学 习 Kconfig。 一 般 不 会 修改 uboot 
中 的 Kconfig 文件 ， 甚 至 都 不 会 使 用 uboot 的 图 形 化 界面 配置 工具 ， 本 小 节 学 习 Keonfig 的 目的 
主要 还 是 为 了 Linux 内 核 作 准 备 。 


34.3 添加 自 定义 菜单 


图 形 化 配置 工具 的 主要 工作 就 是 在 .config 下 面 生 成 前 级 为 “CONFIG ”的 变量 ， 这 些 变量 
一 般 都 要 值 ， 为 y，m Ek n, f£ uboot 源码 里 面 会 根据 这 些 变量 来 决定 编译 哪个 文件 。 本 小 节 我 
们 就 来 学 习 一 下 如 何 添 加 自己 的 自 定 义 菜单 ， 自 定义 菜单 要 求 如 下 : 

(、 在 主 界面 中 添加 一 个 名 为 “My test menu”， 此 荣 单 内 部 有 一 个 配置 项 。 

©, BIB MY TESTCONFIG", 此 配置 项 处 于 菜单 “My test menu” 中 。 

(9、 配 置 项 的 为 变量 类 型 为 bool， 默 认 值 为 y。 

由、 配置 项 菜单 名 字 为 “This is my test config ”。 
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吕 、 配 置 项 的 帮助 内 容 为 “This is a empty config, just for tset! ". 
打开 顶层 Kconfig， 在 最 后 面 加 入 如 下 代码 : 
示例 代码 34.3.1 自 定 义 菜单 





menu "My test menu" 


config MY TESTCONFIG 





il 

2 

B 

2L oe Sinis abe; my reck Comrie 
5 default y 
6 help 

1i 

8 

9 


This is a empty config, just for tset! 


endmenu # my test menu 
添加 完成 以 后 打开 图 形 化 配置 界面 ， 如 图 34.3.1 所 示 : 


zuozhongkai@ubuntu: -/linux/IMX6ULL/uboot/temp/uboot-imx-rel imx 4.1.15 2.1.0 ga 


U-Boot 2016.03 Configuration 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes features. 
Press «Esc»«Esc» to exit, «?» for Help, «/» for Search. Legend: [*] built-in [ ] excluded 
«M» module < > module capable 


Architecture select (ARM architecture) ---> 
ARM architecture ---» 
General setup ---» 
Boot images ---» 
Boot timing ---» 
[ ] Console recording 
Command line interface ---> 
Device Tree Control ---» 
-*- Networking support ---> 
Device Drivers ---» 
File systems ---- 
Library routines ---» 
[] unit tests ---- 


| My test menu ---> 


< Exit > «Help» «Save» < Load > 





图 34.3.1 主 界面 
从 图 34.3.1 可 以 看 出 ， 主 菜单 最 后 面 出 现 了 一 个 名 为 “My test menu” 的 子 菜单 ， 这 个 就 是 
我 们 上 面 添 加 进来 的 子 菜单 。 进 入 此 子 菜单 ， 如 图 34.3.2 所 示 : 











My test menu 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes features. 
Press «Esc»«Esc» to exit, «?» for Help, «/» for Search. Legend: [*] built-in [ ] excluded 
«M» module < > module capable 


[*] This is my test config (NEW) 


« Exit » < Help > < Save > < Load > 





34.3.2 “My test menu” 子 菜单 
从 图 34.3.2 可 以 看 出 ， 配 置 项 添加 成 功 ， 选 中 “This is my test config” 配 置 项 ， 然 后 按 下 
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“H” 键 打开 帮助 文档 ， 如 图 34.3.3 所 示 : 











This is my test config 
CONFIG MY TESTCONFIG: 


This is a empty config, just for tset! 


Symbol: MY TESTCONFIG [=y] 
Type : boolean 
Prompt: This is my test config 
Location: 
-» My test menu 
Defined at Kconfig:244 





图 34.3.3 帮助 信息 
从 图 34.3.3 可 以 看 出 ， 帮 助 信息 也 正确 。 配 置 项 MY_TESTCONFIG 默认 也 是 被 选中 的 ， 
因此 在 .config 文件 中 肯定 会 有 “CONFIG MY_TESTCONFIG=y” 这 一 行 ， 如 图 34.3.4 所 示 : 

















T 





CONFIG MY TESTCONFIG-y 





图 34.3.4 .config 文件 
至 此 ， 我 们 在 主 菜 单 添 加 自己 的 自 定 义 菜 单 就 成 功 了 ， 以 后 大 家 如 果 去 半导体 原 厂 工作 的 
话 ， 如 果 要 编写 Linux 驱动 ， 那 么 很 有 可 能 需要 你 来 修改 甚至 编写 Kconfig 文件 。Kconfig 语法 
其 实 不 难 , 重要 的 点 就 是 34.2.2 小 节 中 的 那 几 个 , 最 主要 的 是 记 住 : Kconfig 文件 的 最 终 目 的 就 
是 在 .config 文件 中 生成 以 “CONFIG ”开头 的 变量 。 
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第 三 十 五 章 Linux 内 核 顶层 Makefile 详解 


前 几 章 我 们 重点 讲解 了 如 何 移植 uboot 到 I.MX6U-ALPHA 开发 板 上 , 从 本 章 开 始 我 们 就 开 
台 学 习 如 何 移植 Linux 内 核 E uboot 一 样 , 在 具体 移植 之 前 , 我们 先 来 学 习 一 下 Linux 内 核 的 
顶层 Makefile 文件 ， 因 为 顶层 Makefile 控制 着 Linux 内 核 的 编译 流程 。 
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35.1 Linux 内 核 获取 


关于 Linux 的 起 源 以 及 发 展 历 史 ， 这 里 就 不 哆 哑 了 ， 网 上 相关 的 介绍 太 多 了 ! 即使 号 到 这 
里 也 只 是 水 一 下 教程 页 数 而 已 ,没有 任何 实际 的 意义 有限 的 时 间 还 是 放 到 有 意义 的 事情 上 吧 ， 
Linux 由 Linux 基金 会 管理 与 发 布 ，Linux 官网 为 https://www.kernel.org， 所 以 你 想 获 取 最 新 的 
Linux 版 本 就 可 以 在 这 个 网 站 上 下 载 ， 网 站 界面 如 图 35.1.1 所 示 : 



















































































c 4) The Linux Kernel Archives xi + Uu EY a X 
~ < Cûr https://www.kernel.org 今夏 的 沙城 不 再 我 寞 "2 g5- Z= 
: The Linux Kernel Archi 
s e Linux NernelArcnlves 
=) About Contact us FAQ Releases Signatures Site news 
B 
p 
Protocol Location 
HTTP https:;//www.kerneLorg/pub/ 
GIT https://git.kerneLorg/ 
RSYNC rsync;//rsync.kerneLorg/pub/ 
mainline: 5.2-rc1 2019-05-19 [tarball] [patch] [view diff] [browse] 
stable: 5.1.4 2019-05-22 [tarball] [pgp] [patch] [inc. patch] [view diff] [browse] [changelog] 
stable: 5.0.18 2019-05-22 [tarball] [pgp] [patch] [inc. patch] [view diff] [browse] [changelog] 
longterm: 4.19.45 2019-05-22 [tarball] [pgp] [patch] [inc. patch] [view diff] [browse] [changelog] 
+ longterm: 4.14.121 2019-05-21 [tarball] [pgp] [patch] [inc. patch] [view diff] [browse] [changelog] 
longterm: 4.9.178 2019-05-21 [tarball] [pgp] [patch] [inc. patch] [view diff] [browse] [changelog] X 
二 直 怀念 高 中 和 同 桌 没 捅 破 的 爱情 ，28 岁 还 没 谈 过 恋爱 ， 父 母 为 我 . Ortze 6 QR Vy TE P a ( Q 10096 " 











图 35.1.1 linux 官网 
从 图 35.1.1 可 以 看 出 最 新 的 稳定 版 Linux 已 经 到 了 5.1.4， 大 家 没 必 要 追 新 ， 因 为 4.x 版 本 
的 Linux 和 5.x 版 本 没有 本 质 上 的 区 别 ,5.x 更 多 的 是 加 入 了 一 些 新 的 平台 、 新 的 外 设 驱 动 而 已 。 
NXP 会 从 https://www.kernel.org 下 载 某 个 版 本 的 Linux 内 核 ， 然 后 将 其 移植 到 自己 的 CPU 
上 ， 测 试 成 功 以 后 就 会 将 其 开放 给 NXP 的 CPU 开发 者 。 开 发 者 下 载 NXP 提供 的 Linux 内 核 ， 
然后 将 其 移植 到 自己 的 产品 上 。 本 章 的 移植 我 们 就 使 用 NXP 提供 的 Linux 源码 ,NXP 提供 Linux 
源码 已 经 放 到 了 开发 板 光 盘 中 ， 路 径 为 : 1、 例 程 源 码 -》4、NXP 官方 原版 Uboot 和 Linux-》 


linux-imx-rel imx 4.1.15 2.1.0 ga.tar.bz2. 


35.2 Linux 内 核 编译 初次 编译 


先 看 一 下 如 何 编译 Linux 源码 ， 这 里 编译 一 下 LMX6U-ALPHA 开发 板 移植 好 的 Linux 源 
码 ， 已 经 放 到 了 开发 板 光 盘 中 , 路 径 为 : 1、 例 程 源码 -》3、 正 点 原子 修改 后 的 Uboot 和 Linux-》 
linux-imx-4.1.15-2.1.0-g8a006db.tar.bz2。 在 Ubuntu 中 新 建 名 为 “alientek linux” 的 文件 夹 ， 然 后 
将 linux-imx-4.1.15-2.1.0-g8a006db.tar.bz2 这 个 压缩 包 找 贝 到 前 面 新 建 的 alientek. linux 文件 夹 中 
并 解压 ， 命 令 如 下 : 

tar -vxjf linux-imx-4.1.15-2.1.0-g8a006db.tar.bz2 

解压 完成 以 后 的 Linux 源码 根 目录 如 图 35.2.1 所 示 : 
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以 EMMC 核心 板 为 例 


原子 哥 在 线 教学 : www.yuanzige.com 


， 讲 解 一 下 如 何 纺 
“mx6ull alientek_emmc.sh” 的 shell 脚本 ， 然 后 在 这 个 shell 脚本 里 


$ ls 
Kbuild MAINTAINERS README 


Kconfig Makefile 


$i 
图 35.2.1 正点 原子 提供 的 Linux 源码 根 目录 




















REPORTING- 


译 出 对 应 的 Linux 镜像 文件 





BUGS 








。 新 建 名 为 








HAU P Br LER 











示例 代码 35.2.1 mx6ull alientek emmc.sh 文件 内 容 


f!/bin/sh 
make ARCH-arm 
make ARCH-arm 


make ARCH-arm 


Gi oae W ND Es 


make ARCH-arm 


CROSS | 
CROSS | 
CROSS | 


COMPILE-arm-linux-gnueabihf- 





COMPILE-arm-linux-gnueabihf- 





COMPILE-arm-linux-gnueabihf- 











E-arm-linux-gnueabihf- 





distclean 
wipe wy (leueounrig 
menuconfig 


all de 


CROSS COMPILI 


使 用 chmod 给 予 x6ull alientek emmc.sh 可 执行 权限 ， 然 后 运行 此 shell 脚本 ， 命 令 如 下 ; 
./mx6ull alientek emmc.sh 


编译 的 时 候 会 弹出 Linux 图 形 配置 界面 ， 如 图 352.3 所 示 : 


zuozhongkai@ubuntu: -/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 























Linux/arm 4.1.15 Kernel Configuration 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes features. 
«Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in [ ] excluded 
« » module capable 


ü eneral setup ---> 


[*] Enable loadable module support 


Highlighted 
Press 
<M> module 


[*] Enable the block layer 


---> 


System Type 
Bus support 


Kernel Features 
Boot options 


---> 
---> 
---> 
---> 


CPU Power Management 


---> 








Floating point emulation 
Userspace binary formats 
Power management options 
Networking support ---> 
Device Drivers ---> 
Firmware Drivers ---> 
File systems ---> 
Kernel hacking ---> 
Security options -- 
Cryptographic API ---> 
Library routines ---> 
- Virtualization 


T 


e Ex]t S < Save > < Load > 


< Help > 














图 35.2.3 Linux 图 形 配 置 界 面 
图 行 界面 配置 和 uboot 是 一 样 的 , 这 里 我 们 不 需要 做 任何 的 配置 , 直接 按 两 下 ESC 
图 形 界 面 以 后 会 自动 开始 编译 Linux。 等 待 编 译 完 成 , 完成 以 后 如 图 35.2.4 所 示 : 























Linux 的 
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zuozhongkai@ubuntu: ~/linux/IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 
[M] fs/nls/nls iso8859-15.ko 

[M] lib/crc-ccitt.ko 

[M] fs/udf/udf.ko 

[M] fs/fat/msdos .ko 

[M] lib/crc-itu-t.ko 

[M] lib/crc7.ko 

[M] lib/libcrc32c.ko 

[M] sound/core/snd-hwdep. ko 

[M] sound/core/snd-rawmidi.ko 





[M] sound/usb/snd-usbmidi-lib.ko 
[M] sound/usb/snd-usb-audio.ko 
arch/arm/boot/compressed/piggy.lzo.o 
arch/arm/boot/compressed/vmlinux 
0BJCOPY arch/arm/boot/zImage 
Kernel: arch/arm/boot/zImage is ready 


图 35.2.4 Linux 编译 完成 
编译 完成 以 后 就 会 在 arch/arm/boot 这 个 目录 下 生成 一 个 叫做 zImage 的 文件 ，zImage 就 是 
我 们 要 用 的 Linux 镜像 文件 。 另 外 也 会 在 arch/arm/boo/dts 下 生成 很 多 .dtb 文件 ， 这 些 .dtb 就 是 
设备 树 文件 。 














编译 Linux 内 核 的 时 候 可 能 会 提示 “recipe for target *'arch/arm/boot/compressed/piggy.lIzo* 
failed", 如 图 35.2.5 所 示 : 


/bin/sh: 1: lzop: not found 

arch/arm/boot/compressed/Makefile:180: recipe for target 'arch/arm/boot/compressed/piggy.lzo' failed 
make[2]: *** [arch/arm/boot/compressed/piggy.lzo] Error 1 

make[2]: *** 正在 等 待 未 完成 的 任务 ... . 





CC arch/arm/boot/compressed/misc.o 
arch/arm/boot/Makefile:52: recipe for target 'arch/arm/boot/compressed/vmlinux' failed 
make[1]: *** [arch/arm/boot/compressed/vmlinux] Error 2 
arch/arm/Makefile:316: recipe for target 'zImage' failed 


图 35.2.5 Izop 未 找到 
图 35.2.5 中 的 错误 提示 lzop 未 找到 ， 原 因 是 没有 安装 lzop 库 ， 输 入 如 下 命令 安装 lzop 库 
即 可 解决 : 
sudo apt-get install lzop 
lzop 库 安装 完成 以 后 在 重新 编译 一 下 Linux. 内 核 即 可 。 
看 一 下 编译 脚本 mx6ull alientek emmc.sh 的 内 容 ， 文 件 内 容 如 下 : 
示例 代码 35.2.1 mx6ull alientek emmc.sh 文件 内 容 



































#!/bin/sh 
make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- distclean 
ake ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- imx v7 defconfig 











CES COMO 








m 
make ARCH=arm CROSS COMPILE-arm-linux-gnueabihf- menuconfig 
make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- all -j16 
第 2 47, 执行 “make distclean”， 清理 工程， 所 以 mx6ull alientek emmc.sh 每 次 都 会 清理 一 
下 工程 。 如 果 通 过 图 形 界 面 配置 了 Linux， 但 是 还 没 保存 新 的 配置 文件 ， 那 么 就 要 慎重 使 用 
mx6ull alientek emmc.sh 编译 脚本 了 ， 因 为 它 会 把 你 的 配置 信息 都 删除 掉 ! 

第 3 行 ， 执 行 “make xxx defconfig", 配置 工程 。 

第 4 行 ， 执行 “make menuconfig” 打开 图 形 配 置 界面 ， 对 Linux 进行 配置 ， 如 果 不 想 每 次 
编译 都 打开 图 形 配 置 界面 的 话 可 以 将 这 一 行 删 除 掉 。 

第 5 行 ， 执行 “make” 编译 Linux 源码 。 

可 以 看 出 ，Linux 的 编译 过 程 基本 和 uboot 一 样 ， 痢 要 先 执 行 “make xxx_defconfig” 来 配置 
一 下 ,然后 在 执行 “make ”进行 编译 。 如果 需要 使 用 图 形 界面 配置 的 话 就 执行 “make menuconfig ". 


35.3 Linux 工程 目录 分 析 
将 正点 原子 提供 的 Linux 源码 进行 解压 ， 解 压 完 成 以 后 的 目录 如 图 35.3.1 所 示 : 
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1 vscode |] .gitignore 
T arch .mailmap 
^ block ] COPYING 
T crypto |] CREDITS 
. Documentation ] Kbuild 
T drivers Kconfig 
— firmware | linuxcode-workspace 
T fs _] MAINTAINERS 
T include ] Makefile 
- init README 
T ipc |] REPORTING-BUGS 
T kernel 
F lib 
I mm 
T net 
T samples 
T scripts 
| security 
1 sound 
T tools 
T usr 
— virt 





图 35.3.1 未 编译 的 Linux 源码 目录 
图 35.3.1 就 是 正点 原子 提供 的 未 编译 的 Linux 源码 目录 文件 ， 我 们 在 分 析 Linux 之 前 一 定 
要 先 在 Ubuntu 中 编译 一 下 Linux， 因 为 编译 过 程 会 生成 一 些 文件 ， 而 生成 的 这 些 恰恰 是 分 析 
Linux 不 可 或 缺 的 文件 。 编 译 完成 以 后 使 用 tar 压缩 命令 对 其 进行 压缩 并 使 用 Filezilla 软件 将 压 
缩 后 的 uboot 源码 拷贝 到 Windows F- 
编译 后 的 Linux 目录 如 图 35.3.2 所 示 : 






























































7 dist | | .config 
tmp_versions | | .gitignore 

T vscode | ].mailmap 

T arch [ ] missing-syscalls.d 
T block | ].tmp kallsyms1.o 
| crypto ].tmp kallsyms2.o 
T Documentation | ].tmp System.map 
| drivers | ].tmp vmlinuxt 

^ firmware | ].tmp vmlinux2 

T fs | | version 

T include [Œ].vmlinux.cmd 

T init [' COPYING 

T ipc | ] CREDITS 

T| kernel | | Kbuild 

F lib | ] Kconfig 

^ mm | ]linux.code-workspace 
T net | ] MAINTAINERS 

| samples Makefile 

T scripts Module.symvers 


B E B 





T security modules.builtin 
| sound | | modules.order 
T tools | |] mx6ull alientek emmc.sh 
^ usr | | mx6ull alientek nand.sh 
7 virt |] README 

[C] REPORTING-BUGS 

| | System.map 

| ] vmlinux 

J vmlinux.o 


L 








图 35.3.2 编译 后 的 Linux 目录 
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SE MM cipis dt uns me 
arch 架构 相关 目录 。 

block 块 设备 相关 目录 。 

crypto 加 密 相 关 目 录 。 
Documentation 文档 相关 目录 。 
drivers 驱动 相关 目录 。 
firmeare 固件 相关 目录 。 
fs 文件 系统 相关 目录 。 
include 头 文件 相关 目录 。 
init 初始 化 相关 目录 。 
ipc 进程 间 通 信 相 关 目 录 。 
7. kernel 内 核 相关 目录 。 Linux 自 带 
3m lib 库 相 关 目 录 。 
mm 内 存 管理 相关 目录 。 
net 网 络 相关 目录 。 

samples 例 程 相关 目录 。 

Scripts 脚本 相关 目录 。 

Security 安全 相关 目录 。 

sound 音频 处 理 相 关 目 录 。 

tools 工具 相关 目录 。 
与 initramfs 相关 的 目录 ， 用 于 生成 
iil initramfs 。 
virt 提供 虚拟 机 技术 (KVM)。 

.config Linux 最 终 使 用 的 配置 文件 。 编译 生成 的 文件 。 
.gitignore git 工具 相关 文件 。 a m 
.mailmap 邮件 列表 。 P 

.missing-syscalls.d 编译 生成 的 文件 
mE xi zl m 作用 目前 笔者 
n 还 不 是 很 清楚 AL DR 3 
.version 好 像 和 版 本 有 关 。 0 
.vmlinux.cmd cmd 文件 ， 用 于 连接 生成 vmlinux。 
m COPYING 版 权 声明 。 
CREDITS Linux 贡献 者 。 
Kbuild Makefile 会 读 取 此 文件 。 Vins ifs 
Kconfig 图 形 化 配置 界面 的 配置 文件 。。 
MAINTAINERS 维护 者 名 单 。 
Makefile Linux 顶层 Makefile 
e 一 系列 文件 ， 和 模块 有 关 。 编译 生成 的 文件 
modules.xx 
mx6ull alientek emmc.sh í E 
ta 正点 原子 提供 的 ，Linux 编译 脚本 。| 正点 原子 提供 
mxóull alientek nand.sh 
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README Linux 描述 文件 。 . 
Linux 自 带 
REPORTING-BUGS | BUG 上 报 指 南 

System.map 符号 表 。 

编译 出 来 的 、 KAH] ELF i 
vmlinux MEUR TREES NA 编译 生成 的 文件 

Linux 文件 

vmlinux.o 编译 出 来 的 vmlinux.o 文件 。 




















表 35.3.1 Linux 目录 
K 35.3.1 中 的 很 多 文件 夹 和 文件 我 们 都 不 需要 去 关心 ， 我 们 要 关注 的 文件 夹 或 文件 如 下 : 
1、arch 目录 
这 个 目录 是 和 架构 有 关 的 目录 ， 比 如 arm、arm64、avr32、x86 等 等 架构 。 每 种 架构 都 对 应 
一 个 目录 ， 在 这 些 目录 中 又 有 很 多 子 目 录 ， 比 如 boot、common、configs 等 等 ， 以 arch/arm 为 
例 ， 其 子 目 录 如 图 35.3.2 所 示 : 











T| boot 2019/5/25 10:44 文件 夹 
| common 2019/5/25 10:44 文件 夹 
| configs 2019/5/25 10:44 文件 夹 
T crypto 2019/5/25 10:44 文件 夹 
| firmware 2019/5/25 10:44 文件 夹 
| include 2019/5/25 10:44 文件 夹 
T kernel 2019/5/25 10:44 文件 夹 
T kvm 2019/5/25 10:44 文件 夹 
— lib 2019/5/25 10:44 文件 夹 
^ mach-alpine 2019/5/25 10:44 文件 夹 
| mach-asm9260 2019/5/25 10:44 文件 夹 
三 mach-at91 2019/5/25 10:44 文件 夹 
| mach-axxia 2019/5/25 10:44 文件 夹 


图 35.3.2 arch/arm 子 目 录 
图 35.3.2 是 arch/arm 的 一 部 分 子 目 录 ， 这 些 子 目 录用 于 控制 系统 引导 、 系 统 调用 、 动 态 调 
频 、 主 频 设置 等 。arch/arm/configs 目录 是 不 同 平台 的 默认 配置 文件 : xxx_defconfig， 如 图 35.3.3 
所 示 : 


















































到 | 回 E s|confis — x 
SGE 主页 共享 =E e 
€ ~ ^ T « linux-imx-rel imx 4.1.15 2.1.0 ga alientek > arch > arm > configs v O 搜索 "configs” p 
^ 名称 修改 日 期 类 型 大 小 ^ 
»t 快速 访问 
mcm 4 | | acs5k_defconfig 2017/5/4 17:35 文件 2KB 
ER » | ] acs5k tiny defconfig 2017/5/4 17:35 文件 2KB 
ud |. | am200epdkit defconfig 2017/5/4 17:35 文件 3 KB 
5 xi - | ] armadillo800eva defconfig 2017/5/4 17:35 文件 5 KB 
e 图 片 * |] assabet defconfig 2017/5/4 17:35 文件 2KB 
T IMX6UL ALPHZ [C] at91 dt defconfig 2017/5/4 17:35 文件 6 KB 
三 IMX6ULL MINI. |.] axm55xx defconfig 2017/5/4 17:35 文件 6 KB 
T mfgtools |. badge4 defconfig 2017/5/4 17:35 文件 3 KB 
I 开发 手册 D bcm defconfig 2017/5/4 17:35 文件 4KB 
y bcm2835 defconfiq 2017/5/4 17:35 文件 4KB 
111 个 项 目 ES 











图 35.3.3 配置 文件 
在 arch/arm/configs 中 就 包含 有 I.MX6U-ALPHA 开发 板 的 默认 配置 文件 : imx_v7_defconfig, 
执行 “make imx_v7_defconfig” 即 可 完成 配置 。arch/arm/boot/dts 目录 里 面 是 对 应 开发 平台 的 设 
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备 树 文件 ， 正 点 原子 LMX6U-ALPHA 开发 板 对 应 的 设备 树 文件 如 图 35.3.4 所 示 : 


dts = 





查看 SRILA 
LMX 6 > LMX6UL > IMX6UL NXP UBOOT And Linux > IMX6ULL > alientek linux > arch > arm > boot > dts > vO 搜索 "dts" 


^. € ` # pE 参与 创作 的 艺术 家 BHE 


Es HHAUUIT ITA auu oN Ne UUs 
已 imx6ull-14x14-ddr3-arm2-ldo.dts 

已 imx6ull-14x14-ddr3-arm2-qspi.dts 
已 imx6ull-14x14-ddr3-arm2-qspi-all.dts 
i imx6ull-14x14-ddr3-arm?2-tsc.dts 

4 imx6ull-14x14-ddr3-arm2-uart2.dts 


已 imx6ull-14x14-ddr3-arm2-usb.dts EM MC 核 心 板 对 应 的 设备 树 
imx6ull-14x14-ddr3-arm2-wm8958.dts 


g imx6ull-14x14-emmc-4.3-480x272-cdts 
i4 imx6ull-14x14-emmc-4.3-800x480-cdts 


已 imx6ull-14x14-emmc-7-800x480-c.dts 
加 imx6ull-14x14-emmc-7-1024x600-c.dts 
二 imx6ull-14x14-emmc-10.1-1280x800-c.dts 
i4 imx6ull-14x14-evk.dts 

加 imx6ull-14x14-evk-btwifi.dts 

加 imx6ull-14x14-evk-emmc.dts 

a imx6ull-14x14-evk-gpmi-weim.dts 

g imx6ull-14x14-evk-usb-certi.dts 

gs imx6ull- 14x14-nand-4.3-480x272-c.dts 
i imx6ull-14x14-nand-4.3-800x480-c.dts 
i4 imx6ull-14x14-nand-7-800x480-c.dts 





NAND 核 心 板 对 应 的 设备 树 


4 imx6ull-14x14-nand-7-1024x600-c.dts 
局 imx6ull-14x14-nand-10.1-1280x800-c.dts 
C imx6ull-pinfunc.h 








@ imx6ull-pinfunc-snvs.h 
v @ imx6ul-pinfunch 
个 项 目 450 字 节 





图 35.3.4 正点 原子 LMX6U 开发 板 对 应 的 设备 树 





arch/arm/boot 目录 下 会 保存 编译 出 来 的 Image 和 zImage 镜像 文件 ， 而 zImage 就 是 我 们 要 


用 的 linux 镜像 文件 。 





om 








2 

















arch/arm/mach-xxx 目录 分 别 为 相应 平台 的 驱动 和 初始 化 文件 ， 比 如 mach-imx 目录 里 面 就 


是 IMX 系列 CPU 的 驱动 和 初始 化 文件 。 
2. block 目录 


block 是 Linux 下 块 设 备 目录 , 像 SD F~ EMMC, NAND, 硬盘 等 存储 设备 就 
block 目录 中 存放 着 管理 块 设 备 的 相关 文件 


3. crypto 目录 











o 





crypto 目录 里 面 存放 着 加 密 文 件 ， 比 如 常见 的 cre. crc32. md4. md5. hash 等 加 密 算法 。 


4. Documentation 目录 























属于 块 设备 ， 





此 目录 里 面 存放 着 Linux 相关 的 文档 ， 如 果 要 想 了 解 Linux 某 个 功能 模块 或 驱动 架构 的 功 














anb 
CC 





就 可 以 在 Documentation 目录 中 查找 有 没有 对 应 的 文档 。 
5. drivers 目录 








驱动 目录 文件 ， 此 目录 根据 驱动 类 型 的 不 同 , 分 门 别 类 进行 整理 ， 比 如 drivers/i2c 就 是 2C 











相关 驱动 目录 ，drivers/gpio 就 是 GPIO 相关 的 驱动 目录 ， 这 是 我 们 学 习 的 重点 。 
6、firmeare 目录 

此 目录 用 于 存放 固件 
7、fs 目录 

此 目录 存放 文件 系统 ， 比 如 fs/ext2、fs/ext4、fs/f2fs 等， 分 别 是 ext2、ext4 和 





o 





2t. 
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8、include 目录 
头 文 件 目录 。 
9、init 目录 


论坛 :www.opendev.com 


此 目录 存放 Linux 内 核 启 动 的 时 候 初始 化 代码 。 





10. ipc 目录 























IPC 为 进程 间 通 信 ，ipe 目录 是 进程 间 通 信 的 具体 实现 代码 。 


11. kernel 目录 
Linux 内 核 代 码 。 
12. lib 目录 











lib 是 库 的 意思 ，lib 目录 都 是 一 些 公 用 的 库 函 。 











13, mm 目录 
此 目录 存放 内 存 管 理 相关 代码 。 
14, net 目录 

此 目录 存放 网 络 相关 代码 。 

15. samples 目录 

此 目录 存放 一 些 示 例 代码 文件 。 
16、scripts 目录 























脚本 目录 ，Linux 编译 的 时 候 会 用 到 很 多 脚本 文件 ， 这 些 脚 本 文件 就 保存 在 此 目录 中 。 











17、security 目录 
此 目录 存放 安全 相关 的 文件 。 
18、sound 目录 


T 








此 目录 存放 音频 相关 驱动 文件 ， 音 频 驱 动 文人 








19、tools 目录 























0. usr 目录 

此 目录 存放 与 initramfs 有 关 的 代码 。 
21. virt 目录 

此 目录 存放 虚拟 机 相关 文件 。 
22. .config 文件 








此 目录 存放 一 些 编译 的 时 候 使 用 到 的 工具 。 
2 


并 没有 存放 到 drivers 目录 中 ， 而 是 单独 的 目 


根 uboot 一 样 ，.config 保存 着 Linux 最 终 的 配置 信息 ， 编 译 Linux 的 时 候 会 读 取 此 文件 中 
的 配置 信息 。 最 终 根 据 配置 信息 来 选择 编译 Linux 哪些 模块 ， 哪 些 功 能 。 


23、Kbuild 文件 
有 些 Makefile 会 读 取 此 文件 。 
24、Kconfig 文件 
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图 形 化 配置 界面 的 配置 文件 。 
25. Makefile 文件 

Linux 顶层 Makefile 文件 ， 建 议 好 好 阅读 一 下 此 文 伯 
26、README 文件 

此 文件 详细 讲解 了 如 何 编译 Linux 源码 ， 以 及 Linux 源码 的 目录 信息 ， 建 议 仔细 阅读 一 下 

此 文件 。 
关于 Linux 源码 目录 就 分 析 到 这 里 ， 接 下 来 分 析 一 下 Linux 的 顶层 Makefile。 























o 











35.4 VSCode 工程 创建 








在 分 析 Linux 的 顶层 Makefile 之 前 ， 先 创建 VSCode 工程 ， 创 建 过 程 和 uboot 一 样 。 创 建 
好 以 后 将 文件 .vscode/settings.json 改 为 如 下 所 示 内 容 : 
示例 代码 35.4.1.1 settings.json 文件 内 容 























i oq 

2 "Search.exclude": f 

3 "**/node modules": true, 

4 "**/bower components": true, 
5 UC ROBUST d e, 

6 TAk E SUN true, 

7 a A EN ne ei 

8 "Documentation" :true, 

9 

10 /* 屏蔽 不 用 的 架构 相关 的 文件 */ 

al ee n/a le ee 

12 nire eure t erue, 

iS "arch/arm64":true, 

14 rase elvZ avr o2 Rer e 

15 "arch/[b-z]*":;true, 

16 "amchy/arm/plat*" true, 

J "arch/arm/mach-[a-h]*":true, 
18 "arch/arm/mach-[n-z]*":true, 
19 "arch/arm/mach-i[n-z]*":true, 
20 "arch/arm/mach-m[e-v]*":true, 
2s "arch/arm/mach-k^*":true, 

29 tareh arm mach dtu, 

28 

24 /* 屏蔽 排除 不 用 的 配置 文件 */ 

25 "arch/arm/configs/[a-ch]*":true, 
26 rarem arm eon tigo [L9] a 1| ee 
2 varem arm econ ales ato Sese Ie, 
28 torem arm contigo n ee 
29 varea rm cont gSA ro VG Erue 
30 voarem arm contigs ee 
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Sil. 

25 /* 屏蔽 掉 不 用 的 DTB 文件 */ 

33 wv ane ha oo des las en 
34 "arch/arm/boot/dts/[k-z]*":true, 
315; varem arn Hooe JES ne We be 

36 Um nm Oe Sy sane 
BF Torei arm /ln e 
38 wan el arnm Poo cles /me ee 
39 Jeneener ne AGE ne Me Ere, 
40 varech mm/ OV Se ne 
41 "arch/arm/boot/dts/imx6d*":true, 
42 "arch/arm/boot/dts/imxó6q*":true, 
43 "arch/arm/boot/dts/imxó6s*":true, 
44 "arch/arm/boot/dts/imxoul-*":true, 
45 "arch/arm/boot/dts/uimxoullb-9x9*":true, 
46 "arch/arm/boot/dts/imxoóull-14x14-ddr*":true, 
2 }, 

48 "files.exclude": { 

49 Ue ie CEUS, 

50 Dor rS Erue, 

Sal We ne ERUS 

DA A AGN tne 

55 oss ID) S Oe ey 

54 DR ONETU Co 

55 We ys DI ee ey 

56 MA ema Erue 

SW "Documentation":true, 

58 

59 /* 屏蔽 不 用 的 架构 相关 的 文件 */ 

60 "arch/alpha":true, 

61 Useless cS trus, 

62 essem o4 ste 

63 "arch/avr32":true, 

64 "arch/[b-z]*"-:true, 

65 "arch/arm/plat*":true;, 

66 "arch/arm/mach-[a-h]*":true, 

67 "arch/arm/mach- [n-z]*":true, 

68 "arch/arm/mach-i[n-z]*":true, 

69 "arch/arm/mach-m[e-v]*":true, 

O "arch/arm/mach-k*":true, 

ga varem arm mach IA RTI OP 

U2 

73 /* 屏蔽 排除 不 用 的 配置 文件 */ 
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74 Mee mmo ass nu Ite 

78 Tancian eon migs [Eyes] s M Sexe P 

76 varenia rm eoni aue sv almo US E EUS 

77 morem arn contigs In a: eue, 

78 varech arm eont lo/ TO oe 

79 voren arm eont igo d. rue 

80 

81 /* 屏蔽 掉 不 用 的 DTB 文件 */ 

82 Mme ehorm/seo Actes lann] le 

83 Tareh arm poot des [Lez | so erue, 

84 virem arm poot (ele rs Imn ne 

85 varech arn poot dts, melk u le 

86 "arch/arm/boot/dts/imx/7*'":true, 

87 Ime ln omm/ ooo el Sm ne 

88 Wen /no ne Ee 

89 wae Sm/ oo ls dms rt ey 

90 "arch/arm/boot/dts/imxod*":true, 

91 "arch/arm/boot/dts/imx6qg*":true, 

97 "amch/amm/boo//cit sux 6s ^ tue, 

93 "arch/arm/boot/dts/imx6ul-*":true, 

94 "acch/arm/boot/dts/uimxoull-9x9*"true, 
95 "arch/arm/boot/dts/imx6ull-14x14-ddr*":true, 
96 } 

er 


创建 好 VSCode 工程 以 后 就 可 以 开始 分 析 Linux 的 顶层 Makefile 了 。 


35.5 顶层 Makefile 详解 

Linux 的 顶层 Makefile 和 uboot 的 顶层 Makefile 非常 相似 , 因为 uboot 参考 了 Linux; 前 602 
行 几乎 一 样 ， 所 以 前 面部 分 我 们 大 致 看 一 下 就 行 了 。 

1、 版 本 号 


顶层 Makefile 一 开始 就 是 Linux 内 核 的 版 本 号 ， 如 下 所 示 : 
示例 代码 35.5.1 顶层 Makefile 代码 段 





1 VERSION = 4 

2 PATCHLEVEL 三 1 

3 SUBLEVEL = 15 

4 EXTRAVERSION = 
可 以 看 出 ，Linux 内 核 版 本 号 为 4.1.15。 
2. MAKEFLAGS 变量 


MAKEFLAGS 变量 设置 如 下 所 示 : 
示例 代码 35.5.2 顶层 Makefile 代码 段 
16 MAKEFLAGS += -rR --include-dirz$ (CURDIR) 


3、 命 令 输 出 
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论坛 :www.opendev.com 


Linux 编译 的 时 候 也 可 以 通过 “V=1” 来 输出 完整 的 命令 ， 


这 个 和 uboot 一 样 ， 相 关 代 码 如 


下 所 示 : 

示例 代码 35.5.3 顶层 Makefile 代码 段 
69 ifeq ("S(origin V)", "command line") 
70 KBUILD VERBOSE = $(V) 
71 endif 
72 ifndef KBUILD VERBOSE 
FES) KBUILD VERBOSE = 0 
74 endif 
75 
76 
7] | quiet = 
78 Q= 
79 else 
80  quiet-quiet 
81 Qz28Q 
82 endif 


4. BRE 
Linux 编译 的 时 候 使 用 “make -s” 就 可 实现 静默 编译 , 编译 的 时 候 就 不 会 打印 任何 的 信息 ， 


E] uboot 一 样 ， 相 关 代 码 如 下 : 
示例 代码 35.5.4. 顶层 Makefile 代码 段 









































ifeq ($ (KBUILD VERBOSE 




































































87 ifneq ($(filter 4.$,59(MAKE VERSION)),) # make-4 
88 ifneq ($(filter $s ,S(firstword x$ (MAKEFLAGS))),) 
89  quiet-silent 

90 endif 

91 else # make-3.8x 

92 ifneq ($ (filter s% -s%,$ (MAKEFLAGS)),) 

23 ë cwiet=silent 

94 endif 

95 endif 

96 





97 export quiet Q KBUILD VERBOSE 


5、 设 置 编译 结果 输出 目录 
Linux 编译 的 时 候 使 用 “O=xxx” 即 可 将 编译 产生 的 过 程 文件 输出 到 指定 的 目录 中 ， 相 关 代 
码 如 下 : 












































示例 代码 35.5.5 顶层 Makefile 代码 段 





116 ifeq ($ (KBUILD SRC),) 
111 9] 
118 # OK, Make called in directory where kernel src resides 


119 
有 EEC 
121 KBUILD OUTPUT := $ (0) 


# Do we want to locate output files in a separate directory? 


"command line") 
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122 endif 
6、 代 码 检查 
Linux 也 支持 代码 检查 ， 使 用 命令 “make C=1” 使 能 代码 检查 ， 检 查 那 些 需 要 重新 编译 的 








T 





文件 “make C=2” 用 于 检查 所 有 的 源码 文件 ， 顶 层 Makefile 中 的 代码 如 下 : 
示例 代码 35.5.6 顶层 Makefile 代码 段 

上 

173 | KBUILD CHECKSRC - $(C) 

174 endif 

175 ifndef KBUILD CHECKSRC 

1b 7/8 KBUILD CHECKSRC CS 0 

177 endif 


7、 模 块 编译 

Linux 允许 单独 编译 某 个 模块 , 使 用 命令 “make M=dir” 即 可 , 旧 语 法 “make SUBDIRS=dir” 
也 是 支持 的 。 顶 层 Makefile 中 的 代码 如 下 : 

示例 代码 35.5.7 顶层 Makefile 代码 段 

179 # Use make M=dir to specify directory of external module to build 
180 4$ Old syntax make ... SUBDIRSZSPWD is still supported 
181 4$ Setting the environment variable KBUILD EXTMOD take precedence 
182 ifdef SUBDIRS 
183  KBUILD EXTMOD ?= $(SUBDIRS) 
184 endif 
135 
186 ifeq ("S(origin M)", "command line") 
187  KBUILD EXTMOD := $(M) 
188 endif 
189 
190 $ If building an external module we do not care about the all: rule 
191 $ but instead all depend on modules 
192 PHONY -*- all 
193 ifeq ($ (KBUILD EXTMOD),) 
19/4 mug eu 


















































195 else 

loe Glle mocuüles 

197 endif 

198 

199 ifeq ($(KBUILD SRC),) 

200 # building in the source tree 

201 BNOeERES BE 

202 else 

203 ifeq ($(KBUILD SRC)/,$(dir $(CURDIR))) 
204 # building in a subdirectory of the source tree 
2/015 srctree :- 
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206 else 

207 srctree :- S$(KBUILD SRC) 

208 endif 

209 endif 

210 objtree := . 

ZHLIL pee 
21.2 1819 
DS 

214 VPATH :29 $(srctree)S(if S(KBUILD EXTMOD),:$(KBUILD EXTMOD)) 
2105 








$(srctree) 


$ (objtree) 








216 export srctree objtree VPATH 
外 部 模块 编译 过 程 和 uboot 也 一 样 ， 最 终 导出 srctree, objtree 和 VPATH 这 三 个 变量 的 值 ， 
其 中 srctree=.， 也 就 是 当前 目录 ，objtree 同样 为 “.”。 


8、 设 置 目标 架构 和 交叉 编译 器 


[E] uboot — FÉ, Linux 编译 的 时 候 需 要 设置 目标 板 架 构 ARCH 和 交叉 编译 器 CROSS_COMPILE， 
在 顶层 Makefile 中 代码 如 下 : 

示例 代码 35.5.8 顶层 Makefile 代码 段 
252 ARCE ?= S(SUBARCH) 
253 CROSS COMPILE ?= $ (CONFIG CROSS COMPILE: "%"=%) 

为 了 方便 ， 一 般 直 接 修改 顶层 Makefile 中 的 ARCH 和 CROSS COMPILE， 直 接 将 其 设置 

为 对 应 的 架构 和 编译 器 ， 比 如 本 教程 将 ARCH 设置 为 为 arm, CROSS COMPILE 设置 为 arm- 
linux-gnueabihf-， 如 下 所 示 : 

示例 代码 35.5.9 顶层 Makefile 代码 段 











































































































252 ARCH ?= arm 

253 CROSS COMPILE ?= arm-linux-gnueabihf- 
设置 好 以 后 我 们 就 可 以 使 用 如 下 命令 编译 Linux. T: 
make xxx defconfig /使 用 默认 配置 文件 配置 Linux 
make menuconfig /启动 图 形 化 配置 界面 
make -j16 /编译 Linux 


9、 调 用 scripts/Kbuild.include 文件 


同 uboot 一 样 ，Linux 顶层 Makefile 也 会 调用 文件 scripts/Kbuild.include， 顶 层 Makefile fH 
应 代码 如 下 : 
示例 代码 35.5.10 顶层 Makefile 代码 段 
348 # We need some generic definitions (do not try to remake the file). 
349 scripts/Kbuild.include: ; 
350 include scripts/Kbuild.include 


10、 交 叉 编 译 工具 变量 设置 


顶层 Makefile 中 其 他 和 交叉 编译 器 有 关 的 变 零 设置 如 下 : 
示例 代码 35.5.11 TA Æ Makefile 代码 段 























353 AS = S$(CROSS COMPILE)as 
354 LD = S$(CROSS COMPILE)ld 
355 cC = S$(CROSS COMPILE)gcc 
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356 
3:57 
358 
SB 
360 
361 
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CRE = S(CC) -E 

AR = S(CROSS COMPILE)ar 

NM = S$(CROSS COMPILE)nm 

SUME. = (CROSS COMPILE)strip 
OBJCOPY = $(CROSS COMPILE)objcopy 
OBJDUMP = $ (CROSS COMPILE)objdump 





LA. LD. CC 等 这 些 都 是 交叉 编译 器 所 使 用 的 工具 。 














HL、 头 文件 路 径 变量 
顶层 Makefile 定义 了 两 个 变量 保存 头 文件 路 径 :， USERINCLUDE 和 LINUXINCLUDE， 相 




















示例 代码 35.5.12 顶层 Makefile 代码 段 








-include $(srctree)/include/linux/kconfig.h 











must reference the include/ directory. 





关 代 码 如 下 : 

381 USERINCLUDE := \ 

2382 -I$(srctree)/arch/$(hdr-arch)/include/uapi \ 
383 -Iarch/$ (hdr-arch)/include/generated/uapi \ 
384 -I$(srctree)/include/uapi \ 

385 -Iinclude/generated/uapi \ 

386 

387 

388 # Use LINUXINCLUDE when you 

389 4 Needed to be compatible with the O= option 

390 LINUXINCLUDE := \ 

391 -IS$(srctree)/arch/$(hdr-arch)/include \ 

392 -Iarch/$ (hdr-arch)/include/generated/uapi \ 
393 -Iarch/$(hdr-arch)/include/generated \ 

394 $(if S(KBUILD SRC), -I$(srctree)/include) \ 
395 -Iinclude y 

396 $ (USERINCLUDE) 


LINUXINCLUDE 是 Linux 内 核 源码 的 头 文 件 路 径 。 























第 381-386 行 是 USERINCLUDE 是 UAPI 相关 的 头 文件 路 径 ， 第 390-396 行 是 














limi 








点 来 看 一 下 LINUXINCLUDE, Hu 








srctree=.，hdrarch=arm，KBUILD SRC 为 空 , 因此 , 将 USERINCLUDE 和 LINUXINCLUDE 展 





开 以 后 为 : 


USERINCLUDE gm 


-I/arch/arm/include/uapi ^ 


-Iarch/arm/include/generated/uapi ^ 


-I/include/uapi ^ 
-Iinclude/generated/uapi V 


-include ./include/linux/kconfig.h 


LINUXINCLUDE E 


-]./arch/arm/include \ 


-Iarch/arm/include/generated/uapi ^ 


-Iarch/arm/include/generated 
-Iinclude ^ 


\ 
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-I/arch/arm/include/uapi V 
-Iarch/arm/include/generated/uapi ^ 


-L/include/uapi \ 
-Iinclude/generated/uapi V 
-include .,/include/linux/kconfig.h 


12、 导 出 变量 
顶层 Makefile 会 导出 很 多 变量 给 子 Makefile 使 用 ， 导 出 的 这 些 变 量 如 下 : 
示例 代码 35.5.13 顶层 Makefile 代码 段 

417 export VERSION PATCHLEVEL SUBLEVEL KERNELRELEASE KERNELVERSION 
418 export ARCH SRCARCH CONFIG SHELL HOSTCC HOSTCFLAGS CROSS COMPILE AS 
LD CE 
419 export CPP AR NM STRIP OBJCOPY OBJDUMP 
420 export MAKE AWK GENKSYMS INSTALLKERNEL PERL PYTHON UTS MACHINE 
421 export HOSTCXX HOSTCXXFLAGS LDFLAGS MODULE CHECK CHECKFLAGS 
422 
423 export KBUILD CPPFLAGS NOSTDINC FLAGS LINUXINCLUDE OBJCOPYFLAGS 
LDFLAGS 
424 export KBUILD CFLAGS CFLAGS KERNEL CFLAGS MODULE CFLAGS GCOV 
CFLAGS KASAN 
425 export KBUILD AFLAGS AFLAGS KERNEL AFLAGS MODULE 
426 export KBUILD AFLAGS MODULE KBUILD CFLAGS MODULE 
KBUILD LDFLAGS MODULE 
427 export KBUILD AFLAGS KERNEL KBUILD CFLAGS KERNEL 
428 export KBUILD ARFLAGS 




































































I 

































































































































































35.5.1 make xxx defconfig 过 程 








第 一 次 编译 Linux 之 前 都 要 使 用 “make xxx. defconfig " clo & Linux 内 核 , 在 顶层 Makefile 
中 有 “%config” 这 个 目标 ， 如 下 所 示 ; 
示例 代码 35.5.1.1 顶层 Makefile 代码 段 















































490 config-targets := 0 

491 mixed-targets := 0 

492 dot-config := 1 

493 

494 ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),) 
495 ifeq (S$(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),) 
496 dor conti o= 

497 endif 

498 endif 

499 

500 ifeq ($ (KBUILD EXTMOD),) 

5O ifneq ($(filter config $config,$ (MAKECMDGOALS)),) 

502 config-targets := 1 
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503 ifneq ($(words $(MAKECMDGOALS)),1) 





504 mixed-targets := 1 

505 endif 

506 endif 

507 endif 

508 

509 ifeq ($(mixed-targets),1) 

E idu cr.rdu dd 
511 # We're called with mixed targets (*config and build targets). 
512 # Handle them one by one. 

Ls 

514 PHONY += $(MAKECMDGOALS) _ build one by one 

Elis 

516 $(filter-out _ build one by one, $ (MAKECMDGOALS)): 








. JowisLlie| one by One 








Syl Q: 

518 

519 build one by one: 

520 $(Q)set -e; ^ 

ult for i in S$(MAKECMDGOALS); do \ 

522 $ (MAKE) -f $(srctree)/Makefile SSi \ 
529 done 

524 

525 else 

526 ifeq (S$(config-targets),1) 
================================================================ 


528 4 *config targets only - make sure prerequisites are updated, and 
529 4 descend in scripts/kconfig to make the *config target 

530 

551 sr Read arch Spaclile Maketile to set KBUILD IDENBCONIIG as needed 
532 4$ KBUILD DEFCONFIG may point out an alternative default 








533 4$ configuration used for 'make defconfig' 
534 include arch/$ (SRCARCH)/Makefile 
535 export KBUILD DEFCONFIG KBUILD KCONFIG 




















596 

551 Gomnuigs Sesspts basic outputmeketile TORCE 
538 $(Q)S$(MAKE) $(build)2scripts/kconfig $@ 
599 

540 $config: scripts basic outputmakefile FORCE 
EDT S (Q) $ (MAKE) $(build)sscripts/kconfig $8 
542 

543 else 
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563 endif 4 KBUILD EXTMOD 





第 490—507 行 和 uboot 一 样 ， 都 是 设置 定义 变量 config-targets. mixed-targets 和 dot-config 
的 值 ， 最 终 这 三 个 变量 的 值 为 : 


config-targets= 1 





mixed-targets= 0 

dot-config- 1 

为 config-targets=1， 因 此 第 534 行 ~541 行 成 立 。 第 534 行 引 用 arch/arm/Makefile 这 个 文 
件 ， 这 个 文件 很 重要 ， 以 为 zzmage、ulImage 等 这 些 文件 就 是 由 arch/arm/Makefile 来 生成 的 。 

第 535 行 导出 变量 KBUILD DEFCONFIG KBUILD KCONFIG. 

第 537 行 ， 疫 有 目标 与 之 匹配 ， 因 此 不 执行 。 

第 540 ÍT, "make xxx _ defconfig” 与 目标 “%config” 匹 配 ， 因 此 执行 。“%config” 依 赖 
scripts basic. outputmakefile 和 FORCE,“%config” 真 正 有 意义 的 依赖 就 只 有 scripts basic, 
scripts basic 的 规则 如 下 : 

























































































示例 代码 35.5.1.2 顶层 Makefile 代码 段 
es en es else: 
449 $(Q)S(MAKE) $(build)sscripts/basic 
450 $(Q)rm -f .tmp quiet recordmcount 
build 定义 在 文件 scripts/Kbuild.include 中 ， 值 为 build := -f S(srctree)/scripts/Makefile.build 
obj， 因 此 将 示例 代码 35.5.1.2 展开 就 是 : 
scripts basic: 
(Q)make -f ./scripts/Makefile.build obj-scripts/basic ” // 也 可 以 没有 
@rm -f.tmp quiet recordmcount /也 可 以 没有 
接着 回 到 示例 代码 35.5.1.1 的 目标 “%config” 处 ， 内 容 如 下 : 
%config: scripts basic outputmakefile FORCE 
$(Q)$(MAKE) $(build)-scripts/kconfig $(a) 
将 命令 展开 就 是 : 
@make -f ./scripts/Makefile.build obj-scripts/kconfig xxx  defconfig 





























， 视 配置 而 定 





@ 
@ 























35.5.2 Makefile.build 脚本 分 析 


从 上 一 小 节 可 知 ,“make xxx_defconfig“ 配 置 Linux 的 时 候 如 下 两 行 命令 会 执行 脚本 
scripts/Makefile.build: 

@make -f ./scripts/Makefile.build obj-scripts/basic 

@make -f ./scripts/Makefile.build obj-scripts/kconfig xxx. defconfig 

我 们 依次 来 分 析 一 下 : 

1、scripts_basic 目标 对 应 的 命令 

scripts basic 目标 对 应 的 命令 为 : @make -f ./scripts/Makefile.build obj=scripts/basic。 打 开 文 
ft scripts/Makefile.build， 有 如 下 代码 : 

示例 代码 35.5.2.1 Makefile.build 代码 段 

41 4$ The filename Kbuild has precedence over Makefile 
de ee Sis (ee (ne) (esee) n (Snore) (sme)) 
43 kbuild-file :2 $(if $(wildcard $(kbuild-dir)/Kbuild),$ (oe 
dir)/Kbuild,$ (kbuild-dir)/Makefile) 
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44 include $(kbuild-file) 











将 kbuild-dir 展开 后 为 : 

kbuild-dir=./scripts/basic 

将 kbuild-file 展开 后 为 : 

kbuild-file= ./scripts/basic/Makefile 
最 后 将 59 行 展开 ， 即 : 

include ./scripts/basic/Makefile 

继续 分 析 scripts/Makefile.build， 如 下 代码 : 

示例 代码 35.5.2.2 Makefile.build 代码 段 

94 build: (if S(KBUILD BUILTIN),$(builtin-target) $(lib-target) 
$(extra-y)) * 











95 $(if S(KBUILD MODULES),$(obj-m) $(modorder-target)) * 
96 $(subdir-ym) S$(always) 
97] Qi: 








— build 是 默认 目标 ， 因 为 命令 “@make -f ./scripts/Makefile.build obj=scripts/basic ”没有 指 
定 目 标 ， 所 以 会 使 用 到 默认 目标 _build。 在 顶层 Makefile 中 ，KBUILD BUILTIN 为 1， 
KBUILD MODULES 为 空 ， 因 此 展开 后 目标 _build 为 : 
. build:$(builtin-target) $(lib-target) $(extra-y)) $(subdir-ym) $(always) 
@: 
可 以 看 出 目标 _build 有 5 个 依赖 : builtin-target、lib-target、extra-y、subdir-ym 和 always. 
这 5 个 依赖 的 具体 内 容 如 下 : 


builtin-target = 
























































lib-target = 
extra-y = 
subdir-ym = 
always = scripts/basic/fixdep scripts/basic/bin2c 
只 有 always 有 效 ， 因 此 _build 最 终 为 : 

. build: scripts/basic/fixdep scripts/basic/bin2c 

(Q): 

. build 依赖 于 scripts/basic/fixdep 和 scripts/basic/bin2c， 所 以 要 先 将 scripts/basic/fixdep 和 
scripts/basic/bin2c.c 这 两 个 文件 编译 成 fixdep 和 bin2c。 

综 上 所 述 ，scripts_basic 目标 的 作用 就 是 编译 出 scripts/basic/fixdep 和 scripts/basic/bin2c 这 
两 个 软件 。 

2. "config 目标 对 应 的 命令 


%config 目标 对 应 的 命令 为 : @make -f ./scripts/Makefile.build obj=scripts/kconfig 
xxx_defconfig， 此 命令 会 使 用 到 的 各 个 变量 值 如 下 : 

Src= scripts/kconfig 

kbuild-dir = ./scripts/kconfig 

kbuild-file = ./scripts/kconfig/Makefile 

include ./scripts/kconfig/Makefile 

可 以 看 出 ，Makefilke.build 会 读 取 scripts/kconfig/Makefile 中 的 内 容 ， 此 文件 有 如 下 所 示 内 



















































































X 


示例 代码 35.5.2.3 scripts/kconfig/Makefile 代码 段 
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113 $ defconfig: $(obj)/conf 
114 $(Q)S« S(silent) --defconfigsarch/$ (SRCARCH) /configs/$G 


$ (Kconfig) 
目标 %_defconfig 与 xxx defconfig 匹配 ， 所 以 会 执行 这 条 规则 ， 将 其 展开 就 是 : 
% defconfig: scripts/kconfig/conf 

















(à) scripts/kconfig/conf  --defconfig-arch/arm/configs/?o defconfig Kconfig 
96 defconfig 依赖 scripts/kconfig/conf, 所 以 会 编译 scripts/kconfig/conf.c ^E pk conf 3x 4 ERAF 
此 软件 就 会 将 % defconfig 中 的 配置 输出 到 .config 文件 中 ， 最 终生 成 Linux kernel 根 目 录 下 
的 .config 文件 。 








35.5.3 make 过 程 














使 用 命令 “makexxx defconfig” 配 置 好 Linux 内 核 以 后 就 可 以 使 用 “make” 或 者 “make all" 
命令 进行 编译 。 顶 层 Makefile 有 如 下 代码 : 
示例 代码 35.5.3.1 顶层 Makefile 代码 段 























192 PHONY tS all 

193 ifeq ($(KBUILD EXTMOD),) 
194 mg eL 

195 else 

Ss alls mocules 











608 all: vmlinux 
第 126 行 ，_ all 是 默认 目标 ， 如 果 使 用 命令 “make” 编 译 Linux 的 话 此 目标 就 会 被 匹配 。 
第 193 行 ， 如 果 KBUILD_ EXTMOD 为 空 的 话 194 行 的 代码 成 立 。 
第 194 行 ， 默 认 目 标 _all 依赖 all。 
第 608 行 ， 目 标 all 依赖 vmlinux， 所 以 接 下 来 的 重点 就 是 vmlinux ! 
顶层 Makefile 中 有 如 下 代码 : 
示例 代码 35.5.3.2 顶层 Makefile 代码 段 
904 # Externally visible symbols (used by link-vmlinux.sh) 



































905 export KBUILD VMLINUX INIT :- $(head-y) S$(init-y) 

906 export KBUILD VMLINUX MAIN :- $(core-y) $(libs-y) S$(drivers-y) 
$ (net-y) 

907 export KBUILD LDS :2 arch/$ (SRCARCH)/kernel/vmlinux.lds 





908 export LDFLAGS vmlinux 
909 4 used by scripts/pacmage/Makefile 
910 export KBUILD ALLDIRS :- $(sort $(filter-out arch/$,$(vmlinux- 











alldirs)) arch Documentation include samples scripts tools virt) 
Ot 

912 vmlinux-deps :- S(KBUILD LDS) S(KBUILD VMLINUX INIT) 

$ (KBUILD VMLINUX MAIN) 
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OFS: 

914 4$ Final link of vmlinux 

915 cmd link-vmlinux = $(CONFIG SHELL) $< $(LD) $ (LDFLAGS) 





S(LDFLAGS vmlinux) 

916 quiet cmd link-vmlinux = LINK Şe 

O7 

918 # Include targets which we want to 

919 # execute if the rest of the kernel build went well. 





920 vmlinux: scripts/link-vmlinux.sh $(vmlinux-deps) FORCE 
921 ifdef CONFIG HEADERS CHECK 
922 $(Q)S(MAKE) -f S(srctree)/Makefile headers check 
923 endif 
924 ifdef CONFIG SAMPLES 
925 $ (Q) $ (MAKE) $ (build)=samples 
926 endif 
927 ifdef CONFIG BUILD DOCSRC 
928 $ (Q) $ (MAKE) S$(build)zDocumentation 
929 endif 
930 ifdef CONFIG GDB SCRIPTS 
931 $(Q)lIn -fsn ‘cd $(srctree) && /bin/pwd' /scripts/gdb/vmlinux- 
gdb.py 
932 endif 
933 + (call if changed,link-vmlinux) 
从 第 920 行 可 以 看 出 目标 vmlinux 依赖 scripts/link-vmlinux.sh $(vmlinux-deps) FORCE. 4& 
912 行 定 义 了 vmlinux-deps， 值 为 : 
vmlinux-deps- $(KBUILD LDS)S(KBUILD VMLINUX INIT) $(KBUILD VMLINUX MAIN) 
第 905 fT, KBUILD VMLINUX INIT- $(head-y) S(init-y). 
第 906 fT, KBUILD VMLINUX MAIN = S$(core-y) $(libs-y) $(drivers-y) $(net-y). 
第 907 fT, KBUILD LDS- arch/$(SSRCARCH)/kernel/vmlinux.lds, 其 中 SRCARCH-arm, 因 
此 KBUILD LDS- arch/arm/kernel/vmlinux.lds . 
综 上 所 述 ，vmlinux 的 依赖 为 :scripts/link-vmlinux.sh、$(head-y) ~ $(init-y). $(core-y) . 
$(libs-y) ~ $(drivers-y) ~ $(net-y). arch/arm/kernel/vmlinux.lds 和 FORCE. 
第 933 行 的 命令 用 于 链接 生成 vmlinux 
重点 来 看 一 下 $S(head-y) 、$(init-y)、$(core-y) ~ $(libs-y) ~ $(drivers-y) 和 $(net-y) 这 六 个 变 
量 的 值 。 
1l. head-y 


head-y 定义 在 文件 arch/arm/Makefile 中 ， 内 容 如 下 : 
示例 代码 35.5.3.3 arch/arm/Makefile 代码 段 
135 head-y := arch/arm/kernel/head$ (MMUEXT) .o 
当 不 使 能 MMU 的 话 MMUEXT=-nommu， 如 果 使 能 MMU 的 话 为 空 ， 因 此 head-y 最 终 的 
值 为 : 
head-y = arch/arm/kernel/head.o 
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2. init-y, drivers-y 和 net-y 


在 顶层 Makefile 中 有 如 下 代码 : 
示例 代码 35.5.3.4 顶层 Makefile 代码 上段 








5509 a ey = 

So aea vie E Sy, o drivers/ sound/ firmware/ 

560 net-y = net/ 

896 init-y = $(patsubst $/, $/built-in.o, $(init-y)) 


898 drivers-y $(patsubst $/, $/built-in.o, $(drivers-y)) 
899 net-y $(patsubst $/, $/built-in.o, $(net-y)) 

从 示例 代码 35.5.3.4 T init-y. libs-y. drivers-y 和 net-y 最 终 的 值 为 : 

inity = init/built-in.o 


drivers-y = drivers/built-in.o sound/built-in.o firmware/built-in.o 
net-y = net/built-in.o 
3. libs-y 


libs-y 基本 和 init-y 一 样 ， 在 顶层 Makefile 中 存在 如 下 代码 : 
示例 代码 35.5.3.5 顶层 Makefile 代码 段 














561 libs-y := lib/ 
900 libs-yl := $ (patsubst $/, $/lib.a, $(libs-y)) 
901 libs-y2 = $(patsubst $/, $/built-in.o, $(libs-y)) 


SUP MSIE SES $(Iibs-yt) $(Iibs-y2) 
根据 示例 代码 35.5.3.5 n] AU, libs-y 应 该 等 于 “lib.abuilt-in.o”， 这 个 只 正确 了 一 部 分 ! [S7 
在 arch/arm/Makefile 中 会 向 libs-y 中 追加 一 些 值 ， 代 人 码 如 下 : 
示例 代码 35.5.3.6 arch/arm/ Makefile 代码 段 
5 L158=Yy = arch/arm/lib/ $(libs-y) 
arch/arm/Makefile 将 libs-y 的 值 改 为 了 : arch/arm/lib $(ibs-y)， 展 开 以 后 为 : 
libs-y = arch/arm/lib lib/ 
因此 根据 示例 代码 35.5.3.5 的 第 900-902 4T RI AI, libs-y 最 终 应 该 为 : 
libs-y = arch/arm/lib/lib.a lib/lib.a arch/arm/lib/built-in.o lib/built-in.o 























4. core-y 
core-y 和 init-y 也 一 样 ， 在 顶层 Makefile 中 有 如 下 代码 : 
示例 代码 35.5.3.7 顶层 Makefile 代码 段 
532 core-y := usr/ 
887 core-y += kernel/ mm/ fs/ ipc/ security/ crypto/ block/ 


但 是 在 arch/arm/Makefile 中 会 对 core-y 进行 追加 ， 代 码 如 下 : 
示例 代码 35.5.3.8 arch/arm/ Makefile 代码 段 



































269 core-S(CONFIG FPE NWFPE) += arch/arm/nwfpe/ 
27/0) exse (CONFIG F PE FASTFPE) += $ (FASTFPE OBJ) 
271 core-S$(CONFIG VEP) += arch/arm/vfp/ 
272 core-9 (CONFIG XEN) += arch/arm/xen/ 
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273 core-$(CONFIG KVM ARM HOST) += arch/arm/kvm/ 

274 core-$ (CONFIG VDSO) += arch/arm/vdso/ 

PES 


276 4 If we have a machine-specific directory, then include it in the 
lenta el 


207 Ee += arch/arm/kernel/ arch/arm/mm/ arch/arm/common/ 
278 Gouscy += arch/arm/probes/ 

279 core-y += arch/arm/net/ 

280 core-y += arch/arm/crypto/ 

20 egue-s += arch/arm/firmware/ 

282 cGore-y += $(machdirs) S$(platdirs) 





第 269-274 行 根据 不 同 的 配置 向 core-y 追加 不 同 的 值 ， 比 如 使 能 VFP 的 话 就 会 在 .config 
中 有 CONFIG VFP-y 这 一 行 ， 那 么 core-y 就 会 追加 “arch/arm/vfp/”。 
第 277~282 行 就 是 对 core-y 直接 追加 的 值 。 
在 顶层 Makefile 中 有 如 下 一 行 : 
示例 代码 35.5.3.9 顶层 Makefile 代码 段 

















897] core y g= $ (partstbst /eve boo EM (C0re=y)) 

经 过 上 述 代码 的 转换 ， 最 终 core-y 的 值 为 : 

core-y = usr/built-in.o arch/arm/vfp/built-in.o \ 
arch/arm/vdso/built-in.o arch/arm/kernel/built-in.o ^ 
arch/arm/mmy/built-in.o arch/arm/common/built-in.o V 
arch/arm/probes/built-in.o arch/arm/net/built-in.o V 
arch/arm/crypto/built-in.o arch/arm/firmware/built-in.o \ 
arch/arm/mach-imx/built-in.o kernel/built-in.oN 
mm/built-in.o fs/built-in.o V 
Ipc/built-in.o security/built-in.o V 
crypto/built-in.o block/built-in.o 














关于 head-y ~ init-y. core-y ~ libs-y ~ drivers-y 和 net-y 这 6 个 变量 就 讲解 到 这 里 。 这 些 
变量 都 是 一 些 built-in.o 或 .a 等 文件 ， 这 个 和 uboot 一 样 ， 都 是 将 相应 目录 中 的 源码 文件 进行 编 
译 ， 然 后 在 各 自 目录 下 生成 built-in.o 文件 ， 有些 生 成 了 .a 库 文 件 。 最 终 将 这 些 built-in.o 和 .a 文 
件 进行 链接 即 可 形成 ELF 格式 的 可 执行 文件 ， 也 就 是 vmlinux! 但 是 链接 是 需要 连接 脚本 的 ， 
vmlinux 的 依赖 arch/arm/kernel/vmlinux.lds 就 是 整个 Linux 的 链接 脚本 。 

示例 代码 35.5.3.2 第 933 行 的 命令 “+$(call if changed,link-vmlinux) ”表示 将 $(call 
if changed,link-vmlinux) 的 结果 作为 最 终生 成 vmlinux 的 命令 , 前 面 的 “+” 表 示 该 命令 结果 不 可 
忽略 。$(call if changed,link-vmlinux) 是 调用 函数 if_changed，link-vmlinux 是 函数 if changed 的 
参数 ， 函 数 让 changed 定义 在 文件 scripts/Kbuild.include 中 ， 如 下 所 示 : 

示例 代码 35.5.3.10 scripts/Kbuild.include 代码 段 











































































































247 if changed = $(if $(strip $(any-prereqg) $(arg-check)), N 
248 QGset -e; N 
249 $(echo-cmd) $(cmd $(1)); N 
2/51) printf '$sWMn' 'cmd $80 :- $(make-cmd)' » $(dot-target).cmd) 











any-prereq 用 于 检查 依赖 文件 是 否 有 变化 ， 如 果 依 赖 文件 有 变化 那么 any-prereq 就 不 为 
空 ， 否 则 就 为 空 。arg-check 用 于 检查 参数 是 否 有 变化 ， 如 果 没 有 变化 那么 arg-check 就 为 空 。 
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第 248 行 ,“@set -e” 告 诉 bash， 如 果 任 何 语句 的 执行 结果 不 为 true( 也 就 是 执行 出 错 ) 的 








话 就 直接 退出 。 
第 249 行 ，$(echo-cmd) 用 于 打印 命令 执行 过 程 ， 比 如 在 链接 vmlinux 的 时 候 就 会 输出 
“LINK vmlinux”. $(cmd_$(1)) 中 的 $(1) 表 示 参 数 ， 也 就 是 link-vmlinux， 因 此 $(cmd_$(1)) 表 示 
执行 cmd_link-vmlinux 的 内 容 。cmd_link-vmlinux 在 顶层 Makefile 中 有 如 下 所 示 定 义 : 
示例 代码 35.5.3.11 顶层 Makefile 代码 段 

914 £$ Final link of vmlinux 
915 cmd link-vmlinux = $(CONFIG SHELL) $< $ (LD) $ (LDFLAGS) 
S(LDFLAGS vmlinux) 
916 quiet cmd link-vmlinux - LINK SQ 

第 915 行 就 是 cmd link-vmlinux 的 值 , 其 中 CONFIG_SHELL=/bin/bash, $< 表示 目标 vmlinux 
J 第 一 个 依赖 文件 ， 根 据 示 例 代 码 示例 代码 35.5.3.2 可 知 ， 这 个 文件 为 scripts/link-vmlinux.sh。 
LD= arm-linux-gnueabihf-ld -EL，LDFLAGS 7j^*. LDFLAGS vmlinux 的 值 由 顶层 Makefile 和 
arch/arm/Makefile 这 两 个 文件 共同 决定 ， 最 终 LDFLAGS vmlinux—-p --no-undefined -X --pic- 
veneer --build-id。 因 此 cmd link-vmlinux 最 终 的 值 为 : 
cmd link-vmlinux = /bin/bash scripts/link-vmlinux.sh arm-linux-gnueabihf-ld -EL -p --no- 





x 






























































undefined -X --pic-veneer --build-id 
cmd link-vmlinux 会 调用 scripts/link-vmlinux.sh 这 个 脚本 来 链接 出 vmlinux! 在 link- 
vmlinux.sh 中 有 如 下 所 示 代 码 ; 
示例 代码 35.5.3.12 scripts/link-vmlinux.sh 代码 段 














51 vmlinux link Y() 





5S2 | 

53 local ldss"$(objtree)/S(KBUILD LDS)" 

54 

Se 

56 $(LD) S(LDFLAGS) $(LDFLAGS vmlinux) -o $(2) \ 
57 -T $(1ds) ${KBUILD VMLINUX INIT) x 

58 --start-group $(KBUILD VMLINUX MAIN) --end-group {1} 
59 else 

60 $(CC) S(CFLAGS vmlinux} -o $(2] N 
61 -Wl1,-T,$(lds) S(KBUILD VMLINUX INIT] N 
62 -Wl,--start-group N 

63 S(KBUILD VMLINUX MAIN] N 

64 -Wl,--end-group Y 

g5 -Jdiwne3tl SYLL 

66 ga =E donne 

y. spa 

ES T 


216 info LD vmlinux 
217 vmlinux link "Sd kallsymso]" vmlinmux 

vmliux link 就 是 最 终 链 接 出 vmlinux 的 函数 ， 第 55 行 判 断 SRCARCH 是 否 等 于 “um”， 如 
果 不 相 等 的 话 就 执行 56~58 行 的 代码 。 因 为 SRCARCH=arm， 因 此 条 件 成 立 ， 执 行 56~58 行 的 
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代码 。 这 三 行 代 码 就 应 该 很 熟悉 了 ! 就 是 普通 的 链接 操作 ， 连 接 脚 本 为 
lds- Jarch/arm/kernel/vmlinux.lds ， 需 要 链接 的 文件 由 变量 KBUILD VMLINUX INIT 和 


























KBUILD VMLINUX MAIN 来 决定 ， 这 两 个 变量 在 示例 代码 35.5.3.2 中 已 经 讲解 过 了 。 
第 217 行 调用 vmlinux link 函数 来 链接 出 vmlinux。 
使 用 命令 “make V=1” 编 译 Linux， 会 有 如 图 35.5.3.1 所 示 的 编译 信息 : 
+ arm-linux-gnueabihf-ld -EL -p --no-undefined -X --pic-veneer --build-id -o vmlinux -T ./arch/arm/kernel/v 


mlinux.lds arch/arm/kernel/head.o init/built-in.o --start-group usr/built-in.o arch/arm/vfp/built-in.o arch 
/arm/vdso/built-in.o arch/arm/kernel/built-in.o arch/arm/mm/built-in.o arch/arm/common/built-in.o arch/arm/ 











probes/built-in.o arch/arm/net/built-in.o arch/arm/crypto/built-in.o arch/arm/firmware/built-in.o arch/arm/ 
mach-imx/built-in.o kernel/built-in.o mm/built-in.o fs/built-in.o ipc/built-in.o security/built-in.o crypto 
/built-in.o block/built-in.o arch/arm/lib/lib.a Lib/Lib.a arch/arm/lib/built-in.o lib/built-in.o drivers/bu 
ilt-in.o sound/built-in.o firmware/built-in.o net/built-in.o --end-group .tmp kallsyms2.0 





图 35.5.3.1 link-vmlinux.sh 链接 vmlinux 过 程 
至 此 我 们 基本 理 清 了 make 的 过 程 ， 重 点 就 是 将 各 个 子 目 录 下 的 built-in.o、.a 等 文件 链接 
在 一 起 ,最 终生 成 vmlinux 这 个 ELF 格式 的 可 执行 文件 ,链接 脚本 为 arch/arm/kernel/vmlinux.lds， 
链接 过 程 是 由 shell 脚本 scripts/link-vmlinux.s 来 完成 的 。 接 下 来 的 问题 就 是 这 些 子 目录 下 的 built- 


inos a 等 文件 又 是 如 何 编译 出 来 的 呢 ? 



































35.5.4 built-in.o 文件 编译 生成 过 程 


根据 示例 代码 35.5.3.2 第 920 行 可 知 ，vmliux 依赖 vmlinux-deps， 而 vmlinux-deps- 
$(KBUILD LDS) $(KBUILD VMLINUX INIT) $(KBUILD VMLINUX MAIN), KBUILD LDS 
是 连接 脚本 , 这 里 不 考虑 , 剩 下 的 KBUILD VMLINUX INIT 和 KBUILD VMLINUX MAIN 就 
是 各 个 子 目 录 下 的 built-in.o、.a 等 文件 。 最 终 vmlinux-deps 的 值 如 下 : 











vmlinux-deps - arch/arm/kernel/vmlinux.lds arch/arm/kernel/head.o ^ 
init/built-in.o usr/built-in.o \ 
arch/arm/vfp/built-in.o arch/arm/vdso/built-in.o \ 
arch/arm/kernel/built-in.o arch/arm/mm/built-in.o \ 
arch/arm/common/built-in.o arch/arm/probes/built-in.o \ 
arch/arm/net/built-in.o arch/arm/crypto/built-in.o V 
arch/arm/firmware/built-in.o arch/arm/mach-imx/built-in.o \ 
kernel/built-in.o mmy/built-in.o V 
fs/built-in.o Ipc/built-in.o V 
security/built-in.o crypto/built-in.o' 
block/built-in.o arch/arm/lib/lib.a 
lib/lib.a arch/arm/lib/built-in.o* 
lib/built-in.o drivers/built-in.o ^ 
sound/built-in.o firmware/built-in.o V 


net/built-in.o 
除了 arch/arm/kernel/vmlinux.lds 以 外 ， 其 他 都 是 要 编译 链接 生成 的 。 在 顶层 Makefile 中 有 
如 下 代码 : 

















示例 代码 35.5.4.1 顶层 Makefile 代码 段 
OST (so en (eee) 
sort 是 排序 函数 ， 用 于 对 vmlinux-deps 的 字符 串 列表 进行 排序 ， 并 且 去 掉 重 复 的 单词 。 可 
以 看 出 vmlinux-deps 依赖 vmlinux-dirs，vmlinux-dirs 也 定义 在 顶层 Makefile F, XWF: 
示例 代码 35.5.4.2 顶层 Makefile 代码 段 
889 vmlinux-dirs se (part substa (en 
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890 S(core-y) $(core-m) $(drivers-y) S(drrvers-cm) N 
891 $(net-y) $(net-m) $(libs-y) S$(libs-m))) 





vmlinux-dirs 看 名 字 就 知道 和 目录 有 关 ， 此 变量 保存 着 生成 vmlinux 所 需 源码 文件 的 目录 ， 
值 如 下 : 























vmlinux-dirs = init usr arch/arm/vfp \ 
arch/arm/vdso arch/arm/kernel arch/arm/mm V 
arch/arm/common  arch/arm/probes arch/arm/net V 
arch/arm/crypto — arch/arm/firmware arch/arm/mach-imxV 
kernel mm fs \ 
ipc Security crypto \ 
block drivers sound \ 
firmware net arch/arm/lib \ 
lib 














在 顶层 Makefile 中 有 如 下 代码 : 
示例 代码 35.5.4.3 顶层 Makefile 代码 段 

946 $(vmlinux-dirs): prepare scripts 
EG m $ (Q) S (MAKE) $(build)-$Q 

目标 vmlinux-dirs 依赖 prepare 和 scripts， 这 两 个 依赖 不 去 浪费 时 间 了 ， 重 点 看 一 下 第 947 
行 的 命令 。build 前 面 已 经 说 了 ， 值 为 “-f./scripts/Makefile.build obj ”， 因 此 将 947 行 的 命令 展开 
就 是 : 

@ make -f ./scripts/Makefile.build obj=$@ 

$@ 表 示 目 标 文件 ， 也 就 是 vmlinux-dirs 的 值 ， 将 vmlinux-dirs 中 的 这 些 目录 全 部 带 入 到 命 
令 中 ， 结 果 如 下 : 

@ make -f ./scripts/Makefile.build obj=init 

@ make -f ./scripts/Makefile.build obj=usr 

@ make -f ./scripts/Makefile.build obj=arch/arm/vfp 

@ make -f ./scripts/Makefile.build obj=arch/arm/vdso 

@ make -f ./scripts/Makefile.build obj=arch/arm/kernel 

@ make -f ./scripts/Makefile.build obj=arch/arm/mm 

@ make -f ./scripts/Makefile.build obj=arch/arm/common 

@ make -f ./scripts/Makefile.build obj=arch/arm/probes 

@ make -f ./scripts/Makefile.build obj=arch/arm/net 

@ make -f ./scripts/Makefile.build obj=arch/arm/crypto 

@ make -f ./scripts/Makefile.build obj=arch/arm/firmware 

@ make -f ./scripts/Makefile.build obj=arch/arm/mach-imx 

@ make -f ./scripts/Makefile.build obj=kernel 

@ make -f ./scripts/Makefile.build obj=mm 

@ make -f ./scripts/Makefile.build obj=fs 

@ make -f ./scripts/Makefile.build obj=ipc 

@ make -f ./scripts/Makefile.build obj=security 

@ make -f ./scripts/Makefile.build obj=crypto 

@ make -f ./scripts/Makefile.build obj=block 

@ make -f ./scripts/Makefile.build obj=drivers 

















limi 
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@ make -f /scripts/Makefile.build obj=sound 
@ make -f ./scripts/Makefile.build obj-firmware 
@ make -f ./scripts/Makefile.build obj-net 
@ make -f /scripts/Makefile.build obj-arch/arm/lib 
@ make -f /scripts/Makefile.build obj=lib 
这 些 命令 运行 过 程 其 实 都 是 一 样 的 ， 我 们 就 以 “@ make -f /scripts/Makefile.build obj-init" 





这 个 命令 为 例 ， 讲 解 一 下 详细 的 运行 过 程 。 这 里 又 要 用 到 Makefile.build 这 个 脚本 了 ， 此 脚本 默 
认 目 标 为 _build， 这 个 在 35.5.2 小 节 已 经 讲 过 了 , 我们 再 来 看 一 下 ，_build 目标 对 应 的 规则 如 
下 : 









































示例 代码 35.5.4.4 scripts/Makefile.build 代码 段 
94 build: $(if S(KBUILD BUILTIN),$(builtin-target) $(lib-target) 
$(extra-y)) N 
95  $(if S(KBUILD MODULES),$(obj-m) $(modorder-target)) wN 
96 $(subdir-ym) $(always) 
9 (8 








当 只 编译 Linux 内 核 镜像 文件 ， 也 就 是 使 用 “make zImage ”编译 的 时 候 ， 
KBUILD BUILTIN-1, KBUILD MODULES 为 空 “make” 命 令 是 会 编译 所 有 的 东西 ,包括 Linux 
内 核 镜像 文件 和 一 些 模 块 文件 。 如 果 只 编译 Linux 内 核 镜像 的 话 ，_build 目标 简化 为 : 
. build: $(builtin-target) $(lib-target) $(extra-y)) $(subdir-ym) $(always) 
(Q): 
重点 来 看 一 下 builtin-target 这 个 依赖 ，builtin-target 同样 定义 在 文件 scripts/Makefile.build 
中 ， 定 义 如 下 : 















































示例 代码 35.5.4.5 scripts/Makefile.build 代码 段 

86 ifneq ($(strip $(obj-y) $(obj-m) $(obj-) $(subdir-m) S$(lib- 
target)),) 
87 builtin-target s3 $(obj)/built-in.o 
88 endif 

第 87 行 就 是 builtin-target 变量 的 值 , 73^ $(obj)/built-in.o ", 这 就 是 这 些 built-in.o 的 来 源 了 。 
要 生成 built-in.o， 要 求 obj-y、obj-m、obj-、subdir-m 和 lib-target 这 些 变量 不 能 全 部 为 空 。 最 后 
一 个 问题 : built-in.o 是 怎么 生成 的 ?在 文件 scripts/Makefile.build 中 有 如 下 代码 : 

示例 代码 35.5.4.6 顶层 Makefile 代码 段 























DNE 

326 4$ Rule to compile a set of .o files into one .o file 
327 d 

328 ifdef builtin-target 

325) quiet cuudl link © target = LD SR 





330 4$ If the list of objects to link is empty, just create an empty 
loea. Lie —acim 5 
331 cmd link o target = $(if $(strip $(obj-y)),WN 


So SUD) (el flage) -r -~o $8 (filtrer 9(9j-y),; 9^9) 
EEG $(cmd secanalysis),N 

334 rm -f $0; $(AR) rcs$ (KBUILD ARFLAGS) $8) 

299 


926 


LMX6U S XR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
336 S(builtin-target): $(obj-y) FORCE 
93" $(call if changed,link o target) 
296 
339 targets t= $(builtin-target) 
340 endif # builtin-target 

第 336 行 的 目标 就 是 builtin-target, 依赖 为 obj-y, 命令 为 “$(callif changed,link o target) "; 














也 就 是 调用 函数 if changed， 参 数 为 link o target， 其 返回 值 就 是 具体 的 命令 。 前 面 讲 过 了 
if changed， 它 会 调用 cmd_$(1) 所 对 应 的 命令 ($(1) 就 是 函数 的 第 1 个 参数 )， 在 在 这 里 就 是 调用 
cmd link o target 所 对 应 的 命令 ， 也 就 是 第 331~334 行 的 命令 。cmd link o target 就 是 使 用 LD 
将 某 个 目录 下 的 所 有 .o 文件 链接 在 一 起 ， 最 终 形 成 built-in.o。 






































35.5.5 make zImage 过 程 


1. vmlinux, Image, zlmage. ulmage 的 区 别 


前 面 几 小 节 重 点 是 讲 vmlinux 是 如 何 编译 出 来 的 ，vmlinux 是 ELF 格式 的 文件 ， 但 是 在 实 
际 中 我 们 不 会 使 用 vmlinux， 而 是 使 用 zImage 或 ulmage 这 样 的 Linux 内 核 镜 像 文件 。 那 么 
vmlinux、zImage、ulmage 他 们 之 间 有 什么 区 别 呢 ? 

©, vmlinux 是 编译 出 来 的 最 原始 的 内 核 文件 ， 是 未 压缩 的 ， 比 如 正点 原子 提供 的 Linux 源 
码 编译 出 来 的 vmlinux 差不多 有 16MB， 如 图 35.5.5.1 所 示 : 


d. E: vmlinux -l 





























-rwxrwxr-x 1 zihano zuozhongkai 16770053 Sep 3 01: 


图 35.5.5.1 vmlinux 信息 
©, Image 是 Linux 内 核 镜 像 文件 ， 但 是 Image 仅 包含 可 执行 的 二 进 制 数据 。Imasge 就 是 使 
用 objcopy 取消 挤 vmlinux 中 的 一 些 其 他 信息 ， 比 如 符号 表 什 么 的 。 但 是 Image 是 没有 压缩 过 
HJ, Image 保存 在 arch/arm/boot 目录 下 ， 其 大 小 大 概 在 12MB 左右 如 图 35.5.5.2 所 示 : 


$ ls arch/arm/boot/Image -l 

































































-rwxrwxr-x 1 zuozhongkai zuozhongkai 12541952 Sep 3 01: M 








图 35.5.5.2 Image "TT dl 

THEE vmlinux 的 16MB, Image 缩小 到 了 12MB. 

©, zlmage 是 经 过 gzip 压缩 后 的 Image， 经 过 压缩 以 后 其 大 小 大 概 在 6MB 左右 ， 如 图 
35.5.5.3 所 示 : 




















$ ls arch/arm/boot/zImage -l 





-rwxrwxr-x 1 zuozhongkai zuozhongkai 6696768 Sep 3 01:44 
: $ 


图 35.5.5.3 zImage 镜像 信息 
©, umage 是 老 版 本 uboot 专用 的 镜像 文件 ，uImag 是 在 zImage 前 面 加 了 一 个 长 度 为 64 
































FWA ER”, 这 个 头 信 息 描述 了 该 镜像 文件 的 类 型 、 加 载 位 置 、 生 成 时 间 、 大 小 等 信息 。 但 是 
新 的 uboot 已 经 文 持 了 zImage 启动 ! 所 以 已 经 很 少 用 到 umage 了 ,除非 你 用 的 很 古老 的 uboot。 
使 用 “make”“make all". “make zImage ”这 些 命令 就 可 以 编译 出 zImage 镜像 ， 在 
arch/arm/Makefile 中 有 如 下 代码 : 
示例 代码 35.5.5.1 顶层 Makefile 代码 段 
310 BOOT TARGETS = zImage Image xiplImage bootpImage ulmage 





























315 $(BOOT TARGETS): vmlinux 
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$ (Q) $ (MAKE) $ (build)=$ (boot) 





第 315 fJ, BOOT TARGETS 依赖 vmlinux, 
核 的 话 ， 首 先 肯 定 要 先 编译 出 vmlinux. 
第 316 行 ， 具体 的 命令 ， 比 如 要 编译 zlImage， 那 么 命令 展开 以 后 如 下 所 示 : 

@ make -f ./scripts/Makefile.build obj=arch/arm/boot MACHINE-arch/arm/boot/zImage 
看 来 又 是 使 用 scripts/Makefile.build 文件 来 完成 vmliux 到 zImage 的 转换 。 

关于 Linux 顶层 Makefile 就 讲解 到 这 里 ， 基 本 和 uboot 的 顶层 Makefile 一 样 ， 重 点 在 于 
vmlinux 的 生成 。 最 后 将 vmlinux 压缩 成 我 们 最 常用 的 zImage 或 uImage 等 文件 。 
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MACHINE-$ (MACHINE) $(boot)/$8 
第 310 行 ， 变 量 BOOT TARGETS 包含 zImage, Image, xiplmage 等 镜像 文件 。 














因此 如 果 使 用 “make zImage ”编译 的 Linux 内 
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第 三 十 六 章 Linux 内 核 启 动 流程 


看 完 Linux 内 核 的 顶层 Makefile 以 后 再 来 看 Linux. 内 核 的 大 致 启动 流程 ，Linux 内 核 的 启 
动 流程 要 比 uboot 复杂 的 多 ， 涉 及 到 的 内 容 也 更 多 ， 因 此 本 章 我 们 就 大 致 的 了 解 一 下 Linux 内 
核 的 启动 流程 。 
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36.1 链接 脚本 vmlinux.lds 
要 分 析 Linux 启动 流程 ， 同 样 需要 先 编译 一 下 Linux 源码 ， 因 为 有 很 多 文件 是 需要 编译 才 











会 生成 的 。 首先 分 析 Linux 内 核 的 连接 脚本 文件 arch/arm/kernel/vmlinux.lds, 通过 链接 脚本 可 以 
找到 Linux 内 核 的 第 一 行程 序 是 从 哪里 执行 的 。vmlinux.lds 中 有 如 下 代码 : 
示例 代码 36.1.1 vmlinux.lds 链接 脚本 











492 OUTPUT ARCH (arm) 
493 ENTRY (stext) 

















494 jiffies = jiffies 64; 

495 SECTIONS 

496 ( 

7 

498 * XXX: The linker does not define how output sections are 

499 * assigned to input sections when there are multiple statements 
500 * matching the same input section name. There is no documented 
501 * order of matching. 

502 bi 

503 * unwind exit sections must be discarded before the rest of the 
504 * unwind sections get included. 

505 Auf 

506 /DISCARD/ : ( 

E *(.ARM.exidx.exit.text) 

508 *(.ARM.extab.exit.text) 

509 

645 } 


第 493 行 的 ENTRY 指明 了 了 Linux 内 核 入 口 ， 入 口 为 stext, stext 定义 在 文件 
arch/arm/kernel/head.S 中 ， 因 此 要 分 析 Linux 内 核 的 启动 流程 ， 就 得 先 从 文件 
arch/arm/kernel/head.S 的 stext 处 开始 分 析 。 


36.2 Linux 内 核 启动 流程 分 析 


36.2.1 Linux 内 核 入 口 stext 

















stext 是 Linux 内 核 的 入 口 地 址 ， 在 文件 arch/arm/kernel/head.S 中 有 如 下 所 示 提 示 内 容 : 
示例 代码 36.2.1.1 arch/arm/kernel/head.S 代码 段 





/* 


* Kernel startup entry point. 





* This is normally called from the decompressor code. The requirements 
* are: MMU - off, D-cache - off, I-cache - dont care, r0 - O0, 
** cel e machine joues x62) aa (Ge dE POTESSE: 
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n 
根据 示例 代码 36.2.1.1 中 的 注释 ，Linux 内 核 启 动 之 前 要 求 如 下 : 





(QD. XH] MMU. 

©, JH] D-cache. 

(8)、I-Cache 无 所 谓 。 

(D. r0-0. 

©, rl-machine nr( 也 就 是 机 器 ID). 

©, r2-atags 或 者 设备 树 (dtb) 首 地 址 。 

Linux 内 核 的 入 口 点 stext 其 实 相当 于 内 核 的 入 口 函数 ，stext 函数 内 容 如 下 : 
示例 代码 36.2.1.2 arch/arm/kernel/head.S 代码 段 





80 ENTRY(stext) 





91 Q ensure svc mode and all interrupts masked 

D safe svcmode maskall r9 

DS 

94 ne pb, 0, xS, e, e Q get processor id 

95 bl . lookup processor type Q r5zprocinfo r9=cpuid 

96 movs c1. 5 @ invalid processor (r5z0)? 

97  THUMB( it eq) Q force fixup-able long branch encoding 
98 beg _ error p @ yes, error 'p' 

99 

TO 














108 fifndef CONFIG XIP KERNEL 








113 £else 

114 ldr r8, zPLAT PHYS OFFSET Q always constant in this case 
115 £endif 

116 

机 

118 + rni = machine no, r2 - atags Oor datb, 

TTS = moi = paye GOxcisxe, 29 = Cowie SLO ee 

120 ur 

112231 bil vet atags 

128 bl . create page tables 

129 

SU f 

ISi * The following calls CPU specific code in a position independent 
T32 * manner. See arch/arm/mm/proc-*.S for details. r10 - base of 
HESS E senex Oro Imro ee elle oy lookki JOOGSSION IS 


134 * above. On return, the CPU will be ready for the MMU to be 
1S1) * turned on, and r0 will hold the CPU control register value. 
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1S6 el 

MEN ldr r13, = mmap switched Q address to jump to after 
3158 Q mmu has been enabled 

139 adr l5, BSM (IEN) @ return (PIC) address 

140 mov r8, r4 @ set TTBRI to swapper pg dir 

141 idr r12, [r10, £$PROCINFO INITFUNC] 

142 acel x12, sed2, se 

143 ret r2 

144 l8 19 _ eneble mmu 

145 ENDPROC (stext) 





第 92 行 ， 调 用 函数 safe svcmode maskall # 











角 保 CPU 处 于 SVC 模式 ， 并 且 关 闭 了 所 有 的 中 











Wro safe svcmode maskall 定义 在 文件 arch/arm/include/asm/assembler.h 中 。 


第 94 行 ， 读 处 理 器 ID，ID 值 保存 在 r9 寄存 器 中 。 








第 95 行 ， 调 月 
获取 procinfo 信 


函数 lookup processor type 检查 当前 系统 是 否 支 持 此 CPU， 如 果 文 持 的 就 
A. procinfo 是 proc info list 类 型 的 结构 体 ， proc info list 在 文件 





arch/arm/include/asm/procinfo.h 中 的 定义 如 下 : 


示例 代码 36.2.1.3 proc_info_list 结构 体 


/* used by head.S */ 








Steuer Proc taro list d 
unsigned int Cow» wells 
unsigned int cpu mask; 
unsigned long cpu mm mmu flags; 
unsigned long . cpu io mmu flags; 
unsigned long . Got Slushy 


Const Cher *arch name; 


Conse weli meus 
unsigned int elf hwcap; 


(metae JEON MEME k 


Srcoce PrOCES SSON ZLOG, 
grruet Gou wilg ng oediog 

sreuct GPU ser irme Eee 
struct GOU Cache tne Cache; 


bg 


/* used by head.S */ 
/* used by head.S */ 


Linux 内 核 将 每 种 处 理 器 都 抽象 为 一 个 proc info list 结构 体 ， 每 种 处 理 器 都 对 应 一 个 


因此 可 以 通过 处 理 器 ID 来 找到 对 应 的 





procinfo. 


procinfo Z5 Tj, ^ lookup processor type 函数 找 


到 对 应 处 理 器 的 procinfo 以 后 会 将 其 保存 到 r5 寄存 器 中 。 

















继续 回 到 示例 


代码 36.2.1.2 rh, 第 121 行 ， 调 用 函数 _vet_atags 验证 atags 或 设备 树 (dtb) 的 








PATE. BER vet atags 定义 在 文件 arch/arm/kernel/head-common.S 中 。 
第 128 行 ， 调 用 函数 create page tables 创建 页 表 。 








第 137 行 , 将 








函数 “mmap_switched 的 地 址 保存 到 r13 寄存 器 中 。 mmap switched 定义 在 


文件 arch/arm/kernel/head-common.S, _ mmap switched 最 终 会 调用 start kernel 函数 。 


第 144 行 ， 





调用 enable mmu 函数 使 能 MMU, _ enable mmu 定义 在 文件 





arch/arm/kernel/head.S 中 。 _ enable mmu 最 终 会 通过 调用 _tur mmu on 来 打开 MMU, 


. turn mmu on 最 


后 会 执行 r13 里 面 保存 的 _mmap_switched 函数 。 
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36.2.2 mmap switched 函数 


. mmap switched 函数 定义 在 文件 arch/arm/kernel/head-common.S 中 ， 函 数 代码 如 下 : 
示例 代码 36.2.2.1 _mmap_switched 函数 


81 . mmap switched: 

82 adr r3, | mmap switched data 

83 

84 Tomio ses Ted. seb seo. Yep 

85 cmp rA S @ Copy data segment if needed 
sis die ewone o MTS 

87 ldrne fp, [r4], #4 

88 strme Ee Irol se 

89 bne 1b 

90 

91 mov fp, 40 Q Clear BSS (and zero fp) 
92 dg duo uxo, i 

9S exces die, [61b 

94 Decre 

95 


96 ARM( emeei — 3:95 qu. x9. 6. fU. SS) 
97] TRAUME lohaia — xS, (ud, zy s, Up ) 





98 MTAHUMB( idr SPP EESTI] ) 

99 Ste CO eA] @ Save processor ID 

100 eree rls @ Save machine type 

MOK eng 352, [il Q Save atags pointer 

102 cmp r7, #0 

OS srama 207 IA] @ Save control register values 
104 b ç  etart kernel 


105 ENDPROC( mmap switched) 
第 104 行 最 终 调 用 start. kernel 来 启动 Linux TZ, start kernel 函数 定义 在 文件 init/main.c 








中 。 


36.2.3 start kernel 函数 


start kernel 通过 调用 众多 的 子 函 数 来 完成 Linux 启动 之 前 的 一 些 初始 化 工作 ， 由 于 
start kernel 函数 里 面 调 用 的 子 函数 太 多 ， 而 这 些 子 函数 又 很 复杂 ， 因 此 我 们 简单 的 来 看 一 下 一 
些 重要 的 子 函数 。 精 简 并 添加 注释 后 的 start. kernel 函数 内 容 如 下 : 

示例 代码 36.2.3.1 start_kernel 函数 
asmlinkage een start kernel (void) 


{ 

















cher ona lie 


Chen veru ee nesy 


lockdep init(); /* lockdep 是 死 锁 检 测 模块 ， 此 函数 会 初始 化 
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* 两 个 hash 表 。 此 函数 要 求 尽 可 能 早 的 执行 ! 
in 
set task stack end magic(&init task);/* 设置 任务 栈 结束 魔术 数 ， 
* 用 于 栈 溢出 检测 
m 
smp setup processor id();  /* 跟 SMP 有关 ( 多 核 处 理 器 ) ， 设 置 处 理 器 ID. 
* 有 很 多 资料 说 ARM 架构 下 此 函数 为 空 函数 ， 那 是 因 
为 他 们 用 的 老 版 本 Linux， 而 那 时 候 ARM 还 没有 多 
* 核 处 理 器 。 
«y 
debug objects early init(); /* 做 一 些 和 debug 有 关 的 初始 化 */ 
boot init stack canary(); /* 栈 溢出 检测 初始 化 */ 
cgroup init early(); /* cgroup 初始 化 ，cgroup 用 于 控制 Linux 系统 资源 */ 
local irq disable(); /* 关闭 当前 CBU Hii */ 
early boot irqs disabled = true; 


* 





js 

* 中 断 关 闭 期 间 做 一 些 重要 的 操作 ， 然 后 打开 中 断 

= 

boot _ cpu _init(); /* ER CPU 有关 的 初始 化 */ 
page address init(); /* 页 地 址 相关 的 初始 化 */ 


pr notice("$s", linux banner);/* 打印 Linux 版 本 号 、 编 译 时 间 等 信息 */ 
setup arch(&command line); /* 架构 相关 的 初始 化 ， 此 函数 会 解析 传递 进来 的 
* ATAGS 或 者 设备 树 (DTB) 文件 。 会 根据 设备 树 
* 的 model 和 compatible 这 两 个 属性 值 来 查找 
* Linux 是 否 支 持 这 个 单 板 。 此 函数 也 会 获取 设备 树 
* 中 chosen 节点 下 的 bootargs 属性 值 来 得 到 命令 
* 行 参数 ， 也 就 是 upoot 中 的 bootargs 环境 变量 的 
* 值 ， 获 取 到 的 命令 行 参数 会 保存 到 
*command line 中 。 
n 
mm init cpumask(&init mm);  /* 看 名 字 ， 应 该 是 和 内 存 有 关 的 初始 化 */ 
setup command line(command line);  /* 好 像 是 存储 命令 行 参数 */ 
setup nr cpu ids(); /* 如 果 只 是 SMP (多 核 CPU) 的 话 ， 此 函数 用 于 获取 
* CPU 核心 数量 ，CPU 数量 保存 在 变量 
= mie Go ES 中 。 
"f 
setup per cpu areas(); /* Œ SMP 系统 中 有 有 用， 设置 每 个 CPU per-cpu 数据 */ 


smp prepare boot cpu(); 


Z 


Hl 





TH 






































build all zonelists (NULL, NULL); /* 建立 系统 内 存 页 区 (zone) 链表 */ 
page alloc init(); /* 处 理 用 于 热 插 拔 CPU 的 页 */ 
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/* dTHIdp m fT */ 
pr aotice( "Kernel command line: San boot command line); 
parse early param(); /* 解析 命令 行 中 的 console 参数 */ 
after dashes S parse arge (VBOOTing kerneli, 


static command line, _ start č param, 
. EGO js9seussun — Mstar iparon; 
-1, -1, &unknown bootoption); 

if (!IS ERR OR NULL(after dashes)) 





[paie susge(("Settime ium el nh, O, —ly lp 


set init arg)? 
Jumo label imir (D) p 


setup log buf(0); /* WE log 使 用 的 缓冲 区 */ 

pidhash init(); /* WÈ PIDEAK, Linux 中 每 个 进程 都 有 一 个 ID， 
* 这 个 ID 叫做 PID。 通 过 构建 哈 希 表 可 以 快速 搜索 进程 
* 信息 结构 体 。 








本 
vfs caches init early(); /* 预先 初始 化 vts (虚拟 文件 系统 ) 的 目录 项 和 
* 索引 节点 缓存 
my 
sort main extable(); /* 定义 内 核 异常 列表 / 
trap init h) e /* 完成 对 系统 保留 中 断 向 量 的 初始 化 */ 
mm init(); /* 内 存 管理 初始 化 */ 
schedcinit() /* 初始 化 调度 器 ， 主 要 是 初始 化 一 些 结构 体 */ 
preempt disable(); /* 关闭 优先 级 抢占 */ 


if (WARN(!irgs disabled(),  /* 检查 中 断 是 否 关 闭 ， 如 果 没 有 的 话 就 关闭 中 断 */ 


"Interrupts wer nabled *very* early, fixing it\n")) 





local irg disable (>; 


idr init cache(); /* IDR 初始 化 ，IDR 是 Linux 内 核 的 整数 管理 机 
* 制 ， 也 就 是 将 一 个 整数 ID 与 一 个 指针 关联 起 来 。 
"i 


rcu init(); /* 初始 化 RCU，RCU 全 称 为 Read Copy Update ( 读 -拷贝 修改 ) */ 
trace init(); /* 跟踪 调试 相关 初始 化 */ 


Context tracking imiti)? 


radix tree init(); /* 基数 树 相 关 数 据 结构 初始 化 */ 

early irq init(); /* 初始 中 断 相 关 初 始 化 , 主要 是 注册 irg desc 结构 体 变 
* 量 ， 因 为 Linux 内 核 使 用 irq desc 来 描述 一 个 中 断 。 
v 

init IROQ)? /* 中 断 初始 化 */ 

tick imith) y /* tick We 
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reu init nonz (() p 
init timers(); /* 初始 化 定时 器 */ 
hrtimers init(); /* 初始 化 高 精度 定时 器 */ 
softirq init(); /* 软 中 断 初始 化 */ 
timekeeping init(); 
time init(); /* 初始 化 系统 时 间 */ 


Slelneleeloe me tee (> 
perit event inmane (Qj 
prorile init); 

call tuncetiom inmubte (0) p 


WARN(!irqs disabled(), "Interrupts wer nabled earlyNn"); 








early boot iras chissisieo = 5alse; 


local irq enable (); /* 使 能 中 断 */ 


kmem cache init late(); /* slab 初始 化 ，slab Æ Linux 内 存 分 配器 */ 
console init(); /* 初始 化 控制 台 ， 之 前 printk 打印 的 信息 都 存放 
缓冲 区 中 ， 并 没有 打印 出 来 。 只 有 调用 此 函数 
初始 化 控制 台 以 后 才能 在 控制 台 上 打印 信息 。 


* 





x* 


ay 
de (panie larer) 
pemi (Hiogo meny DOGE Se vars cnt GS", jeune later, 


panic param); 


lockdep info();/* 如 果 定 义 了 宏 CONFIG LOCKDEP， 那 么 此 函数 打印 一 些 信息 。*/ 





locking selftest() /* 锁 自 测 */ 
peage ext umane (7 
debug objects mem init(); 
kmemleak init(); /* kmemleak 初始 化 ，kmemleak 用 于 检查 内 存 泄漏 */ 
setup per Cpu pegeset (h)? 
numa policy init(); 
sus (late time init) 
late time imir) p 
sehed Clock init); 
calibrate delay); /* 测定 BogoMIPS 值 ， 可 以 通过 BogoMIPS 来 判断 CPU 的 性 能 
* BogoMIPS 设置 越 大 ， 说 明 CPU 性 能 越 好 。 





wh 
pidmap init(); /* PID 位 图 初始 化 */ 
anon vma init(); /* Æ anon vma slab ZH */ 


acpi early imir)? 


threat into cache Imith)? 
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cred init(); /* 为 对 象 的 每 个 用 于 赋予 资格 (凭证 ) sind 
torkcinie(Q). /* 初始 化 一 些 结构 体 以 使 用 fork 函数 ”*/ 
proc caches init();  /* 给 各 种 资源 管理 结构 分 配 缓存 a 
buffer init(); /* 初始 化 缓冲 缓存 erf 
key init(); /* 初始 化 密 角 WA 
security init(); /* 安全 相关 初始 化 wa 


dbg larte imit) g 
vie Caches imit(totalramn pages) 7 /* 为 VES 创建 缓存 erf 











signals init(); /* 初始 化 信号 六 水 

page writeback init(); /* 页 回 写 初 始 化 2 

proe root mle) /* 注册 并 挂 载 proc 文件 系统 */ 

neis Imit)? 

Consett init (h? /* 初始 化 cpuset，cpuset 是 将 CPU 和 内 存 资源 以 逻辑 性 
* 和 层次 性 集成 的 一 种 机 制 ， 是 cgroup 使 用 的 子 系统 之 一 
5 

Cereal /* 初始 化 cgroup */ 

taskstats init early(); /* 进程 状态 初始 化 */ 


delayacet init() s 
check bugs(); /* 检查 写 缓冲 一 致 性 */ 


agpi subsystem Tmi)? 


Sr Jdieuee (0 p 




















if (efi enabled(EFI RUNTIME SERVICES)) ( 
efi late imi 
eui diee boot services ()) ? 


ftrace imiti)? 


rest init(); /* rest init MIEL */ 








start kernel 里面 调用 了 大 量 的 函数 ， 每 一 个 函数 都 是 一 个 庞大 的 知识 点 ， 如 果 想 要 学 习 
Linux 内 核 ,那么 这 些 函数 就 需要 去 详细 的 研究 。 本 教程 注重 于 红 入 式 Linux 入 门 ， 因 此 不 会 去 
讲 太 多 关于 Linux 内 核 的 知识 。start kernel 函数 最 后 调用 了 rest init, 接 下 来 简单 看 一 下 rest init 














36.2.4 rest init 函数 


rest init 函数 定义 在 文件 init/main.c 中 ， 函 数 内 容 如 下 : 
示例 代码 36.2.4.1 rest. init 函数 


SES Static ne ne voill ^ imit retook rast mit (vorc 
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384 ( 

SO ang One 

386 

387 icu scheduler starting N)? 

388 smoboot threat imit (0) P 

389 145 

290 * We need to spawn init first so that it obtains pid 1, however 
SSH * the init task will end up wanting to create kthreads, which, 
392 * if we schedule it before we create kthreadd, will OOPS. 
393 < 

394 kernel thread(kernel init, NULL, CLONE FS); 

995 numa default policy(); 

396 pid - kernel thread(kthreadd, NULL, CLONE FS | CLONE FILES); 
B97 rcu read lock(); 

398 kthreadd task = find task by pid ns(pid, &init pid ns); 

E icu reac unlock (0 y 

400 complete(&kthreadd done); 

401 

402 [5 

403 Ec orti Meine muertes ese ene le 

404 * at least once to get things moving: 

405 Au 

406 init iole bootup task (Current) f 

407 schedule preempt disabled(); 

408 vCal suus cpu selle wiin precenpt disabled */ 

409 cpu startup entry(CPUHP ONLINE); 

410 ) 


28387 行 ， 调 用 函数 rcu scheduler starting, JA53 RCU 锁 调 度 器 

第 394 行 , 调用 函数 kernel thread 创建 kernel init 线程 , 也 就 是 大 名 罗 易 的 init 内 核 进程 。 
init 进程 的 PID 为 1。init 进程 一 开始 是 内 核 进程 (也 就 是 运行 在 内 核 态 )， 后 面 init 进程 会 在 根 
文件 系统 中 查找 名 为 “init” 这 个 程序 ， 这 个 “init” 程 序 处 于 用 户 态 ， 通 过 运行 这 个 “init” 程 
序 ，init 进程 就 会 实现 从 内 核 态 到 用 户 态 的 转变 。 

第 396 行 , 调用 函数 kernel thread 创建 kthreadd 内 核 进程 , 此 内 核 进程 的 PID X 2. kthreadd 
进程 负责 所 有 内 核 进 程 的 调度 和 管理 。 

第 409 行 ， 最 后 调用 函数 cpu startup entry 来 进入 idle XEfÉ, cpu startup entry 会 调用 
cpu idle loop, cpu idle loop 是 个 while 循环 ， 也 就 是 idle 进程 代码 。idle 进程 的 PID 73 0, idle 
进程 叫做 空闲 进程 ， 如 果 学 过 FreeRTOS 或 者 UCOS 的 话 应 该 听 说 过 空闲 任务 。idle 空闲 进程 
就 和 空闲 任务 一 样 ， 当 CPU 没有 事情 做 的 时 候 就 在 idle 空闲 进程 里 面 “ 瞎 逛 游 ” 反正 就 是 给 
CPU 找 点 事 做 。 当 其 他 进程 要 工作 的 时 候 就 会 抢占 idle 进程 ， 从 而 夺取 CPU 使 用 权 。 其 实 大 
家 应 该 可 以 看 到 idle 进程 并 没有 使 用 kernel thread 或 者 fork 函数 来 创建 ， 因 为 它 是 有 主 进程 演 
变 而 来 的 。 
在 Linux 终端 中 输入 “ps -A” 就 可 以 打印 出 当前 系统 中 的 所 有 进程 ， 其 中 就 能 看 到 init 进 
程 和 kthreadd 进程 ， 如 图 36.2.4.1 所 示 : 
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/ # ps -A 
PID USER TIME COMMAND 
10 0:01 init 
2 0 0:00 [kthreadd] 
30 0:00 [ksoftirqd/0] 
3 y 0:00 [kworker/0: 0H] 
7 0 0:00 [rcu preempt] 


图 36.2.4.1 Linux 系统 当前 进程 
从 图 36.2.4.1 可 以 看 出 ，init 进程 的 PID 为 1，kthreadd 进程 的 PID 为 2。 之 所 以 图 36.2.4.1 
中 没有 显示 PID 为 0 的 idle 进程 ， 那 是 因为 idle 进程 是 内 核 进 程 。 我 们 接 下 来 重点 看 一 下 init 
HEFE, kernel init 就 是 init 进程 的 进程 函数 。 






























































36.2.5 init 进程 


kernel init 函数 就 是 init 进程 具体 做 的 工作 ， 定 义 在 文件 initmain.c 中 ， 函 数 内 容 如 下 ; 
示例 代码 36.2.5.1 kernel init 函数 








S220 ue ne ne (eee 

OO 

930 aLigE PEE, 

DISSE 

932 kernel init freeable(); /* init 进程 的 一 些 其 他 初始 化 工作 */ 
DES m mee to finis all async Init code Detare freeTng uae 


memory */ 




















934 async_synchronize_full(); /* 等 待 所 有 的 异步 调用 执行 完成 */ 
935 free initmem(); /* f init EAF i 
936 mark rodata ro(); 

937 system state = SYSTEM RUNNING; /* 标记 系统 正在 运行 sy 
938 numa default policy(); 

999 

940 lush deleye! tput) 5 

941 

942 if (ramdisk execute command) ( 

943 ret o run init process(ramdisk execute command); 

944 if (!ret) 

945 return 0; 

946 je exee(("mesllee! mo ewescwce we (exo t8) wv, 

947 ramdisk execute command, ret); 

948 ) 

949 

950 "hs 

OI * We try each of these until one succeeds. 

952 A 

955 * The Bourne shell can be used instead of init if we are 

954 * trying to recover a really broken machine. 

955 */ 
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956 if (execute command) ( 

25 ret © run init process(execute command); 

958 if (lret) 

959 return 0; 

960 panic ("Requested init $s failed (error %d).", 

961 execute command, ret); 

962 } 

963 sus (try toa run iaie process ("/sbin/init") [i 

964 Uii co run init procona ("/ere/inic) [[ 

965 [tcy to rwa imie process ("les sae» [D 

966 !try to run init process("/bin/sh")) 

SIGN return 0; 

968 

969 panic("No working init found. Try passing init- option to 
f«esewel; 

970 "See Linux Documentation/init.txt for guidance."); 
ea 


第 932 ÍF, kernel init freeable 函数 用 于 完成 init 进程 的 一 些 其 他 初始 化 工作 ， 稍 后 再 来 具 



































体 看 一 下 此 函数 。 
第 940 fT, ramdisk execute command 是 一 个 全 局 的 char 指针 变量 ， 此 变量 值 为 “/init”， 
也 就 是 根 目录 下 的 init 程序 。ramdisk execute command 也 可 以 通过 uboot 传递 ， 在 bootargs 中 


























使 用 “rdinit=xxx” 即 可 ，xxx 为 具体 的 init 程序 名 字 。 




















第 943 行 ， 如 果 存 在 “/init” 程 序 的 话 就 通过 函数 run init process 来 运行 此 程序 。 

第 956 行 ， 如 果 ramdisk execute command 为 空 的 话 就 看 execute command 是 否 为 空 ， 反 
正 不 管 如 何 一 定 要 在 根 文 件 系统 中 找到 一 个 可 运行 的 init 程序 。execute_ command 的 值 是 通过 
uboot 传递 ， 在 bootargs 中 使 用 “init=xxxx” 就 可 以 了 ， 比 如 “init=/linuxre ”表示 根 文 件 系 统 中 
的 linuxrc 就 是 要 执行 的 用 户 空间 init 程序 。 

第 963~966 íT, WR ramdisk execute command 和 execute command 都 为 空 ， 那 么 就 依次 


4 





















































查找 “/sbin/init”、“/etc/init”、“/bin/init” 和 “/bin/sh”， 这 四 个 相当 于 备用 init 程序 ， 如 果 这 四 








个 也 不 存在 ， 那 么 Linux 启动 失败 ! 
第 969 行 ， 如 果 以 上 步骤 都 没有 找到 用 户 空间 的 init 程序 ， 那 么 就 提示 错误 发 生 ! 
最 后 来 简单 看 一 下 kernel init freeable 函数 ， 前 面 说 了 ，kernel_init 会 调用 此 函数 来 做 一 些 


















































init 进程 初始 化 工作 。kernel_init_freeable 定义 在 文件 init/main.c 中 ， 缩 减 后 的 函数 内 容 如 下 ; 


示例 代码 36.2.5.2 kernel init freeable 函数 


DS ee ne  — lmit kernel inir ireeelble (vorc) 


974 ( 
Os 
976 
e 
978 


/ * 
* Wait until kthreadd is all set-up. 
i 
wait for completion(&kthreadd done);/* 等 待 kthreadd 进程 准备 就 绪 * / 


smp init(); /* SMP 初始 化 sf 
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1000 sched init smp() /* 多 核 (SMP) 调度 初始 化 —*/ 

1001 

1002 donbasicesetup(); /* 设备 初始 化 都 在 此 函数 中 完成 */ 

1003 


1004 /* Open the /dev/console on the rootfs, this should never fail */ 

1005 if (sys _ open((const char Vser 9) "/dev/console", O RDWR, (0) < 
0) 

1006 pr err("Naroping: Unable to open an initial console. n"); 

1007 

1008 (void) sys dup(0); 

1009 (void) sys dup(0); 





1010 Es 

1011 * check if there is an early userspace init. If yes, let it do 

ONZ * all the work 

MONS a 

1014 

LOLS if (!ramdisk execute command) 

1016 ramdisk execute command = "/init"; 

1017 

1018 de (eys access ( (const Coar _ Uger =) Eam leis execute e o m mtt 
0) != 0) { 

ONES ramdisk execute command = NULL; 

1020 prepare namespace(); 

WO2 } 

O22 

125 (5 

1024 * Ok, we have completed the initial bootup, and 

1025 * we're essentially up and running. Get rid of the 

1026 * initmem segments and start the user-mode stuff.. 

WOZ B 

1028 * rootfs is available now, try loading the public keys 

1O29 x and default modules 

1030 g 

1031 


1032 integrity load keys(); 
1093 load default modules (); 
1034 ) 

第 1002 ÍT, do basic setup 函数 用 于 完成 Linux 下 设备 驱动 初始 化 工作 ! 非常 重要 。 
do basic setup 会 调用 driver init 函数 完成 Linux 下 驱动 模型 子 系统 的 初始 化 。 

第 1005 行 ， 打 开设 备 “/dewconsole” 在 Linux 中 一 切 丝 为 文件 ! 因此 “/dewconsole” 也 
是 一 个 文件 , 此 文件 为 控制 台 设 备 。 每 个 文件 都 有 一 个 文件 描述 符 , 此 处 打开 的 “/dev/console” 
文件 描述 符 为 0， 作为 标准 输入 (0)。 








Ta] 
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第 1008 和 1009 行 ，sys_dup 函数 将 标准 输入 (0) 的 文件 描述 符 复 制 了 2 次 ， 一 个 作为 标准 
输出 (1)， 一 个 作为 标准 错误 (2)。 这 样 标准 输入 、 输 出 、 错 误 都 是 /dev/console Jo console 通过 
uboot 的 bootargs 环境 变量 设置 ,“console=ttymxc0,115200” 表 示 将 /dev/ttymxc0 设置 为 console， 
也 就 是 IMX6U 的 串口 1。 当 然 ， 也 可 以 设置 其 他 的 设备 为 console， 比 如 虚拟 控制 台 ttyl, w 
置 ttyl 为 console 就 可 以 在 LCD 屏幕 上 看 到 系统 的 提示 信息 

第 1020 行 ， 调 用 函数 prepare namespace 来 挂 载 根 文件 系统 。 跟 文件 系统 也 是 由 命令 行 参 
数 指定 的 ， 也 就 是 uboot 的 bootargs 环境 变量 。 比 如 “root=/dev/mmcblk1p2 rootwait rw " Ji 表示 
根 文件 系统 在 /dev/mmcblk1p2 F, ii EMMC 的 分 区 2 中 。 

Linux 内 核 启 动 流程 就 分 析 到 这 里 ，Linux 内 核 最 终 是 需要 和 根 文件 系统 打交道 的 ， 需 要 挂 
载 根 文件 系统 ， 并 且 执 行 根 文件 系统 中 的 init 程序 ， 以 此 来 进去 用 户 态 。 这 里 就 正式 引出 了 根 
文件 系统 ， 根 文件 系统 也 是 我 们 系统 移植 的 最 后 一 片 拼图 。Linux 移植 三 巨头 : uboot、Linux 
kernel, rootfs( 根 文件 系统 )。 关于 根 文件 系统 后 面 章节 会 详细 的 讲解 , 这 里 我 们 只 需要 知道 Linux 
内 核 移 植 完成 以 后 还 需要 构建 根 文件 系统 即 可 。 
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第 三 十 七 章 Linux 内 核 移植 


前 两 章 我 们 简单 了 解 了 一 下 Linux 内 核 顶 层 Makefile 和 Linux 内 核 的 启动 流程 ， 本 章 我 们 
就 来 学 习 一 下 如 何 将 NXP 官方 提供 的 Linux 内 核 移植 到 正点 原子 的 LIMX6U-ALPHA 开发 板 上 。 
通过 本 章 的 学 习 , 我 们 将 掌握 如 何 将 半导体 厂商 提供 的 Linux BSP 包 移 植 到 我 们 自己 的 平台 上 。 
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37.1 创建 VSCode 工程 





这 里 我 们 使 用 NXP 官方 提供 的 Linux 源码 ， 将 其 移植 到 正点 原子 LIMX6U-ALPHA 开发 板 
Eo NXP 官方 原版 Linux 源码 已 经 放 到 了 开发 板 光 盘 中 ， 路 径 为 : 1、 例 程 源码 ->4、NXP 官方 
原版 UJboot 和 Linux->linux-imx-rel imx 4.1.15 2.1.0_ga.tar.bz2。 使 用 FileZilla 将 其 发 送 到 Ubuntu 
中 并 人 解压， 得 到 名 为 linux-imx-rel imx 4.1.15 2.1.0 ga 的 目录 ， 为 了 和 NXP 官方 的 名 字 区 分 ， 
可 以 使 用 “mv ”命令 对 其 重 命 名 ， 我 这 里 将 其 重 命 名 为 “ linux-imx- 
rel imx 4.1.15 2.1.0 ga alientek” 命令 如 下 : 

mv linux-imx-rel imx 4.1.15 2.1.0 galinux-imx-rel imx 4.1.15 2.1.0 ga alientek 

完成 以 后 创建 VSCode TE, WRA Windows 下 一 样 ， 重 点 是 .vscode/settings.json 这 个 文 


















































37.2 NXP 官方 开发 板 Linux 内 核 编译 


NXP 提供 的 Linux 源码 肯定 是 可 以 在 自己 的 LMX6ULL EVK 开发 板 上 运行 下 去 的 ， 所 以 
我 们 肯定 是 以 IMX6ULL EVK 开发 板 为 参考 ， 然 后 将 Linux 内 核 移植 到 IMX6U-ALPHA 开发 
板 上 的 。 











37.2.1 修改 顶层 Makefile 


修改 顶层 Makefile， 直 接 在 顶层 Makefile 文件 里 面 定义 ARCH 和 CROSS_COMPILE 这 两 
个 的 变量 值 为 arm 和 arm-linux-gnueabihf-， 结 果 如 图 37.2.1 所 示 : 


242 # CROSS COMPILE specify the prefix used for all executables used 

243 # during compilation. Only gcc and related bin-utils executables 

244 # are prefixed with $(CROSS COMPILE). 

245 # CROSS COMPILE can be set on the command line 

246 # make CROSS COMPILE-ia64-linux- 

247 # Alternatively CROSS COMPILE can be set in the environment. 

248 # A third alternative is to store a setting in .config so that plain 
249 # "make" in the configured kernel build directory always uses that. 
250 # Default value for CROSS COMPILE is not to prefix executables 

251 # Note: Some architectures assign CROSS COMPILE in their arch/*/Makefile 
252 ARCH ?= arm 

253 CROSS COMPILE ?= arm-linux-gnueabihf- 


图 37.2.1 修改 顶层 Makefile 
图 37.2.1 中 第 252 和 253 行 分 别 设置 了 ARCH 和 CROSS_COMPILE 这 两 个 变量 的 值 ， 这 
样 在 编译 的 时 候 就 不 用 输入 很 长 的 命令 了 。 





























37.2.2 配置 并 编译 Linux 内 核 


和 uboot 一 样 ， 在 编译 Linux 内 核 之 前 要 先 配 置 Linux 内 核 。 每 个 板子 都 有 其 对 应 的 默认 
配置 文件 ， 这 些 默 认 配 置 文件 保存 在 arch/arm/configs 目录 中 。imx v7 defconfig 和 
imx v7 mfg defconfig 都 可 作为 IMX6ULL EVK 开发 板 所 使 用 的 默认 配置 文件 。 但 是 这 里 建议 
使 用 imx v7 mfg defconfig 这 个 默认 配置 文件 ， 首 先 此 配置 文件 默认 支持 ILMX6UL XN ; 
而 且 重 要 的 一 点 就 是 此 文件 编译 出 来 的 zImage 可 以 通过 NXP 官方 提供 的 MfgTool 工具 烧 写 !! 
imx v7 mfg defconfig 中 的 “mfg” 的 意思 就 是 MfgTool。 

进入 到 Ubunut 中 的 Linux 源码 根 目 录 下 ， 执 行 如 下 命令 配置 Linux 内 核 : 

make clean // 第 一 次 编译 Linux 内 核 之 前 先 清理 一 下 
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make imx v7 mfg defconfig /配置 Linux 内 核 
配置 完成 以 后 如 图 37.2.2.1 所 示 : 





A $ make imx v7 mfg defconfig 
HOSTCC scripts/basic/fixdep 

HOSTCC scripts/kconfig/conf.o 

HOSTCC scripts/kconfig/zconf.tab.o 

HOSTLD scripts/kconfig/conf 


configuration written to .config 





图 37.2.2.1 配置 Linux 内 核 
配置 完成 以 后 就 可 以 编译 了 ， 使 用 如 下 命令 编译 Linux 内 核 : 
make -j16 // 编 译 Linux 内 核 
等 待 编译 完成 ， 结 果 如 图 37.2.2.2 所 示 : 

lib/libcrc32c.ko 

lib/crc-itu-t.ko 

sound/core/snd- rawmidi.ko 


sound/core/snd-hwdep.ko 
sound/usb/snd-usbmidi-lib.ko 





























sound/usb/snd-usb-audio. ko 


arch/arm/boot/compressed/piggy.lzo.o 
arch/arm/boot/compressed/vmlinux 
OBJCOPY arch/arm/boot/zImage 
Kernel: arch/arm/boot/zImage is ready 





图 37.2.2.2 Linux 编译 完成 

Linux 内 核 编译 完成 以 后 会 在 arch/arm/boot 目录 下 生成 zImage 镜像 文件 ， 如 果 使 用 设备 树 
的 话 还 会 在 arch/arm/boot/dts 目录 下 开发 板 对 应 的 .dtb( 设 备 树 ) 文 件 ， 比 如 imx6ull-14x14-evk.dtb 
就 是 NXP 官方 的 LMX6ULL EVK 开发 板 对 应 的 设备 树 文 件 。 至 此 我 们 得 到 两 个 文件 : 

(D. Linux 内 核 镜 像 文件 ，zImage。 

(2. NXP 官方 LMX6ULL EVK 开发 板 对 应 的 设备 树 文 件 :imx6ull-14x14-evk.dtb。 



































37.2.3 Linux 内 核 启动 测试 


在 上 一 小 节 我 们 已 经 得 到 了 NXP 官方 LMX6ULL EVK 开发 板 对 应 的 zImage 和 imx6ull- 
14x14-evk.dtb 这 两 个 文件 。 这 两 个 文件 能 不 能 在 正点 原子 的 LMX6U-ALPHA EMMC 版 开发 板 
上 局 动 呢 ? 测试 一 下 不 就 知道 了 ， 在 测试 之 前 确保 uboot 中 的 环境 变量 bootargs 内 容 如 下 : 

console-ttymxc0,115200 root-/dev/mmcblk1p2 rootwait rw 

将 上 一 小 节 编 译 出 来 的 zImage 和 imx6ull-14x14-evk.dtb 复制 到 Ubuntu 中 的 tftp 目录 下 ， 
因为 我 们 要 在 uboot 中 使 用 tftp 命令 将 其 下 载 到 开发 板 中 ， 找 贝 命令 如 下 : 

cp arch/arm/boot/zImage /home/zuozhongkai/linux/tftpboot/ -f 

cp arch/arm/boot/dts/imx6ull-14x14-evk.dtb /home/zuozhongkai/linux/tftpboot/ -f 

拷贝 完成 以 后 就 可 以 测试 了 ， 启 动 开 发 板 ， 进 入 uboot 命令 行 模式 ， 然 后 输入 如 下 命令 将 
zImage 和 imx6ull-14x14-evk.dtb 下 载 到 开发 板 中 并 启动 : 

tftp 80800000 zImage 

tftp 83000000 imx6ull-14x14-evk.dtb 

bootz 80800000 - 83000000 
结果 图 37.2.3.1 所 示 : 
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=> tftp 80800000 zImage 
FEC1 Waiting for PHY auto negotiation to complete.... done 


Using FEC1 device 

TFTP from server 192.168.1.250; our IP address is 192.168.1.251 

|Filename 'zImage'. 

Load address: 0x80800000 

Loading: ZSESESSESESESTHESEHHHSHHTHEHHEHEHEHEEHHRRHREEBEH HUE EE EHEHHEHHHHHHTSHESESTNNN 
BESESHSSHSSHSHRHRSRHHHHHHHHHEHSEEEHHEHHRHHSHHHHHU UE EE E HEHEHHHDHTHHSHSTS 
BESSHEHHHHHHHHEHHHHRHRERESHEHEHHH USE EEHHSHHHHHSHHH UH SEHE HEEHEHHSHHSHTTSE 
BESSSHHHTEHEHHHHHHEHHHRRRRRHHHHUHHUUEHEEHEHEHHHHRHREREHEHH HU HH HH HUE DN 
BEBSESHHSHSHHHESHHHRRHRESHHHUSHHEHEHEEEHHHHHHHHRHHHUH UH EHE EHEHHHHHTHTHSSTS 
BESSSHHSHHEHHHHHHEHHHERHRRRHSSHSHHHHU EE EEHEHHHHRRRRRHSETHHHH HH HH HH UH n 
pee i 


2.4 MiB/s 
done 


Bytes transferred - 6680432 (65ef70 hex) 
-» tftp 83000000 imx6ull-14x14-evk.dtb 
Using FEC1 device 
TFTP from server 192.168.1.250; our IP address is 192.168.1.251 
Filename 'imx6ull-14x1l4-evk.dtb'. 
Load address: 0x83000000 
Loading: ### 
1.2 MiB/s 
done 


Bytes transferred = 35969 (8c81 hex) 

=> bootz 80800000 - 83000000 

Kernel image @ 0x80800000 [ 0x000000 - 0x65ef70 ] 

|## Flattened Device Tree blob at 83000000 

Booting using the fdt blob at 0x83000000 

Using Device Tree in place at 83000000, end 8300bc80 


Starting kernel ... 





Booting Linux on physical CPU 0x0 

|Linux version 4.1.15 (zuozhongkaiQubuntu) (gcc version 4.9.4 (Linaro GCC 4.9-2017.01) 
|n 8 12:26:48 CST 2019 

CPU: ARMv7 Processor [410fc075] revision 5 (ARMv7), cr-10c53c7d 


37.2.3.1 启动 Linux 内 核 
从 图 37.2.3.1 可 以 看 出 ， 此 时 Linux 内 核 已 经 启动 了 ， 如 果 EMMC 中 的 根 文 件 系统 存在 ， 
我 们 就 可 以 进入 到 Linux 系统 里 面 使 用 命令 进行 操作 如 题 37.2.3.2 所 示 : 


VFS: Mounted root (ext3 tilesystem) on device 1/9:1U. 
devtmpfs: mounted 

Freeing unused kernel memory: 440K (80b18000 - 80b86000) 
usb 1-1.2: new high-speed USB device number 4 using ci hdrc 
ALSA: Restoring mixer settings... 




















Please press Enter to activate this console. 
# 


random: nonblocking pool is initialized 


/ 
/ 
/ 
/ 
/ 


淋淋 HH 


37.2.32. 进入 Linux 根 文件 系统 


37.2.4 根 文件 系统 缺失 错误 


Linux 内 核 启 动 以 后 是 需要 根 文件 系统 的 , 根 文件 系统 存在 哪里 是 由 uboot 的 bootargs 环境 
变量 指定 ，bootargs 会 传递 给 Linux 内 核 作 为 命令 行 参数 。 比 如 上 一 小 节 设 置 
root=/dev/mmcblk1p2， 也 就 是 说 根 文件 系统 存储 在 /dev/mmcblk1lp2 F, Hitz EMMC 的 分 区 2 
中 。 这 是 因为 正点 原子 的 EMMC 版 本 开发 板 出 厂 的 时 候 已 经 EMMC 的 分 区 2 中 烧 写 好 了 根 文 
件 系统 ， 所 以 设置 root=/dev/mmcblk1p2。 如 果 我 们 不 设置 根 文件 系统 路 径 ， 或 者 说 根 文件 系 统 
路 径 设置 错误 的 话 会 出 现 什么 问题 ? 这 个 问题 是 很 常见 的 , 我 们 在 实际 的 工作 中 开发 一 个 产品 ， 
这 个 产品 的 第 一 版 硬件 出 来 以 后 我 们 是 没有 对 应 的 根 文件 系统 可 用 的 ， 必 须要 自己 做 根 文 件 系 
统 。 在 构建 出 对 应 的 根 文件 系统 之 前 Linux 内 核 是 没有 根 文件 系统 可 用 的 ， 此 时 Linux 内 核 启 
动 以 后 会 出 现 什 么 问题 呢 ? 带 着 这 个 问题 ， 我 们 将 uboot 中 的 bootargs 环境 变量 改 为 
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“console=ttymxc0,115200”， 也 就 是 不 填写 root 的 内 容 了 ， 命 令 如 下 : 
setenv bootargs 'console-ttymxc0,115200' 


修改 完成 以 后 重新 从 网 络 启 动 ， 启 动 以 后 会 有 如 图 37.2.4.1 所 示 错 误 : 








usb 1-1.2: new full-speed USB device number 3 using ci_hdrc 

mmcblklbootl: mmc1:0001 4FTE4R partition 2 4.00 MiB 

mmcblklrpmb: mmc1:0001 4FTE4R partition 3 512 KiB 

mmcblkl: pl p2 

VFS: Cannot open root device "(null)" or unknown-block(0,0): error -6 

Please append a correct "root-" boot option; here are the available partitions: 
536 ram0 (driver?) 


0101 65536 raml (driver?) 

0102 65536 ram2 (driver?) 

0103 65536 ram3 (driver?) 

0104 65536 ram4 (driver?) 

0105 65536 ram5 (driver?) 

0106 65536 ram6 (driver?) 

0107 65536 ram/ (driver?) 

0108 65536 ram8 (driver?) 

0109 65536 ram9 (driver?) 

010a 65536 ram10 (driver?) 

010b 65536 ramll (driver?) 

010c 65536 raml2 (driver?) 

010d 65536 ram13 (driver?) 

010e 65536 raml4 (driver?) 

010f 65536 ram15 (driver?) 

b300 15558144 mmcblkO driver: mmcblk 
b301 512000 mmcblkOpl f95bOdec-01 
b302 14943744 mmcblkOp2 f95bO0dec-02 

b308 3817472 mmcblk1 driver: mmcblk 
b309 512000 mmcblklpl b29f4828-01 
b30a 3203072 mmcblklp2 b29f4828-02 

b320 512 mmcblklrpmb (driver?) 

b318 4096 mmcblklbootl (driver?) 

b310 4096 mmcblklbootO (driver?) 


Kernel panic - not syncing: VFS: Unable to mount root fs on unknown-block(0,0) 
---[ end Kernel panic - not syncing: VFS: Unable to mount root fs on unknown- block(0,0) 


图 37.2.4.1 根 文件 系统 缺失 错误 
在 图 37.2.4.1 中 最 后 会 有 下 面 这 一 行 : 
Kernel panic - not syncing: VFS: Unable to mount root fs on unknown-block(0,0) 
也 就 是 提示 内 核 朋 涡 ， 因 为 VFS( 虚 拟 文 件 系 统 ) 不 能 挂 载 根 文 件 系统 ， 因 为 根 文件 系统 目 
录 不 存在 。 即 使 根 文件 系统 目录 存在 ， 如 果 根 文件 系统 目录 里 面 是 空 的 依旧 会 提示 内 核 月 误 。 
这 个 就 是 根 文件 系统 缺失 导致 的 内 核 骨 省 , 但 是 内 核 是 启动 了 的 ,只 是 根 文件 系统 不 存在 而 已 。 


37.3 在 Linux 中 添加 自己 的 开发 板 


在 37.2 小 节 中 我 们 通过 编译 NXP £7; LMX6ULL EVK 开发 板 对 应 的 Linux 内 核 ， 发 现 其 
可 以 在 正点 原子 的 EMMC 版 本 开发 板 启动 ， 所 以 我 们 就 参考 LMX6ULL EVK 开发 板 的 设置 ， 
在 Linux 内 核 中 添加 正点 原子 的 LMX6U-ALPHA 开发 板 。 















































37.3.1 添加 开发 板 默认 配置 文件 


将 arch/arm/configs 目录 下 的 imx v7 mfg defconfig 
imx alientek emmc defconfig, áp P: 

cd arch/arm/configs 

cpimx v7 mfg defconfig imx alientek emmc defconfig 

以 后 imx alientek emmc defconfig 就 是 正点 原子 的 EMMC 版 开发 板 默认 配置 文件 了 。 完 
成 以 后 如 图 37.3.1.1 Bran: 


limi 
muy 


新 复制 一 份 ， 命 名 为 
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imx alientek emmc defconfig 
imx v4 v5 defconfig 
imx v6 v7 defconfig 


imx v7 defconfig 
imx v7 mfg defconfig 
图 37.3.1.1 新 添加 的 默认 配置 文件 





















































以 后 就 可 以 使 用 如 下 命令 来 配置 正点 原子 EMMC 版 开发 板 对 应 的 Linux 内 核 了 : 


make imx alientek emmc defconfig 





37.3.2. 添加 开发 板 对 应 的 设备 树 文件 


添加 适合 正点 原子 EMMC 版 开发 板 的 设备 树 文件 ， 进 入 目录 arch/arm/boot/dts H, Sth 
份 imx6ull-14x14-evk.dts， 然 后 将 其 重 命名 为 imx6ull-alientek-emmc.dts,. MEU F: 

cd arch/arm/boot/dts 

cp imx6ull-14x14-evk.dts imx6ull-alientek-emmc.dts 

.dts 是 设备 树 源码 文件 ,编译 Linux 的 时 候 会 将 其 编译 为 .dtb 文件 ,imx6ull-alientek-emmc.dts 
创建 好 以 后 我 们 还 需要 修改 文件 arch/arm/boot/dts/Makefile ， 找 到 “ dtb- 
$(CONFIG SOC IMX6ULD)” 配 置 项 ， 在 此 配置 项 中 加 入 “imx6ull-alientek-emmc.dtb” ， 如 下 
所 示 : 





T 















































示例 代码 37.3.2.1 atch/atm/boot/dts/Makefile 代码 段 




































































a00 citos (CONFIG SOC IMX6ULL) += N 

401 amix ou dax 14 ere em 

402 imx6ull-14x14-ddr3-arm2-adc.dtb N 

403 imx6ull-14x14-ddr3-arm2-cs42888.dtb \ 
404 mu A le S) a me esl 
405 imx6ull-14x14-ddr3-arm2-emmc.dtb N 

406 mu lA le arm ele 

407 imx6ull-14x14-ddr3-arm2-flexcan2.dtb NW 
408 imx6ull-14x14-ddr3-arm2-gpmi-weim.dtb V 
409 rG L= 45:141 elehe.Sj-eucm2;— lergbtit glo N 
410 imx6ull-14x14-ddr3-arm2-ldo.dtb N 

411 imxóoull-T4x14-ddr3-arm2-qspdi-dtb.N 

412 imx6ull-14x14-ddr3-arm2-qspi-all.dtb wN 
413 ates Soi. 1L — 1:45:11 ol Sn bee sche Y 

414 imx6ull-14x14-ddr3-arm2-uart2.dtb N 
415 imx6ull-14x14-ddr3-arm2-usb.dtb \ 

416 imx6ull-14x14-ddr3-arm2-wm8958.dtb V 
any) imx6ull-14xl4-evk.dtb \ 

418 imx6ull-14x14-evk-btwifi.dtb V 

419 imx6ull-14xl4-evk-emmc.dtb \ 

420 imx6ull-14x14-evk-gpmi-weim.dtb \ 

Zl imx6ull-14xl4-evk-usb-certi.dtb N 

422 imx6ull-alientek-emmc.dtb \ 
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423 imx6ull-9x9-evk.dtb V 

424 imx6ull-9x9-evk-btwifi.dtb Y 

425 imx6ull-9x9-evk-ldo.dtb 


第 422 行为 “imx6ull-alientek-emmc.dtb”， 这样 编译 Linux 的 时 候 就 可 以 从 imx6ull-alientek- 
emmc.dts 编译 出 imx6ull-alientek-emmc.dtb 文件 了 。 

















37.3.3 编译 测试 


经 过 37.3.1 和 37.3.2 两 个 小 节 ，Linux 内 核 里 面 已 经 添加 了 正点 原子 LMX6UL-ALIPHA 
EMMC 版 开发 板 了 ， 接 下 接 编 译 测 试 一 下 ， 我 们 可 以 创建 一 个 编译 脚本 ， 
imx6ull alientek emmc.sh， 脚 本 内 容 如 下 : 

示例 代码 37.3.2.1 imx6ull alientek_emmc.sh 编译 脚本 





























1 £'/bin/sh 
2 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- distclean 
3 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- 








imx alientek emmc defconfig 





4 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- menuconfig 
5 make ARCH-arm CROSS COMPILE-arm-linux-gnueabihf- all -j16 
第 1 行 ， 清 理工 程 。 
第 2 行 ， 使 用 默认 配置 文件 imx_alientek emmc defconfig 来 配置 Linux 内 核 。 
第 3 行 ,打开 Linux 的 图 形 配置 界面 , 如 果 不 需要 每 次 都 打开 图 形 配置 界面 可 以 删除 此 行 。 
第 4 行 ， 编 译 Linux。 
执行 shell 脚本 imx6ull alientek emmc.sh 编译 Linux 内 核 ， 编 译 完 成 以 后 就 会 在 目录 
arch/arm/boot 下 生成 zImasge 镜像 文件 。 在 arch/arm/boot/dts 目录 下 生成 imx6ull-alientek-emmc.dtb 
文件 。 将 这 两 个 文件 拷贝 到 tftp 目录 下 , 然后 重启 开发 板 , TE uboot 命令 模式 中 使 用 tftp 命令 下 
载 这 两 个 文件 并 启动 ， 命 令 如 下 : 
tftp 80800000 zImage 
tftp 83000000 imx6ull-alientek-emmc.dtb 
bootz 80800000 - 83000000 
只 要 出 现 如 图 37.3.3.1 所 示 内 容 就 表示 Linux 内 核 启动 成 功 : 


Booting Linux on physical CPU 0x0 

Linux version 4.1.15 (zuozhongkaiQubuntu) (gcc version 4.9.4 (Linaro GCC 4.9-2017.01) ) # 
n 8 18:38:28 CST 2019 

CPU: ARMv7 Processor [410fc075] revision 5 (ARMv7), cr-10c53c7d 

CPU: PIPT / VIPT nonaliasing data cache, VIPT aliasing instruction cache 

Machine model: Freescale i.MX6 ULL 14x14 EVK Board 

Reserved memory: created CMA memory pool at 0x8c000000, size 320 MiB 

Reserved memory: initialized node linux,cma, compatible id shared-dma-pool 

Memory policy: Data cache writealloc 


图 37.3.3.1 Linux 内 核 启 动 
Linux 内 核 启 动 成 功 ， 说 明 我 们 已 经 在 NXP 提供 的 Linux 内 核 源 码 中 添加 了 正点 原子 
I.MX6UL-ALPHA 开发 板 。 


37.4 CPU 主 频 和 网 络 驱 动 修 改 
37.4.1 CPU 主 频 修 改 




















































































































1、 设 置 IMX6U-ALPHA 开发 板 工作 在 528MHz 
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确保 EMMC 中 的 根 文件 系统 可 用 ! 然后 重新 启动 开发 板 ， 进 入 终端 (可 以 输入 命令 )， 如 图 
37.4.1.1 所 示 : 





devtmpfs: mounted 

Freeing unused kernel memory: 440K (80b18000 - 80b86000) 

usb 1-1.2: device no response, device descriptor read/64, error -32 
usb 1-1.2: not running at top speed; connect to a high speed hub 
ALSA: Restoring mixer settings... 


Please press Enter to activate this console. 
/ 








# 
/ # 
/ # 
/ # 
37.4.1.1 进入 命令 行 
进入 图 37.4.1 所 示 的 命令 行 以 后 输入 如 下 命令 查看 epu 信息 : 
cat /proc/cpuinfo 
结果 如 图 37.4.2 所 示 : 
/ # cat /proc/cpuinfo 
processor :0 
model name : ARMv7 Processor rev 5 (v71) 
BogoMIPS EX. 
Features : half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt vfpd32 lpae 


CPU implementer : 0x41 
CPU architecture: 7 





CPU variant : 0x0 

CPU part : 0xc07 

CPU revision HESS 

Hardware : Freescale i.MX6 Ultralite (Device Tree) 
Revision : 

serial : 0000000000000000 


37.4.1.2 cpu 信息 
在 图 37.4.2.1 中 有 BogoMIPS 这 一 条 ， 此 时 BogoMIIS 73 3.00, BogoMIPS 是 Linux 系统 中 
衡量 处 理 器 运行 速度 的 一 个 “尺子 ”， 处 理 器 性 能 越 强 ， 主 频 越 高 ，BogoMIPS 值 就 越 大 。 
BogoMIPS 只 是 粗略 的 计算 CPU 性 能 ， 并 不 十 分 准确 。 但 是 我 们 可 以 通过 BogoMIPS 值 来 大 致 
的 判断 当前 处 理 器 的 性 能 。 在 图 37.4.1.2 中 并 没有 看 到 当前 CPU 的 工作 频率 ， 那 我 们 就 转变 另 
一 种 方法 查看 当前 CPU 的 工作 频率 。 进 入 到 目录 /sys/bus/cpu/devices/cpu0/cpufreq FP, 此 目录 下 
会 有 很 多 文件 ， 如 图 37.4.1.3 PZR: 


/sys/devices/system/cpu/cpu0/cpufreq # ls 
































affected_cpus scaling_cur_freq 
cpuinfo_cur_freq scaling_driver 

cpuinfo_max_freq scaling_governor 
cpuinfo_min_freq scaling_max_freq 
cpuinfo_transition_latency scaling min freq 
related cpus scaling setspeed 


scaling. available frequencies stats 
scaling available governors 


37.4.1.3 cpufreq 目录 
此 目录 中 记录 了 CPU 频率 等 信息 ， 这 些 文件 的 含义 如 下 : 
cpuinfo_cur_freq: 当前 cpu 工作 频率 ， 从 CPU 寄存 器 读 取 到 的 工作 频率 。 
cpuinfo max freq: 处 理 器 所 能 运行 的 最 高 工作 频率 (单位 :KHz )。 
cpuinfo min freq : 处 理 器 所 能 运行 的 最 低 工 作 频 率 ( 单 位 : KHz)。 
cpuinfo transition latency: 处 理 器 切换 频率 所 需要 的 时 间 ( 单 位 :ns)。 
scaling available frequencies: 处 理 器 支持 的 主 频 率 列 表 ( 单 位 : KHz)。 
scaling available governors: 当前 内 核 中 支持 的 所 有 governor( 调 频 ) 类 型 。 
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scaling cur freq: 保存 着 cpufreq 模块 缓存 的 当前 CPU 频率 ， 不 会 对 CPU 硬件 寄存 器 进 
行 检查 。 








scaling driver: 改 文 件 保存 当前 CPU 所 使 用 的 调频 驱动 。 

scaling governor: governor( 调 频 ) 策 略 ，Linux 内 核 一 共有 5 中 调频 策略 ， 

QD)、Performance， 最 高 性 能 ， 直 接 用 最 高 频率 ， 不 考虑 耗 电 。 

(、Interactive， 一 开始 直接 用 最 高 频率 ， 然 后 根据 CPU Ss 

(3)、Powersave， 省 电 模式 ， 通 常 以 最 低频 率 运 行 ， 系 统 性 能 会 受 影响 ， 一 般 不 会 用 这 个 ! 

由、Userspace， 可 以 在 用 户 空 间 手动 调节 频率 。 

多 、Ondemand， 定时 检查 负载 ,然后 根据 负载 来 调节 频率 。 负载 低 的 时 候 降 低 CPU 频率 ， 
这 样 省 电 ， 负 载 高 的 时 候 提 高 CPU 频率 ， 增 加 性 能 。 

scaling max freq: governor( 调 频 ) 可 以 调节 的 最 高 频率 。 

cpuinfo min freq: governor( 调 频 ) 可 以 调节 的 最 低频 率 。 

stats 目录 下 给 出 了 CPU 各 种 运行 频率 的 统计 情况 ， 比 如 CPU 在 各 频率 下 的 运行 时 间 以 及 

使 用 如 下 命令 查看 当前 CPU 频率 : 

cat cpuinfo cur freq 


结果 如 图 37.4.1.4 所 示 : 


e e Aa aa # cat cpuinfo_cur_freq 
198 
/sys/devices/system/cpu/cpu0/cpufreq # 


图 37.4.1.4 当前 CPU 频率 

从 图 37.4.1.4 可 以 看 出 ， 当 前 CPU 频率 为 198MHz， 工 作 频 率 很 低 ! 其 他 的 值 如 下 : 
cpuinfo cur freq = 198000 

cpuinfo max freq = 528000 












































































































































cpuinfo min freq — 198000 

scaling cur freq = 198000 

scaling max freq = 528000 

catscaling min freq = 198000 

scaling available frequencies — 198000 396000 528000 

cat scaling governor = ondemand 

可 以 看 出 ， 当 前 CPU 支持 198MHz. 396MHz 和 528Mhz 三 种 频率 切换 ， 其 中 调频 策略 为 
ondemand， 也 就 是 定期 检查 负载 ， 然 后 根据 负载 情况 调节 CPU 频率 。 因 为 当前 我 们 开发 板 并 没 
有 做 什么 工作 , 因此 CPU 频率 降低 为 198MHz 以 省 电 。 如 果 开 发 板 做 一 些 高 负载 的 工作 ， 比 如 
播放 视频 、 播 放 视频 等 操作 那么 CPU 频率 就 会 提升 上 去 。 查 看 stats 目录 下 的 time in state X 
件 可 以 看 到 CPU 在 各 频率 下 的 工作 时 间 ， 命 令 如 下 : 

cat /sys/bus/cpu/devices/cpuO/cpufreq/stats/time in state 
结果 如 图 37.4.1.5 所 示 : 


EN GO CET OS # cat time_in_state 
198000 26736 

396000 419 

528000 2995 

/sys/devices/system/cpu/cpu0/cpufreq/stats # 


















































图 37.4.1.5 CPU 运行 频率 统计 
从 图 37.4.1.5 中 可 以 看 出 ，CPU 在 198MHz、396MHz 和 528MHz 都 工作 过 ， 其 中 198MHz 
的 工作 时 间 最 长 ! 假如 我 们 想 让 CPU 一 直 工 作 在 528MHz 那 该 怎么 办 ? 很 简单 ， 配置 Linux 内 
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核 ， 将 调频 策略 选择 为 performance。 或 者 修改 imx alientek emmc defconfig 文件 ， 此 文件 中 有 











下 面 几 行 : 











示例 代码 37.4.1.1 调频 策略 
41 CONFIG CPU FREQ DEFAULT GOV ONDEMAND=y 
42 CONFIG CPU FREQ GOV POWERSAVE-y 
43 CONFIG CPU FREQ GOV USERSPACE-y 
44 CONFIG CPU FREQ GOV INTERACTIVE-y 
第 41 行 ， 配 置 ondemand 为 默认 调频 策略 。 
第 42 行 ， 使 能 powersave 策略 。 
第 43 行 ， 使 能 userspace 策略 。 
第 44 行 ， 使 能 interactive 策略 。 
将 示例 代码 37.4.1.1 中 的 第 41 行 屏 蔽 掉 ， 然 后 在 44 行 后 面 添加 : 
CONFIG CPU FREQ GOV. ONDEMAND-y 
AR PB: 


















































示例 代码 37.4.2. 修改 调频 策略 

41 $CONFIG CPU FREQ DEFAULT GOV ONDEMAND-y 
42 CONFIG CPU FREQ GOV POWERSAVE-y 
43 CONFIG CPU FREQ GOV USERSPACE-y 
44 CONFIG CPU FREO GOV INTERACTIVE-y 
45 CONFIG CPU FREO GOV ONDEMAND-y 

修改 完成 以 后 重新 编译 Linux 内 核 ， 编 译 之 前 先 清理 一 下 工程 ! 因为 我 们 重新 修改 过 默认 
配置 文件 了 ， 编 译 完成 以 后 使 用 新 的 zImage 镜像 文件 重新 启动 Linux 。 再 次 查看 


/sys/devices/system/cpu/cpu0/cpufreq/ cpuinfo cur freq 文件 的 值 ， 如 图 37.4.1.6 所 示 : 
dr eti a ces/system/cpu/cpuO0/cpufreq £ cat cpuinfo. cur. freq 











































































































/sys/devices/system/cpu/cpuO0/cpufreq £ 
图 37.4.1.6 当前 CPU 频率 

从 图 37.4.1.6 可 以 看 出 ， 当 前 CPU 频率 为 528MHz 了 。 查 看 scaling governor 文件 看 一 下 
当前 的 调频 策略 ， 如 图 37.4.1.7 所 示 : 
/sys/devices/system/cpu/cpuO0/cpufreq £ cat scaling. governor 
performance 
/sys/devices/system/cpu/cpuO0/cpufreq # 

图 37.4.1.7 调频 策略 
从 图 37.4.1.7 可 以 看 出 当前 的 CPU 调频 策略 为 preformance， 也 就 是 高 性 能 模式 ， 一 直 以 最 

高 主 频 运行 。 

我 们 再 来 看 一 下 如 何 通过 图 形 化 界面 配置 Linux 内 核 的 CPU 调频 策略 ， 输 入 “make 
menuconfig” 打 开 Linux 内 核 的 图 形 化 配置 界面 ， 如 图 37.4.1.8 所 示 : 
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zuozhongkai@ubuntu: -/linux/IMXGULL/linux/temp/linux-imx-rel, imx, 4.1.15. 2.1.0 ga aliente! 





Linux/arm 4.1.15 Kernel Configuration 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). Highlighted letters are hotkeys. 
Pressing «Y» includes, «N» excludes, «M» modularizes features. Press «Esc»«Esc» to exit, «?» for Help, «/» for Search. 
Legend: [*] built-in [ ] excluded «M» module < > module capable 


General setup ---» 

Enable loadable module support ---» 
Enable the block layer ---» 

System Type ---» 

Bus support ---» 

Kernel Features ---» 

Boot options ---» 

I 
Floating point emulation ---> 
Userspace binary formats ---> 

i(*) 


< Exit > «Help» < Save > < Load > 


37.4.1.8 Linux 内 核 图 形 化 配置 界面 
进入 如 下 路 径 : 
CPU Power Management 
-> CPU Frequency scaling 
-> CPU Frequency scaling 
-> Default CPUFreq governor 


打开 默认 调频 策略 选择 界面 ， 选 择 “performance”， 如 图 37.1.4.9 所 示 : 


zuozhongkai@ubuntu: -/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 


Default CPUFreq governor 
Use the arrow keys to navigate this window or press the 
hotkey of the item you wish to select followed by the «SPACE 
BAR». Press «?» for additional information about this 


[xj TES 

( powersave 
userspace 
ondemand 


( 

( 

( conservative 
( interactive 


< Help > 





37.1.4.9 默认 调频 策略 选择 
在 图 37.1.4.9 中 选择 “performance” 即 可 ， 选 择 以 后 推出 图 形 化 配置 界面 ， 然 后 编译 Linux 
内 核 ， 一 定 不 要 清理 工程 ! 否则 的 话 我 们 刚刚 的 设置 就 会 被 清理 掉 。 编 译 完成 以 后 使 用 新 的 
zlmage 重启 Linux， 查 看 当前 CPU 的 工作 频率 和 调频 策略 。 
我 们 学 习 的 时 候 为 了 高 性 能 , 大 家 可 以 使 用 performance 模式 。 但 是 在 以 后 的 实际 产品 开发 
中 ， 从 省 电 的 角度 考虑 ， 建 议 大 家 使 用 ondemand 模式 ， 一 来 可 以 省 电 ， 二 来 可 以 减少 发 热 。 
2、 超 频 至 700MHz 


LMX6ULL 有 多 种 型 号 ， 按 照 工作 频率 可 以 分 为 528MHz、700Mhz( 实 际 696MHz)， 
800MHz( 实 际 792MHz) 和 900MHz( 实 际 频率 未 知 ， 应 该 在 900MHz 左右 )。 其 中 900MHz 的 不 
支持 RGB 屏幕 ,所 以 正点 原子 Linux 团队 没有 选择 ,而 700MHz 的 没有 工业 级 (工作 温度 -40~85” 
C 以 上 )， 因 此 也 没有 选择 700MHz 的 型 号 。 最 后 就 剩 下 了 528MHz 和 800MHz 的 ， 目 前 正点 原 
子 只 提供 了 528MHz 的 版 本 (型 号 为 MCIMX6Y2CVM08AB)， 至 于 800MHz 版 本 (型 号 为 
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MCIMX6Y2CVMO08AB) 的 核心 板 后 续 就 看 客户 的 需求 ， 如 果 有 需求 就 会 加 上 , 但 是 800MHz 版 











本 的 IMX6ULL 芯片 会 贵 


一 些 ， 成 本 会 上 涨 。 













































































虽然 正点 原子 的 LMX6U-ALPHA 开发 板 所 选择 的 LMX6ULL 标 称 最 高 只 能 工作 在 528MHz， 
但 是 其 是 可 以 超频 的 700MHz 的 (这 里 的 700MHz 实际 上 只 有 696MHz， 但 是 NXP 官方 宣传 其 
为 700MHz， 所 以 我 们 就 统一 称 为 700MHz IE). 
声明 : 
对 于 想 体验 一 下 高 性 能 的 朋友 体验 一 下 超频 ， 虽 然 笔 者 一 直 在 用 700MHz 来 测试 ， 而 且 正 
点 原子 的 LMX6U-ALPHA 开发 板 目 前 还 没有 出 现 过 超频 不 稳定 的 现象 发 生 , 但 是 ! 毕竟 是 超频 

















了 的 ， 肯 定 没 有 工作 在 528MHz 稳定 。 




























































































如 果 因 为 超频 带 了 任何 损坏 ， 正 点 原子 不 负 任何 责任 ! 

如 果 因 为 超频 带 了 任何 损坏 ， 正 点 原子 不 负 任何 责任 ! 

如 果 因 为 超频 带 了 任何 损坏 ， 正 点 原子 不 负 任何 责任 ! 

在 实际 的 产品 中 ， 禁 止 任何 超频 ! 务必 严格 按照 LIMX6ULL 手册 上 给 出 的 标准 工作 频率 来 
运行 !! 如 果 想 要 更 高 的 性 能 ， 请 购买 相应 型 号 的 处 理 器 ! 

看 到 这 里 ， 如 果 您 还 是 执意 要 超频 ， 那 么 就 接着 往 下 看 ， 如 果 要 放弃 超频 ， 那 就 跳 过 本 小 
节 ， 看 下 一 小 节 。 

超频 设置 其 实 很 简单 ， 修 改 一 下 设备 树 文件 imx6ull.dtsi 即 可 ,打开 imx6ull.dtsi， 找 到 下 
代码 : 

示例 代码 37.4.1.3 imx6ull.dtsi 文件 代码 段 

54 cpu0: cpuGO ( 
55 compatible = "arm,cortex-a7"; 
56 device type = emih 
57 reg = <0>; 
58 clock-latency = «61036»; /* two CLK32 periods */ 
59 operating-points -2 « 
60 J kaiz wy 9/ 
61 996000 1275000 
62 792000 1225000 
63 528000 1175000 
64 396000 1025000 
65 198000 2950000 
66 2g 
67 fsl,soc-operating-points = < 
68 Me Xdsbz OV v 
69 996000 1175000 
70 792000 1175000 
Yal 528000 1175000 
12) 396000 1175000 
33 198000 1175000 
74 >; 


示例 代码 37.4.1.3 就 是 设置 CPU 频率 的 , 第 61-65 行 和 第 69-73 行 就 是 IMX6ULL 所 支持 
的 频率 , 单位 为 KHz, 可 以 看 出 ILMX6ULL( 视 具体 型 号 而 定 ) 支 持 996MHz、792MHz、 528MHz、 


396MHz 和 198MHz。 在 上 一 小 节 中 ,我 们 知道 Linux 内 核 默认 支持 198MHz、396MHz 和 528MHz， 
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并 不 能 支持 到 792MHz， 说 明 MCIMX6Y2CVMOSAB 这 颗 芯 片 不 能 跑 到 792MHz。 我 们 在 示例 
代码 37.4.2.1 中 加 入 针对 696MHz 的 支持 ， 修 改 以 后 代码 如 下 : 

示例 代码 37.4.1.4 增加 696MHz 的 支持 





54 cpu0: cpuGO ( 


55 compatible - "arm,cortex-a7"; 
56 device type = "cpu"; 

e reg = «0»; 

58 clock-latency = «61036»; /* two CLK32 periods */ 
S9 operating-points - « 

60 p= Me we Sy 

61 996000 1275000 

62 792000 1225000 

63 696000 1225000 

64 528000 1175000 

65 396000 1025000 

66 198000 2950000 

67 > 

68 fsl,soc-operating-points = « 
69 [** kiz UV 9 

3/Q) 996000 1175000 

pil 2:92:00 0 91 9/5/0009) 

112; 696000 1175000 

TS) 528000 1175000 

74 396000 1175000 

75; 198000 1175000 

WII Sy 


第 63 行 ， 加 入 了 “696000 1225000”， 这 个 就 是 696MHz 的 支持 。 

第 72 行 ， 加 入 了 “696000 1175000”， 也 是 对 696MHz 的 支持 。 

修改 好 以 后 保存 , 并 且 编译 设备 树 , 在 Linux. 内 核 源 码 根 目 录 下 输入 如 下 命令 编译 设备 树 : 

Imake dtbs 

命令 “make dtbs” 只 编译 设备 树 文件 ， 也 就 是 将 .dts 编译 为 .dtb， 编 译 完成 以 后 使 用 新 的 设 
备 树 文件 imxóul-alientek emmc.dtb 启动 Linux . X JH U J8 fr d x fh 
/sys/devices/system/cpu/cpuO/cpufreq/ scaling available frequencies 的 内 容 ， 如 图 37.4.1.10 所 示 : 


/Sys/devices/system/cpu/cpuU/cpurreq £ cat scaling_avallable_Trequencies 
198000 396000 528000 696000 
/sys /devices/system/cpu/cpuO/cpufreq £ 


图 37.4.1.10 文件 scaling available frequencies 内 容 

从 图 37.4.1.11 可 以 看 出 ， 此 时 支持 了 696MHz。 如 果 设 置 调频 策略 为 performance， 那 么 处 
理 器 就 会 一 直 工 作 在 696MHz。 可 以 对 比 一 下 工作 在 528MHz 和 696MHz 下 的 BogoMIPS 的 值 ， 
528MHz 主 频 下 的 BogoMIPS 值 如 图 37.4.1.12 所 示 : 


























"n 


























955 


LMX6U AR Linux 驱动 开发 指南 e31E ABT 





原子 哥 在 线 教学 : www.yuanzige.com 论坛 :www.opendev.com 
/sys/devices/system/cpu/cpuU/cputreq # cat /proc/cpuinto 

processor 0 

model name : ARMv7 Processor rev 5 (v71) 

BogoMIPS : 8.00 

Features : half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt vfpd32 lpae 


CPU implementer : 0x41 
CPU architecture: 7 


CPU variant : 0x0 

CPU part : 0xc07 

CPU revision 

Hardware : Freescale i.MX6 Ultralite (Device Tree) 
Revision : 0000 

Serial 0000000000000000 


sva devices /avstes/cou/cpuü/ put Fed # 


37.4.1.12 528MHz 主 频 下 的 BogoMIPS 


696MHz 主 频 下 的 BogoMIPS 值 如 图 37.4.1.13 所 示 : 
全 信人 ae en # cat /proc/cpuinfo 


processor 
model name : No Processor rev 5 (v71) 

BogoMIPS : .54 

Features : half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt vfpd32 lpae 


CPU implementer : 0x41 
CPU architecture: 7 





CPU variant : 0x0 

CPU part : 0xc07 

CPU revision HER 

Hardware : Freescale i.MX6 Ultralite (Device Tree) 
Revision : 000 

Serial : 0000000000000000 


37.4.1.13 696MHz 主 频 下 的 BogoMIPS 
从 图 37.4.1.12 和 图 37.2.1.13 中 可 以 看 到 ，528MHz 和 696MHz 下 的 BogoMIPS 值 分 别 为 
8.00 和 10.54， 相 当 于 性 能 提升 了 (10.54/8)-1=31.75%。 





37.4.2 使 能 8 线 EMMC 驱动 
正点 原子 EMMC 版 本 核心 板 上 的 EMMC 采用 的 8 位 数据 线 ， 原 理 图 如 图 37.4.2.1 所 示 : 














图 37.4.2.1 EMMC 原理 图 
Linux 内 核 驱动 里 面 EMMC 默认 是 4 线 模 式 的 ，4 线 模式 肯定 没有 8 线 模 式 的 速度 快 ， 所 
以 本 节 我 们 将 EMMC 的 驱动 修改 为 8 线 模式 。 修 改 方法 很 简单 ， 直接 修 改 设备 树 即 可 ， 打 开 文 
ft imx6ull-alientek-emmc.dts， 找 到 如 下 所 示 内 容 : 
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示例 代码 37.4.2.1 imx6ull-alientek-emmc.dts 代码 段 


734 &usdhc2 ( 


T65 pinctrl-names - "default"; 

ESI pinctrl-0 2 «&pinctrl usdhc2»; 
Ten non-removable; 

TE status - "okay"; 

TEER 








关于 设备 树 的 原理 以 及 内 容 我 们 后 面 会 有 专门 的 章节 讲解 ， 示 例 代 码 37.4.2.1 中 的 代码 含 
义 我 们 现在 不 去 纠结 ， 只 需要 将 其 改 为 如 下 代码 即 可 : 
示例 代码 37.4.2.1 imx6ull-alientek-emmc.dts 代码 段 





734 &usdhc2 { 


TIS Pame trl naamnes = Kaerat Oae Omaa 
736 pinctrl-0 - «&pinctrl usdhc2 8bit»; 

3 51 pinctrl-i 2 «&pinctrl usdhc2 8bit 100mhz»; 

738 pinctrl-2 = «&pinctrl usdhc2 8bit 200mhz»; 

T29 bus-width = «8»; 

740 non-removable; 

741 Status = "okay"; 

742 ); 











limi 
Tad 

















修改 完成 以 后 保存 一 下 imx6ull-alientek-emmc.dts， 然 后 使 用 命令 “make dtbs" 
下 设备 树 ， 编 译 完成 以 后 使 用 新 的 设备 树 重启 Linux 系统 即 可 。 


新 编译 一 























37.4.3 修改 网 络 驱动 


因为 在 后 面 学 习 Linux. 驱动 开发 的 时 候 要 用 到 网 络 调试 驱动 ， 所 以 必须 要 把 网 络 驱 动 调 试 
好 。 在 讲解 uboot 移植 的 时 候 就 已 经 说 过 了 ， 正 点 原子 开发 板 的 网 络 和 NXP 官方 的 网 络 硬件 | 
不 同 ， 网 络 PHY 芯片 由 KSZ8081 换 为 了 LAN8720A， 两 个 网 络 PHY 芯片 的 复位 IO 也 不 同 。 
所 以 Linux 内 核 自 带 的 网 络 驱 动 是 驱动 不 起 来 LMX6U-ALPHA 开发 板 上 的 网 络 的 ， 需 要 做 修 
改 。 

1、 修 改 LAN8720 的 复位 引 脚 驱动 

ENETI1 复位 引 脚 ENET1 RST 连接 在 IM6ULL 的 SNVS_TAMPER7 这 个 引 脚 上 。ENET2 
的 复位 引 脚 ENET2 RST 连接 在 LMX6ULL 的 SNVS_TAMPER8 上 。 打 开设 备 树 文件 imx6ull- 
alientek-emmc.dts， 找 到 如 下 代码 : 


示例 代码 37.4.3.1 imx6ull-alientek-emmc.dts 代码 段 
394 me Erle 





























[T 















































EIS Eli c x 

586 MX6ULL PAD BOOT MODEO GPIO5 IO10 0x70a1 

587 MX6ULL PAD BOOT MODEl GPIO5 IOll 0x70a1 

588 MX6ULL PAD SNVS TAMPER7  GPIO5 1007 0x70a1 

589 MX6ULL PAD SNVS TAMPER8 GPIO5 IO08 . 0x80000000 
590 > 

591 }; 





示例 代码 37.4.3.1 中 第 588 和 589 行 就 是 初始 化 SNVS_TAMPER7 和 SNVS_TAMPER8 这 两 个 
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引 脚 的 ， 不 过 看 样子 好 像 是 作为 了 SPI4 的 IO ， 这 不 是 我 们 想 要 的 ， 所 以 将 588 和 589 这 两 行 
删除 掉 ! 删除 掉 以 后 继续 在 imx6ull-alientek-emmc.dts 中 找到 如 下 所 示 代 码 : 

示例 代码 37.4.3.2 imx6ull-alientek-emmc.dts 代码 段 














125 spi4 ( 

126 compatible - "spi-gpio"; 

3L27 d) pinctrl-names = "default"; 

3028 pinctrl-0 2 «&pinctrl spi4»; 

129 pinctrl-assert-gpios = «&gpio5 9 GPIO ACTIVE LOW»; 
133 cs-gpios = <&gpio5 7 0>; 





第 129 行 ， 设 置 GPIO5_IO08 为 SPI4 的 一 个 功能 引 脚 (我 也 不 清楚 具体 作为 什么 功能 用 )， 
而 GPIOS IO08 就 是 SNVS_TAMPER8 的 GPIO 功能 引 脚 。 

第 133 fr, 设置 GPIOS IO07 作为 SPI4 的 片 选 引 脚 , 而 GPIO5_ 1007 就 是 SNVS_TAMPER7 
的 GPIO 功能 引 脚 。 

现在 我 们 需要 GPIOS IO07 和 GPIOS IO08 分 别 作为 ENET1 和 ENET2 的 复位 引 脚 ， 而 不 
是 SPI4 的 什么 功能 引 脚 ,因此 将 示例 代码 37.4.3.2 中 的 第 129 行 和 第 133 行 处 的 代码 删除 掉 !11 
否则 会 干扰 到 网 络 复位 引 脚 ! 

继续 在 imx6ull-alientek-emmc.dts 中 找到 如 下 所 示 代 码 : 

示例 代码 37.4.3.3 imx6ull-alientek-emmc.dts 代码 段 

0% Blinetel enetle enetigrp d 























































































































































































































































































































SAO fsl,pins = « 

E MX6UL PAD ENET1 RX EN ENET] RX EN 0x1b0b0 
En MX6UL PAD ENET1 RX ER ENET] RX ER 0x1b0b0 
313 MX6UL PAD ENET1 RX DATAO ENET1 RDATAO0 0x1b0bp0 
314 MX6UL PAD ENET1 RX DATA1  ENET1 RDATAO1 0x1b0bp0 
3155 MX6UL PAD ENET1 TX EN ENET1 TX EN 0x1b0b0 
316 MX6UL PAD ENET1 TX DATAO0  ENET1 TDATAO0 0x1b0bp0 
253) MX6UL PAD ENET1 TX DATA1  ENET1 TDATAO1 0x1b0bp0 
318 MX6UL PAD ENET1 TX CLK  ENET1 REF CLK1 0x40015031 
EUN >; 

220) r8 

EN 

32/2 PMET nl cn 

223 fsl,pins =< 

324 MX6UL PAD GPIO1 IO07  ENET2 MDC Oxl1b0b0 
325 MX6UL PAD GPIO1 IO06  ENET2 MDIO 0x1b0b0 
326 MX6UL PAD ENET2 RX EN ENET2 RX EN 0x1b0b0 
pos MX6UL PAD ENET2 RX ER ENET2 RX ER 0x1b0b0 
328 MX6UL PAD ENET2 RX DATAO0 ENET2 RDATAO00 . Ox1b0bO 
329 MX6UL PAD ENET2 RX DATA1 ENET2 RDATAO1 0x1b0bp0 
330 MX6UL PAD ENET2 TX EN ENET2 TX EN 0x1b0b0 
3] MX6UL PAD ENET2 TX DATAO0 ENET2 TDATAO0 0x1b0b0 
2:32 MX6UL PAD ENET2 TX DATA1  ENET2 TDATAO1 0x1b0bp0 
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333 MX6UL PAD ENET2 TX CLK  ENET2 REF CLK2 0x4001b031 
334 2 

SIE Jg 


第 309-320 fT, pinctrl enetl 是 ENET1 的 IO 初始 化 配置 。 
第 322-335 行 ，pinctrl_enet2 是 ENET2 的 IO 初始 化 配置 。 
根据 示例 代码 37.4.3.3， 我 们 需要 将 ENETI 的 复位 IO 初始 化 配置 添加 到 pinctrl_enetl 中 ， 
将 ENET2 的 复位 IO 初始 化 配置 添加 到 pinctrl_enet2 中 ， 添 加 完成 以 后 的 代码 如 下 所 示 : 
示例 代码 37.4.3.4 imx6ull-alientek-emmc.dts 代码 段 



























































































































































S00omamee Menet Guxelcen d 

SAKO) fsl,pins - « 

Sil MX6UL PAD ENET1 RX EN ENET] RX EN 0x1b0b0 

312 MX6UL PAD ENET1 RX ER ENET1 RX ER 0x1b0b0 

Be MX6UL PAD ENET1 TX CLK  ENET1 REF CLK1 0x40015031 

319 MX6UL PAD SNVS TAMPER7  GPIO5 IO07 . 0x10B0/* ENET1 RESET */ 
320 > 

Eod e 

S 

349 joximGicEl exwenZs nol 

324 fsl,pins = < 

225 MX6UL PAD GPIOl1 IO07  ENET2 MDC Ox1b0b0 

326 MX6UL PAD GPIO1 IO06 ENET2 MDIO 0x1b0b0 

334 MX6UL PAD ENET2 TX CLK  ENET2 REF CLK2 0x40015031 

25 MX6UL PAD SNVS TAMPER8  GPIO5 IO08 0x10B0 /* ENET2 RESET */ 
336 >; 

SSPE 





第 319 47, ENETI 复位 引 脚 SNVS_TAMPER7 的 配置 代码 。 

第 335 行 ，ENET2 复位 引 脚 SNVS_TAMPER8 的 配置 代码 。 

修改 完成 以 后 记得 保存 一 下 imx6ull-alientek-emmc.dts， 网 络 的 复位 引 脚 驱动 就 修改 好 了 。 
2、 修 改 LAN8720A 的 PHY 地 址 


在 uboot 移植 章节 中 ， 我 们 说 过 ENETI 的 LAN8720A 地 址 为 0x0，ENET2 的 LAN8720A 
地 址 为 0x1。 在 imx6ull-alientek-emmc.dts 中 找到 如 下 代码 : 
示例 代码 37.4.3.5 imx6ull-alientek-emmc.dts 代码 段 









































171 &fecl ( 


JL 702 pinctrl-names = "default"; 

JL s pinctrl-0 2 «&pinctrl enetl»; 
174 phy mode = "rmii"; 

NE phy-handle = «&ethphyO0»; 

176 status = "okay"; 

jw Jg 

dE 3/8) 


179 &tec2 { 
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180 pinctrl-names = "default"; 

3L pinctrl-0 2 «&pinctrl enet2»; 

182 phy-mode = "rmii"; 

183 phy-handle = «&ethphyl»; 

184 Status = "okay"; 

185 

186 mdio ( 

187 faddress-cells = «1»; 

188 fsize-cells = «0»; 

le 

190 ethphy0: ethernet-phyQO ( 

JE compatible = "ethernet-phy-i 90/2, c Si MR 
1:577 reg = «2»; 

19:3) hg 

194 

T95 ethphyl: ethernet-phy@1 { 

196 compatible = "ethernet-phy-i 9012. S622. 8 
TO reg = <1>; 

iSS hg 

199 »g 

208 


第 171-177 ÍF, ENETI 对 应 的 设备 树 节 点 。 





























第 179-200 fT, ENET2 对 应 的 设备 树 节 点 。 但 是 第 186~198 行 的 mdio 节点 
fll ENET2 的 PHY 地 址 信息 。 将 示例 代码 37.4.3.5 改 为 如 下 内 容 : 
示例 代码 37.4.3.6 imx6ull-alientek-emmc.dts 代码 段 
171 &fecl { 








dT] pinctrl-names = "default"; 

17S pinctrl-0 2 «&pinctrl enetl»; 

174 phy- models "rmii"; 

yh phy-handle = <&ethphy0>; 

176 phy-reset-gpios = «&gpio5 / GPIO ACTIVE LOW»; 
JU phy-reset-duration = <26>; 

178 status = "okay"; 

dE ONES 

180 

181 &fec2 { 

JST pinctrl-names = "default"; 

183 pinctrl-0 2 «&pinctrl enet2»; 

184 phy-mode = "rmii"; 

185 phy-handle = «&ethphyl»; 

186 phy-reset-gpios = «&gpio5 98 GPIO ACTIVE LOW»; 
Kom phy-reset-duration = <26>; 

188 status - "okay"; 


960 














述 了 ENETI 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 

















原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
e9 

190 mdio ( 

je #address-cells = «1»; 

JL Og fsize-cells = «0»; 

19S 

194 ethphy0: ethernet-phy@0 { 

E95 compatible = "ethernet-phy-i 90/2. SI Se 
196 smsc,disable-energy-detect; 

IES reg = <0>; 

Me hg 

1:99) 

200 ethphyl: ethernet-phyG1 ( 

ZO compatible = "ethernet-phy-i S02 
202 smsc,disable-energy-detect; 

203 reg = «1»; 

204 }; 

205 Ig 

206 ); 




















78 176 40177 行 ,添加 了 ENETI 网 络 复位 引 脚 所 使 用 的 IO 7y GPIOS 1007, 低 电 平 有 效 。 
复位 低 电 平 信号 持续 时 间 为 26ms。 

第 186 和 187 fT, ENET2 网 络 复位 引 脚 所 使 用 的 IO 为 GPIOS IO08， 同 样 低 电 平 有 效 ， 持 
续 时 间 同 样 为 26ms。 
第 196 和 202 行 ,“smsc,disable-energy-detect” 表 明 PHY wri SMSC 公司 的 ， 这 样 Linux 内 
核 就 会 找到 SMSC 公司 的 PHY 芯片 驱动 来 驱动 LAN8720A。 
第 194 行 ， 注 意 “ethernet-phy@” 后 面 的 数字 是 PHY 的 地 址 ，ENETI1 的 PHY 地 址 为 0， 所 以 
“@” 后 面 是 0( 默 认为 2)。 

第 197 行 ，reg 的 值 也 表示 PHY 地 址 ，ENETI1 的 PHY 地 址 为 0， 所 以 reg=0。 
第 200 ÍT, ENET2 的 PHY 地 址 为 1， 因 此 “@” 后 面 为 1。 

第 203 行 ， 因 为 ENET2 的 PHY 地 址 为 1， 所 以 reg=1。 
至 此 ，LAN8720A 的 PHY 地 址 就 改 好 了 ， 保 存 一 下 imx6ull-alientek-emmc.dts 文件 。 然 后 使 用 

“make dtbs ”命令 重新 编译 一 下 设备 树 。 


3、 修 改 fec main.c 文件 


要 在 ILMX6ULL 上 使 用 LAN8720A ， 需 要 修改 一 下 Linux 内 核 源 码 ， 打 开 
drivers/net/ethernet/freescale/fec_main.c， 找 到 函数 fec_probe， 在 fec probe 中 加 入 如 下 代码 : 
示例 代码 37.4.3.7 imx6ull-alientek-emmc.dts 代码 段 







































































SEE 
3439 fec probe(struct platform device *pdev) 


3440 ( 

3441 struct tee enet private "rep, 
3442 exeo carrello MS el atc 
3443 struct net deyice -noev? 





3444 agoe aia aae were. s 0E 


3445 struct resource *r; 
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3446 Const Struct (Gu device ic vot iel; 


3447 statie ine cew iele 

3448 struct devices node vap = pdev=cev oft node, jy nedeg 
3449 djsnt mum e GSy 

3450 int num rx qs; 

3451 

3452 /* 设置 MX6UL PAD ENET1 TX CLK 和 和 MX6UL PAD ENET2 TX CLK 
3453 * 这 两 个 Io 的 复 用 寄存 器 的 SION 位 为 1。 










































































3454 wf 

Sat void . ionem *IMX6U ENET1 TX CLK; 

3456 void . iomem *IMX6U ENET2 TX CLK? 

3457 

3458 IMX6U ENET1 TX CLK = ioremap(0X020E00DC, 4); 
3459 writel(0X14, IMX6U ENET1 TX CIK); 

3460 

3461 IMX6U ENET2 TX CLK = ioremap(0X020E00FC, 4); 
3462 writel(0X14, IMX6U ENET2 TX CLK); 

3463 

3656 return ret; 

Sos 





第 3455-3462 就 是 新 加 入 的 代码 ， 如 果 要 在 LMX6ULL 上 使 用 LAN8720A 就 需要 设置 
ENETI 和 ENET2 的 TX_CLK 引 脚 复位 寄存 器 的 SION 位 为 1。 
4、 配 置 Linux 内 核 ， 使 能 LAN8720 驱动 


输入 命令 “make menuconfig”， 打 开 图 形 化 配置 界面 ， 选 择 使 能 LAN8720A 的 驱动 ， 路 径 
如 下 : 


-> Device Drivers 





-> Network device support 
-> PHY Device support and infrastructure 
-> Drivers for SMSC PHYs 
如 图 37.4.3.1 所 示 : 
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zuozhongkai@ubuntu: -/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 


PHY Device support and infrastructure 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes features. 
Press «Esc»«Esc» to exit, «?» for Help, «/» for Search. Legend: [*] built-in [ ] excluded 
«M» module < > module capable 


- PHY Device support and infrastructure 

*** MII PHY device drivers *** 

Drivers for Atheros AT803X PHYs 

Drivers for the AMD PHYs 

Drivers for Marvell PHYs 

Drivers for Davicom PHYs 

Drivers for Quality Semiconductor PHYs 
Drivers for the Intel LXT PHYs 

Drivers for the Cicada PHYs 

Drivers for the Vitesse PHYs 

k> Drivers for SMSC_PHYs 

Drivers for Broadcom PHYs 

Drivers for Broadcom 7xxx SOCs internal PHYs 
Driver for Broadcom BCM8706 and BCM8727 PHYs 
Drivers for ICPlus PHYs 

Drivers for Realtek PHYs 


EMVVVvVvvvvv 


< 
< 
< 
< 
< 
< 
< 
< 
< 


v 


< Exit» «Help» «Save» < Load > 











图 37.4.3.1 使 能 LAN8720A 驱动 

图 37.4.3.1 中 选择 将 “Drivers for SMSC PHYs” 编 译 到 Linux 内 核 中 ， 因 此 “<>” 里 面 变 
为 了 “*”LAN8720A 是 SMSC 公司 出 品 的 ， 因 此 勾 选 这 个 以 后 就 会 编译 LAN8720 驱动 ， 配 
置 好 以 后 退出 配置 界面 ， 然 后 重新 编译 一 下 Linux 内 核 。 

5S、 修改 smsc.c 文件 
在 修改 smsc.c 文件 之 前 先 说 点 题 外 话 ， 那 就 是 我 是 怎么 确定 要 修改 smsc.c 这 个 文件 的 。 在 
写本 书 之 前 我 并 没有 修改 过 smsc.c 这 个 文件 ,都 是 使 能 LAN8720A 驱动 以 后 就 直接 使 用 。 但 是 
我 在 测试 NFS 挂 载 文件 系统 的 时 候 发 现 文件 系统 挂 载 成 功率 很 低 ! 老 是 提示 NFS 服务 器 找 不 
到 ， 三 四 次 就 有 一 次 挂 载 失 败 ! RIEA. NFS 挂 载 就 是 通过 网 络 来 挂 载 文 件 系统 ， 这 样 做 的 
好 处 就 是 方便 我 们 后 续 调 试 Linux 驱动 。 既 然 老 是 挂 载 失 败 那 么 可 以 肯定 的 是 网 络 驱动 有 问题 ， 
网 络 驱动 分 两 部 分 : 内 部 MAC+ 外 部 PHY， 内 部 MAC 驱动 是 由 NXP 提供 的 ， 一 般 不 会 出 问 
题 ， 否 则 的 话 用 户 早 就 给 NXP 反馈 了 。 而 且 我 用 NXP 官方 的 开发 板 测试 网 络 是 一 直 正 常 的 ， 
但 是 NXP 官方 的 开发 板 所 使 用 的 PHY 沪 片 为 KSZ8081。 所 以 只 有 可 能 是 外 部 PHY， 也 就 是 
LAN8720A 的 驱动 可 能 出 问题 了 。 鉴 于 LAN8720A 有 “前 车 之 鉴 ” 那 就 是 在 uboot 中 需要 对 
LAN8720A 进行 一 次 软 复 位 ， 要 设置 LAN8720A 的 BMCR( 寄 存 器 地 址 为 0) 寄 存 器 bit15 为 1. 
所 以 我 猜测 ， 在 Linux 中 也 需要 对 LAN8720A 进行 一 次 软 复位 。 
首先 需要 找到 LAN8720A 的 驱动 文件 ，LAN8720A 的 驱动 文件 是 drivers/net/phy/smsc.c; 
在 此 文件 中 有 个 叫做 smsc phy reset 的 函数 ， 看 名 字 都 知道 这 是 SMSC PHY 的 复位 函数 ， 因 
此 ，LAN8720A 肯定 也 会 使 用 到 这 个 复位 函数 ， 此 函数 内 容 如 下 : 

示例 代码 37.4.3.8 smsc_phy_teset 函数 

GU statice int smse phy ieerer((stiuel phy device *jmyelew)j 
61 { 





















































































































































62 int rc - phy read(phydev, MII LAN83C185 SPECIAL MODES); 
63 TE (re <0) 

64 return rc; 

65 
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66 /* If the SMSC PHY is in power down mode, then set it 
67 * in all capable mode before using it. 

68 A 

69 if ((rc & MII LAN83C185 MODE MASK) == 

MII LAN83C185 MODE POWERDOWN) ( 

70 int timeout = 50000; 

p 

7/2 /* set "all capable" mode and reset the phy */ 

ES rc |= MII LAN83C185 MODE ALL; 

74 phy write(phydev, MII LAN83C185 SPECIAL MODES, rc); 
T5 phy write(phydev, MII BMCR, BMCR RESET); 

76 

75 /* wait end of reset (max 500 ms) */ 

78 do ( 

79 udelay(10); 

80 if (timeout-- == 0) 

81 return -l; 

82 rc —- phy read(phydev, MII BMCR); 

83 ) while (rc & BMCR RESET); 

84 } 

85 return 0; 

SIGNE 





第 69 fT, RA PHY Ab T power down 模式 的 时 候 第 70-83 行 的 代码 段 才 会 执行 。 











第 75 行 ， 向 LAN872A0 的 BMCR 寄存 器 写 入 BMCR_RESET， 也 就 是 对 LAN8720A 进行 





软件 初始 化 ， 所 以 smsc_phy reset 函数 会 对 LAN8720A 进行 软件 初始 化 。 





看 到 没 ， 只 有 LAN8720A 处 于 power down 模式 的 时 候 才 会 对 LAN8720A 进行 软 复 位 ， 但 
是 我 们 在 uboot 中 已 经 “唤醒 ”了 LAN8720A，LAN8720A 也 已 经 工作 了 ， 因 此 它 不 可 能 处 于 

















power down 模式 ， 进 而 就 没 法 对 LAN8720A 进行 软 复 位 。 因 此 ， 我 们 要 对 smsc_phy_reset 函数 














fT 








修改 ， 将 复位 相关 的 代码 从 条 件 语 句 中 提出 来 ， 不 管 LAN8720A 有 没有 工作 在 power 
down 模式 下 ， 只 要 调用 smsc phy reset. 函数 就 对 LAN8720A 进行 软 复位 ， 修 改 后 的 
smsc phy reset 函数 内 容 如 下 : 



































示例 代码 37.4.3.9 修改 后 的 smsc_phy_teset 函数 


GO starice int smee ye ee pay device nel) 














ol 

62 int rc = phy read(phydev, MII LAN83C185 SPECIAL MODES); 
63 If (re < 0) 

64 return rc; 

65 

66 /* If the SMSC PHY is in power down mode, then set it 
67 * in all capable mode before using it. 

68 e 

69 if ((rc & MII LAN83C185 MODE MASK) == 








MII LAN83C185 MODE POWERDOWN) ( 
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70 

Thil /* set "all capable" mode and reset the phy */ 

72 rc |= MII LAN83C185 MODE ALL; 

33 phy write(phydev, MII LAN83C185 SPECIAL MODES, rc); 
74 } 

qs 

76 phy write(phydev, MII BMCR, BMCR RESET); 

p /* wait end of reset (max 500 ms) */ 

78 int timeout = 50000; 

79 do ( 

80 udelay(10); 

81 if (timeout-- == 0) 

82 return -l; 

83 rc = phy read(phydev, MII BMCR); 

84 ) while (rc & BMCR RESET); 

85 

86 return 0; 

87 ]) 


重点 是 76~84 行 , 我 们 将 软 复位 代码 移出 来 , 这 样 每 次 调用 smsce. phy. reset 函数 LAN8720A 
都 会 被 软 复 位 。 修 改 以 后 基本 上 每 次 通过 NFS 挂 载 根 文件 系统 都 会 成 功 。 

6、 网 络 驱 动 测试 

修改 好 设备 树 和 Linux 内 核 以 后 重新 编译 一 下 ， 得 到 新 的 zmage 镜像 文件 和 imx6ull- 
alientek-emmc.dtb 设备 树 文 件 , 使 用 网 线 将 LMX6U-ALPHA 开发 板 的 两 个 网 口 与 路 由 器 或 者 电 
脑 连接 起 来 ， 最 后 使 用 新 的 文件 启动 Linux 内 核 。 启 动 以 后 使 用 “ifconfig” 命 令 查 看 一 下 当前 
活动 的 网 卡 有 哪些 ， 结 果 如 图 37.4.3.2 所 示 : 


Please press Enter to activate this console. 
/ # ifconfig 
/ # 












































图 37.4.3.2 ifconfig 命令 结果 
从 图 37.4.3.2 可 以 看 出 ， 当 前 没有 活动 的 网 卡 。 输 入 命令 “ifconfig -a” 来 查看 一 下 开发 板 
中 存在 的 所 有 网 卡 ， 结 果 如 图 37.4.3.3 所 示 : 
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|Z # ifconfig -a 

can0 Link encap:UNSPEC Hwaddr 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00 
NOARP MTU:16 Metric:1 
RX packets:0 errors:0 dropped:0 overruns:O frame:0 
TX packets:0 errors:0 dropped:0 overruns:O carrier:0 
collisions:0 txqueuelen:10 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 
Interrupt:27 

canl Link encap:UNSPEC Hwaddr 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00 
NOARP MTU:16 Metric:1 
RX packets:0 errors:0 dropped:0 overruns:O frame:0 
TX packets:0 errors:0 dropped:0 overruns:O carrier:0 
collisions:0 txqueuelen:10 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 
Interrupt:28 

| ethO Link encap:Ethernet  Hwaddr 00:04:9rF:04:D2:35 
BROADCAST MULTICAST MTU:1500 Metric:1 
RX packets:0 errors:0 dropped:0 overruns:0 frame:0 
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 
collisions:0 txqueuelen: 1000 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 

ethl Link encap:Ethernet  Hwaddr 00:04:9rF:04:D2:35 
BROADCAST MULTICAST MTU:1500 Metric:1 
RX packets:0 errors:0 dropped:O0 overruns:O frame:0 
TX packets:0 errors:0 dropped:0 overruns:O carrier:0 
collisions:0 txqueuelen:1000 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 

lo Link encap:Local Loopback 
LOOPBACK MTU:65536 WMetric:1 
RX packets:0 errors:0 dropped:0 overruns:O frame:0 
TX packets:0 errors:0 dropped:0 overruns:O carrier:0 
collisions:0 txqueuelen:O 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 

sit0 Link encap:IPv6-in-IPv4 
NOARP MTU:1480 Metric:1 
RX packets:0 errors:O dropped:0 overruns:O frame:0 
TX packets:0 errors:0 dropped:0 overruns:O carrier:0 
collisions:O0 txqueuelen:O 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 





37.4.3.3 开发 板 所 有 网 卡 











图 37.4.3.3 中 can0 和 canl 为 CAN 接口 的 网 卡 ，eth0 和 ethl 才 是 网 络 接口 的 网 卡 ， 其 中 
eth0 对 应 于 ENET1，ethl 对 应 于 ENET2。 使 用 如 下 命令 依次 打开 eth0 和 ethl 这 两 个 网 卡 : 

ifconfig eth0 up 

ifconfig ethl up 


网 卡 的 打开 过 程 如 图 37.4.3.4 所 示 : 


/ # ifconfig eth0 up 

fos. x ^-^. at eth0: Freescale FEC PHY driver [SMSC LAN8710/LAN8720] (mii. bus: phy. addr-20b4000. ethernet 
irq-- 

/ # fec 20b4000.ethernet eth0: Link is Up - 100Mbps/Full - flow control rx/tx 


/ # ifconfig ethl up 


Tas Ug c ues ina ethl: Freescale FEC PHY driver [SMSC LAN8710/LAN8720] (mii. bus: phy. addr-20b4000. ethernet 
irq-- 

i ADDRCONF (NETDEV UP): ethl: link is not ready 

/ # fec 2188000.ethernet ethl: Link is Up - cesi - flow control rx/tx 

IPv6: ADDRCONF(NETDEV CHANGE): ethl: link becomes read 

IPv6: ethl: IPv6 duplicate address fe80::204:9fff:fe04: Ya235 detected! 


/ 8$ r 
图 37.4.3.4 两 个 网 卡 打开 过 各 

从 图 37.4.3.4 中 可 以 看 到 “SMSC LAN8710/LAN8720” 字 样 ， 

就 是 我 们 前 面 使 能 的 SMSC 驱动 。 
再 次 输入 “ifconfig” 命 令 来 查看 一 下 当前 活动 的 网 卡 ， 结 果 如 图 37.4.3.5 所 示 : 


HE 





说 明 当 前 的 网 络 驱 动 使 用 的 
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/ # ifconfig 
eth0 Link encap:Ethernet Hwaddr 00:04:9F:04:D2:35 


inet6 addr: fe80::204:9fff:fe04:d235/64 Scope:Link 

UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 

RX packets:1643 errors:0 dropped:19 overruns:0 frame:0 
TX packets:12 errors:0 dropped:0 overruns:0 carrier:0 
collisions:0 txqueuelen:1000 

RX bytes:110575 (107.9 KiB) TX bytes:992 (992.0 B) 


eth1 Link encap:Ethernet Hwaddr 00:04:9F:04:D2:35 
inet6 addr: fe80::204:9fff:fe04:d235/64 Scope:Link 
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 
RX packets:1394 errors:0 dropped:18 overruns:0 frame:0 
TX packets:3 errors:0 dropped:0 overruns:0 carrier:0 
collisions:0 txqueuelen:1000 
RX bytes:94453 (92.2 KiB) TX bytes:258 (258.0 B) 


37.4.3.5 当前 活动 的 网 卡 。 

可 以 看 出 ， 此 时 eth0 和 ethl 两 个 网 卡 都 已 经 打开 ,， 并且 工 作 正常 ， 但 是 这 两 个 网 卡 都 还 没 
有 IP 地 址 ， 所 以 不 能 进行 ping 等 操作 。 使 用 如 下 命令 给 两 个 网 卡 配置 IP 地 址 : 

ifconfig eth0 192.168.1.251 

ifconfig ethl 192.168.1.252 

上 述 命令 配置 eth0 和 ethl 这 两 个 网 卡 的 IP 地 址 分 别 为 192.168.1.251 和 192.168.1.252， 注 
意 IP 地 址 选择 的 合理 性 ， 一 定 要 和 自己 的 电脑 处 于 同一 个 网 段 内 ， 并 且 没 有 被 其 他 的 设备 占 
用 ! 设置 好 以 后 ， 使 用 “ping” 命 令 来 ping 一 下 自己 的 主机 ， 如 果 能 ping 通 那 说 明 网 络 驱动 修 
改 成 功 ! 比如 我 的 Ubuntu 主机 IP 地址 为 192.168.1.250， 使 用 如 下 命令 ping 一 下 : 

ping 192.168.1.250 
结果 如 图 37.4.3.6 所 示 : 


/ # ping 192.168.1.250 

PING 192.168.1.250 (192.168.1.250): 56 data bytes 

64 bytes from 192.168.1.250: seq=0 tt1=64 time-0.906 ms 
64 bytes from 192.168.1.250: seq-1 tt1=64 time-1.016 ms 
64 bytes from 192.168.1.250: seq-2 tt1=64 time-0.893 ms 
^C 


--- 192.168.1.250 ping statistics --- 
3 packets transmitted, 3 packets received, 0% packet loss 
/z iue min/avg/max = 0.893/0.938/1.016 ms 























T 




















图 37.4.3.6 ping 结 
可 以 看 出 ，ping 成 功 ， 说 明 网 络 驱动 修改 成 功 ! 我 们 在 后 面 的 构建 根 文 件 系统 和 Linux I 
动 开 发 中 就 可 以 使 用 网 络 调试 代码 啦 ， 好 哮 森 ! 








x 


37.4.4 保存 修改 后 的 图 形 化 配置 文件 


在 修改 网 络 驱动 的 时 候 我 们 通过 图 形 界面 使 能 了 LAN8720A 的 驱动 ， 使 能 以 后 会 在 .config 
中 存在 如 下 代码 : 

CONFIG MICREL PHY-y 

打开 drivers/met/phy/Makefile， 有 如 下 代码 : 

示例 代码 37.4.4.1 drivers/net/phy/Makefile 代码 段 

11 obj-$(CONFIG SMSC PHY) += smsc.o 

当 CONFIG SMSC PHY-y 的 时 候 就 会 编译 smsc.c 这 个 文件 , smsc.c 就 是 LAN8720A 的 驱 
动 文件 。 但 是 当 我 们 执行 “make clean ”清理 工程 以 后 .config 文件 就 会 被 删除 掉 ， 因 此 我 们 所 有 
的 配置 内 容 都 会 丢失 ， 结 果 就 是 前 功 尽 弃 ， 一 “ 删 ” 回 到 解放 前 ! 所 以 我 们 在 配置 完 图 形 界面 
以 后 经 过 测试 没有 问题 ， 就 必须 要 保存 一 下 配置 文件 。 保 存 配置 的 方法 有 两 个 。 
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1、 直 接 另 存 为 .config 文件 

既然 图 形 化 界面 配置 后 的 配置 项 保存 在 .config 中 ， 那 么 就 简单 粗暴 ， 直 接 将 .config 文件 另 
存 为 imx alientek emmc defconfig， 然 后 其 复制 到 arch/arm/configs 目录 下 ， 蔡 换 以 前 的 
imx alientek emmc defconfig。 这 样 以 后 执行 “make imx alientek emmc _defconfig” 重 新 配置 
Linux 内 核 的 时 候 就 会 使 用 新 的 配置 文件 ， 默 认 就 会 使 能 LAN8720A 的 驱动 。 

2、 通 过 图 形 界 面 保存 配置 文件 

相 比 于 第 1 种 直接 另存 为 .config 文件 ， 第 2 种 方法 就 很 “文雅 ”了 ， 在 图 形 界面 中 保存 配 
置 文件 ， 在 图 形 界 面 中 会 有 “< Save >” 选 项 ， 如 图 37.4.4.1 所 示 : 


zuozhongkai@ubuntu: -/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 





Linux/arm 4.1.15 Kernel Configuration 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, <N> excludes, «M» modularizes features. 
Press «Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in [ ] excluded 
«M» module < > module capable 


[*] Enable loadable module support ---» 
[*] Enable the block layer ---» 

System Type ---» 
4 (+) 


<Exit> < Help > 





图 37.4.4.1 保存 配置 
通过 键盘 的 “一 ” 键 , 移动 到 “< Save >” 选 项 , 然后 按 下 回 车 键 , 打开 文件 名 输入 对 话 框 ， 
如 图 37.4.42 所 示 : 





A zuozhongkai@ubuntu: ~/linux/IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 


Enter a filename to which this configuration 
should be saved as an alternate. Leave blank to 
abort. 


.config | 


« Help » 





图 37.4.4.2 输入 文件 名 
在 图 37.4.4.2 中 输入 要 保存 的 文件 名 ， 可 以 带路 径 ， 一 般 是 相对 路 径 ( 相 对 于 Linux 内 核 源 
人 码 根 目 录 )。 比 如 我 们 要 将 新 的 配置 文件 保存 到 目录 arch/arm/configs 下 ， 文 件 名 为 
imx alientek emmc defconfig, 也 就 是 用 新 的 配置 文件 蔡 换 掉 老 的 默认 配置 文件 。 那么 我 们 在 图 
37.4.4.2 中 输入 “arch/arm/configs/imx alientek emme defconfig” 即 可 ， 如 图 37.4.4.3 所 示 : 
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zuozhongkai@ubuntu: ~/linuxy/ 


设置 好 文件 名 以 后 选择 下 方 的 “< Ok >” 按钮 ， 保 存 文件 并 退出 。 退 出 以 后 再 打开 


IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 


论坛 :www.opendev.com 


Enter a fiLename to which this configuration 
should be saved as an alternate. Leave blank to 


abort. 


arch/arm/configs/imx alientek emmc defconfigli 


< Help > 


图 37.4.4.3 输入 文件 名 

















imx alientek emmc defconfig 文件 , 就 会 在 此 文件 中 找到 “CONFIG_MICREL PHY=y” 这 一 行 ， 








如 图 37.4.4.4 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 


CONFIG SMSC PHYzy 





图 37.4.4.4 新 的 配置 文件 





1278,31 


同样 的 , 使 用 “make imx alientek emmc defconfig” 重 新 配置 Linux 内 核 的 时 候 , LAN8720A 
的 驱动 就 会 使 能 ， 并 被 编译 进 Linux 镜像 文件 zImage 中 。 

关于 Linux 内 核 的 移植 就 讲解 到 这 里 ， 简 单 总 结 一 下 移植 步骤 ; 

O, ££ Linux 内 核 中 查找 可 以 参考 的 板子 ， 一 般 都 是 半导体 厂商 自己 做 的 开发 板 。 








@、 编 译 出 参考 板子 对 应 的 zImage 和 .dtb 文件 。 


















































©, SHST HI zImage 文件 和 .dtb 文件 在 我 们 所 使 用 的 板子 上 启动 Linux 内 核 ， 看 能 


否 启 动 。 


区、 如 果 能 局 动 的 话 就 万 事 大 吉 ， 如 果 不 能 局 动 那 就 翡 

















般 都 会 参考 半导体 官方 的 开发 板 设计 自己 的 硬件 ， 所 以 大 部 








Linux 内 核 用 到 的 外 设 不 多 ， 一 般 就 DRAM(Uboot 都 初始 化 好 的 ) 和 串口 。 作 为 终端 使 用 的 串 





一 般 都 会 参考 半导体 厂商 的 Demo f. 


©, EBAK 








KZJ, f£ NAND Flash, EMMC, SD FÆ 





Ef. mW Linux WA. 4X 
pa 
H 





分 情况 下 都 会 启动 起 来 。 








区 动 官方 的 Linux 内 核 都 是 已 经 








提供 好 了 ， 基 本 不 会 出 问题 。 重 点 是 网 络 驱 动 ， 因 为 Linux 驱动 开发 一 般 都 要 通过 网 络 调试 代 
码 ， 所 以 一 定 要 确保 网 络 驱动 工作 正常 。 如 果 是 处 理 器 内 部 MAC+ 外 部 PHY 这 种 网 络 方案 的 











x 


























位 引 脚 、PHY 地 址 信息 基本 上 都 可 以 驱动 起 来 。 








(6, Linux 内 核 启动 以 后 需要 根 文件 系统 , 如 果 没有 根 文 人 
内 核 移植 成 功 以 后 就 要 开始 根 文件 系统 的 构建 。 
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话 ， 一 般 网 络 驱 动 都 很 好 处 理 ， 因 为 在 Linux 内 核 中 是 有 外 部 PHY 通用 驱动 的 。 只 要 设置 好 复 























系统 的 话 肯 定 会 崩溃 , 所 以 确定 Linux 
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第 三 十 八 章 根 文件 系统 构建 





Linux “三 巨头 ”已 经 完成 了 2 个 了 ， 就 剩 最 后 一 个 rootfs( 根 文件 系统 ) 了 ， 本 章 我 们 就 来 学 
习 一 下 根 文 件 系统 的 组 成 以 及 如 何 构建 根 文 件 系统 。 这 是 Linux 移植 的 最 后 一 步 ， 根 文件 系统 
构建 好 以 后 就 意味 着 我 们 已 经 拥有 了 一 个 完整 的 、 可 以 运行 的 最 小 系统 。 以 后 我 们 就 在 这 个 最 
小 系统 上 编写 、 测 试 Linux 驱动 ， 移 植 一 些 第 三 方 组 件 ， 逐 步 的 完善 这 个 最 小 系统 。 最 终 得 到 
一 个 功能 完善 、 驱 动 齐全 、 相 对 完善 的 操作 系统 。 
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38.1 根 文件 系统 简介 
根 文件 系统 一 般 也 叫做 rootfs， 那 么 什么 叫 根 文件 系统 ? 看 到 “文件 系统 ”这 四 个 字 ， 很 多 








人 ， 包 括 我 第 一 反应 就 是 FATFS、FAT、EXT4、YAFFS 和 N 
根 文件 系统 并 不 是 FATFS 这 样 的 文件 
一 部 分 。Linux 中 的 根 文件 系统 更 像 是 一 个 文件 






































不 过 是 特殊 的 文件 夹 ),， 在 这 个 目录 里 面 会 有 很 多 的 子 目录 。 4 
件 ， 这 些 文件 是 Linux 运行 所 必须 的 ， 比 如 库 、 常 用 的 软件 和 命 
以 后 我 们 说 到 文件 系统 , 如 果 不 特别 指明 , 统一 表示 根 文 件 系 统 ,对 于 根 文件 系统 专业 的 解释 ， 

百度 百科 上 是 这 么 说 的 (原谅 我 把 百度 百科 引用 为 专业 解释 , 因为 我 实在 找 不 到 根 文件 系统 的 最 
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TFS į 


等 这 样 的 文件 系统 。 在 这 里 ， 
的 文件 系统 代码 属于 Linux 内 核 的 
录 ( 在 我 看 来 就 是 一 个 文件 来 ， 只 
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设备 文件 、 





民 目 录 下 和 子 目录 中 会 有 很 多 的 文 


令 、 





配置 文件 等 等 。 





初 定义 , 也 不 要 建议 我 到 哪些 404 网 站 去 查找 , 毕竟 我 胖 , 我 伯 翻 到 一 般 梯子 不 稳 把 我 摔 妖 了 ): 
根 文件 系统 首先 是 内 核 启 动 时 所 mount( 挂 载 ) 的 第 一 
根 文件 系统 中 ， 而 系统 引导 启动 程序 会 在 根 文件 系统 挂 载 之 后 从 中 把 一 些 基 本 的 初始 化 脚本 和 











服务 等 加 载 到 内 存 中 去 运行 。 


百度 百科 上 说 内 核 代码 镜像 文件 

















个 文件 系统 , 内 核 代码 映像 文件 保存 在 





保存 在 根 文 件 系 统 中 ， 但 是 我 们 内 入 式 Linux. 并 没有 将 内 





核 代 码 镜像 保存 在 根 文件 系统 中 , 而 是 保存 到 了 其 他 地 方 。 比 如 NAND Flash 的 指定 存储 地 址 、 

EMMC 专用 分 区 中 。 根 文件 系统 是 Linux 内 核 启动 以 后 挂 载 (mount) 的 第 一 个 文件 系统 , 然后 从 
根 文件 系统 中 读 取 初 始 化 脚本 ， 比 如 rcS，inittab 等 。 根 文件 系统 和 Linux 内 核 是 分 开 的 ， 单 独 
的 Linux 内 核 是 没 法 正常 工作 的 ， 必须 要 搭配 根 文件 系 统 。 如 果 不 提供 根 文件 系统 ，Linux 内 核 
































在 启动 的 时 候 就 会 提示 内 核 衣 演 (Kernel panic) 的 提示 ， 这 



































个 在 37.2.4 小 节 已 经 说 过 了 。 


根 文件 系统 的 这 个 “ 根 ” 字 就 说 明了 这 个 文件 系统 额 重要 性 ， 它 是 其 他 文件 系统 的 根 ， 没 


有 这 个 “ 根 ” 其 他 的 文件 系统 或 者 软 人 
其 实 就 是 一 个 个 小 软件 ， 只 是 这 些 软件 没有 
就 保存 在 根 文件 系统 中 ， 这 些小 软件 是 怎么 来 的 呢 ? 
构建 自己 的 根 文件 系统 ， 这 个 根 文件 












































根据 自己 的 实际 工作 需求 不 断 的 去 填充 这 个 最 


文件 系统 。 











图 形 界 

















F 就 别 想 工作 。 比 如 我 们 常用 的 ls、mv、ifconfig 等 命令 
在 ， 而 且 需 要 输入 命令 来 运行 。 这 些小 软件 


这 个 就 是 我 们 本 章 教程 的 目的 ， 教 大 家 来 





系统 是 满足 Linux 运行 的 最 小 根 文 件 系统 ， 后 续 我 们 可 以 














小 根 文件 系统 ， 最 终 使 其 成 为 一 个 相对 完善 的 根 


在 构建 根 文件 系统 之 前 ， 我 们 先 来 看 一 下 根 文件 











系统 里 面 大 概 都 有 些 什么 内 容 ， 以 Ubuntu 


为 例 ， 根 文件 系统 的 目录 名 字 为 “/”， 没 看 错 就 是 一 个 斜 枉 ， 所 以 输入 如 下 命令 就 可 以 进入 根 目 





FH: 
w /进入 根 目录 





进入 根 目录 以 后 输入 “ls” 命 








令 查 看 根 目录 下 的 内 容 都 有 哪些 ， 结 果 如 图 





38.1.1 所 示 : 




















SCRI SC TE RAL TUN T Linux 是 
1. /bin 目录 














就 讲 








图 38.1.1 Ubuntu 根 目录 
图 38.1.1 中 根 目录 下 子 目 录 和 文件 不 少 , 但 是 这 些 都 是 Ubuntu 所 需要 的 ， 
不 到 的 ， 所 以 这 里 


解 一 些 


Dd 


"m 








| 








的 子 目 录 : 

















其 中 有 很 多 子 目 





看 到 “bin” 大 家 应 该 能 想到 bin 文件 ，bin 文件 就 是 可 执行 文件 。 所 以 此 目录 下 存放 着 系统 
。 此 目录 下 的 命令 所 有 的 客户 都 可 


要 的 可 执行 文件 ， 一 般 都 是 一 
以 使 用 。 





些 命令 ， 比 如 ls、mv 
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2. /dev 目录 

dev 是 device 的 缩写 ， 所 以 此 目录 下 的 文件 都 是 和 设备 有 关 的 ， 此 目录 下 的 文件 都 是 设备 
X ft. Æ Linux 下 一 切 丝 文件 ， 即 使 是 硬件 设备 ， 也 是 以 文件 的 形式 存在 的 ， 比 如 
/dev/ttymxc0(I.MX6ULL 根 目 录 会 有 此 文件 ) 就 表示 IMX6ULL 的 串口 0， 我 们 要 想 通过 串口 0 
发 送 或 者 接收 数据 就 要 操作 文件 /dev/ttymxc0， 通 过 对 文件 /dev/ttymxc0 的 读 写 操作 来 实现 串口 
0 的 数据 收发 。 

3. /etc 目录 

此 目录 下 存放 着 各 种 配置 文件 ， 大 家 可 以 进入 Ubuntu 的 etc 目录 看 一 下 ， 里 面 的 配置 文件 
非常 多 ! 但 是 在 艇 入 式 Linux 下 此 目录 会 很 简洁 。 

4、/lib 目录 

lib 是 library 的 简称 ， 也 就 是 库 的 意思 ， 因 此 此 目录 下 存放 着 Linux 所 必须 的 库 文件 。 这 些 
库 文件 是 共享 库 ， 命 令 和 用 户 编写 的 应 用 程序 要 使 用 这 些 库 文件 。 

5, /mt 目录 

临时 挂 载 目录 ， 一 般 是 空 目 录 ， 可 以 在 此 目录 下 创建 空 的 子 目 录 ， 比 如 /mnt/sd、/mnt/usb， 
这 样 就 可 以 将 SD 卡 或 者 U 盘 挂 载 到 /mnt/sd 或 者 /mnt/usb 目录 中 。 

6. /proc 目录 

此 目录 一 般 是 空 的 ， 当 Linux 系统 启动 以 后 会 将 此 目录 作为 proc 文件 系统 的 挂 载 点 ，proc 
是 个 虚拟 文件 系统 ， 没 有 实际 的 存储 设备 。proc 里 面 的 文件 都 是 临时 存在 的 ， 一 般 用 来 存储 系 
统 运行 信息 文件 。 

7、/usr 目录 

要 注意 ，usr 不 是 user 的 缩写 ， 而 是 Unix Software Resource 的 缩写 ， 也 就 是 Unix 操作 系统 
软件 资源 目录 。 这 里 有 个 小 知识 点 , 那 就 是 Linux 一 般 被 成 为 类 Unix 操作 系统 , 苹果 的 MacOS 
也 是 类 Unix 操作 系统 。 关 于 Linux 和 Unix 操作 系统 的 渊源 大 家 可 以 直接 在 网 上 找 Linux 的 发 
展 历史 来 看 。 既 然 是 软件 资源 目录 ， 因 此 /usr 目录 下 也 存放 着 很 多 软件 ， 一 般 系 统 安装 完成 以 
后 此 目录 占用 的 空间 最 多 。 

8. /var 目录 

此 目录 存放 一 些 可 以 改变 的 数据 。 

9、/sbin 目录 

此 目录 页 用 户 存放 一 些 可 执行 文件 ,但 是 此 目录 下 的 文件 或 者 说 命令 只 有 管理 员 才 能 使 用 ， 
主要 用 户 系统 管理 。 

10, /sys 目录 

系统 启动 以 后 此 目录 作为 sysfs 文件 系统 的 挂 载 点 ，sysfs 是 一 个 类 似 于 proc 文件 系统 的 特 
殊 文 件 系统 ，sysfs 也 是 基于 ram 的 文件 系统 ， 也 就 是 说 它 也 没有 实际 的 存储 设备 。 此 目录 是 系 
统 设备 管理 的 重要 目录 ， 此 目录 通过 一 定 的 组 织 结构 向 用 户 提供 详细 的 内 核 数据 结 构 信 息 。 

11. /opt 

可 选 的 文件 、 软 件 存放 区 ， 由 用 户 选择 将 哪些 文件 或 软件 放 到 此 目录 中 。 
关于 Linux 的 根 目 录 就 介绍 到 这 里 ， 接 下 来 的 构建 根 文件 系统 就 是 研究 如 何 创建 上 面 这 些 子 目 
录 以 及 子 目 录 中 的 文件 。 
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38.2 BusyBox 构建 根 文 件 系统 


38.2.1 BusyBox 简介 








上 一 小 节 说 了 ， 根 文件 系统 里 面 就 是 一 堆 的 可 执行 文件 和 其 他 文件 组 成 的 ? 难道 我 们 得 一 
个 一 个 的 从 网 上 去 下 载 这 些 文件 ? 显然 这 是 不 现实 的 ! 那么 有 没有 人 或 者 组 织 专门 干 这 个 事 呢 ? 
他 们 负责 “收集 ”这 些 文件 ， 然 后 将 其 打包 ， 像 我 们 这 样 的 开发 者 可 以 直接 拿 来 用 。 答 案 是 有 
的 ， 它 就 叫做 BusyBox! 其 名 字 分 为 “Busy” 和 “Box”， 也 就 是 忙碌 的 盒子 。 盒 子 是 用 来 放 东 
西 的 ， 忙 碌 的 是 因为 它 要 提供 根 文件 系统 所 需 的 文件 ， 所 以 忙碌 。BusyBox 是 一 个 集成 了 大 量 
的 Linux 命令 和 工具 的 软件 ， 像 ls、mv、ifconfig 等 命令 BusyBox 都 会 提供 。BusyBox 就 是 一 
个 大 的 工具 箱 ， 这 个 工具 箱 里 面 集成 了 Linux 的 许多 工具 和 命令 。 一 般 下 载 BusyBox 的 源码 ， 
然后 配置 BusyBox， 选 择 自己 想 要 的 功能 ， 最 后 编译 即 可 。 

BusyBox 可 以 在 其 官网 下 载 到 ， 官 网 地 址 为 : https:/busybox.net， 官 网 比较 简陋 ， 如 图 
38.2.1.1 所 示 : 


e © BusyBox x | 十 


> GC Q p & https;//busybox.net/ 


© BUSYBOX 













































































zt 
JU 
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口 





About * The Software Fr Conse acts as the GPL enforcement agent for various BusyBox copyright holders. 


If you wish to report a GPL violation on BusyBox, please write to gpl(obusybox.net. 
* About BusyBox 


e BusyBox in VM * Life without systemd. 
e Screenshot 


十 


* Announcements 


* | want to thank the following companies which are providing support for the BusyBox project: 


Documentation o Analog Devices, Inc. provided a Blackfin development board free of charge. Blackfin is a NOMMU 
processor, and its availability for testing is invaluable. If you are an embedded device developer, please 
* FAQ note that Analog Devices has an entire Linux distribution available for download for this board. Visit 


* Command Help 
Get BusyBox 


* Download Source 


http//blackfin.uclinux.org/ for more information. 


* 10 June 2019 -- BusyBox 1.31.0 (unstable) 


BusyBox 1.31.0. (git, patches, how to add a patch) 


* Download Binaries 
e License Sizes of busybox-1.30.1 and busybox-1.31.0 (with equivalent config, static uclibc build): 
* Products text data bss dec hex filename 
1008478 487 7436 1016401  f8251 busybox-1. 30. 1 
Development 1008392 482 7428 1016302  fSlee busybox-1.31.0 


* Browse Source 
e Source Control 
* Mailing Lists 
e Bug Tracking 











Changes since previous release: 


Aaro Koskinen: 


sysctl: fix compatibility with procps sysctl 





38.2.1.1 BusyBox 官网 


在 官网 左 侧 的 “Get BusyBox" £L —11 “Download Source", 点 击 “Download Source" RẸ 





可 打开 BusyBox 的 下 载 页 ， 如 图 38.2.1.2 所 示 : 
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xi F tj 一 口 x 
& https;//busybox.net/downloads 点 此 搜索 x-Q-.dgd.-.N -三 
UET bust 12-30 15:13 7.2M 
[$1 b 2018-12-30 15:13 89 
[2 b 8-12-30 15:13 72 
A, 2019-02-14 14:27 7.4M 
[2 b 2019-02-14 14:27 89 
[2 L 2019-02-14 14:27 72 
[2 b z2 2019-06-10 10:52 2.3 
[2 b 2019-06-10 10:5 
is b 2019-06-10 10:5 
十 2] busyt 2019-06-12 00:20 2.3M 
EN i J-0€ - 人 - E 








图 38.2.1.2 BusyBox 下 载 页 

从 图 38.2.1.2 可 以 看 出 ， 目 前 最 新 的 BusyBox 版 本 是 1.31.0， 不 过 我 建议 大 家 使 用 我 们 开 
AR tI] 1.29.0 版 本 的 BusyBox。 因 为 笔者 测试 1.29.0 版 本 目前 还 没有 出 现任 何 问 
题 ， 路 径 为 : 1、 例 程 源码 ->6、BusyBox 源码 ->busybox-1.29.0.tarbz2，BusyBox 准备 好 以 后 就 
可 quiere bien o 












































38.2.2 编译 BusyBox 构建 根 文件 系统 


一 般 我 们 在 Linux 驱动 开发 的 时 候 都 是 通过 nfs 挂 载 根 文 件 系统 的 ， 当 产品 最 终 上 市 开 卖 
的 时 候 才 会 将 根 文件 系统 烧 写 到 EMMC 或 者 NAND 中 。 所 以 要 在 4.2.1 小 节 中 设置 的 nfs 服务 
器 目录 中 创建 一 个 名 为 rootfs 的 子 目 录 ( 名 字 大 家 可 以 随意 起 ， 为 了 方便 就 用 了 rootfs)， 比 如 我 
的 电脑 中 “/home/zuozhongkai/linux/nfs” 就 是 我 设置 的 NFS 服务 器 目录 ， 使 用 如 下 命令 创建 名 
X rootfs 的 子 目 录 : 

mkdir rootfs 

创建 好 的 rootfs 子 目 录 就 用 来 存放 我 们 的 根 文 件 系统 了 。 

将 busybox-1.29.0.tar.bz2 发 送 到 Ubuntu 中 ， 存 放 位 置 大 家 随便 选择 。 然 后 使 用 如 下 命令 将 
其 解压 : 

tar -vxjf busybox-1.29.0.tar.bz2 

解压 完成 以 后 进入 到 busybox-1.29.0 目录 中 ， 此 目录 中 的 文件 和 文件 夹 如 图 38.2.2.1 所 示 : 





















































$ cd busybox-1.29.0/ 
$ ls 
Makefile NOFORK NOEXEC. lst 
INSTALL Makefile.custom 
Makefile.flags 
Makefile.help 


AUTHORS 
Config.in LICENSE README TODO 
TODO unicode 





图 38.2.2.1 busybox-1.29.0 目录 内 容 
1、 修 改 Makefile， 添 加 编译 器 


同 Uboot 和 Linux 移植 一 样 ， 打 开 busybox 的 顶层 Makefile， 添 加 ARCH 和 CROSS_COMPILE 
的 值 ， 如 下 所 示 : 





示例 代码 38.2.2.1 Makefile 代码 段 
164 CROSS COMPILE ?= /usr/local/arm/gcc-linaro-4.9.4-2017.01- 


x86 64 arm-linux-gnueabihf/bin/arm-linux-gnueabihf- 





190 ARCH ?= arm 
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在 示例 代码 38.2.2.1 中 CORSS_COMPILE 使 用 了 绝对 路 径 ! 主要 是 为 了 防止 编译 出 错 。 


2、busybox 中 文字 符 支 持 





Ne 


如 果 默 认 直 接 
































中 的 shell 命令 对 中 文 输入 即 显示 做 了 限 
Ze 
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有 译 busybox 的 话 ， 在 使 用 SecureCRT 的 时 候 中 文 











Pr Ar EE 








字符 是 显示 不 正常 的 ， 中 文字 
符 会 显示 为 “2”， 比 如 你 的 中 文 目录 ， 中 文 文件 都 显示 为 “?2”。 不 知道 从 哪个 版 本 开始 busybox 








所 以 我 们 需要 修改 busybox 源码 ， 取 消 busybox 对 中 文 显示 的 限制 ， 打 玫 
1.29.0Vlibbb/printable_string.c， 找 到 函数 printable_string， 缩 减 后 的 函数 内 容 如 下 : 
示例 代码 38.2.2.2 libbb/printable string.c 代码 段 

12 conet Cherw PAST PUNG printable stringluni stat t vstats, Const Char 


*str) 
IBe 


damanm kdo t, 





























eonst ehar tS, 

16 

J C3 mue 

18 while (1) ( 

3159) unsigned char c = *s; 

20 if (c == '\0') ( 

28 } 

29 SER CCS) 

30 break; 

Sl if (c >= Ox7f) 

82 break; 

E Sum g 

34 } 

35 

SGI ENABLE UNICODE SUPPORT 

37 det = unicoce Cony tO printablelstats, miti) 
38 #else 

39 - i 

40 char *d - dst = xstrdup(str); 
41 while (!) ( 

42 unsigned char c = *d; 

43 if (c == ' M0!) 

44 break; 

45 Tf (CEU ME E OSEE) 
46 wol c WB 

47 dtt; 

48 } 

55 #endif 
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56 return auto string (dst); 
MS 

98 31 48132 行 ， 当 字符 大 于 OXTF 以 后 就 跳出 去 了 。 

第 45 和 46 ÍT, WRF UNICODE 码 的 话 ， 当 字符 大 于 0X7F 就 直接 输出 “?’。 

所 以 我 们 需要 对 这 4 行 代码 进行 修改 ， 修 改 以 后 如 下 所 示 : 

示例 代码 38.2.2.3 libbb/printable string.c 代码 段 

12 gonst clueurt! PAST PUNG printable stringluni stat t vstats, Const Chien 
*str) 
IPSE T 
Menar vele 























eonse chari S 
16 
= 


18 while (1) { 

















30 if (ce < ) 

Syl break; 

32 /* 注释 掉 下 面 这 个 两 行 代码 */ 
EE f sb (e me su 

34 break; */ 

au Sb 

DOES 

E 

















38 £if ENABLE UNICODE SUPPORT 


39) det = unicode Cony i printable (stats, sti) 


40 #else 

AT i 

42 char *d - dst = xstrdup(str); 
43 while (l) ( 

44 unsigned char c =< *d; 

45 if (c == 'X0') 

46 break; 

47 /* 修改 下 面 代码 */ 

48 je ab e a N E S e 
49 ael ene Uu) 

50 son= N, 

5l Charh 

52 } 

59 #endif 

60 return auto string (dst); 

TS 
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示例 代码 38.2.2.3 中 红色 部 分 的 代码 就 是 被 修改 以 后 的 ， 主 要 就 是 禁止 字符 大 于 0X7F 以 
后 break 和 输出 “? ”。 
接着 打开 文件 busybox-1.29.0/libbb/unicode.c， 找 到 如 下 内 容 : 
示例 代码 38.2.2.4 libbb/unicode.c 代码 段 
100S se Ee Chare PASEL DUNC eel Cony Nall (uml Stat T 











omatsy Const ehar ep un emo en as) 
1004 ( 

1005 Gmeus tels? 

1006 wumeibenaexo! ele lenm; 

1007 unsigned uni count; 


1008 unsigned uni width; 





1009 

1010 if (unicode status l= UNICODE ON) < 
KOND! Char Ead 

TO if (flags & UNI FLAG PAD) { 

TONS d = dst = xmalloc(width + T); 
1022 satt = (e >= gge e < ORE 2 
102S smet 

1024 } 

dL wxgl c2 NO 

1026 ) else { 

21012777 d —- dst = xstrndup(src, width); 
1028 while (*d) ( 

OZS unsigned char c = *d; 
1030 if (e[s Uu UE e xe eem 
1031 E 

1.018) dtt; 

35/515] ) 

1034 } 

1040 return dst; 

1041 } 

LSO 

rT return dst; 

Abas 2 


第 1022 行 ， 当 字符 大 于 OXTF 以 后 ，*d++ 就 为 “?’。 
第 1030 和 1031 行 ， 当 字符 大 于 0X7F 以 后 ，*d 也 为 “?’。 
修改 示例 代码 38.2.2.4， 修 改 后 内 容 如 下 所 示 : 
示例 代码 38.2.2.5 libbb/unicode.c 代码 段 
14005; ptatic chers BAST PUNC unicode cony meme 


*stats, const char *src, unsigned width, int flags) 
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1004 ( 

TOOS (meus /Es 

1006 punsmonecdacdsugiren 

1007 unsigned uni count; 

1008 unsigned uni width; 

1009 

1010 if (unicode status !- UNICODE ON) ( 

3: (0L 31. Gael 

1012 if (flags & UNI FLAG PAD) ( 

TONS d = dst = xmalloc(width + |); 
1022 /* f£ P] TRE */ 

1023 [5s *gHe o (ee duese m e 
1024 sdrk cuc nuc tit 
380/225; Se 

1026 } 

OZAT wp c VOUS 

1028 ) else { 

1029 d —- dst - xstrndup(src, width); 
1030 while (*d) ( 

OSI unsigned char c = *d; 

1032 /* AEG PIE - 414A */ 

OSS | 
1034 工人 (ce < uY) 

1035 XLS Ue 

1036 dtt; 

1037 } 

1038 } 

1044 return dst; 

1045 ) 

1047 

1048 return dst; 

1049 ) 


TER 








示例 代码 38.2.2.5 中 红色 部 分 的 代码 就 是 被 修改 以 后 的 , 同村 
时 候 设置 为 “? ”。busybox 中 文字 符 支 持 跟 代码 修改 有 关 的 就 改 好 了 ， 
来 使 能 unicode 码 ， 这 个 稍 后 我 们 配置 busybox 的 时 候 在 设置 。 


3、 配 置 busybox 
































主要 是 


(e 


Ei 
Ed 


Hx 


论坛 :www.opendev.com 


禁止 字符 大 于 0X7F 的 


后 还 需要 配置 busybox 





根 我 们 编译 Uboot、Linux kernel 一 样 ， 我 们 要 先 对 busybox 进行 默认 的 配置 ， 有 一 下 几 种 











配置 选项 : 
GD、defconfig， 缺 省 配置 ， 也 就 是 默认 配置 选项 。 
人 @、allyesconfig， 全 选 配 置 ， 也 就 是 选中 busybox 的 所 有 功能 。 
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@、allnoconfig， 最 小 配置 。 
我 们 一 般 使 用 默认 配置 即 可 ， 因 此 使 用 如 下 命令 先 使 用 默认 配置 来 配置 一 下 busybox: 
make defconfig 
busybox 也 支持 图 形 化 配置 ， 通 过 图 形 化 配置 我 们 可 以 进一步 选择 自己 想 要 的 功能 ， 输 入 
如 下 命令 打开 图 形 化 配置 界面 : 
make menuconfig 


打开 以 后 如 图 38.2.2.2 所 示 : 


zuozhongkai@ubuntu: ~/linux/busybox/busybox-1.29.0 











Biisybox configuration 
Arrow keys navigate the menu. «Enter» selects submenus ---». Highlighted letters are hotkeys. Pressing 
«Y» includes, «N» excludes, «M» modularizes features. Press «Esc»«Esc» to exit, «?» for Help, </> for 
Search. Legend: [*] built-in [ ] excluded «M» module < > module capable 


--- Applets 
Archival Utilities ---» 
 oreutils ---» 
 onsole Utilities ---» 
 ebian Utilities ---» 
 libc-utils ---> 
Editors ---» 
 inding Utilities ---» 
init Utilities ---» 


> « Exit » < Help > 





38.2.2.2 busybox 图 形 化 配置 界面 
配置 路 径 如 下 ; 
Location: 
-> Settings 
-> Build static binary (no shared libs) 

选项 “Build static binary (no shared libs)” 用 来 决定 是 静态 编译 busybox 还 是 动态 编译 ， 静 
态 编译 的 话 就 不 需要 库 文件 ， 但 是 编译 出 来 的 库 会 很 大 。 动 态 编译 的 话 要 求 根 文件 系统 中 有 库 
文件 ， 但 是 编译 出 来 的 busybox 会 小 很 多 。 这 里 我 们 不 能 采用 静态 编译 ! 因为 采用 静态 编译 的 
话 DNS 会 出 问题 ! 无 法 进行 域名 解析 ， 配 置 如 图 38.2.2.3 所 示 : 


zuozhongkai@ubuntu: ~/linux/busybox/busybox-1.29.0 



































Settings 
Arrow keys navigate the menu. «Enter» selects submenus ---». Highlighted letters are hotkeys. Pressing <Y> 
includes, «N» excludes, «M» modularizes features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search. 
Legend: [*] built-in [ ] excluded «M» module < > module capable 


t(-) 

[] xec prefers applets 

(/proc/self/exe) ath to busybox executable 

[ ] upport NSA Security Enhanced Linux 

u ] Crean up all memory before exiting (usually not needed) 


uitd binary (no shared Libs) 


不 要 选中 ， 否 则 DNS 
] EUER NOMMU build 
] uild shared libbusybox 无 法 进行 域名 解析 


) ross compiler prefix 
) ath to sysroot 
(+) 


[ 
[ 
( 
( 
à 


E < Exit > < Help > 





38.2.2.3 不 选择 “Build static binary (no shared libs)” 
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继续 配置 如 下 路 径 配 置 项 : 
Location: 
-> Settings 


-> vi-style line editing commands 


吉 果 如 图 38.2.2.4 所 示 : 


zuozhongkai@ubuntu: ~/linux/busybox/busybox-1.29.0 





N 


Settings 
Arrow keys navigate the menu. «Enter» selects submenus ---». Highlighted letters are hotkeys. Pressing 
«Y» includes, «N» excludes, «M» modularizes features. Press «Esc»«Esc» to exit, «?» for Help, </> for 
Search. Legend: [*] built-in [ ] excluded «M» module < > module capable 


1(-) 

[ ] aster /proc scanning code (+100 bytes) 

[ ] upport /etc/networks 

[] onsult /etc/services even for well-known ports 
[*] ommand line editing 

(1024) M ximum length of input 

[*] i-style line editing commands 

(255) H story size 

[*] H story saving 

[i 2] ave history on shell exit, not after every command 
[*] | everse history search 

i(*) 


<S « Exit » « Help » 





38.2.2.4 选择 “vi-style line editing commands  " 
继续 配置 如 下 路 径 配 置 项 ; 
Location: 
-> Linux Module Utilities 


-> Simplified modutils 
默认 会 选中 “Simplified modutils”， 这 里 我 们 要 取消 勾 选 1! 结果 如 图 38.2.2.5 所 示 : 


zuozhongkai@ubuntu: ~/linux/busybox/busybox-1.29.0 


Linux module Ut3lities 
Arrow keys navigate the menu. «Enter» selects submenus ---». Highlighted letters are hotkeys. Pressing 
«Y» includes, «N» excludes, «M» modularizes features. Press «Esc»«Esc» to exit, «?» for Help, </> for 
Search. Legend: [*] built-in [ ] excluded «M» module < > module capable 


 nsmod (22 kb) 
smod (4.3 kb) 
 retty output (NEW) 
m dinfo (25 kb) 
m dprobe (29 kb) 
 lacklist support (NEW) 
mmod (3.6 kb) 
Options common to multiple modutils 


«S < Exit > < Help > 





38.22.5 取消 选中 “Simplified modutils " 
继续 配置 如 下 路 径 配 置 项 : 
Location: 
-> Linux System Utilities 
-> mdev (16 kb) /确保 下 面 的 全 部 选中 ， 默 认 都 是 选中 的 
结果 如 图 38.2.2.6 所 示 : 
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zuozhongkai@ubuntu: ~/linux/busybox/busybox-1.29.0 


Linux System Utilities 
Arrow keys navigate the menu. «Enter» selects submenus ---». Highlighted letters are hotkeys. Pressing 
«Y» includes, «N» excludes, «M» modularizes features. Press «Esc»«Esc» to exit, «?» for Help, </> for 
Search. Legend: [*] built-in [ ] excluded «M» module < > module capable 


1(-) 
[*] osetup (5.4 kb) 
[*] ispci (5.7 kb) f 
[*] susb (3.5 kb) 保 部 选中 
[M] mdev (16 kb) 
 upport /etc/mdev.conf 
 upport subdirs/symlinks 
 upport regular expressions substitutions when renaming device 
 upport command execution at device addition/removal 
 upport loading of firmware 


< Exit > < Help > 


图 38.2.2.6 “mdev” 配 置 项 
最 后 就 是 使 能 busybox 的 unicode 编码 以 支持 中 文 ， 配 置 路 径 如 下 : 


Location: 























-> Settings 
-> Support Unicode /选中 
-> Check $LC ALL, $LC CTYPE and $LANG environment variables /选中 
结果 如 图 38.2.2.7 所 示 : 


zuozhongkai@ubuntu: ~/linux/busybox/busybox-1.29.0 





Settings 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing 
<Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for 
Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


1(-) 

[*] ancy shell prompts 

[*]  nable automatic tracking of window size changes 
nel Er cursor position non peers 


[r5 DOF Unicode 


E heck $LC ALL, $LC Sa: and $LANG environment variables 


(767) ange of supported EOE characters 

[-] llow zero-width Unicode characters on output 
[1 _ llow wide Unicode characters on output 

i(*) 


S < Exit > < Help > 


图 38.2.2.7 中 文 支持 
busybox 的 配置 就 到 此 结束 了 ， 大 家 也 可 以 根据 自己 的 实际 需求 选择 配置 其 他 的 选项 ， 
过 对 于 初学 者 笔者 不 建议 再 做 其 他 的 修改 ， 可 能 会 出 现 编译 出 错 的 情况 发 生 。 
4、 编 译 busybox 
配置 好 busybox 以 后 就 可 以 编译 了 ， 我 们 可 以 指定 编译 结果 的 存放 目录 ， 我 们 肯定 要 将 
对 结果 存放 到 前 面 创建 的 rootfs 目录 中 ， 输 入 如 下 命令 
make install CONFIG PREFIX-/home/zuozhongkai/linux/nfs/rootfs 
COFIG PREFIX 指定 编译 结果 的 存放 目录 ， 比 如 我 存放 









































不 


编 


到 


“/home/zuozhongkai/linux/nfs/rootfs” 目 录 中 , 等 待 编译 完成 。 编译 完成 以 后 如 图 38.2.2.8 所 示 : 
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zuozhongkai@ubuntu: ~/linux/busybox/busybox-1.29.0 
./_install//usr/sbin/ubirename -> ../../bin/busybox 
./_install//usr/sbin/ubirmvol -> ../../bin/busybox 
./_install//usr/sbin/ubirsvol -> ../../bin/busybox 
./_install//usr/sbin/ubiupdatevol -> ../../bin/busybox 
./_install//usr/sbin/udhcpd -> ../../bin/busybox 


You will probably need to make your busybox binary 
setuid root to ensure all configured applets will 
work properly. 








图 38.2.2.8 busybox 编译 完成 
编译 完成 以 后 会 在 busybox 的 所 有 工具 和 文件 就 会 被 安装 到 rootfs 目录 中 , rootfs 目录 内 容 
如 图 38.2.2.9 所 示 : 

















$ ls 


$ 
图 38.2.2.9 rootfs 目录 

从 图 38.2.2.9 可 以 看 出 ，rootfs 目录 下 有 bin, sbin 和 usr 这 三 个 目录 ， 以 及 linuxrc 这 个 文 
件 。 前 面 说 过 Linux 内 核 init 进程 最 后 会 查找 用 户 空间 的 init 程序 ， 找 到 以 后 就 会 运行 这 个 用 
户 空间 的 init 程序 ， 从 而 切换 到 用 户 态 。 如 果 bootargs 设置 init=/linuxrce， 那 么 linuxrc 就 是 可 以 
作为 用 户 空间 的 init 程序 ， 所 以 用 户 态 空间 的 init 程序 是 busybox 来 生成 的 。 

busybox 的 工作 就 完成 了 , 但 是 此 时 的 根 文件 系统 还 不 能 使 用 , 还 学 要 一 些 其 他 的 文件 ， 所 
以 我 们 继续 来 完善 rootfs。 






















































































38.2.3 向 根 文件 系统 添加 lib Æ 


1、 向 rootfs 的 “/lib” 目 录 添 加 库 文件 


Linux 中 的 应 用 程序 一 般 都 是 需要 动态 库 的 ， 当 然 你 也 可 以 编译 成 静态 的 ， 但 是 静态 的 可 执行 
文件 会 很 大 。 如 果 编 译 为 动态 的 话 就 需要 动态 库 ， 所 以 我 们 需要 先 根 文件 系统 中 添加 动态 库 。 
在 rotofs 中 创建 一 个 名 为 “lib” 的 文件 夹 ， 命 令 如 下 : 

mkdir lib 

lib 文件 创建 好 了 ， 库 文件 从 哪里 来 呢 ? lib. 库 文件 从 交叉 编译 器 中 获取 ， 前 面 我 们 搭建 交 
又 编译 环境 的 时 候 将 交叉 编译 器 存放 到 了 “usvlocalarm/” 目 录 中 。 交 叉 编译 器 里 面 有 很 多 的 
库 文件 ， 这 些 库 文件 具体 是 做 什么 的 我 们 作为 初学 者 肯定 不 知道 ， 既 然 我 不 知道 那 就 简单 粗暴 
的 把 所 有 的 库 文件 都 放 到 我 们 的 根 文 件 系 统 中 。 这 样 做 出 来 的 根 文件 系统 肯定 很 大 ， 但 是 我 们 
现在 是 学 习 阶 段 ， 还 做 不 了 裁剪 。 这 就 是 为 什么 我 们 推荐 大 家 购买 512MB+4GB 版 本 的 EMMC 
核心 版 ， 如 果 后 面 要 学 习 QT 的 话 那 占用 的 空间 将 更 大 ， 不 裁剪 的 话 512MB 的 NAND 完全 不 
够 用 的 ! 而 裁剪 又 是 需要 经 验 的 ， 我 们 都 是 初学 者 ， 哪 里 来 的 经 验 啊 。 所 以 我 们 推荐 初学 者 购 
X EMMC 版 核心 板 并 不 是 说 为 了 多 赚 大 家 的 钱 ， 而 是 从 实际 角度 考虑 的 。 

进入 如 下 路 径 对 应 的 目录 : 

/usr/local/arm/gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf/arm-linux- 
gnueabihf/libc/lib 

此 目录 下 有 很 多 的 *so*(* 是 通配符 ) 和 .a 文件 , 这 些 就 是 库 文 件 , 将 此 目录 下 所 有 的 *so* 和 .a 
文件 都 拷贝 到 rootfs/lib 目录 中 ， 找 贝 命令 如 下 : 
cp *so* *.a /home/zuozhongkai/linux/nfs/rootfs/lib/ -d 
后 面 的 “-d” 表 示 找 贝 符号 链接 ,这 里 有 个 比较 特殊 的 库 文件 : 1d-linux-armhfso.3， 此 库 文 件 也 
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是 个 符号 链 " 相当 于 Windows 下 的 快捷 方式 。 会 链接 到 库 1d-2.19-2014.08-1-git.so ci 输入 命 
4 “Is ld-linux-armhf so.3 -1” 查 看 此 文件 详细 信息 ， 如 图 38.2.3.1 所 示 : 


zuozhongkaiQubuntu:-/linux/nfs/rootfs$ cd lib/ 
zuozhongkai@ubuntu linux/nfs/rootfs/lib$ ls Ld-Linux-armhf.so.3 -l 























lrwxrwxrwx 1 zuozhongkai zuozhongkai 24 Jun 13 12:36 ld-linux-armhf.so.3 -> ld-2.19-2014.08-1-git.so 


图 38.2.3.1 文件 Id-linux-armhf.so.3 
从 图 38.2.3.1 可 以 看 出 ，ld-linux-armhf so.3 后 面 有 个 “->” 表示 其 是 个 软 连接 文件 ， 链 接 











n 
















































































到 文件 1d-2.19-2014.08-1-git.so， 因 为 其 是 一 个 “快捷 方式 ”因此 大 小 只 有 24B。 但 是 , ld-linux- 
armhf.so.3 不 能 作为 符号 链接 ， 和 否则 的 话 在 根 文件 系统 中 执行 程序 无 法 执行 ! 所 以 我 们 需要 ld- 
linux-armhf.so.3 5&3 2, 由 “快捷 方式 ” 变 为 “本 尊 ” 方法 很 简单 ,， 那 就 是 重新 复制 1d-linux- 
armhfso.3， 只 是 不 复制 软 链接 即 可 ， 先 将 rotfs/lib 中 的 Id-linux-armhf.so.3 文件 删除 掉 ， 命 令 如 
下 : 













































































rm ld-linux-armhf.so.3 

然后 重新 进入 到 msvlocalarm/gcc-linaro-4.9.4-2017.01-x86_ 64 arm-linux-gnueabihf/arm- 
linux-gnueabihf/libc/lib 目录 中 ， 重 新 拷贝 ld-linux-armhfso.3， 命 令 如 下 : 

cp ld-linux-armhf.so.3 /home/zuozhongkai/linux/nfs/rootfs/lib/ 

拷贝 完成 以 后 再 到 rootfs/lib 目录 下 查看 Id-linux-armhf.so.3 文件 详细 信息 ， 如 图 38.2.32 所 
















































































7: 


zuozhongkai@ubuntu:~/linux/nfs/rootfs/lib$ rm qld-linux-armhf.so.3 
zuozhongkaię@ubuntu:~/linux/nfs/rootfs/lib$ ls ld-linux-armhf.so.3 -l 


-rwxr-xr-x 1 zuozhongkai zuozhongkai 724392 Jun 13 12:59 ld-linux-armhf.so.3 
zuozhongkai@ubuntu:~/linux/nfs/rootfs/lib$ 








n 





图 38.2.3.2 文件 Id-linux-armhf.so.3 
从 图 38.2.3.2 可 以 看 出 ， 此 时 1d-linux-armhf.so.3 已 经 不 是 软 连接 了 ， 而 是 实 实 在 在 的 一 个 
库 文 件 ， 而 且 文件 大 小 为 724392B。 
继续 进入 如 下 目录 中 : 
/usr/local/arm/gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf/arm-linux-gnueabihf/lib 
此 目录 下 也 有 很 多 的 的 *so* 和 .a 库 文 件 ， 我 们 将 其 也 拷贝 到 rootfs/lib 目录 中 ， 命 令 如 下 : 
cp *so* *.a /home/zuozhongkai/linux/nfs/rootfs/lib/ -d 
rootfs/lib 目录 的 库 文 件 就 这 些 了 ， 完 成 以 后 的 rootfs/lib 目录 如 图 38.2.3.3 所 示 : 


zuozhongkai@ubuntu: ~/linux/nfs/rootfs/lib 
zuozhongkaigubuntu:-/linux/nfs/rootfs/lib$ ls 
ld-2.19-2014.08-1-git.so libgomp. so libpthread-2.19-2014.08-1-git.so 
Ld-Linux-armhf.so.3 Libgomp.so.1 Libpthread.so.0 
LibanL-2.19-2014.08-1-git.so Libgomp.so.1.0.09 LibresoLv-2.19-2014.08-1-git.so 
i libitm.a LibresoLv.so.2 
Libitm.so librt-2.19-2014.08-1-git.so 
libitm.so.1 librt.so.1 
libitm.so.1.0.0 libSegFault.so 
libm-2.19-2014.08-1-git.so libssp.a 
libatomic.a libmemusage.so Libssp_nonshared.a 
Libatomic.so Libm.so.6 Libssp.so 
libatomic.so.1 libnsl-2.19-2014.08-1-git.so Libssp.so.0 
Libatomic.so.1.1.9 libnsl.so.1 Libssp.so.0.0.9 
a 
s 



















































































LibBrokenLocaLe-2.19-2014.08-1-git.so Libnss_compat-2.19-2014.08-1-git.so libstdc++. 
libBrokenLocale.so.1 libnss_compat.so.2 libstdc++. so 
libc-2.19-2014.08-1-git.so Libnss_db-2.19-2014.08-1-git.so libstdc++. 
Libcrypt-2.19-2014.08-1-git.so Libnss_db.so.2 libstdc++. 
libcrypt.so.1 libnss_dns-2.19-2014.08-1-git.so libstdc++. 
libc.so.6 Libnss_dns.so.2 libsupc++. 
libdl-2.19-2014.08-1-git.so libnss files-2.19-2014.08-1-git.so libthread ， 
LibdL.so.2 libnss_files.so.2 libthread_db.so.1 
libgcc s.so libnss_hesiod-2.19-2014.08-1l1-git.so libubsan.a 
libgcc_s.so.1 libnss_hesiod.so.2 Libubsan.so 
Libgfortran.a Libnss_nis-2.19-2014.08-1-git.so Libubsan.so.0 

.SO Libnss_nispLus-2.19-2014.08-1-git.so Libubsan.so.0.0.0 

.S0.3 Libnss_nispLus.so.2 LibutiL-2.19-2014.08-1-git.so 

.S0.3.0.0 libnss_nis.so.2 libutil.so.1 

libpcprofile. so 
i@ubuntu:~/linux/nfs/rootfs/lib$ 
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图 38.2.3.3 lib 目录 
2、 向 rootfs 的 “usrwlib” 目 录 添 加 库 文件 
T rootfs 的 usr 目录 下 创建 一 个 名 为 lib 的 目录 ,将 如 下 目录 中 的 库 文件 拷贝 到 rootfs/usr/lib 
目录 下 : 

/usr/local/arm/gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabihf/arm-linux-gnueabihf/libc/ 
usr/lib 

将 此 目录 下 的 so 和 .a 库 文 件 都 拷贝 到 rootfs/us/lib 目录 中 ， 命 令 如 下 : 

cp *so* *.a /home/zuozhongkai/linux/nfs/rootfs/usr/lib/ -d 


完成 以 后 的 rootfs/usr/lib 目录 如 图 38.2.3.4 所 示 : 


j $ ls 

libanl.a libcrypt pic.a M libnsl.a libnss nis pic.a librpcsvc p.a 
libanl p.a libnsl p.a libnss_nisplus_pic.a librt.a 
libanl pic.a Libc.so libnsl pic.a librt p.a 

libdl.a librt pic.a 
libBrokenLocale.a libdl p.a libnss compat pic.a  libpthread.a 
libBrokenLocale p.a libdl pic.a libpthread nonshared.a  libthread db pic.a 
libBrokenLocale pic.a libnss db pic.a libpthread p.a 

libg.a libpthread.so libutil.a 
libc.a libieee.a libnss dns pic.a libresolv.a libutil p.a 
libc nonshared.a libm.a libresolv p.a libutil pic.a 

i libmcheck.a libnss files pic.a  libresolv pic.a 
libm p.a libresolv pic.map 
libm pic.a libnss hesiod pic.a 
librpcsvc.a 




















图 38.2.3.4 rootfs/usr/lib 目录 
至 此 ， 根 文件 系统 的 库 文 件 就 全 部 添加 好 了 ， 可 以 使 用 “du” 命 令 来 查看 一 下 rootfs/lib 和 
rootfs/usr/lib 这 两 个 目录 的 大 小 ， 命 令 如 下 : 





























cd rootfs // 进 入 根 文件 系统 目录 
du ./lib ./usr/lib/ -sh 1/ 查看 lib Ñ usr/lib 这 两 个 目录 的 大 小 
结果 如 图 38.2.3.5 所 示 : 








a RATE A Y ET 
rA lo 





/UsSr/Liby 


图 38.2.3.5 lib FI usr/lib 目录 大 小 
可 以 看 出 lb 和 usr/lib 这 两 个 文件 的 大 小 分 别 为 57MB 和 67MB ,加 起 来 就 是 57+67=124MB。 
非常 大 ! 所 以 正点 原子 的 256MB 和 512MB 的 NAND 核心 版 就 不 是 给 初学 者 准备 的 , 而 是 给 大 
批量 采购 的 企业 准备 的 ， 还 是 那 句 话 ， 初 学 者 选择 EMMC 版 本 的 。 




















38.2.4 创建 其 他 文件 夹 


在 根 文件 系统 中 创建 其 他 文件 来， 如 dev. proc. mnt. sys. tmp 和 root 等 ， 创 建 完成 以 后 
如 图 38.2.4.1 所 示 : 




















$ Ls 


$ 
图 38.2.4.1 创建 好 其 他 文件 夹 以 后 的 rootfs 
目前 来 看 , 这 个 根 文件 系统 好 像 已 经 准备 好 了 , 究竟 有 没有 准备 好 , 直接 测 一 下 就 知道 了 ! 


38.3 根 文件 系统 初步 测试 
接 下 来 我 们 使 用 测试 一 下 前 面 创建 好 的 根 文 件 系统 rootfs, MATERE NFS ER, 
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uboot 里 面 的 bootargs 环境 变量 会 设置 “root” 的 值 ， 所 以 我 们 将 root 的 值 改 为 NFS 挂 载 即 可 。 
在 Linux 内 核 源 码 里 面 有 相应 的 文档 讲解 如 何 设置 ， 文 档 为 Documentation/filesystems/nfs/ 
nfsroot.txt， 格 式 如 下 : 

root=/dev/nfs nfsroot=[<server-ip>:]<root-dir>[,<nfs-options>] ip=<client-ip>:<server-ip>:<gw- 
ip>:<netmask>:<hostname>:<device>:<autoconf>:<dns0-ip>:<dns1-ip> 

<server-ip>: 服务 器 IP 地 址 ， 也 就 是 存放 根 文件 系统 主机 的 IP 地 址 ， 那 就 是 Ubuntu 的 IP 
地 址 ， 比 如 我 的 Ubuntu 主机 IP 地 址 为 192.168.1.250。 

<root-dir>: 根 文件 系统 的 存放 路 径 ， 比 如 我 的 就 是 /home/zuozhongkai/linux/nfs/rootfs 。 

<nfs-options>: NFS 的 其 他 可 选 选项 ， 一 般 不 设置 。 

<client-ip>: 客户 端 卫 地 址 ， 也 就 是 我 们 开发 板 的 下 地 址 ，Linux 内 核 启 动 以 后 就 会 使 用 
此 IP 地 址 来 配置 开发 板 。 此 地 址 一 定 要 和 Ubuntu 主机 在 同一 个 网 段 内 ， 并 且 没 有 被 其 他 的 设 
备 使 用 , 在 Ubuntu 中 使 用 ping 命令 ping 一 下 就 知道 要 设置 的 IP 地 址 有 没有 被 使 用 ， 如 果 不 能 
ping 通 就 说 明 没有 被 使 有 用， 那么 就 可 以 设置 为 开发 板 的 IP 地 址 ， 比 如 我 就 可 以 设置 为 
192.168.1.251. 

<server-ip>: 服务 器 IP 地 址 ， 前 面 已 经 说 了 。 

<gw-ip>: 网 关 地 址 ， 我 的 就 是 192.168.1.1。 

<netmask>: 子 网 掩 码 ， 我 的 就 是 255.255.255.0。 

<hostname>: 客户 机 的 名 字 ， 一 般 不 设置 ， 此 值 可 以 空 着 。 

«device»; 设备 名 ， 也 就 是 网 卡 名 ， 一 般 是 eth0，eth1.…， 正 点 原子 的 LIMX6U-ALPHA Jf 
发 板 的 ENET2 为 ethü, ENETI 为 ethl1。 如 果 你 的 电脑 只 有 一 个 网 卡 ， 那 么 基本 只 能 是 eth0。 
这 里 我 们 使 用 ENET2， 所 以 网 卡 名 就 是 eth0。 

<autoconf>: 自动 配置 ， 一 般 不 使 用 ， 所 以 设置 为 off。 

<dns0-ip>: DNS0 服务 器 IP 地 址 ， 不 使 用 。 

<dnsl-ip>: DNS1 服务 器 IP 地 址 ， 不 使 用 。 

根据 上 面 的 格式 bootargs 环境 变量 的 root 值 如 下 : 

root—-/dev/nfs rw nfsroot-192.168.1.250:/home/zuozhongkai/linux/nfs/rootfs 1p-192.168.1.251: 
192.168.1.250:192.168.1.1:255.255.255.0::eth0:off 
启动 开发 板 ， 进 入 upoot 命令 行 模式 ， 然 后 重新 设置 bootargs 环境 变量 ， 命 令 如 下 : 

setenv bootargs 'console-ttymxc0,115200 root-/dev/nfs rw nfsroot-192.168.1.250: 
/home/zuozhongkai/linux/nfs/rootfs 1p-192.168.1.251:192.168.1.250:192.168.1.1:255.255.255.0::eth0: 
off /设置 bootargs 

saveenv /保存 环境 变量 

设置 好 以 后 使 用 “boot” 命 令 启 动 Linux 内 核 ， 结 果 如 图 38.3.1 Wrzn: 
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1-1.2: new high-speed USB device number 4 using ci- 

Tee 20b4000.ethernet eth0: Link is Up - 100Mbps/Full - Flow control rx/tx 

IPv6: ADDRCONF(NETDEV CHANGE): eth0: link becomes ready 

IP-Config: Complete: 
device-eth0, hwaddr-00:04:9f:04:d2:35, ipaddr-192.168.1.251, mask-255.255.255.0, gw-192.168.1. 
host-192. 168. 1.251, domains, nis-domain-(none) 
bootserver-192.168.1.250, rootserver-192.168.1.250, rootpath- 

gpio dvfs: disabling 

VSD. 3v3: disabling 

can-3v3: disabling 

ALSA device list: 

$0: wm8960-audio 

VFS: Mounted root (nfs filesystem) on device 0:14. 

devtmpfs: mounte 

Freeing unused kernel memory: 444K (80b19000 - 80b88000) 

can't run '/etc/init.d/rcS': No such file or directory 


Please press Enter to activate this console. 
# 


/ 8 


ac S sa d 
Tt 


38.3.1 进入 根 文件 系统 
从 图 38.3.1 可 以 看 出 ， 我 们 进入 了 根 文件 系统 ， 说 明 我 们 的 根 文件 系统 工作 了 ! 如 果 没 有 
启动 进入 根 文件 系统 的 话 可 以 重启 一 次 开发 板 试 试 。 我 们 可 以 输入 “1s” 命 令 测 试 一 下 ,结果 如 
图 38.3.2 所 示 : 


















































/ # ls 

bin lib mnt root sys usr 
dev linuxrc proc sbin tmp 

/ # 


图 38.3.2 ls 命令 测试 
可 以 看 出 ls 命令 工作 正常 ! 那么 是 不 是 说 明 我 们 的 rootfs 就 制作 成 功 了 了 呢 ? 大 家 注意 ， 在 
进入 根 文 件 系统 的 时 候 会 有 下 面 这 一 行 错 误 提 示 : 
can't run "etc/init.d/rcS': No such file or directory 
提示 很 简单 ， 说 是 无 法 运行 “/ete/init.d/reS” 这 个 文件 ， 因 为 这 个 文件 不 存在 。 如 图 38.3.3 
FEZN 


can't run '/etc/init.d/rcS': No such file or directory 


























Please press Enter to activate this console. 
# 


/ # 
图 39.3.3  "/etc/init.d'rcS" PFE 
看 来 我 们 的 rootfs 还 是 缺 文 件 啊 ， 没 什么 六 的， 一步 一 步 的 完善 


38.4 完善 根 文件 系统 


38.4.1 创建 /etc/init.d/reS 文件 


rcS 是 个 shell HÆ, Linux 内 核 启 动 以 后 需要 启动 一 些 服 务 , 而 rcS 就 是 规定 启动 哪些 文件 
的 脚本 文件 。 在 rootfs 中 创建 /etwinit.dmrcgS 文件 ， 然 后 在 res 中 输入 如 下 所 示 内 容 : 
示例 代码 38.4.1.1 /etc/init.d/rcS 文件 




















#!/bin/sh 


PATH-/sbin:/bin:/usr/sbin:/usr/bin 
LD LIBRARY PATH=SLD LIBRARY PATH:/lib:/usr/lib 
export PATH LD LIBRARY PATH runlevel 





Cn TS Fo 
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6 

1| mouünt -A 

8 mkdir /dev/pts 

9 mount -t devpts devpts /dev/pts 

10 

11 echo /sbin/mdev » /proc/sys/kernel/hotplug 


12 mdev -s 

第 1 行 ， 表 示 这 是 一 个 shell 脚本 。 

第 3 行 ，PATH 环境 变量 保存 着 可 执行 文件 可 能 存在 的 目录 ， 这 样 我 们 在 执行 一 些 命令 或 
者 可 执行 文件 的 时 候 就 不 会 提示 找 不 到 文件 这 样 的 错误 。 

W 4 1T, LD LIBRARY PATH 环境 变量 保存 着 库 文 件 所 在 的 目录 。 

第 5 行 ， 使 用 export 来 导出 上 面 这 些 环境 变量 ， 相 当 于 声明 一 些 “ 全 局 变量 ” 

第 7 行 ， 使 用 mount 命令 来 挂 载 所 有 的 文件 系统 ， 这 些 文件 系统 由 文件 /etc/fstab 来 指定 ， 
所 以 我 们 一 会 还 要 创建 /etc/fstab 文件 。 

第 8 和 9 行 ， 创 建 目 录 /devwpts， 然 后 将 devpts 挂 载 到 /dev/pts HRF. 

第 11 和 12 行 ， 使 用 mdev 来 管理 热 插 拔 设备 ， 通 过 这 两 行 ，Linux 内 核 就 可 以 在 /dev 目录 
下 自动 创建 设备 节点 。 关 于 mdev 的 详细 内 容 可 以 参考 busybox 中 的 docs/mdev.txt 文档 。 

示例 代码 38.4.1.1 中 的 rcS 文件 内 容 是 最 精简 的 ,大 家 如 果 去 看 Ubuntu 或 者 其 他 大 型 Linux 
操作 系统 中 的 res 文件 , 就 会 发 现 其 非常 复杂 。 因 为 我 们 是 初次 学 习 , 所 以 不 用 搞 这 么 复杂 的 ， 
而 且 这 么 复杂 的 ves 文件 也 是 借助 其 他 工具 创建 的 ， 比 如 buildroot 等 。 

创建 好 文件 /etc/init.d/res 以 后 一 定 要 给 其 可 执行 权限 ! 

创建 好 文件 /etc/init.d/reS 以 后 一 定 要 给 其 可 执行 权限 ! 

创建 好 文件 /etc/init.d/res 以 后 一 定 要 给 其 可 执行 权限 ! 

使 用 如 下 命令 给 予 /ec/init.d/reS 可 执行 权限 : 

chmod 777 reS 

设置 好 以 后 就 重新 启动 Linux 内 核 ， 启 动 以 后 如 图 38.4.1.1 所 示 : 

mount: can't read '/etc/fstab': No such file or directory 


/etc/init.d/rcS: line 13: can't create /proc/sys/kernel/hotplug: nonexistent directory 
mdev: /sys/dev: No such file or directory 















































































































































Please press Enter to activate this console. 

图 38.4.1.1 Linux 启动 过 程 
从 图 38.4.1.1 可 以 看 到 , 提示 找 不 到 /etc/fstab 文件 , 还 有 一 些 其 他 的 错误 , 我 们 先 把 /etc/fstab 

这 个 错误 解决 了 。 说 不 定 把 这 个 问题 解决 以 后 其 他 的 错误 也 就 解决 了 。 前 面 我 们 说 了 “mount- 

a” 挂 载 所 有 根 文件 系统 的 时 候 需 要 读 取 /etc/fstab， 因 为 /etc、fstab 里 面 定 义 了 改 挂 载 哪些 文件 ， 

好 了 ， 接 下 来 就 是 创建 /etc/fstab 文件 。 


























e 
































38.4.2 创建 /etc/fstab 文件 


在 rootfs 中 创建 /etc/fstab 文件 ,fstab 在 Linux 开机 以 后 自动 配置 哪些 需要 自动 挂 载 的 分 区 ， 
格式 如 下 : 

<file system> <mount point> <type> <options> <dump> <pass> 

«file system»: 要 挂 载 的 特殊 的 设备 ， 也 可 以 是 块 设备 ， 比 如 /dev/sda 等 等 。 

«mount point»: 挂 载 点 。 

«type»: 文件 系统 类 型 ， 比 如 ext2、ext3、proc、romfs、tmpfs 等 等 。 

«options»: 挂 载 选项 ， 在 Ubunut 中 输入 “man mount” 命 令 可 以 查看 具体 的 选项 。 一 般 使 
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用 defaults, 也 就 是 默认 选项 ,defaults 包含 了 rw. suid, dev. exec. auto. nouser 和 async. 
«dump»: 为 1 的 话 表示 允许 备份 ， 为 0 不 备份 ， 一 般 不 备份 ， 因 此 设置 为 0。 




















<pass>: 磁盘 检查 设置 ,为 0 表示 不 检查 。 根 目录 “/” 设 置 为 1， 其 他 的 都 不 能 设置 为 1， 
其 他 的 分 区 从 2 开始 。 一 般 不 在 fstab 中 挂 载 根 目 录 ， 因 此 这 里 一 般 设置 为 0。 
按照 上 述 格式 ， 在 fstab 文件 中 输入 如 下 内 容 : 



































示例 代码 38.4.2.1 /etc/fstab 文件 


1 #<file system» «mount point» «type» <options> «dump» «pass» 
2 ee /proc proc defaults 0 0 
3 tmpfs / tmp tmpfs defaults 0 0 
4 sysfs /sys sysfs defaults 0 0 
5 tmpfs /dev tmpfs defaults 0 0 








fstab 文件 创建 完成 以 后 重新 启动 Linux， 结 果 如 图 38.4.2.1 所 示 : 


VFS: Mounted root (nfs filesystem) on device 0:14. 
devtmpfs: mounted 


Freeing unused kernel memory: 444K (80b19000 - 80b88000) 


Please press Enter to activate this console. 
E 


图 38.4.2.1 Linux 启动 过 程 





从 图 38.4.2.1 可 以 看 出 ， 启 动 启动 成 功 ， 而 且 没 有 任何 错误 提示 。 但 是 我 们 要 需要 创建 一 
个 文件 /etc/inittab。 








38.4.3 创建 /etc/inittab 文件 


inittab 的 详细 内 容 可 以 参考 busybox 下 的 文件 examples/inittab。init 程序 会 读 取 /etc/inittab 
这 个 文件 ，inittab 由 若干 条 指令 组 成 。 每 条 指令 的 结构 都 是 一 样 的 ， 由 以 “:” 分 隔 的 4 个 段 组 
成 ， 格 式 如 下 : 

<id>:<runlevels>:<action>:<process> 

«ide: 每 个 指令 的 标识 符 ， 不 能 重复 。 但 是 对 于 busybox 的 init 来 说 ，<id> 有 着 特殊 意义 。 
对 于 busybox 而 言 <id> 用 来 指定 启动 进程 的 控制 ty， 一 般 我 们 将 串口 或 者 LCD 屏幕 设置 为 控 





制 | tty。 


<runlevels>: 对 busybox 来 说 此 项 完全 没 用 ， 所 以 空 着 。 





























«action»: 动作 ， 用 于 指定 <process> 可 能 用 到 的 动作 。busybox 支持 的 动作 如 表 38.4.3.1 所 















































ZN: 
sysinit | 在 系统 初始 化 的 时 候 process 才 会 执行 一 次 。 
respawn | 当 process 终止 以 后 马上 启动 一 个 新 的 。 
"m 和 respawn 类 似 , TE3& fT process 之 前 在 控制 台 上 显示 “Please press Enter to activate 
this console.”。 只 要 用 户 按 下 “Enter” 键 以 后 才 会 执行 process。 
wait 告诉 init， 要 等 待 相应 的 进程 执行 完 以 后 才能 继续 执行 。 
once 仅 执 行 一 次 ， 而 且 不 会 等 待 process 执行 完成 。 
restart | 当 init 重启 的 时 候 才 会 执行 procee。 
ctrlaltdel | 当 按 下 ctrl+alt+del 组 合 键 才 会 执行 process- 
shutdown | 关机 的 时 候 执行 process。 














表 38.4.3.1 动作 
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<process>: 具体 的 动作 ， 比 如 程序 、 脚 本 或 命令 等 。 
参考 busybox 的 examples/inittab 文件 ， 我 们 也 创建 一 个 /etc/inittab， 在 里 面 输入 如 下 内 容 : 
示例 代码 38.4.3.1 /etc/inittab 文件 




















#etc/inittab 
::sysinit:/etc/init.d/rcS 


console::askfirst:-/bin/sh 


1 

2 

B 

4 ::restart:/sbin/init 

5 ::ctrlaltdel:/sbin/reboot 

6 ::shutdown:/bin/umount -a -r 

7 ::sShutdown:/sbin/swapoff -a 
第 2 行 ， 系统 启动 以 后 运行 /etc/init.d/rcS 这 个 脚本 文件 。 
第 3 行 ， 将 console 作为 控制 台 终 端 ， 也 就 是 ttymxc0。 
第 4 行 ， 重 启 的 话 运行 /sbin/init。 
第 5 行 ， 按 下 ctrl+talttdel 组 合 键 的 

启 系统 。 
第 6 行 ， 关 机 的 时 候 执 行 /bin/umount， 也 就 是 卸载 各 个 文件 系统 。 
第 7 行 ， 关 机 的 时 候 执行 /sbin/swapof， 也 就 是 关闭 交换 分 
letc/initta 文件 创建 好 以 后 就 可 以 重启 开发 板 即 可 ， 至 此 ! 根 文件 系统 要 创建 的 文件 就 已 经 

全 部 完成 了 。 接 下 来 就 要 对 根 文 件 系统 进行 其 他 的 测试 ， 比 如 是 我 们 自己 编写 的 软件 运行 收费 

正常 、 是 否 支 持 软 件 开 机 自 启动 、 中 文 支持 是 否 正常 以 及 能 不 能 链接 等 。 


38.5 根 文件 系统 其 他 功能 测试 


38.5.1 软件 运行 测试 


我 们 使 用 Linux 的 目的 就 是 运行 我 们 自己 的 软件 , 我 们 编译 的 应 用 软件 一 般 都 使 用 动态 库 ， 
使 用 动态 库 的 话 应 用 软件 体积 就 很 小 ， 但 是 得 提供 库 文 件 ， 库 文件 我 们 已 经 添加 到 了 根 文件 系 
统 中 。 我 们 编写 一 个 小 小 的 测试 软件 来 测试 一 下 库 文件 是 否 工 作 正常 ， 在 根 文件 系统 下 创建 一 
个 名 为 “drivers” 的 文件 夹 ， 以 后 我 们 学 习 Linux 驱动 的 时 候 就 把 所 有 的 实验 文件 放 到 这 个 文 
牛 夹 里 面 。 
在 ubuntu 下 使 用 vim 编辑 器 新 建 一 个 hello.c 文件 ， 在 hello.c 里 面 输入 如 下 内 容 : 
示例 代码 38.5.1.1 hello.c 文件 


















































limi 
Hp 








话 就 运行 /sbin/reboot， 看 来 ctrl+alt+del 组 合 键 用 于 








x 























[x 





o 




































































































































































1 #include <stdio.h> 

2 

3 int main(void) 

t 

5 while(1) { 

6 printf("hello world!NrNn"); 
T7 sleep(2); 

8 ) 

9 return 0; 

OMA 
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hello.c 内 容 很 简单 ， 就 是 循环 输出 “hello world”，sleep 相当 于 Linux 的 延 时 函数 ， 单 位 为 
秒 ， 所 以 sleep(2) 就 是 延 时 2 秒 。 编 写 好 以 后 就 是 编译 ， 因 为 我 们 是 要 在 ARM 芯片 上 运行 的 ， 
所 以 要 用 交叉 编译 器 去 编译 ， 也 就 是 使 用 arm-linux-gnueabihf-gcc 编译 ， 命 令 如 下 : 
































arm-linux-gnueabihf-gcc hello.c -o hello 

使 用 arm-linux-gnueabihf-gcc 将 hello.c 编译 为 hello 可 执行 文件 。 这 个 hello 可 执行 文件 究 
竟 是 不 是 ARM 使 用 的 呢 ? 使 用 “file” 命 令 查看 文件 类 型 以 及 编码 格式 : 

file hello ”/W 查 看 hello 的 文件 类 型 以 及 编码 格式 
结果 如 图 38.5.1.1 所 示 : 





























$ arm-linux-gnueabihf-gcc hello.c -o hello 
Sas 





hello.c 
: $lfile hello 
: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpr 


eter /lib/ld-, for GNU/Linux 2.6.31，BuiLdID[shal]=7ddlbde89e09327b11ad95e22e72f9bfafd8aec 
b, not stripped 


图 38.5.1.1 查看 hello 编码 格式 
从 图 38.5.1.1 可 以 看 出 ， 输 入 “file hello” 输 入 了 如 下 所 示 信 息 : 
hello: ELF 32-bit LSB executable, ARM, EABIS version 1 (SYSV), dynamically linked…… 
hello 是 个 32 位 的 LSB 可 执行 文件 ，ARM 架构 的 ， 并 且 是 动态 链接 的 。 所 以 我 们 编译 出 
来 的 hello 文件 没有 问题 。 将 其 拷贝 到 rootfs/drivers 目录 下 ,在 开发 板 中 输入 如 下 命令 来 执行 这 
个 可 执行 文件 : 
cd/drivers ”// 进 入 drivers 目录 





























Jhello /执行 hello 
结果 如 图 38.5.1.2 所 示 : 










drivers # ./hello 
wor 1 


world! 
/drivers # 
图 38.5.1.2 hello 运行 结果 

可 以 看 出 ，hello 这 个 软件 运行 正常 ， 说 明 我 们 的 根 文件 系统 中 的 共享 库 是 没 问 题 的 ， 要 想 
终止 hello 的 运行 ， 按 下 “ctrl+tc” 组 合 键 即 可 。 此 时 大 家 应 该 能 感觉 到 ，hello 执行 的 时 候 终端 
是 没 法 用 的 ， 除 非 使 用 “ctrl+tc” 来 关闭 hello， 那 么 有 没有 办 法 既 能 让 hello 正常 运行 ， 而 且 终 
端 能 够 正常 使 用 ? 那 肯 定 是 有 的 , 让 hello 进入 后 台 运 行 就 行 了 , 让 一 个 软件 进入 后 台 的 方法 很 
简单 ， 运 行 软件 的 时 候 加 上 “区 ” 即 可 ， 比 如 “./hello &&” 就 是 让 hello 在 后 台 运 行 。 在 后 台 运 
行 的 软件 可 以 使 用 “kill -9 pid( 进 程 ID)” 命 令 来 关闭 掉 ， 首 先 使 用 “ps” 命 令 查 看 要 关闭 的 软 
^F PID 是 多 少 , ps 命令 用 于 查看 所 有 当前 正在 运行 的 进程 , 并 且 会 给 出 进程 的 PID。 输入 “ps” 
命令 ， 结 果 如 图 38.5.1.3 所 示 : 
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/drivers # ps 
PID USER TIME COMMAND 

Jj 0:01 [linuxrc] init 
20 0:00 [kthreadd] 

30 0:00 [ksoftirqd/0] 

50 0:00 [kworker/0: 0H] 
60 0:00 [kworker/u2:0] 

7 0 0:04 [rcu_preempt] 

8 0 0:00 sr 

9 0 0:00 [rcu bh] 

10 0 0:00 [migration/0] 

11 0 0:00 elper 

12 0 0:00 mme 

13 0 0:00 

14 0 0:00 e 
15 0 0:00 [crypto] 

16 0 0:00 [bioset] 

17 0 0:00 [kblockd] 

18 0 0:00 [ata_sff] 

20 0 0:00 [cfg80211] 
21 0 0:00 [rpciod] 

22 0 0:00 [kswapd0] 

23 0 0:00 prenoti ty wank] 
24 0 0:00 [nfsiod] 
61 0 0:00 Ies 1] 
66 0 0:00 [ci 
67 0 0:00 Lirq/21- 2040000. ] 
68 0 0:00 [cfinteractive] 
69 0 0:00 [irq/225-mmcO 

71 0 0:00 [irq/50-2190000.] 
72 0 0:00 [irq/226-mmc1] 

73 0 0:00 [mxs. dcp. chan/sh] 
74 0 0:00 [mxs. dcp. chan/ae] 
81 0 0:00 [ipv6 addrconf] 
82 0 0:00 [krfcommd] 
83 0 0:00 [pxp. dispatch] 
84 0 0:00 [deferwq] 
85 0 0:00 [irq/203- imx the] 
87 0 0:00 [kworker/0: 1H] 
93 0 0:00 -/bin/s 
97 ^ 0:00 [mmcqd/0] 

0 


0:00 [mmcqd/1boot0] 
D 0:00 [mmcqd/1lbootl] 








38.5.1.3 ps 命令 结 
从 图 38.5.1.3 可 以 看 出 hello 对 应 的 PID 为 166， 因 此 我 们 使 用 如 下 命令 关闭 在 后 台 运 行 的 
hello 软件 : 
kill -9 166 
因为 helo 在 不 断 的 输出 “hello world” 所 以 我 们 的 输入 看 起 来 会 被 打 断 ， 其 实 是 没有 的 ， 
因为 我 们 是 输入 ,而 hello 是 输出 。 在 数据 流 上 是 没有 打 断 的 ， 只 是 显示 在 SecureCRT 上 就 好 像 
被 打 断 了 ， 所 以 只 管 输入 “kill -9 166” 即 可 。hello 被 kill 以 后 会 有 提示 ， 如 图 38.5.1.4 所 示 : 


|n: Killed . /hello 
/drivers £ 




















38.5.1.4 提示 hello 4 kill 掉 。 
再 去 用 ps 命令 查看 一 下 当前 的 进程 ， 发 现 没 有 hello 了 。 这 个 就 是 Linux 下 的 软件 后 台 运 
行 以 及 如 何 关闭 软件 的 方法 ， 重 点 就 是 3 个 操作 : 软件 后 面 加 “&”、 使 用 ps 查看 要 关闭 的 软 
件 PID、 使 用 “kill -9 pid” 来 关闭 指定 的 软件 。 
































38.5.2 中 文字 符 测试 


1、 设 置 SecureCRT 使 用 UTF-8 编码 

因为 Linux 使 用 的 编码 格式 为 UTF-8， 因 此 要 先 设置 SecureCRT 的 编码 格式 。 打 开 
Options->Session Options...， 打 开 “Session Options ”对话 框 ， 选 择 左 侧 的 “Appearance”， 然后 
在 右 侧 的 “Character encoding:” 栏 选择 UTF-8 编码 ， 如 图 38.5.2.1 所 示 : 
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Session Options - serial-com13 x | 
Category: 
| E-Connection Window and Text Appearance 
c mm Current color scheme 
Serial 
-j- Terminal Monochrome Y Edit... New... 
=- Emulation 
Modes Fonts 
Emacs : 
: | Lucida Console is 
duae Normal font: i 1. Font 
Advanced |. L]Narrow font: Font. 
ipee 
E Use Unicode graphics characters 
ER 2、 选 中 UTF-8 
Cursor style: Block v 
|1. i&rRAppearance [use color: Color 
Blinking 
Highlight keywords 
Name: «None» v Edit. 
Style: Reverse video Bold Color 
[^x] ee 





图 38.5.2.1 设置 UTF-8 编码 
设置 好 以 后 点 击 下 方 的 “Ok” 按 钮 即 可 ，SecureCRT 我 们 就 设置 好 了 。 
2、 创 建 中 文 文件 
在 ubuntu "IHE rootfs 目录 新 建 一 个 名 为 “中 文 测试 ”的 文件 夹 ， 然 后 在 SecureCRT 下 查 
看 中 文 名 能 不 能 显示 正确 。 输 入 “ls” 命 令 ， 结 果 如 图 38.5.2.2 所 示 : 
/drivers £ cd / 














/ € is 

bin etc mnt sbin usr 

dev lib proc sys 中 文 测试 
dri vers linuxrc root tmp 





图 38.5.2.2 中 文 文件 夹 测试 
可 以 看 出 “中 文 测试 ”这 个 文件 夹 显 示 正 常 ， 接 着 “touch” 命 令 在 “中 文 测试 ”文件 夹 中 
新 建 一 个 名 为 “测试 文档 .txt” 的 文件 ， 并 且 使 用 vim 编辑 器 在 其 中 输入 “这 是 一 个 中 文 测试 文 
fr", 借 此 来 测试 一 下 中 文 文件 名 和 中 文 内 容 显示 是 否 正 常 。 在 SecureCRT 中 使 用 “cat” 命 令 
来 查看 “测试 文档 .txt” 中 的 内 容 ， 结 果 如 图 38.5.2.3 所 示 : 























/ # cd 中 文 测试 / 


1、cat 命 令 查 看 ”测试 文档 .txt“ 内 容 





2、 文 档 内 容 





图 38.5.2.3 中 文 文档 内 容 显示 
从 图 38.5.2.3 可 以 看 出 ,“ 测 试 文档 .txt” 的 中 文 内 容 显 示 正 确 , 而 且 中 文 路 径 也 完全 正常 ， 
说 明 我 们 的 根 文件 系统 已 经 完美 支持 中 文 了 ! 

















38.5.3 开机 自 启动 测试 


在 38.5.1 小 节 测 试 hello 软件 的 时 候 都 是 等 Linux 启动 进入 根 文件 系统 以 后 手动 输入 命令 
“./hello” 来 完成 的 。 我 们 一 般 做 好 产品 以 后 都 是 需要 开机 自动 启动 相应 的 软件 ， 本 节 我 们 就 以 
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hello 这 个 软件 为 例 ， 讲 解 一 下 如 何 实现 开机 自 启动 。 前 面 我 们 说 过 了 ， 进 入 根 文 件 系统 的 时 候 
会 运行 /etc/init.d/reS 这 个 shell 脚本 ， 因 此 我 们 可 以 在 这 个 脚本 里 面 添加 自 启动 相关 内 容 。 添 加 
完成 以 后 的 /ete/init.d/reS 文件 内 容 如 下 : 

示例 代码 38.5.3.1 rcS 文件 代码 

















aay Sl 

PATH-/sbin:/bin:/usr/sbin:/usr/bin 

LD LIBRARY PATH-$LD LIBRARY PATH:/lib:/usr/lib 
runlevelzS 

umask 022 

export PATH LD LIBRARY PATH runlevel 


OON JEEP SCO SUISSES 


mount -a 


mkdir /dev/pts 


Mo 


mount -t devpts devpts /dev/pts 


=e Ho 
No | o 


echo /sbin/mdev » /proc/sys/kernel/hotplug 


mdev -s 


# 开 机 自 启动 

cd /drivers 

./hello & 

Gel // 

第 16 行 ， 进 入 drivers 目录 ， 因 为 要 启动 的 软件 存放 在 drivers 目录 下 。 

第 17 行 ， 以 后 台 方 式 执行 hello 这 个 软件 。 

第 18 行 ， 退 出 drivers 目录 ， 进 入 到 根 目 录 下 。 

自 启动 代码 添加 完成 以 后 就 可 以 重启 开发 板 , 看 看 hello 这 个 软件 会 不 会 自动 运行 。 结果 如 
图 38.5.3.1 所 示 : 


BHABmBDuamanu 
c -1 O Oi d Q9 





























#0: wm8960-audio 
VFS: Mounted root (nfs filesystem) on device 0:14. 
devtmpfs: mounted 
Freeing unused kernel memory: 444K (80b19000 - 80b88000) 
nfs: server 192.168.1.250 not responding, still trying 
nfs: server 192.168.1.250 oğ 










e-nre nter to activate this console. hello world! 
world! 

hello world! 
hello world! 
world! 
world! 








hello 软 件 开始 运行 






图 38.5.3.1 hello 开机 自 启动 
从 图 38.5.3.1 可 以 看 出 ，hello 开机 自动 运行 了 ， 说 明 开 机 自 启动 成 功 。 














38.5.4 外 网 连接 测试 


这 里 说 的 外 网 不 是 外 国 哪些 404 网 站 的 连接 测试 ， 而 是 百度 、 淘 宝 等 这 些 网 站 的 测试 。 也 
就 是 说 看 看 我 们 的 开发 板 能 不 能 上 网 ， 能 不 能 和 我 们 的 局 域 网 外 的 这 些 网 站 进行 通信 。 测 试 方 
法 很 简单 ， 就 是 通过 ping 命令 来 ping 一 下 百度 的 官网 : www.baidu.com。 输 入 如 下 命令 

ping www.baidu.com 


结果 如 图 38.5.4.1 所 示 : 
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/ # ping www.baidu.com 
"P bad address 'www.baidu.com' 


图 38.5.4.1 ping 测试 结 

可 以 看 出 ， 测 试 失 败 ， 提 示 www.baidu.com 是 个 “bad address”， 也 就 是 地 址 不 对 ， 显 然 我 
们 的 地 址 是 正确 的 。 之 所 以 出 现 这 个 错误 提示 是 因为 www.baidu.com 的 地 址 解析 失败 了 ， 并 没 
有 解析 出 其 对 应 的 IP 地 址 。 我 们 需要 配置 域名 解析 服务 器 的 IP 地 址 ， 一 般 域 名 解析 地 址 可 以 
设置 为 所 处 网 络 的 网 关 地 址 ， 比 如 192.168.1.1。 也 可 以 设置 为 114.114.1144.114， 这 个 是 运营 商 
的 域名 解析 服务 器 地 址 。 
在 rootfs 中 新 建文 件 /etc/resolv.conf， 然 后 在 里 面 输入 如 下 内 容 : 

示例 代码 38.5.4.1 resolv.conf 文件 内 容 

1 nameserver 114.114.114.114 
2 nameserver 192.168.1.1 

设置 很 简单 nameserver 表示 这 是 个 域名 服务 器 ， 设 置 了 两 个 域名 服务 器 地 址 : 
114.114.114.114 和 192.168.1.1， 大 家 也 可 以 改 为 其 他 的 域名 服务 器 试 试 。 如 果 使 用 “udhcpc” 命 
令 自 动 获 取 IP 地 址 ,“udhcpc” 命 令 会 修改 nameserver 的 值 ， 一 般 是 将 其 设置 为 对 应 的 网 关 地 
址 。 修 改 好 以 后 保存 退出 ， 重 启 开发 板 ! 重启 以 后 重新 ping 一 下 百度 官网 ， 结 果 如 图 38.5.42 
所 示 : 
/ € ping www.baidu.com 
PING www.baidu.com (14.215.177.39): 56 data bytes 
64 bytes from 14.215.177.39: seq=0 ttl-56 time-9.591 ms 
6d bytes from 14.215.1/7. 39: sec? tti-36 time-ll.850 mes 
64 bytes from 14.215.177.39: seq-3 ttl-56 time-10.878 ms 


64 bytes from 14.215.177.39: seq-4 tt1=56 time-9.816 ms 
64 bytes from 14.215.177.39: seq-5 tt1=56 time-10.515 ms 
^C 
































--- www.baidu.com ping statistics --- 
6 packets transmitted, 6 packets received, 0% packet loss 
rupes min/avg/max = 9.591/10.796/13.850 ms 
图 38.5.4.2 ping 百度 官网 结果 

可 以 看 出 ping 百度 官网 成 功 了 ! 域名 也 成 功 的 解析 了 ， 至 此 ! 我 们 的 根 文 件 系统 就 彻底 的 
制作 完成 ， 这 个 根 文 件 系 统 最 好 打包 保存 一 下 ， 防 止 以 后 做 实验 不 小 心 破坏 了 根 文件 系统 而 功 
亏 一 簧 ， 又 得 从 头 制作 根 文件 系统 。uboot、Linux kernel. rootfs 这 三 个 共同 构成 了 一 个 完整 的 
Linux 系统 ， 现 在 的 系统 至 少 是 一 个 可 以 正常 运行 的 系统 ， 后 面 我 们 就 可 以 在 这 个 系统 上 完成 
Linux 驱动 开发 的 学 习 。 
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第 三 十 九 章 系统 烧 写 


前 面 我 们 已 经 移植 好 了 uboot 和 linux kernle， 制 作 好 了 根 文件 系统 。 但 是 我 们 移植 都 是 通 











过 网 络 来 测试 的 ， 在 实际 的 产品 开发 中 肯定 不 可 能 通过 网 络 来 运行 ， 否 则 没 网 的 时 候 产 品 岂 不 
是 就 歇 菜 了 。 因 此 我 们 需要 将 uboot、linux kernel、.dtb( 设 备 树 ) 和 rootfs 这 四 个 文件 烧 写 到 板子 
上 的 EMMC、NAND 或 QSPI Flash 等 其 他 存储 设备 上 , 这 样 不 管 有 没有 网 络 我 们 的 产品 都 可 以 
正常 运行 。 本 章 我 们 就 来 学 习 一 下 如 何 使 用 NXP 官方 提供 的 MfgTool 工具 通过 USB OTG OX 
烧 写 系统 。 
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39.1 MfgTool 工具 简介 





MfgTool 工具 是 NXP 提供 的 专门 用 于 给 LMX 系列 CPU 烧 写 系统 的 软件 ， 可 以 在 NXP 官 
网 下 载 到 。 此 工具 已 经 放 到 了 开发 板 光盘 中 ,路 劲 为 :5、 开 发 工具 ->3、NXP 官方 原版 MFG_TOOL 
烧 写 工具 ->L4.1.15_2.0.0-ga_mfg-tools.tar.gz。 此 软件 在 Windows 下 使 用 ， 对 于 我 们 来 说 太 友好 
了 。, 将 此 压缩 包 进 行 解压 , 解压 完成 以 后 会 出 现 一 个 名 为 L4.1.15_2.0.0-ga_mfg-tools 的 文件 夹 ， 
进入 此 文件 来， 此 文件 夹 的 内 容 如 图 39.1.1 所 示 : 


I 

































































| A T > [11.15 20.0-ga mfg-tools x 
文件 主页 ” 共享。 查看 e 
€ v ^ T * L41.15 2.0.0-ga mfg-tools > 教程 使 用 > L4.1.15 2.0.0-ga mfg-tools v O 搜索 "1L4.1.15 2.00-ga mfg-t.. P 

^ 。 名称 ` 修改 日 期 类 型 大 小 
快速 访问 
m 桌面 + || EULA.txt 2016/9/20 11:06 文本 文档 33 KB 
& TER K B} mfgtools-without-rootfs.tar.gz 2016/9/27 23:26 360 压 缩 93,402 KB 
i B} mfgtools-with-rootfs.tar.gz 2016/9/27 23:27 360 压 缩 604,206 KB < 
exi el 7! SCR-4.1.15-2.0.0 mfgtools.txt 2016/9/28 22:27 文本 文档 6KB 
EAK + 
— 第 3 讲 Ubuntu 搬 
M 
4 个 项 目 ”选中 1 个 项 目 327 KB - 














图 39.1.1 mfg tools 工具 目录 

从 图 39.1.1 可 以 看 出 ， 有 两 个 .txt 文件 和 两 个 .gz 压缩 包 。.txt 文档 就 不 去 看 了 , 重点 是 这 两 
个 .gz 压缩 包 , 这 两 个 压缩 包 的 区 别 在 名 字 上 已 经 写 的 很 详细 了 。 without-rootfs "I^ with-rootfs ", 
一 个 是 带 rootfs 和 一 个 是 不 带 rootfs 。mfg tools 这 个 工具 本 意 是 给 NXP 自己 的 开发 板 设计 的 烧 
写 软件 ， 所 以 肯定 带 有 自家 开发 板 对 应 的 uboot, linux kernel 和 rootfs 的 文件 。 我 们 肯定 是 要 烧 
写 文件 系统 的 ， 所 以 选择 mfgtools-with-rootfs.tar.gz 这 个 压缩 包 ， 继 续 对 其 解压 ， 解压 出 一 个 
名 为 mfgtools-with-rootfs 的 文件 夹 ， 此 文件 夹 就 包含 有 我 们 需要 的 烧 写 工具 。 

进入 目录 mfgtools-with-rootfs\mfgtools FP, 在 此 目录 下 有 几 个 文件 夹 和 很 多 的 .vbs 文件 , 如 
图 39.1.2 所 示 : 













































































LESTE 管理 mfgtools 一 x 
i 主页 共享。 查看 ”应 用 程序 I 具 e 
€ > ~v 个 看 “教程 使 用 》1L4.1.15 2.0.0-ga mfg-tools > mfgtools-with-rootfs > mfgtools v O 搜索 "mfgtools” 2 
^ 名 称 ^ 修改 日 其 类 型 大 小 ^ 
t 快速 访问 
msn " a Document 2019/6/15 10:54 bin 
: Drivers 2019/6/15 10:54 文件 夹 
时 下 我 More scripts 2019/6/15 10:54 文件 夹 
B 文档 ^ Profiles 2019/6/15 10:54 SUE 
EAK * ^ Utils 2019/6/15 10:54 文件 夹 
7 第 3 讲 Ubuntul 口 gitignore 2016/9/13 11:53 GITIGNORE 文件 1KB 
— 截图 4] cfg.ini 2016/9/13 11:53 配置 设置 1 KB 
I 开发 手册 E libMfgToolLib.so 2016/9/13 11:53 Digital Waveform F... 6,393 KB « 
Tox | linux-cvbs.sh 2016/9/13 11:53 SH 文件 2 KB 
| linux-runvbs.sh 2016/9/13 11:53 SH 文件 1 KB 
*& OneDrive ] linux-ver-usage 2016/9/13 11:53 文件 1 KB 
加 此 电脑 -| MfgTool.log 2019/6/15 10:57 文本 文档 4KB 
DDA dih MfgTool2.exe 2016/9/13 11:53 应 用 程序 1,955 KB 
[S] mfgtool2-android-mx6dl-sabreauto-nand.vbs 2016/9/13 11:53 VBScript Script 文件 1KB 
8 视频 3$] mfgtool2-android-mx6dl-sabreauto-sdcard.vbs 2016/9/13 11:53 VBScript Script 文件 1KB 
= BH 图 mfgtool2-android-mx6dl-sabreauto-sdcard-f2fs.vbs 2016/9/13 11:53 VBScript Script 文件 1KB 
5j 文档 v 3$] mfgtool2-android-mx6dl-sabresd-emmc.vbs 2016/9/13 11:53 VBScript Script 文件 1 KB v 











78 个 项 目 ”选中 1 个 项 目 23375 








n" 





图 39.1.2 mfgtools 目录 内 容 

我 们 只 关心 图 39.1.2 中 Profiles 这 个 文件 夹 ， 因 为 后 面 要 烧 写 文件 就 放 到 这 个 文件 夹 中 。 
mfgTool2.exe 就 是 烧 写 软件 ， 但 是 我 们 不 会 直接 打开 这 个 软件 烧 写 ，mfg_tools 不 仅 能 烧 写 
IMX6U， 而 且 也 能 给 LMX7. LMX6Q 等 芯片 烧 写 ， 所 以 在 烧 写 之 前 必须 要 进行 配置 ， 指 定 烧 
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写 的 是 什么 芯片 ， 烧 写 到 哪里 去 ?下 面 的 这 些 众 多 的 .vbs 文件 就 是 配置 脚本 ， 烧 写 的 时 候 通过 
双击 这 些 .vbs 文件 来 打开 烧 写 工具 。 这 些 .vbs 烧 写 脚本 既 可 以 根据 处 理 器 的 不 同 ， 由 用 户 选 择 
向 IMX6D、I.MX6Q、I.MX6S、I.MX7、I.MX6UL 和 了 I.MX6ULL 等 的 哪 一 款 蕊 片 烧 写 系统 。 也 
可 以 根据 存储 芯片 的 不 同 ， 选 择 向 EMMC、NAND 或 QSPI Flash 等 的 哪 一 种 存储 设备 烧 写 ， 功 
能 非常 强大 !! 我 们 现在 需要 向 ILMX6U 烧 写 系统 ， 因 此 需要 参考 表 39.1.1 所 示 的 5 个 烧 写 脚 
本 : 










































































mfgtool2-yocto-mx-evk-emmc.vbs EMMC 烧 写 脚本 。 
mfgtool2-yocto-mx-evk-nand.vbs NAND 烧 写 脚本 
mfgtool2-yocto-mx-evk-qspi-nor-n25q256a.vbs | QSPI Flash 烧 写 脚本 ， 型 号 为 n25q256a 
mfgtool2-yocto-mx-evk-sdcard-sd1.vbs WR SD1 和 SD2 接 的 SD 卡 ， 这 连 个 文件 分 
mfgtool2-yocto-mx-evk-sdcard-sd2.vbs 别 向 SD1 和 SD2 上 的 SD 卡 烧 写 系统 。 














K 39.1.1 IMX6U 使 用 的 烧 写 脚本 
其 他 的 .vbs 烧 写 脚本 用 不 到 ， 因 此 可 以 删除 掉 ， 防 止 干扰 我 们 的 视线 。 本 书 用 的 是 正点 原 
THI EMMC 版 核心 板 ， 因 此 只 会 用 到 mfgtool2-yocto-mx-evk-emmc.vbs 这 个 烧 写 脚本 ， 如 果 用 
其 他 的 核心 板 请 参考 相应 的 烧 写 脚 本 。 







































































39.2 MfgTool 工作 原理 简介 


MfgTool 只 是 个 工具 , 具体 的 原理 不 需要 去 深入 研究 , 大 概 来 了 解 一 下 其 工作 原理 就 行 了 ， 
知道 它 的 工作 流程 就 行 了 。 

















39.2.1 烧 写 方式 


1、 连 接 USB 线 


MfgTool 是 通过 USB OTG 接口 将 系统 烧 写 进 EMMC 中 的 ， 正 点 原子 LMX6U-ALPHA FF 
发 板 上 的 USB OTG 口 如 图 39.2.1.1 所 示 : 


医 国 cec 











PEALE 
A 


baea C80 U17 ® 
n nmt 
A 

CAMERA RN 


区 fo D2 D4 DGPCUKEWON 
| A ) E : 


SOVVEYNEHFEFRETDIBS DS D7 OE 





图 39.2.2.1 USB OTGI 接口 
在 烧 写 之 前 ， 需 要 先 用 USB 线 将 图 39.2.2.1 中 的 USB_OTG1 接口 与 电脑 连接 起 来 。 


2、 拨 码 开关 找到 USB 下 载 模式 
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将 图 39.2.2.1 中 的 拨 码 开关 拨 到 “USB ”模式 ， 如 图 39.2.2.2 所 示 : 


BOOT CFG 


E SXDUSETCGEJESEJEIR 
DOE NERLICIERUITIESE] 
[i34 TEMP 


DIP 
"^, T TTTIT 


2845678 


图 39.2.2.2 USB 下 载 模式 





如 果 插 了 TF 卡 ， 请 弹出 TF 卡 ， 否 则 电脑 不 能 识别 USB! 等 识别 出 来 以 后 再 插 上 TF 卡 ! 





如 果 插 了 TF 卡 ， 请 弹出 TF 卡 ， 否 则 电脑 不 能 识别 USB! 等 识别 出 来 以 后 再 插 上 TFE! 
如 果 插 了 TF 卡 ， 请 弹出 TF 卡 ， 否 则 电脑 不 能 识别 USB! 等 识别 出 来 以 后 再 插 上 TF 卡 ! 











一 切 准 备 就 绪 以 后 ， 按 一 re nn i 如 果 是 第 一 次 进 
入 USB 模式 的 话 可 能 会 久 一 点 ， 这 个 是 免 驱 的 ， 因 此 不 需要 安装 驱动 。 第 一 次 进入 USB 模式 


会 在 电脑 右 下 角 有 如 图 39.2.2.3 所 示 提 示 : 


次 ”正在 设置 设备 

















图 39.2.2.3 第 一 次 进入 USB 模式 
一 旦 第 一 次 设置 好 设备 以 后 ， 后 面 每 次 连接 都 不 会 有 任何 提示 了 。 到 这 里 ， 我 们 的 开发 板 








已 经 和 电脑 连接 好 了 ， 可 以 开始 烧 写 系统 了 。 
39.2.2 系统 烧 写 原理 





开发 板 连 接 电脑 以 后 双击 “mfgtool2-yocto-mx-evk-emmc.vbs”， 打 开 下 载 对 话 框 ， 如 图 
39.2.2.1 所 示 : 





ith MfgTool MultiPanel (Library: 2.7.0) X x 
Status Information 


开发 板 连 接 的 USB 接 口 Successful Operations: 0 
33 Failed Operations: 0 
Failure Rate: 0 96 


39.2.2.1 MfgTool 工具 界面 

如 果 出 现 “ 符 合 HID 标准 的 供应 商定 义 设备 ”就 说 明 连 接 正常 , 可 以 进行 烧 写 , 如 果 出 现 

其 他 的 字符 那么 就 要 检查 连接 是 否 正确 。 点 击 “Start” 按 钮 即 可 开始 烧 写 ， 烧 写 什么 东西 呢 ? 

肯定 是 烧 写 uboot、Linux kernel、.dtb 和 rootfs， 那 么 这 四 个 应 该 放 到 哪里 MfgTool 才能 访问 到 
呢 ? 进入 如 下 目录 中 : 

L4.1.15 2.0.0-ga mfg-tools/mfgtools-with-rootfs/mfetools/Profiles/Linux/OS Firmware 
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此 目录 中 的 文件 如 图 39.2.2.2 Brzn: 
^| MH T s |0sFirmware 一 x 
主页 ”共享 ”查看 @ 
€- — ~ ^ . « mfgtools-with-rootfs > mfgtools > Profiles > Linux > OS Firmware v OD 搜索 "OS Firmware" p 
B wa ^ ER 修改 日 期 类 型 大 小 
e 图 片 T files 2019/6/15 16:09 文件 夹 
5 文档 T firmware 2019/6/15 16:09 文件 来 
ATE B mksdcard.sh.tar 2016/9/13 11:53 360 压 缩 10 KB 
小 音乐 庆 mksdcard-android.sh.tar 2016/9/13 11:53 360 压 缩 10 KB 
国 桌面 B} mksdcard-android-f2fs.sh.tar 2016/9/13 11:53 360 压 缩 10 KB 
i 本 地 磁盘 (C3) B} mksdcard-brillo.sh.tar 2016/9/13 11:53 360 压 缩 10 KB 
spi-header.sh.tar 2016/9/13 11:53 360 压 缩 10 KB 
、 林地 磁盘 (D) 8 asp i 
IRE [C] ucdzxml 2016/9/13 11:53 XML 文档 57 KB 
7 e |] ucl2-old.xml 2016/9/13 11:53 XML 文档 52 KB 
一 仓库 (Fj h 
9 个 项 目 I 











图 39.2.2.2 OS Firmware XHK KZ 

文件 来“OS Firmware” 看 名 字 就 知道 是 存放 系统 固件 的 ， 我 们 重点 关注 files、firmware 这 
两 个 文件 夹 ， 以 及 ucl2.xml 这 个 文件 。 在 具体 看 这 三 个 文件 和 文件 夹 之 前 ， 我 们 先 来 简单 了 解 
一 下 MfgTool 烧 写 的 原理 ，MfgTool 其 实 是 先 通 过 USB OTG 先 将 uboot, kernel 和 .dtb( 设 备 树 ) 
这 是 三 个 文件 下 载 到 开发 板 的 DDR 中, 注意 不 需要 下 载 rootfs。 就 相当 于 直接 在 开发 板 的 DDR. 
上 启动 Linux 系统 ， 等 Linux 系统 启动 以 后 在 向 EMMC 中 烧 写 完整 的 系统 ， 包 括 uboot. linux 
kernel、.dtb( 设 备 树 ) 和 rootfs， 因 此 MfgTool 工作 过 程 主要 分 两 个 阶段 : 

CD. Jf firmware 目录 中 的 uboot、linux kernel 和 .dtb( 设 备 树 )， 然 后 通过 USB OTG 将 这 个 
文件 下 载 到 开发 板 的 DDR 中 ， 目 的 就 是 在 DDR 中 启动 Linux 系统 ， 为 后 面 的 烧 写 做 准备 。 

包 、 经 过 第 中 步 的 操作 ， 此 时 Linux 系统 已 经 运行 起 来 了 ， 系 统 运行 起 来 以 后 就 可 以 很 方 
便 的 完成 对 EMMC 的 格式 化 、 分 区 等 操作 。EMMC 分 区 建立 好 以 后 就 可 以 从 firmware 中 读 取 
要 烧 写 的 uboot、linux kernel、.dtb( 设 备 树 ) 和 rootfs 这 4 个 文件 ， 然 后 将 其 烧 写 到 EMMC 中 ， 
这 个 就 是 MfgTool 的 大 概 工作 流程 。 

1、firmeare 文件 夹 


打开 firmware XR, EMARE Him 结尾 的 uboot 文件 、 一 个 zImage 镜像 文件 、 很 
多 .dtb 结尾 的 设备 树 文件 .这 些 文件 都 是 NXP 官方 开发 板 使 用 的 ,不 同 的 板子 使 用 不 同 的 文件 ， 
其 中 我 们 需要 关心 的 只 有 表 39.2.2.1 中 的 这 三 个 文件 : 

























































































zImage NXP 7; LMX6ULL EVK 开发 板 的 Linux 镜像 文件 。 
u-boot-imx6ulll4x14evk emmc.imx NXP H7; LMX6ULL EVK 开发 板 的 uboot 文件 。 
zImage-imx6ull-14x14-evk-emmc.dtb | NXP 官方 LMX6ULL EVK 开发 板 的 设备 树 
表 39.22.1 LMX6ULL EVK 开发 板 使 用 的 系统 文件 

表 39.2.2.1 中 的 这 三 个 文件 就 是 IMX6ULLEVK 开发 板 烧 写 系 统 的 时 候 第 一 阶段 所 需 的 文 
件 。 如 果 要 烧 写 我 们 的 系统 ， 就 需要 用 我 们 编译 出 来 的 zzmmage、u-boot.imx 和 imx6ull-alientek- 
emmc.dtb 这 三 个 文件 替换 掉 表 39.2.2.1 中 这 三 个 文件 。 但 是 名 字 要 和 表 39.2.2.1 中 的 一 致 ， 
此 需要 将 u-boot.imx 重 命名 为 ubootr-imx6ull14x14evk_emmc.imx， 将 imx6ull-alientek-emmc.dtb 
重 命 名 为 zImage-imxóull-14x 14-evk-emmc.dtb 。 


2. files 文件 夹 
将 表 39.2.2.1 中 的 这 三 个 文件 下 载 到 开发 板 的 DDR 上 以 后 烧 写 的 第 一 阶段 就 完成 了 , 第 二 
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阶段 就 是 从 fies 目录 中 读 取 整个 系统 文件 ， 并 将 其 烧 写 到 EMMC Po files 目录 中 的 文件 和 





firmware 目录 中 的 基本 差不多 ， 都 是 不 同 板子 对 应 的 uboot、 设 备 树 文件 ， 同 样 ， 我 们 只 关心 表 
39.2.2.2 中 的 四 个 文件 : 
本 文件 | 
zImage NXP ÈY LMX6ULL EVK 开发 板 的 Linux 镜像 文件 。 
u-boot-imx6ullldxIdevk emmc.imx | NXP 官方 IMX6ULL EVK 开发 板 的 uboot 文件 。 
zImage-imx6ull-14x14-evk-emmc.dtb | NXP 117; LMX6ULL EVK 开发 板 的 设备 树 
根 文 件 系统 ， 注 意 和 另外 一 个 rootfs.tar.bz2 根 文件 系 
rootfs nogpu.tar.bz2 统 区 分 开 。nogpu 表示 此 根 文件 系统 不 包含 GPU 的 内 
容 ，I.MX6ULL 没有 GPU， 因 此 要 使 用 此 根 问 价 系统 
K 39.2.2.2 LMX6ULL EVK 开发 板 烧 写 文件 

如 果 要 烧 写 我 们 自己 编译 出 来 的 系统 ， 就 需要 用 我 们 编译 出 来 的 zImage、u-boot.imx 和 
imx6ull-alientek-emmc.dtb 和 rootfs 这 四 个 文件 蔡 换 掉 表 39.2.2.2 中 这 四 个 文件 。 

3、ucl2.xml 文件 


files 和 firmware 目录 下 有 众多 的 uboot 和 设备 树 ， 那 么 烧 写 的 时 候 究 竟 选 择 哪 一 个 昵 ? 这 
个 工作 就 是 由 ucl2.xml 文件 来 完成 的 ,ucl2.xml 以 “<UCL> ”开始 , 以 *</UCL> ?结束 。<CFG>” 
和 “</CFG>” 之 间 是 配置 相关 内 容 ， 主 要 是 判断 当前 是 给 LMX 系列 的 哪个 芯片 烧 写 系统 。 
“<LIST>” 和 “</LIST>” 之 间 的 是 针对 不 同 存储 芯片 的 烧 写 命令 。 整 体 框架 如 下 : 
示例 代码 39.2.2.1 ucl2.xml 框架 



























































«/CFG» 


«LIST name-"SDCard" desc-"Choose SD Card as media"> 


«1-- I] SD-FE$5 Linux 系统 ==> 
«f bees 


«LIST name-"eMMC" desc-"Choose eMMC as media" 


«1-- H] EMMC 5€ 5j Linux 系统 --» 
S BLEST 


«LIST name-"Nor Flash" desc-"Choose Nor flash as media"^ 
<!-- |] Nor Flash 烧 写 Linux 系统 --» 
«EE: 


XLIST name-"Quad Nor Flash" desc-"Choose Quad Nor flash as media"» 


«!-- |] Quad Nor Flash 4€ 5 Linux 系统 --» 
< /ELS 


1000 


LMX6U AR Linux 驱动 开发 指南 ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
<LIST name-"NAND Flash" desc-"Choose NAND as media"- 
«!-- J NAND Flash 5&5 Linux 系统 --» 
< /LIDS 


<LIST name-"SDCard-Android" desc-"Choose SD Card as media"> 


«1—- [H SD FBS Android Zt --» 
ANS oU 


«LIST name-"eMMC-Android" desc-"Choose eMMC as media"> 


<!-- 向 EMMC 烧 写 Android 系统 --» 
< LISIS 


<LIST name="Nand-Android" desc="Choose NAND as media"> 
<!-- 向 NAND Flash #5 Android 系统 --» 
ES ANS 


XLIST name-"SDCard-Brillo" desc-"Choose SD Card as media"> 
«1-- 向 SD FS Brillo 系统 --» 
ES BIEN 
«/UCL» 
ucl2.xml 首先 会 判断 当前 要 向 IMX 系列 的 哪个 芯片 烧 写 系统 ， 代 码 如 下 ; 
示例 代码 39.2.2.2 判断 要 烧 写 的 处 理 器 型 号 





DIM 
22 «STATE name-"BootStrap" dev-"MX6SL" vid-"15A2" pid-"0063"/» 
23 <STATE name="BootStrap" dev="MX6D" vid="15A2" pid="0061"/> 
24 <STATE name-"BootStrap" dev-"MX6Q" vid-"15A2" pid="0054"/> 
25 <STATE name="BootStrap" dev="MX6SX" vid="15A2" pid="0071"/> 
26 <STATE name="BootStrap" dev-"MX6UL" vid-"15A2" pid="007D"/> 
2 <STATE name-"BootStrap" dev="MX7D" vid-"15A2" pid="0076"/> 
28 «STATE name-"BootStrap" dev-"MX6ULL" vid-"15A2" pid-"0080"/» 
29 <STATE name="Updater" dev="MSC" vid="066F" pid="37FF"/> 
SOR- /Che> 
通过 读 取 蕊 片 的 VID AI PID 即 可 判断 出 当前 要 烧 写 什么 处 理 器 的 系统 ,如 果 VID=0X15A2， 
PID=0080， 那 么 就 表示 要 给 LMX6ULL 烧 写 系统 。 确 定 了 处 理 器 以 后 就 要 确定 向 什么 存储 设备 
烧 写 系统 ， 这 个 时 候 就 要 有 请 mfgtool2-yocto-mx-evk-emmc.vbs 再 次 登场 ， 此 文件 内 容 如 下 : 
示例 代码 39.2.2.3 mfgtool2-yocto-mx-evk-emmc.vbs 文件 内 容 
Set wshShell = CreateObject("WScript.shell") 
































weliS hen un AEO EO A sexe re MM dba Vi JE wed —e 
""board-sabresd"" -s ""mmc-1"" -s ""6uluboot-14x1l4evk"" -s 
""6uldtb-14xl4-evk""" 
Set wshShell = Nothing 

重点 是 “wshShellrun” 这 一 行 ， 这 里 一 行 调用 了 mfgtool2.exe 这 个 软件 ， 并 且 还 给 出 了 一 
堆 的 参数 ， 其 中 就 有 “eMMC” 字样 ， 说 明 是 向 EMMC 烧 写 系统 ， 要 烧 写 的 存储 设备 就 这 样 确 








上 
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定 下 来 了 。“wshShellrun” 后 面 还 有 一 堆 的 其 他 参数 ， 这 些 参数 都 有 对 应 的 值 ， 如 下 所 示 : 


board=sabresd 











mmc-1 
6uluboot-14x14evk 
6uldtb-14x14-evk 
我 们 继续 回 到 ucI2.xml 中 ， 既 然 现在 已 经 知道 了 是 向 LMX6ULL 的 EMMC 中 烧 写 系统 ， 
那么 直接 在 ucl2.xml 中 找到 相应 的 烧 写 命令 就 行 了 ， 因 为 相应 的 命令 太 长 ， 为 了 缩小 篇 幅 ， 我 
们 就 以 uboot 的 烧 写 为 例 讲 解 一 下 .前 面 说 了 烧 写 分 两 个 阶段 , 第 一 步 是 通过 USB OTG 向 DDR 
中 下 载 系统 ， 第 二 步 才 是 正常 的 烧 写 。 通 过 USB OTG 向 DDR. F uboot 的 命令 如 下 : 
示例 代码 39.2.2.4 通过 USB OTG 下 载 uboot 
<CMD state-"BootStrap" type-"boot" body-"BootStrap" file -"firmware/u- 
boot-imx6ul$lite$$6uluboot$ emmc.imx" ifdev-"MX6ULL"»Loading U-boot 
«/CMD» 
上 面 的 命令 就 是 BootStrap 阶段 ,也 就 是 第 一 阶段 file” 表示 要 下 载 的 文件 位 置 ,在 fimware 
目录 下 ， 文 件 名 字 为 
u-boot-imx6ul%lite%%6uluboot% emmc.imx 
“o%lite%” 和 “%6uluboot% ”分 别 表 示 取 lite 和 6uluboot 的 值 , 而 lite=l, Guluboot-14x14evk, 
因此 将 这 来 个 值 带 进去 以 后 就 是 : 
u-boot-imx6ulll4x14evk emmc.imx 
所 以 ， 这 里 向 DDR 中 下 载 的 是 firmware/ u-boot-imx6ulll4x14evk emmc.imx 这 个 uboot X 
件 。 同 样 的 方法 将 .dtb( 设 备 树 ) 和 zImage 都 下 载 到 DDR 中 以 后 就 会 跳 转 去 运行 0S， 这 个 时 候 
会 在 MfgTool 工具 中 会 有 “Jumping to OS image” 提 示 语 句 ，ucl2.xml 中 的 跳 转 命令 如 下 : 
示例 代码 39.2.2.5 跳 转 到 OS 
<CMD state-"BootStrap" type-"jump" » Jumping to OS image. </CMD> 
启动 Linux 系统 以 后 就 可 以 在 EMMC 上 创建 分 区 ， 然 后 烧 写 uboot、zImage、.dtb( 设 备 树 ) 
和 根 文 件 系统 。 
这 个 就 是 MfgTool 的 整个 烧 写 原理 ， 和 弄 懂 了 烧 写 原理 以 后 就 可 以 开始 试 着 先 将 NXP 官方 
的 系统 烧 写 到 正点 原子 的 LMX6U-ALPHA 开发 板 中 。 


39.3 烧 写 NXP 官方 系统 


我 们 先 试 着 将 NXP 官方 的 系统 烧 写 到 正点 原子 的 LMX6U-ALPHA 开发 板 中 ， 主 要 是 先 熟 
悉 一 下 烧 写 过 程 。 因 为 正点 原子 的 EMMC 核心 版 用 的 也 是 512MB 的 DDR3 加 4G 的 EMMC, 

因此 烧 写 NXP 官方 的 系统 是 没有 任何 问题 的 。 烧 写 步 又 如 下 : 

QD、 连 接 好 USB， 拨 码 开 关 拨 到 USB 下 载 模式 。 

©, HH TF 卡 ， 然 后 按 下 开发 板 复位 按键 。 

®©, HF SecureCRT。 

G@、 双 击 “mfgtool2-yocto-mx-evk-emmc.vbs”， 打 开 下 载 软件 ， 如 果 出 现 “ 符 合 HID 标准 
的 供应 商定 义 设 备 ” 等 字样 就 说 明 下 载 软件 已 经 准备 就 绪 。 点 击 “Start” 按 钮 开发 烧 写 NXP È 
方 系统 ， 烧 写 过 程 如 图 39.3.1 所 示 : 
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ith MfgTool MultiPanel (Library: 2.7.0) = X 
Hub 7--Port 2 Status Information 
Driv(s)| K: Successful Operations: 0 
Failed Operations: 0 
[Formatting rootfs partition| | i 
Failure Rate: 0% 
m — 
p —ÀÓ Stop Exit 
型 | 











39.3.1 烧 写 过 程 
这 个 时 候 可 以 在 SecurCRT 上 看 到 具体 的 烧 写 过 程 ， 如 图 39.3.2 所 示 : 











** serial-com13 x 4 b 






./opt/ltp/testcases/bin/cpuct]l. def task03 
./opt/ltp/testcases/bin/nfs05. make tree 
./opt/ltp/testcases/bin/ioct102 
./opt/ltp/testcases/bin/msgrcv08 
./opt/ltp/testcases/bin/getgid03. 16 
./opt/ltp/testcases/bin/tcp4-multi-diffport12 
./opt/ltp/testcases/bin/tcp4-multi-sameport02 
./opt/ltp/testcases/bin/tcp6-uni -sackoff10 
./opt/ltp/testcases/bin/pauseO01 


39.3.2 正在 烧 写 的 文件 












































等 待 烧 写 完成 ， 因 为 NXP 官方 的 根 文件 系统 比较 大 ,因此 烧 写 的 时 候 耗 时 会 久 一 点 。 烧 写 
完成 以 后 MfgTool 软件 如 图 39.3.3 所 示 : 
dfi MfgTool_MultiPanel (Library: 2.7.0) 5 X 
Hub 7--Port 2 Status Information 
Drive(s):| K: Successful Operations: 1 
b Failed Operations: 0 
Ade Failure Rate: 0.00 96 
a— — d Stop -— 
Eo 











39.3.2 烧 写 完成 
烧 写 完 成 以 后 点 击 “Stop” 按 钮 停止 烧 写 ， 然 后 点 击 “Exit” 键 退出 。 拔 出 USB 线 ， 将 开 
发 板 上 的 拨 码 开关 拨 到 EMMC 启动 模式 ， 然 后 重启 开发 板 ， 此 时 就 会 从 EMMC 启动 。 只 是 启 
动 以 后 的 系统 是 NXP 官方 给 LMX6ULL EVK 开发 板 制 作 的 ， 这 个 系统 需要 输入 用 户 名 ， 用 户 
名 为 “root”， 没 有 密码 ， 如 图 39.3.3 所 示 : 


Running local boot scripts (/etc/rc.local). 


























Freescale i.MX Release Distro 4.1.15-2.0.0 imx6ul7d /dev/ttymxcO 
imx6ul7d login: 

39.3.3 NXP 官方 根 文件 系统 
在 “imx6ul7d login: ”后 面 输入 “root” 用 户 名 ， 然 后 点 击 回 车 键 即 可 进入 系统 中 ， 进 入 系 
统 以 后 就 可 以 进行 其 他 操作 了 。 所 以 说 ，NXP 官方 的 系统 其 实 是 可 以 在 正点 原子 的 EMMC 版 
核心 板 上 运行 的 。 


39.4 烧 写 自制 的 系统 


39.4.1 系统 烧 写 


上 一 小 节 我 们 试 着 将 NXP 官方 提供 的 系统 烧 写 到 正点 原子 的 LMX6U-ALPHA 开发 板 好 
中 ， 目 的 是 体验 一 下 通过 MfgTool 烧 写 系统 的 过 程 。 本 小 节 我 们 就 来 学 习 如 何 将 我 们 做 好 的 系 
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统 烧 写 到 开发 板 中 ， 首 先是 准备 好 要 烧 写 的 原材料 ; 

(、 自 己 移 植 编译 出 来 的 uboot 可 执行 文件 : u-boot.imx. 

@、 自 己 移植 编译 出 来 的 zImage 镜像 文件 和 开发 板 对 应 的 .dtb( 设 备 树 )， 对 于 LMX6U- 
ALPHA 开发 板 来 说 就 是 imx6ull-alientek-emmc.dtb。 

(B)、 自 己 构建 的 根 文件 系统 rootfs， 这 里 我 们 需要 对 rootfs 进行 打包 ， 进 入 到 Ubuntu 中 的 
rootfs 目录 中 ， 然 后 使 用 tar 命令 对 其 进行 打包 ， 命 令 如 下 : 

cd rootfs/ 

tar -vcjf rootfs.tar.bz2 * 

完成 以 后 会 在 rootfs 目录 下 生成 一 个 名 为 rootfs.tar.bz2 的 压缩 包 ， 将 rootfs.tar.bz2 发 送 到 
windows 系统 中 。 

将 上 面 提 到 的 这 4 个 “原材料 ”都 发 送 到 Windows 系统 中 ， 如 图 39.4.1 所 示 : 


























LIB. | 原始 文件 = x 
POEM 主页 。 共享 。 查看 © 
所 vo^ o 》 烧 写 文件 > 原始 文件 vO 搜索 "原始 文件 ” 5 
z ^ 。 名 称 修改 日 期 类 型 大 小 
快速 访问 
m 桌面 + | ] imx6ull-alientek-emmc.dtb 2019/6/16 15:47 DTB 文件 36 KB 
LTR » BY rootfs.tar.bz2 2019/6/16 15:42 360 压 缩 38,798 KB 
| ] u-bootimx 2019/6/16 15:44 IMX 文件 419 KB 
58 文档 * |L] zlmage 2019/6/16 15:47 文件 5,453 KB 
E 图 片 * 
T 14.1.15 2.0.0-g 
CO xu M 


4 个 项 目 [3L 
图 39.4.1 烧 写 原材料 

材料 准备 好 以 后 还 不 能 直接 进行 烧 写 ， 必 须 对 其 进行 重 命名 ， 否 则 的 话 ucl2.xml 是 识别 不 

出 来 的 ,前 面 讲解 ucl2.xml 语法 的 时 候 已 经 说 过 了 ,图 39.4.1 中 的 这 四 个 文件 重 命 名 见 表 39.4.1: 






























































u-boot.imx u-boot-imx6ulll4x14evk emmc.imx 
zlmage zImage( 不 需要 重 命 名 ) 
imx6ull-alientek-emmc.dtb zlImage-imx6ull-14x14-evk-emmc.dtb 
rootfs.tar.bz2 rootfs nogpu.tar.bz2 





K 39.4.1 文件 重 命 名 表 





完成 以 后 如 图 39.4.2 所 示 : 



































1| Q 看 > | 修改 名 字 后 的 文件 E x 
文件 主页 共享 查看 © 
c vo^ 里 》 烧 写 文件 > 修改 名 字 后 的 文件 vO 搜索 "修改 名 字 后 的 文件 " 2 
^ 。 名 称 修改 日 期 类 型 大 小 

» 快速 访问 

mu + BY rootfs nogpu.tar.bz2 2019/6/16 15:42 360 压 缩 38,798 KB 

LTR 了 |. | u-boot-imx6ull14x14evk emmc.imx 2019/6/16 15:44 IMX 文件 419 KB 

i |] zimage 2019/6/16 15:47 文件 5,453 KB 

5 xe * | ] zlImage-imxó6ull-14x14-evk-emmc.dtb 2019/6/16 15:47 DTB 文件 36 KB 

e 图 片 + E 
4 个 项 目 四 











39.4.2 重 命名 以 后 的 文件 
接 下 来 就 是 用 我 们 的 文件 替换 掉 NXP 官方 的 文件 ， 先 将 图 39.4.2 中 的 zImage, u-boot- 
imx6ulll4x14evk emmc.imx 和 zImage-imx6ull-14x14-evk-emmc.dtb 这 三 个 文件 拷贝 到 mfgtools- 
with-rootfs/mfgtools/Profiles/Linux/OS Firmware/firmware 目录 中 ， 替 换 掉 原来 的 文件 。 然 后 将 
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39.4.2 中 的 所 有 4 个 文件 都 拷贝 到 mfgtools-with-rootfs/mfgtools/Profiles/Linux/OS Firmware/files 











目录 中 ， 这 两 个 操作 完成 以 后 我 们 就 可 以 进行 烧 写 了 。 

双击 “mtfgtool2-yocto-mx-evk-emmec.vbs”， 打 开 烧 写 软件 ， 点 击 “Start” 按 钮 开始 烧 写 ， 由 
于 我 们 自己 制作 的 rootfs 比较 小 ， 因 此 烧 写 相对 来 说 会 快 一 点 。 烧 写 完成 以 后 设置 开发 板 从 
EMMC 启动 ， 启 动 我 们 刚刚 烧 写 进去 的 系统 ， 测 试 有 没有 问题 一般 肯定 没 问 题 ， 因 为 这 些 都 
是 我 们 已 经 测试 好 的 。 























39.4.2 网 络 开 机 自 启 动 设置 


大 家 在 测试 网 络 的 时 候 可 能 会 发 现 网 络 不 能 用 ,这 并 不 是 因为 我 们 将 系统 烧 写 到 EMMC 中 
以 后 网 络 坏 了 。 仅仅 是 因为 网 络 没有 打开 , 我 们 用 NFS 挂 载 根 文件 系统 的 时 候 因 为 要 使 用 NFS 
服务 , 因此 Linux 内 核 会 打开 eth0 这 个 网 卡 , 现在 我 们 不 使 用 NFS 挂 载 根 文件 系统 , 因此 Linux 
内 核 也 就 不 会 自动 打开 eth0 网 卡 了 。 我 们 可 以 手动 打开 网 卡 ， 首 先 输入 “ifconfig -a” 命 令 查 看 
一 下 eth0 和 ethl 是 否 都 存在 ， 结 果 如 图 39.4.3 所 示 : 


/ # ifconfig -a 

ethO Link encap:Ethernet Hwaddr 46:F9:14:3B:59:62 
BROADCAST MULTICAST MTU:1500 Metric:1 
RX packets:O0 errors:O dropped:0 overruns:O frame:0 
TX packets:0 errors:0 dropped:0 overruns:O carrier:O 
collisions:O0 txqueuelen:1000 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 


ethl Link encap:Ethernet  HWaddr 2A:61:50:01:A4:3C 
BROADCAST MULTICAST MTU:1500 Metric:l1 
RX packets:O0 errors:O dropped:0 overruns:O frame:0 
TX packets:O0 errors:O dropped:0 overruns:O carrier:O 
collisions:0 txqueuelen: 1000 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 





























lo Link encap:Local Loopback 
LOOPBACK MTU:65536 WMetric:1 
RX packets:0 errors:O dropped:0 overruns:O frame:0 
TX packets:O0 errors:O dropped:0 overruns:O carrier:O 
collisions:O0 txqueuelen:O 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 


sit0 Link encap:IPv6-in-IPv4 
NOARP MTU:1480 Metric:1 
RX packets:O0 errors:O dropped:0 overruns:O frame:0 
TX packets:0 errors:0 dropped:0 overruns:O carrier:O 
collisions:O0 txqueuelen:O 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 


394. 查看 网 络 
可 以 看 出 eth0 好 ethl 都 存在 ， 既 然 存在 我 们 就 打开 ， 以 打开 eth0 网 卡 为 例 ， 输 入 如 下 命 
令 打 开 eth0: 
ifconfig eth0 up 
打开 网 卡 的 时 候 会 有 如 图 39.4.4 所 示 的 提示 信息 : 
/ # ifconfig ethO up 
fec 20b4000.ethernet eth0: Freescale FEC PHY driver [SMSC LAN8710/LAN8720 
] (mii. bus:phy addr-20b4000.ethernet:01, irq--1) 
IPv6: ADDRCONF(NETDEV UP): eth0: link is not ready 
/ # fec 20b4000.ethernet eth0: Link is Up - 100Mbps /Fu11 - flow control r 


x/tx 
IPv6: ADDRCONF(NETDEV CHANGE): eth0: link becomes ready 


39.4.5 打开 eth0 网 卡 
打开 的 时 候 会 提示 使 用 LANS710/LAN8720 的 网 络 蕊 片 ，eth0 连接 成 功 ， 并 且 是 100Mpbs 
全 双 工 ，eth0 链接 准备 就 绪 。 这 个 时 候 输入 “ifeconfig” 命 令 就 会 看 到 eth0 这 个 网 卡 , 如 图 39.4.6 
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所 示 : 

/ # ifconfig 

ethO Link encap:Ethernet Hwaddr 46:F9:14:3B:59:62 


inet6 addr: fe80::44f9:14ff:fe3b:5962/64 Scope:Link 
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 

RX packets:588 errors:O dropped:24 overruns:O frame:0 
TX packets:8 errors:0 dropped:0 overruns:O carrier:O 
collisions:O0 txqueuelen:1000 

RX bytes:44330 (43.2 KiB) TX bytes:680 (680.0 B) 


/ # 


图 39.4.6 当前 工作 的 网 卡 

接 下 来 就 是 个 eth0 设置 IP 地 址 ， 如 果 你 的 开发 板 连 接 的 路 由 器 ， 那 么 可 以 通过 路 由 器 自 
动 分 配 IP 地 址 ， 命 令 如 下 : 

udhepc -ieth0 /通过 路 由 器 分 配 IP 地 址 

如 果 你 的 开发 板 连 接着 电脑 ， 那 么 就 可 以 手动 设置 P 地 址 ， 比 如 设置 为 192.168.1.251, 命 
令 如 下 : 

ifconfig eth0 192.168.1.251 netmask 255.255.255.0 /设置 下 地 址 和 子 网 掩 码 

route add default gw 192.168.1.1 // 添 加 默认 网 关 

推荐 大 家 将 开发 板 连接 到 路 由 器 上 ， 设 置 好 IP 地 址 以 后 就 可 以 测试 网 络 了 ， 比 如 ping 一 
下 电脑 他 地址， 或 者 ping 一 下 百度 官网 。 

每 次 开机 以 后 都 要 自己 手动 打开 网 卡 , 然后 手动 设置 P 地 址 也 太 麻 烦 了 ， 有 没有 开机 以 后 
自动 启动 网 卡 并 且 设 置 IP 地 址 的 方法 呢 ?” 表 定 有 的 ， 我 们 将 打开 网 卡 ， 设 置 网 卡 IP 地 址 的 命 
令 添 加 到 /etc/init.d/rcS 文件 中 就 行 了 ， 完 成 以 后 的 rcS 文件 内 容 如 下 所 示 : 

// 示 例 代 码 39.4.2.1 网 络 开 机 自 启动 






























































PU /om 


PATH-/sbin:/bin:/usr/sbin:/usr/bin 
LD LIBRARY PATH-S$LD LIBRARY PATH:/lib:/usr/lib 
export PATH LD LIBRARY PATH runlevel 





# 网 络 开 机 自 启动 设置 
ifconfig eth0 up 

fudhcpe -i ethO 

TOR reont ig ethno LOL Lees 2L TokexEMWeVSs 121915) 6 219) 5 5 215) 0 
11 route add default gw 192.168.1.1 





IKoy eey SY (ey dms. Mesh qe9us p 


12 4cd /drivers 
13 £$./hello & 
14 #cd / 
第 8 行 ， 打 开 eth0 网 卡 
第 9 行 ， 通 过 路 由 器 自动 获取 IP 地 址 。 
第 10 行 ， 手 动 设置 eth0 的 IP 地 址 和 子 网 掩 码 。 
第 11 行 ， 添 加 默认 网 关 。 
修改 好 rcS 文件 以 后 保存 并 退出 ， 重 启 开发 板 ， 这 个 时 候 eth0 网 卡 就 会 在 开机 的 时 候 自动 
启动 了 ， 我 们 也 就 不 用 手动 添加 相关 设置 了 。 
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39.5 改造 我 们 自己 的 烧 写 工具 


39.5.1 改造 MfgTool 


在 上 一 小 节 中 我 们 已 经 实现 了 将 自己 的 系统 烧 写 到 开发 板 中 ， 但 是 使 用 的 是 “ 借 鸡 生 蛋 ” 
的 方法 。 我 们 通过 将 NXP 官方 的 系统 更 换 成 我 们 自己 制作 的 系统 来 完成 系统 烧 写 ， 本 节 我 们 就 
来 学 习 一 下 如 何 将 MfgTool 这 个 工具 改造 成 我 们 自己 的 工具 ， 让 其 支持 我 们 自己 的 开发 板 。 要 
改造 MfgTool， 重 点 是 三 方面 : 
QD、 针 对 不 同 的 核心 版 ， 确 定 系 统 文件 相关 名 字 。 
包 、 新 建 我 们 自己 的 .vbs 文件 
(@)、 修 改 ucl2.xml 文件 。 
1、 确 定 系统 文件 名 字 
确定 系统 文件 名 字 完 全 是 为 了 兼容 不 同 的 产品 ， 比 如 某 个 产品 有 NAND A EMMC 两 个 版 
本 ， 那 么 EMMC 和 NAND 这 两 个 版 本 的 uboot. zlmage. .dtb 和 rootfs 有 可 能 不 同 。 为 了 在 


MfgTool 工具 中 同时 支持 EMMC 和 NAND 这 两 个 版 本 的 核心 板 ，EMMC 版 本 的 系统 文件 命名 
如 图 39.5.1.1 所 示 : 



























































o 









































1 有 = 原始 文件 < X 
主页 A5 SE e 
€ v ^ 里 》 烧 写 文件 > 原始 文件 vO 搜索 "原始 文件 "” p 
^ BR 修改 日 期 类 型 大 小 
v st 快 速 访问 
m 桌面 + | ] imx6ull-alientek-emmc.dtb 2019/6/16 15:47 DTB 文件 36 KB 
LFR : B rootfs-alientek-emmc.tar.bz2 2019/6/16 15:42 360 压 缩 38,798 KB 
: u-boot-alientek-emmc.imx 2019/6/16 15:44 IMX 文件 419 KB 
53 文档 ai |. ] zimage-alientek-emmc 2019/6/16 15:47 文件 5,453 KB 
&- 图 片 + 
| firmware v < 


> 
4 个 项 目 - 
图 39.5.1.1 系统 文件 名 





2、 新 建 .vbs 文件 


直接 复制 mfgtool2-yocto-mx-evk-emmc.vbs 文件 即 可 ， 将 新 复制 的 文件 重 命名 为 mfgtool2- 
alientek-alpha-emmc.vbs， 文 件 内 容 不 要 做 任何 修改 ，.vbs 文件 我 们 就 新 建 好 了 。 

3、 修 改 ucl2.xml 文件 
在 修改 ucD.xml 文件 之 前 ， 先 保存 一 份 原始 的 ucl2.xml。 将 ucl2.xml 文件 改 为 如 下 所 示 内 



































DM 


谷 : 
«1-- 正点 原子 修改 后 的 uc12.xml 文件 --> 


«UCL» 
«CFG» 
XSTATE name-"BootStrap" dev-"MX6UL" vid-"15A2" pid-"007D"/» 
«STATE name-"BootStrap" dev-"MX6ULL" vid-"15A2" pid-"0080"/» 
«STATE name-"Updater" dev="MSC" vid-"066F" pid-"37FF"/-» 
«/CFG» 
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<!-- 向 EMMC 烧 写 系统 --> 
<LIST name-"eMMC" desc-"Choose eMMC as media"> 


«CMD state-"BootStrap" type-"boot" body-"BootStrap" file 


-"firmware/u-boot-alientek-emmc.imx" ifdev-"MX6ULL'"»Loading U- 
boot«/CMD-» 
<CMD state-"BootStrap" type-"load" file-"firmware/zImage-alientek- 
emmc" address-"0x80800000" 
loadSection-"OTH" setSection-"OTH" HasFlashHeader-"FALSE" 
ifdev-"MX6SL MX6SX MX7D MX6UL MX6ULL'»Loading Kernel.«/CMD» 
<CMD state-"BootStrap" type-"load" file-"firmware/$initramfs$" 
address-"0x83800000" 
loadSection-"OTH" setSection-"OTH" HasFlashHeader-"FALSE" 
ifdev-"MX6SL MX6SX MX7D MX6UL MX6ULL'"»Loading Initramfs.«/CMD» 
<CMD state-"BootStrap" type-"load" file-"firmware/imx6ull-alientek- 
emmc.dtb" address-"0x83000000" 
loadSection-"OTH" setSection-"OTH" HasFlashHeader-"FALSE" 
ifdev-"MX6ULL"»Loading device tree.«/CMD» 
«CMD state-"BootStrap" type-"jump" > Jumping to OS image. «/CMD-» 


<== (suene jxeutiEdES p ==> 

<CMD state-"Updater" type-"push" body-"send" 
file-"mksdcard.sh.tar"»Sending partition shell«/CMD-» 

<CMD state-"Updater" type-"push" body-"$ tar xf $FILE "> 
Partitioning...«/CMD» 

«CMD state-"Updater" type-"push" body-"$ sh mksdcard.sh 
/dev/mmcblk$mmc$"» Partitioning...«/CMD» 


<I legem. doce ==> 

<CMD state="Updater" type="push" body="$ dd if=/dev/zero 
of-/dev/mmcblk$mmc$ bs=1k seek=768 conv-fsync count=8">clear u-boot 
arg</CMD> 

<l== metes OBE eur) ==> 

<CMD state="Updater" type="push" body="$ echo 0 > 
/sys/block/mmcblk$mmc$boot0/force ro">access boot partition 1</CMD> 

<CMD state-"Updater" type-"push" body-"send" file-"files/u-boot- 
alientek-emmc.imx" ifdev-"MX6ULL"»Sending u-boot.bin«/CMD» 

<CMD state-"Updater" type-"push" body-"$ dd if-$FILE 
of-/dev/mmcblk$mmc$boot0 bs-512 seek-2"»write U-Boot to sd card«/CMD» 

<CMD state-"Updater" type-"push" body-"$ echo 1 > 











/sys/block/mmcblk$mmc$boot0/force ro"> re-enable read-only access 
«/CMD» 

<CMD state-"Updater" type-"push" body-"$ mmc bootpart enable 1 1 
/dev/mmcblk$mmc$"»enable boot partion 1 to boot«/CMD» 
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«!-- create fat partition ==> 
<CMD state-"Updater" type-"push" body-"$ while [ ! -e 


/dev/mmcblk$mmc$pl ]; do sleep 1; echo WV'waiting...N"; done ">Waiting 
for the partition ready</CMD> 

<CMD state-"Updater" type-"push" body-"$ mkfs.vfat 
/dev/mmcblk$mmc$pl"»Formatting rootfs partition«/CMD» 

<CMD state-"Updater" type-"push" body-"$ mkdir -p 
/mnt/mmcblk$mmc$p1"/- 

<CMD state-"Updater" type-"push" body-"$ mount -t vfat 
/dev/mmcblk$mmc$pl /mnt/mmcblk£mmc$p1"/-» 


< lopuom na —— 

<CMD state-"Updater" type-"push" body-"send" file-"files/zImage- 
alientek-emmc"»Sending kernel zImage-c/CMD» 

<CMD state-"Updater" type-"push" body-"$ cp $FILE 
/mnt/mmcblk$mmc$pl/zlImage"»write kernel image to sd card«/CMD» 


«I—- onin hue ==> 

<CMD state-"Updater" type-"push" body-"send" file-"files/imx6ull- 
alientek-emmc.dtb" ifdev-"MX6ULL"»Sending Device Tree file«/CMD» 

<CMD state-"Updater" type-"push" body-"$ cp $FILE 
/mnt/mmcblk$mmc$pl/imx6ull-alientek-emmc.dtb" ifdev-"MX6ULL"»write 
device tree to sd card«/CMD» 

<CMD state-"Updater" type-"push" body-"$ umount 
/mnt/mmcblk$£mmc$pl"»Unmounting vfat partitionc/CMD» 


«l— loque ee Ee ==> 

<CMD state-"Updater" type-"push" body-"$ mkfs.ext3 -F -E nodiscard 
/dev/mmcblk$mmc$p2"»Formatting rootfs partitionc/CMD» 

<CMD state-"Updater" type-"push" body-"$ mkdir -p 
/mnt/mmcblk£mmc$p2"/-» 

<CMD state-"Updater" type-"push" body-"$ mount -七 ext3 
/dev/mmcblk$mmc$p2 /mnt/mmcblk$mmc$p2"/-» 

«CMD state-"Updater" type-"push" body-"pipe tar -jxv -C 














/mnt/mmcblk$mmc$p2" file-"files/rootfs-alientek-emmc.tar.bz2" 
ifdev-"MX6UL MX7D MX6ULL'»Sending and writting rootfs«/CMD» 

<CMD state-"Updater" type-"push" body-"frf"»Finishing rootfs 
writec«/CMD» 

<CMD state-"Updater" type-"push" body-"$ umount 
/mnt/mmcblk$mmc$p2"»Unmounting rootfs partition</CMD> 

<CMD state-"Updater" type-"push" body-"$ echo Update 
Complete! "»Done«/CMD» 
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< LEST 
«/UCL» 
ucD.xml 文件 我 们 仅仅 保留 了 给 EMMC 烧 写 系统 ， 如 果 要 支持 NAND 的 话 可 以 自行 参考 
原版 的 ucl2.xml 文件 ， 添 加 相关 的 内 容 。 


39.5.2 烧 写 测试 


MfgTool 工具 修改 好 以 后 就 可 以 进行 烧 写 测试 了 ， 将 imx6ull-alientek-emmec.dtb u-boot- 
alientek-emmc.imx 和  zlmage-alientek-emmc 这 三 个 文件 复制 到 mfgtools-with- 
rootfs/mfgtools/Profiles/Linux/OS Firmware/firmware 目录 中 。 将 imx6ull- -emmc.dtb , u-boot- 
alientek-emmc.imx , zImage-alientek-emmc 和 rootfs-alientek-emmc.tar.bz2 这 四 个 文件 复制 到 
mfgtools-with-rootfs/mfgtools/Profiles/Linux/OS Firmware/files 目录 中 。 

点 击 “mfgtool2-alientek-alpha-emmc.vbs” 打 开 MfgTool 烧 写 系统 ， 等 待 烧 写 完成 ， 然 后 设 
置 拨 码 开关 为 EMMC 启动 ， 重 启 开发 板 ， 系 统 启动 信息 如 图 39.5.2.1 所 示 : 


Normal Boot 

Hit any key to stop autoboot: 0 

switch to partitions £0, OK 

mmcl(part 0) is current device 

switch to partitions £0, OK 

mmcl(part 0) is current device 

reading boot.scr 

** Unable to read file boot.scr ** 

reading zlImage 

5583352 bytes read in 138 ms (38.6 MiB/s) 
Booting from mmc .. 

reading imx6ull- 14xl4-evk.dtb 

** Unable to read file imx6ull-1l4xl4-evk.dtb ** 
Kernel image & 0x80800000 [ 0x000000 - 0x5531f8 ] 




















Starting kernel ... 
[| 
图 39.5.2.1 系统 启动 log 信息 
从 图 39.5.2.1 可 以 看 出 ， 出 现 “Starting kernel ...” 以 后 就 再 也 没有 任何 信息 输出 了 ， 说 明 
Linux 内 核 启 动 失败 了 。 接 下 来 就 是 解决 为 何 Linux 内 核 启动 失败 这 个 问题 。 


























39.5.3 解决 Linux 内 核 启动 失败 


上 一 小 节 我 们 启动 系统 以 后 发 现 输出 “Starting kernel ...” 以 后 就 再 也 没有 任何 信息 了 ， 难 
道 是 系统 烧 写 错 误 了 ? 可 以 确定 的 是 uboot 启动 正常 ， 就 是 在 启动 Linux 的 时 候 出 问题 了 ， 仔 
观察 uboot 输出 的 log 信息 ， 会 发 现 如 图 39.5.3.1 所 示 两 行 信息 : 


reading imx6u11-14x14-evk.dtb 
** Unable to read file imx6ull-14xl4-evk.dtb ** 


图 39.5.3.1 读 取 设备 树 出 错 
从 图 39.5.3.1 可 以 看 出 ， 在 读 取 “imx6ull-14x14-evk.dtb” 这 个 设备 树 文件 的 时 候 出 错 了 。 
重启 uboot， 进 入 到 命令 行 模式 ， 输 入 如 下 命令 查看 EMMC 的 分 区 1 里 面 有 没有 设备 树 文件 : 
mmc dev 1 /切换 到 EMMC 























MR 















































ls mmc 1:1 /输出 EMMCI 分 区 1 中 的 所 有 文件 
结果 如 图 39.5.3.2 所 示 : 
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-»]s mmc 1:1 
5583352 zimage 
36185 imx6ull-alientek-emmc.dtb 


2 file(s), 0 dir(s) 
=> 
图 39.5.3.2 EMMC 分 区 1 文件 

从 图 39.5.3.2 可 以 看 出 ， 此 时 EMMC 的 分 区 1 中 是 存在 设备 树 文件 的 ， 只 是 文件 名 字 为 : 
imx6ull-alientek-emmc.dtb， 因 此 读 取 imx6ull-14x14-evk.dtb 肯定 会 出 错 的 ， 因 为 根本 就 不 存在 
这 个 文件 。 之 所 以 出 现 这 个 错误 的 原因 是 因为 uboot 里 面 默 认 的 设备 树 名 字 就 是 imx6ull-14x14- 
evk.dtb， 这 个 我 们 在 讲解 uboot 的 时 候 就 已 经 说 过 了 。 解 决 方法 很 简单 ， 有 两 种 方法 : 

1、 重 新 设置 bootcmd 环境 变量 值 

进入 uboot 的 命令 行 ， 重 新 设置 bootcmd 和 bootargs 这 两 个 环境 变量 的 值 ， 这 里 要 注意 的 
是 bootargs 的 值 也 要 重新 设置 一 下 ， 命 令 如 下 : 

setenv bootcmd 'mmc dev 1;fatload mmc 1:1 80800000 zImage;fatload mmc 1:1 83000000 
imx6ull-alientek-emmc.dtb;bootz 80800000 - 83000000' 

setenv bootargs 'console-ttymxc0,115200 root-/dev/mmcblk1p2 rootwait rw' 





























saveenv 
设置 好 bootemd 和 bootargs 这 两 个 环境 变量 以 后 重启 开发 板 ，Linux 系统 就 可 以 正常 启动 。 

25 修改 uboot 源码 

第 1 种 方法 每 次 重新 烧 写 系统 以 后 都 要 先 手 动 设置 一 下 bootemd 的 值 ， 这 样 有 点 麻烦 ， 有 
没有 一 劳 永 逸 的 方法 呢 ? 肯 定 是 有 的 ， 就 是 直接 修改 uboot 源码 。 打 开 uboot 源码 中 的 文件 
include/configs/mx6ull alientek_emmc.h, 在 宏 CONFIG EXTRA ENV SETTINGS 中 找到 如 下 所 
WAX: 


























示例 代码 39.5.31 查找 设备 树 文件 
194 "findfdt-"N 


























195 "if test $fdt file = undefined; then " \ 

196 "if test $board name = EVK && test $board rev = 9X9; then " N 
d "setenv fdt file imx6ull-9x9-evk.dtb; fi; " N 

198 "if test $board name = EVK && test $board rev = 14X14; then " \ 
199 "setenv fdt file imx6ull-14x14-evk.dtb; fi; " N 

200 "if test $fdt file = undefined; then " \ 

20! "echo WARNING: Could not determine dtb to use; fi; " N 

202 AED NOME NN 





findfdt 就 是 用 于 确定 设备 树 文件 名 字 的 环境 变量 ，fdt_ file 环境 变量 保存 着 设备 树 文件 名 。 
第 196 行 和 197 行 用 于 判断 设备 树 文件 名 字 是 否 为 imx6ull-9x9-evk.dtb， 第 198 行 和 199 行 用 
于 判断 设备 树 文 件 名 字 是 否 为 imx6ull-14x14-evk.dtb。 这 两 个 设备 树 都 是 NXP 官方 开发 板 使 用 
的 ，LMX6U-ALPHA 开发 板 用 不 到 ， 因 此 直接 将 示例 代码 39.5.3.1 中 findfdt 的 值 改 为 如 下 内 


ZA 


合 : 




















示例 代码 39.5.3.1 查找 设备 树 文件 
194 "findfdt-"N 
T95 "if test $fdt file = undefined; then " N 
196 "setenv fdt file imx6ull-alientek-emmc.dtb; "AN 
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第 196 行 ， 如 果 fdt file 未 定义 的 话 ， 直 接 设置 fdt file= imx6ull-alientek-emmc.dtb, ffi% Ef 
接 , 不 需要 任何 的 判断 语句 。 修 改 后 以 后 重新 编译 uboot, 然后 用 将 新 的 uboot 烧 写 到 开发 板 中 ， 
烧 写 完成 以 后 重启 测试 ，Linux 内 核 启 动 正 常 。 

关于 系统 烧 写 就 讲解 到 这 里 ， 本 章 我 们 使 用 NXP 提供 的 MfgTool 工具 通过 USB OTG 口 向 
开发 板 的 EMMC 中 烧 写 uboot、Linux kernel、.dtb( 设 备 树 ) 和 rootfs 这 四 个 文件 。 在 本 章 我 们 主 
要 做 了 五 个 工作 : 

Q@、 理 解 MfgTool 工具 的 工作 原理 。 

©., fH] MfgTool 工具 将 NXP 官方 系统 烧 写 到 IMX6U-ALPHA 开发 板 中 ， 主 要 是 为 了 体 
验 一 下 MfgTool 软件 的 工作 流程 以 及 烧 写 方法 。 

©, fF MfgTool 工具 将 我 们 自己 编译 出 来 的 系统 烧 写 到 IMX6U-ALPHA 开发 板 中 。 

(、 修 改 MfgTool 工具 ， 使 其 支持 我 们 所 使 用 的 硬件 平台 。 

@@、 修 改 相 应 的 错误 。 

关于 系统 虐 写 的 方法 就 讲解 到 这 里 ， 本 章 内 容 不 仅仅 是 为 了 讲解 如 何 向 LIMX6ULL 芯片 中 
烧 写 系统 ， 更 重要 的 是 向 大 家 详细 的 讲解 了 MfgTool 的 工作 原理 。 如 果 大 家 在 后 续 的 工作 或 学 
2] P EF] LMXT 或 者 LMX8 等 芯片 ， 本 章 同样 适用 。 
随 着 本 章 的 结束 ， 也 宣告 着 本 书 第 三 篇 的 内 容 也 正式 结束 了 ， 第 三 篇 是 系统 移植 篇 ， 重 点 
就 是 uboot、Linux kernel 和 rootfs 的 移植 ， 看 似 简 简单 单 的 “移植 ”两 个 字 ， 引 出 的 却 是 一 篇 
300 多 页 的 “ 爱 恨 情 仇 ” 授 人 以 鱼 不 如 授 人 以 渔 ， 本 可 以 简 简单 单 的 教 大 家 修改 哪些 文件 、 添 
加 哪些 内 容 ， 怎 么 去 编译 ， 然 后 得 到 哪些 文件 。 但 是 这 样 只 能 看 到 表象 ， 并 不 能 深入 的 了 解 其 
原理 ， 为 了 让 大 家 能 够 详细 的 了 解 整个 流程 ， 笔 者 义无反顾 的 选择 了 这 条 最 难 走 的 路 ， 不 管 是 
uboot 还 是 Linux kernel, J Makefile 到 启动 流程 ， 都 尽 自己 最 大 的 努力 去 阐述 清楚 。 奈 何 ， 笔 
者 水 平 有 限 ， 还 是 有 很 多 的 细节 没有 处 理 好 ， 大 家 有 疑问 的 地 方 可 以 到 正点 原子 论坛 
www.openedv.com 上 发 帖 留言 ， 大 家 一 起 讨论 学 习 。 
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第 四 篇 ARM Linux 驱动 开发 篇 


前 面 3 篇 ， 我 们 学 习 Ubuntu 操作 系统 、 学 习 ARM 裸 机 、 学 习 系统 移植 ， 其 目的 就 是 为 了 











本 篇 做 准备 。 本 篇 应 该 是 大 家 最 期 待 的 内 容 了 ， 毕 竞 大 部 分 学 习 者 的 最 初 目的 就 是 学 习 Linux 
驱动 开发 。 本 篇 我 们 将 会 详细 讲解 Linux 中 的 三 大 类 驱动 : 字符 设备 驱动 、 块 设备 驱动 和 网 络 
设备 驱动 。 其 中 字符 设备 驱动 是 占用 篇 幅 最 大 的 一 类 驱动 ， 因 为 字符 设备 最 多 ， 从 最 简单 的 点 
灯 到 I2C、SPI、 音 频 等 都 属于 字符 设备 驱动 的 类 型 。 块 设备 和 网 络 设备 驱动 要 比 字 符 设备 驱动 
复杂 ， 就 是 因为 其 复杂 所 以 半导体 厂商 一 般 都 给 我 们 编写 好 了 ， 大 多 数 情况 下 都 是 直接 可 以 使 
用 的 。 所 谓 的 块 设备 驱动 就 是 存储 器 设备 的 驱动 ， 比 如 EMMC, NAND, SD 卡 和 TU 盘 等 存储 
设备 ， 因 为 这 些 存储 设备 的 特点 是 以 存储 块 为 基础 ， 因 此 叫做 块 设备 。 网 络 设 备 驱 动 就 更 好 理 
解 了 ， 就 是 网 络 驱动 ， 不 管 是 有 线 的 还 是 无 线 的 ， 都 属于 网 络 设备 驱动 的 范畴 。 一 个 设备 可 以 
属于 多 种 设备 驱动 类 型 ， 比 如 USB WIFI， 其 使 用 USB 接口 ， 所 以 属于 字符 设备 ， 但 是 其 又 能 
上 网 ， 所 以 也 属于 网 络 设备 驱动 。 本 篇 我 们 就 围绕 着 三 大 设备 驱动 类 型 展开 ， 尽 可 能 详细 的 讲 
解 每 种 设备 驱动 的 开发 方式 。 

本 书 使 用 的 Linux 内 核 版 本 为 4.1.15， 其 支持 设备 树 (Device tree)， 所 以 本 篇 所 有 例 程 均 采 
用 设备 树 。 设 备 树 将 是 本 篇 的 重点 ! 从 设备 树 的 基本 原理 到 设备 树 驱 动 的 开发 方式 ， 从 最 简单 
的 点 灯 到 复杂 的 网 络 驱 动 开 发 ， 本 篇 均 有 详细 的 讲解 ， 是 学 习 设 备 树 的 不 二 之 选 。 

最 后 ， 祝 大 家 学 习 愉快 ! 
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第 四 十 章 字符 设备 驱动 开发 


本 章 我 们 从 Linux. 驱动 开发 中 最 基础 的 字符 设备 驱动 开始 ， 重 点 学 习 Linux 下 字符 设备 驱 
动 开 发 框架 。 本 章 会 以 一 个 虚拟 的 设备 为 例 ， 讲 解 如 何 进行 字符 设备 驱动 开发 ， 以 及 如 何 编写 
测试 APP 来 测试 驱动 工作 是 否 正常 ， 为 以 后 的 学 习 打下 坚实 的 基础 。 
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40.1 字符 设备 驱动 简介 








字符 设备 是 Linux 驱动 中 最 基本 的 一 类 设备 驱动 ， 字 符 设备 就 是 一 个 一 个 字 节 ， 按 照 字 节 
流 进 行 读 写 操作 的 设备 ， 读 写 数据 是 分 先后 顺序 的 。 比 如 我 们 最 常见 的 点 灯 、 按 键 、IIC、SPL， 
LCD 等 等 都 是 字符 设备 ， 这 些 设备 的 驱动 就 叫做 字符 设备 驱动 。 
在 详细 的 学 习 字 符 设 备 驱动 架构 之 前 ， 我 们 先 来 简单 的 了 解 一 下 Linux 下 的 应 用 程序 是 如 
何 调用 驱动 程序 的 ，Linux 应 用 程序 对 驱动 程序 的 调用 如 图 40.1.1 所 示 : 



































| 应 用 程序 
库 





40.1.1 Linux 应 用 程序 对 驱动 程序 的 调用 流程 
在 Linux 中 一 切 丝 为 文件 ， 驱 动 加 载 成 功 以 后 会 在 “/dev” 目 录 下 生成 一 个 相应 的 文件 ， 应 
用 程序 通过 对 这 个 名 为 “/dev/xxx”(xxx 是 具体 的 驱动 文件 名 字 ) 的 文件 进行 相应 的 操作 即 可 实 
现 对 硬件 的 操作 。 比 如 现在 有 个 叫做 /dev/led 的 驱动 文件 ， 此 文件 是 led 灯 的 驱动 文件 。 应 用 程 
序 使 用 open 函数 来 打开 文件 /dewled, 使 用 完成 以 后 使 用 close 函数 关闭 /dewled 这 个 文件 。 open 
和 close 就 是 打开 和 关闭 led 驱动 的 函数 ， 如 果 要 点 亮 或 关闭 led， 那 么 就 使 用 write 函数 来 操 
作 ， 也 就 是 向 此 驱动 号 入 数据 ， 这 个 数据 就 是 要 关闭 还 是 要 打开 led 的 控制 参数 。 如 果 要 获取 
led 灯 的 状态 ， 就 用 read 函数 从 驱动 中 读 取 相应 的 状态 。 

应 用 程序 运行 在 用 户 空 间 ， 而 Linux 驱动 属于 内 核 的 一 部 分 ， 因 此 驱动 运行 于 内 核 空间 。 

当 我 们 在 用 户 空间 想 要 实现 对 内 核 的 操作 ， 比 如 使 用 open 函数 打开 /dev/led 这 个 驱动 ， 因 为 用 
户 空间 不 能 直接 对 内 核 进 行 操作 ， 因 此 必须 使 用 一 个 叫做 “系统 调用 ”的 方法 来 实现 从 用 户 空 
间 陷入 到 内 核 空间 ， 这 样 才能 实现 对 底层 驱动 的 操作 。open、close、write 和 read 等 这 些 函 数 是 
有 C 库 提供 的 ， 在 Linux 系统 中 ， 系 统 调用 作为 C 库 的 一 部 分 。 当 我 们 调用 open 函数 的 时 候 
流程 如 图 40.1.2 所 示 : 
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应 用 程序 | CH | WE | 具体 驱动 

图 40.1.2 open 函数 调用 流程 
其 中 关于 OC 库 以 及 如 何 通 过 系统 调用 陷入 到 内 核 空 间 这 个 我 们 不 用 去 管 ， 我 们 重点 关注 的 
是 应 用 程序 和 具体 的 驱动 ， 应 用 程序 使 用 到 的 函数 在 具体 驱动 程序 中 都 有 与 之 对 应 的 函数 ， 比 
如 应 用 程序 中 调用 了 open 这 个 函数 ， 那 么 在 驱动 程序 中 也 得 有 一 个 名 为 open 的 函数 。 每 一 个 
系统 调用 ， 在 驱动 中 都 有 与 之 对 应 的 一 个 驱动 函数 ， 在 Linux 内 核 文件 include/linux/fs.h. 中 有 
个 叫做 file operations 的 结构 体 ， 此 结构 体 就 是 Linux 内 核 驱 动 操 作 函 数 集 合 ， 内 容 如 下 所 示 : 

示例 代码 40.1.1 file operations 结构 体 


ein 











































































































ESO struct module *owner; 
1590 lott de (wlSeek) (struct ile w, lofi t, ion) p 





1591 seize ic (eso) (struct tile w, Ghar deer w, Size tp lex 起 
*); 

15.97 Sshzc © (write) (struct file w, Const char ^ User w, GULEG E 
lux qw c9» p 

ils seize © (eme iter)  (leuewcie kloch w, Struct ioy iter 9) 

1594 ssize ÈE (write Ler) (struct kioo w, struct ioy iter w) p 

SSS int (vicerat) (struct iile w, struct cir Contest 9). 


1596 uasigiecd ime (aoll) (Struct tile v, Struct poll table struct 


*); 


T597 long (tumlockee ioctl) (otcruct iile w, wuseoncawecl ime, nm 
long); 

1598 lemem( eomeat eer) (Le dele sm uae 
LONGA 

1599 iot (mmap) (Struct tile w, sururci ym area strúuct =) 2 

1600 iat (mrema) (struct ille w, struct ym areca Struct 9) 

1601 ine (topen) (Scr Cie inode t" Ew iade t) 


1602 inane (wilusmwi (srrucr file w, il owner © re)? 

1603 bhae (meeeass) (arree moce ti. IEEE riie f) P 

1604 iat (iewme) (srruect iile w, lori t, loti t, imt cdacaeseyne) s 
1605 int (vaio teme) (struct kioci w, imt catasyne)? 

1606 Tae asya) (oec, Serter sile wp dunk) B 

1607 ane (loek) (struct tile w, inae, StrUCE tile lock =) z 








1608 selze © (vsencpege) (Struct tile w, suxwweE page V, xmi, SS E; 
lott e wy ime)? 

1609 uasignec long (vger unmapped erea) (Struct tile w, umeigpmevl! low 
unsigned long, unsigned long, unsigned long); 

HIST) suene (meneek ilegges) (iat) g 

IGA! int (ilock) (struct iile w, int, SCrUCE tile lock t$ 
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JE selze © (vsplice weite (struct pue inode inio v, struct iile v, 


loft č v, size t, wüsicuel imt) p 
IESS seize © (wsplice zeedD (struct Tile w, lotri t ; Struct 


Bec noc mee 





1614 ine ((eerleasey (struct iile w, long, struct tile lock ww wool 
**); 
下 6 下 5 lewwg  (CsiadLlecene) (suec iile viile, int moce, lot t otteet, 


1616 lei t len)? 
IE void (Snev folinio) (struct seg iile wm, struct Tile wi)? 
1618 $ifndef CONFIG MMU 
EIS Cnenonedii( mm ea eis (Se 
1620 #endif 
KEZTEN; 

简单 介绍 一 下 file operation 结构 体 中 比较 重要 的 、 常 用 的 函数 : 

第 1589 ÍF, owner 拥有 该 结构 体 的 模块 的 指针 ， 一 般 设 置 为 THIS_ MODULE。 

第 1590 行 ，llseek 函数 用 于 修改 文件 当前 的 读 写 位 置 。 

第 1591 ÍF, read 函数 用 于 读 取 设备 文件 。 

第 1592 行 ，write 函数 用 于 向 设备 文件 写 入 (发 送 ) 数 据 。 

第 1596 fT, poll 是 个 轮 询 函 数 ， 用 于 碍 询 设 备 是 否 可 以 进行 非 阻 塞 的 读 写 。 

第 1597 fT, unlocked ioctl 函数 提供 对 于 设备 的 控制 功能 , 与 应 用 程序 中 的 ioctl 函数 对 应 。 

第 1598 ÍT, compat ioctl 函数 与 unlocked ioctl 函数 功能 一 样 ， 区 别 在 于 在 64 位 系统 上 ， 
32 位 的 应 用 程序 调用 将 会 使 用 此 函数 。 在 32 位 的 系统 上 运行 32 位 的 应 用 程序 调用 的 是 
unlocked ioctl。 

第 1599 ÍF, mmap 函数 用 于 将 将 设备 的 内 存 映射 到 进程 空间 中 (也 就 是 用 户 空间 )， 一 般 帧 
缓冲 设备 会 使 用 此 函数 ， 比 如 LCD 驱动 的 显存 , 将 帧 缓冲 (LCD 显存 ) 映 射 到 用 户 空间 中 以 后 应 
用 程序 就 可 以 直接 操作 显存 了 ， 这 样 就 不 用 在 用 户 空间 和 内 核 空间 之 间 来 回复 制 。 

第 1601 fT. open 函数 用 于 打开 设备 文件 。 

第 1603 íF, release 函数 用 于 释放 (关闭 ) 设 备 文件 ， 与 应 用 程序 中 的 close 函数 对 应 。 

第 1604 1T, fasync 函数 用 于 刷新 待 处 理 的 数据 ， 用 于 将 缓冲 区 中 的 数据 刷新 到 磁盘 中 。 

第 1605 行 ，aio_fsync 函数 与 fasync 函数 的 功能 类 似 ， 只 是 aio fsync 是 异步 刷新 待 处 理 的 
数据 。 
在 字符 设备 驱动 开发 中 最 常用 的 就 是 上 面 这 些 函数 ， 关 于 其 他 的 函数 大 家 可 以 查阅 相关 文 
档 。 我 们 在 字符 设备 驱动 开发 中 最 主要 的 工作 就 是 实现 上 面 这 些 函 数 ， 不 一 定 全 部 都 要 实现 ， 
但 是 向 open. release. write. read 等 都 是 需要 实现 的 ， 当 然 了 ， 具 体 需 要 实现 哪些 函数 还 是 要 
看 具体 的 驱动 要 求 。 


40.2 字符 设备 驱动 开发 步 又 


上 一 人 小节 我 们 简单 的 介绍 了 一 下 字符 设备 驱动 ， 那 么 字符 设备 驱动 开发 都 有 哪些 步骤 呢 ? 
我 们 在 学 习 裸 机 或 者 STM32 的 时 候 关 于 驱动 的 开发 就 是 初始 化 相应 的 外 设 寄存 器 ,在 Linux 驱 
动 开发 中 肯定 也 是 要 初始 化 相应 的 外 设 寄存 器 ， 这 个 是 毫 无 疑问 的 。 只 是 在 Linux 驱动 开发 中 
我 们 需要 按照 其 规定 的 框架 来 编写 驱动 ， 所 以 说 学 Linux 驱动 开发 重点 是 学 习 其 驱动 框架 。 
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40.2.1 驱动 模块 的 加 载 和 印 载 


Linux 驱动 有 两 种 运行 方式 ， 第 一 种 就 是 将 驱动 编译 进 Linux 内 核 中 , 这 样 当 Linux 内 核 局 
动 的 时 候 就 会 自动 运行 驱动 程序 。 第 二 种 就 是 将 驱动 编译 成 模块 (Linux 下 模块 扩展 名 为 .ko), 在 
Linux 内 核 启 动 以 后 使 用 “insmod” 命 令 加 载 驱 动 模块 。 在 调试 驱动 的 时 候 一 般 都 选择 将 其 编译 
为 模块 ， 这 样 我 们 修改 驱动 以 后 只 需要 编译 一 下 驱动 代码 即 可 ， 不 需要 编译 整个 Linux 代码 。 
而 且 在 调试 的 时 候 只 需要 加 载 或 者 彼 载 驱动 模块 即 可 ， 不 需要 重启 整个 系统 。 总 之 ， 将 驱动 编 
译 为 模块 最 大 的 好 处 就 是 方便 开发 ， 当 驱动 开发 完成 ， 确 定 没 有 问题 以 后 就 可 以 将 驱动 编译 进 
Linux 内 核 中 ， 当 然 也 可 以 不 编译 进 Linux 内 核 中 ， 具 体 看 自己 的 需求 。 
模块 有 加 载 和 代 载 两 种 操作 ， 我 们 在 编写 驱动 的 时 候 需 要 注册 这 两 种 操作 函数 ， 模 块 的 加 载 和 
ENERE PRAU F : 

module init(xxx init); / 广 册 模块 加 载 函数 

module exit(xxx exit); [FEE EBERT S eR C 

module init 函数 用 来 向 Linux. 内 核 注 册 一 个 模块 加 载 函 数 ， 参 数 xxx_init 就 是 需要 注册 的 
有 具体 函数 ,， 当 使 用 “insmod” 命 令 加 载 驱动 的 时 候 , xxx_init 这 个 函数 驶 会 被 调用 。module_exit0 
函数 用 来 向 Linux 内 核 注 册 一 个 模块 卸载 函数 ， 参 数 xxx_exit 就 是 需要 注册 的 具体 函数 ， 当 使 
用 “rmmod” 命 令 撮 载 具 体 驱 动 的 时 候 xxx exit 函数 就 会 被 调用 。 字 符 设 备 驱动 模块 加 载 和 凶 
载 模板 如 下 所 示 : 













































































































































































示例 代码 40.2.1.1 字符 设备 驱动 模块 加 载 和 印 载 函数 模板 
/* 驱动 入 口 函数 */ 
statie imwe —— imir (eel) 


{ 








/* 入口 函数 具体 内 容 */ 


return 0; 





/* Ban SA */ 
statie voici ^^ eirt Sex (exeabu (wee) 


{ 


ONCE ICE OI ES COMINUS 


=e E 
=. o 


/* 出 口 函 数 具 体内 容 */ 


H He 
C) MN 
~ 








p 
B 


/* 将 上 面 两 个 函数 指定 为 驱动 的 入 口 和 出 口 函数 / 


module init(xxx init); 


= B 
Ov a 


module exit(xxx exit); 
第 2 行 ， 定 义 了 个 名 为 xxx init 的 驱动 入 口 函数 ， 并 且 使 用 了 “__init” 来 修饰 。 
第 9 行 ， 定 义 了 个 名 为 xxx exit 的 驱动 出 口 函数 ， 并 且 使 用 了 “__exit” 来 修饰 。 
第 15 行 ,调用 函数 module init 来 声明 xxx. init 为 驱动 入 口 函数 , 当 加 载 驱动 的 时 候 xxx init 
函数 就 会 被 调用 。 
第 16 行 ,调用 函数 module_exit 来 声明 xxx _exit 为 驱动 出 口 函数 , HERIK IJ] E xxx exit 
函数 就 会 被 调用 。 
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驱动 编译 完成 以 后 扩展 名 为 .ko, 有 两 种 命令 可 以 加 载 驱 动 模块 :insmod 和 modprobe, insmod 











是 最 简单 的 模块 加 载 命 令 ， 此 命令 用 于 加 载 指 定 的 .ko 模块 ， 比 如 记载 drv.ko 这 个 驱动 模块 ， 命 
令 如 下 : 

insmod drv.ko 

insmod 命令 不 能 解决 模块 的 依赖 关系 ， 比 如 drv.ko 依赖 first.ko 这 个 模块 ， 就 必须 先 使 用 
insmod 命令 加 载 first.ko 这 个 模块 ， 然 后 再 加 载 drv.ko 这 个 模块 。 但 是 modprobe 就 会 存在 这 个 
问题 ，modprobe 会 分 析 模 块 的 依赖 关系 ， 然 后 会 所 有 的 依赖 的 模块 都 加 载 到 内 核 中 ， 因 此 
modprobe 命令 相 比 insmod 要 智能 一 些 。modprobe 命令 主要 智能 在 提供 了 模块 的 依赖 性 分 析 、 
错误 检查 、 错 误 报 告 等 功能 ， 推 荐 使 用 modprobe 命令 来 加 载 驱 动 。modprobe 命令 默认 会 去 
/lib/modules/<kernel-version> 目 录 中 查找 模块 , 比如 本 书 使 用 的 Linux kernel 的 版 本 号 为 4.1.15， 
因此 modprobe 命令 默认 会 到 /lib/modules/4.1.15 这 个 目录 中 查找 相应 的 驱动 模块 ， 一 般 自 己 制 
作 的 根 文件 系统 中 是 不 会 有 这 个 目录 的 ， 所 以 需要 自己 手动 创建 。 

驱动 模块 的 卸载 使 用 命令 “rmmod” 即 可 ， 比 如 要 利 载 drv.ko， 使 用 如 下 命令 即 可 : 

rmmod drv.ko 

也 可 以 使 用 “modprobe -rT” 命 令 卸 载 驱动 ， 比 如 要 伸 载 drv.ko， 命 令 如 下 : 

modprobe -r drv.ko 

使 用 modprobe ME n] ERIKS USER, — BU De KRR R D 2T 
有 被 其 他 模块 所 使 用 ,否则 就 不 能 使 用 modprobe 来 卸载 驱动 模块 。 所 以 对 于 模块 的 卸载 ， 还 是 


推荐 使 用 rmmod 命令 。 









































































































































40.2.2 字符 设备 注册 与 注销 


对 于 字符 设备 驱动 而 言 ， 当 驱动 模块 加 载 成 功 以 后 需要 注册 字符 设备 ， 同 样 ， 倒 载 驱动 模 
块 的 时 候 也 需要 注销 掉 字 符 设备 。 字 符 设备 的 注册 和 注销 函数 原型 如 下 所 示 : 


static inline int register chrdev(unsigned int major, const char *name, 











const struct file operations *fops) 

static inline void unregister chrdev(unsigned int major, const char *name) 

register chrdev 函数 用 于 注册 字符 设备 ， 此 函数 一 共有 三 个 参数 ， 这 三 个 参数 的 含义 如 下 : 

major: 主 设备 号 ，Linux 下 每 个 设备 都 有 一 个 设备 号 ,设备 号 分 为 主 设备 号 和 次 设备 号 两 
部 分 ， 关 于 设备 号 后 面 会 详细 讲解 。 

name: 设备 名 字 ， 指 向 一 串 字 符 串 。 

fops: 结构 体 file operations 类 型 指针 ， 指 向 设备 的 操作 函数 集合 变量 。 

unregister chrdev 函数 用 户 注销 字符 设备 ， 此 函数 有 两 个 参数 ， 这 两 个 参数 含义 如 下 ; 

major: 要 注销 的 设备 对 应 的 主 设备 号 。 

name: 要 注销 的 设备 对 应 的 设备 名 。 

一 般 字 符 设 备 的 注册 在 驱动 模块 的 入 口 函数 xxx_init 中 进行 ， 字 符 设备 的 注销 在 驱动 模块 
的 出 口 函数 xxx exit 中 进行 。 在 示例 代码 40.2.1.1 中 字符 设备 的 注册 和 注销 ， 内 容 如 下 所 示 ; 

示例 代码 40.2.2.1 加 入 字符 设备 注册 和 注销 
static struct file operations test fops; 





















































x 
lm 
























































Static ime _— imit xx imit (voeh) 


1 
2 

3 /* 驱动 入 口 函 数 */ 
4 

S1 

6 


/* 入口 函数 具体 内 容 */ 


1019 


LMX6U WAR Linux 驱动 开发 指南 ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
7 int retvalue = 0; 

8 

9 /* 注册 字符 设备 驱动 */ 

10 retvalue = register chrdev(200, "chrtest", &test fops); 
lit if(retvalue < 0){ 

12 /* 字符 设备 注册 失败 ,自行 处 理 */ 

LS } 

14 return 0; 

i5 

16 


17 /* 驱动 出 口 函数 */ 


lb etatie voici (el) 


JL «i 

20 /* 注销 字符 设备 驱动 */ 

2:1] unregister chrdev(200, "chrtest"); 
222) 

23 








24 /* 将 上 面 两 个 函数 指定 为 驱动 的 入 口 和 出 口 函 数 / 


25 module snm (sexes imit) f 








26 module exit(xxx exit); 
第 1 行 ， 定 义 了 一 个 file operations 结构 体 变量 test fops, test fops 就 是 设备 的 操作 函数 集 
合 ， 只 是 此 时 我 们 还 不 没有 初始 化 test fops 中 的 open. release 等 这 些 成 员 变 量 ， 所 以 这 个 操作 函 
数 集合 还 是 空 

第 10 fT, 调用 函数 register chrdev 注册 字符 设备 , 主 设备 号 为 200, 设备 名 字 为 “chrtest”， 
设备 操作 函数 集合 就 是 第 1 行 定 义 的 test_fops。 要 注意 的 一 点 就 是 ， 选 择 没有 被 使 用 的 主 设备 
号 ， 输 入 命令 “cat /proc/devices” 可 以 查看 当前 已 经 被 使 用 掉 的 设备 号 ， 如 图 40.2.2.1 所 示 ( 限 
于 篇 幅 原 因 ， 只 展示 一 部 分 ): 









































/ # cat /proc/devices 
Character devices: 
l mem 
4 /dev/vc/O 
4 tty 
5 /dev/tty 
5 /dev/console 
5 /dev/ptmx 
7 vcs 
10 misc 
13 input 
29 fb 
81 video4linux 


图 40.2.2.1 查看 当前 设备 
在 图 40.2.2.1 中 可 以 列 出 当 前 系统 中 所 有 的 字符 设备 和 块 设备 ， 其 中 第 1 dici NA 
的 主 设备 号 。200 这 个 主 设备 号 在 我 的 开发 板 中 并 没有 被 使 用 ， 所 以 我 这 里 就 用 了 200 这 个 主 
设备 号 。 

第 21 行 ， 调 用 函数 unregister chrdev 注销 主 设备 号 为 200 的 这 个 设备 。 
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40.2.3 实现 设备 的 具体 操作 函数 








file operations 结构 体 就 是 设备 的 具体 操作 函数 ， 在 示例 代码 40.2.2.1 中 我 们 定义 了 
file operations 结构 体 类 型 的 变量 test fops, 但 是 还 没 对 其 进行 初始 化 ,也 就 是 初始 化 其 中 的 open、 
release, read 和 write 等 具体 的 设备 操作 函数 。 本 节 小 节 我 们 就 完成 变量 test_fops 的 初始 化 ， 设 
置 好 针对 chrtest 设备 的 操作 函数 。 在 初始 化 test fops 之 前 我 们 要 分 析 一 下 需求 ， 也 就 是 要 对 
chrtest 这 个 设备 进行 哪些 操作 ， 只 有 确定 了 需求 以 后 才 知 道 我 们 应 该 实现 哪些 操作 函数 。 假 设 
对 chrtest 这 个 设备 有 如 下 两 个 要 求 : 


1、 能 够 对 chrtest 进行 打开 和 关闭 操作 


设备 打开 和 关系 是 最 基本 的 要 求 ， 几 乎 所 有 的 设备 都 得 提供 打开 和 关闭 的 功能 。 因 此 我 们 
需要 实现 file operations 中 的 open 和 release 这 两 个 函数 。 

2、 对 chrtest 进行 读 写 操作 

假设 chrtest 这 个 设备 控制 着 一 段 缓冲 区 (内 存 )， 应 用 程序 需要 通过 read 和 write 这 两 个 区 
数 对 chrtest 的 缓冲 区 进行 读 写 操作 。 所 以 需要 实现 file operations 中 的 read 和 write 这 两 个 函 
数 。 

需求 很 清晰 了 ， 修 改 示例 代码 40.2.2.1， 在 其 中 加 入 test_fops 这 个 结构 体 变量 的 初始 化 操 
作 ， 完 成 以 后 的 内 容 如 下 所 示 : 

示例 代码 40.2.3.1 加 入 设备 操作 函数 


























































































































/* 37F E */ 
static int chrtest open(struct inode *inode, struct file *filp) 
( 

/* 用 户 实现 具体 功能 * 


return 0; 


/* 从 设备 读 取 */ 
static ssize t chrtest read(struct file *filp, char user *buf, 
size t cnt, loff t *offt) 


"OMNE ICE OIM ESCONDE 


HOME 

is /* 用 户 实现 具体 功能 * 
12 return 0; 

1.8. 3 

14 


15 /* 向 设备 写 数据 */ 

16 static ssize t chrtest write(struct file *filp, 
const char _ user *buf, 
size t cnt, loff t *offt) 


dE 

18 /* 用 户 实现 具体 功能 */ 
19 return 0; 

20 } 

2al 
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22 /* 关闭 /释放 设备 */ 
23 static int chrtest release(struct inode *inode, struct file *filp) 


24 d 
25 /* 用 户 实 现 具 体 功 能 */ 











26 return 0; 

zu 

28 

29 static struct file operations test fops - ( 
30 .owner — THIS MODULE, 

Srl .open = chrtest_open, 

32 .read = chrtest read, 

33 .write = chrtest write, 

34 .release = chrtest release, 

SB TER 

36 

37 /* 驱动 入 口 函 数 */ 

Sosa Le dng Amie <e (ee) 
39 q 

40 /* 入 口 函数 具体 内 容 */ 

41 ine retvyalue = O; 

42 

43 /* 注册 字符 设备 驱动 */ 

44 retvalue = regleter hroey (200, "chnrtest", vrest Tops) e 
45 if(retvalue < 0){ 

46 EE 
47 } 

48 return 0; 

49 ] 

50 





51 /* 驱动 出 口 函数 */ 


52 tatie void _ ee (Voie) 


Son 

54 /* 注销 字符 设备 驱动 */ 

55 unregister eia ci (00, Vehrtssi™ h) p 
56 ) 

5 








58 /* 将 上 面 两 个 函数 指定 为 驱动 的 入 口 和 出 口 函数 / 

59 module init(xxx init); 

60 module exit(xxx exit); 

在 示例 代码 40.2.3.1 中 我 们 一 开始 编写 了 四 个 函数 : chrtest open. chrtest read, chrtest. write 
和 chrtest release。 这 四 个 函数 就 是 chrtest 设备 的 open. read. write 和 release 操作 函数 。 第 29 
行 ~35 行 初 始 化 test fops 的 open. read. write 和 release 这 四 个 成 员 变 量 。 
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40.2.4 添加 LICENSE 和 作者 信息 


最 后 我 们 需要 在 驱动 中 加 入 LICENSE 信息 和 作者 信息 ， 其 中 LICENSE 是 必须 添加 的 ， 
则 的 话 编译 的 时 候 会 报错 ， 作 者 信息 可 以 添加 也 可 以 不 添加 。LICENSE 和 作者 信息 的 添加 使 用 
如 下 两 个 函数 : 
MODULE LICENSEO /添加 模块 LICENSE 信息 
MODULE AUTHOR() // 添 加 模块 作者 信息 
最 后 给 示例 代码 40.2.3.1 加 入 LICENSE 和 作者 信息 ， 完 成 以 后 的 内 容 如 下 : 
示例 代码 40.2.4.1 字符 设备 驱动 最 终 的 模板 














Ib 





















































L Lal ra 
2 skartie int Ghrtest Gems: inode Tuimoele, struct iile vil 
Se oxi 

4 /* 用 户 实现 具体 功能 */ 
5 

6 





return 0; 





58 /* 将 上 面 两 个 函数 指定 为 驱动 的 入 口 和 出 口 函 数 / 


59 module init(xxx init); 











60 module exit(xxx exit); 


62 MODULE LICENSE ("GPL"); 
63 MODULE AUTHOR ("zuozhongkai"); 
第 621], LICENSE 采用 GPL 协议 。 
第 63 行 ， 添 加 作者 名 字 。 
至 此 ， 字 符 设 备 驱 动 开发 的 完整 步骤 就 讲解 完了 ， 而 且 也 编写 好 了 一 个 完整 的 字符 设备 驱 
动 模板 ， 以 后 字符 设备 驱动 开发 都 可 以 在 此 模板 上 进行 。 


40.3 Linux 设备 号 
40.3.1 设备 号 的 组 成 


为 了 方便 管理 ，Linux 中 每 个 设备 都 有 一 个 设备 号 ， 设 备 号 由 主 设备 号 和 次 设备 号 两 部 分 
组 成 , 主 设备 号 表示 某 一 个 具体 的 驱动 , 次 设备 号 表示 使 用 这 个 驱动 的 各 个 设备 。Linux 提供 了 
一 个 名 为 dev t 的 数据 类 型 表示 设备 号 , dev t XE X. TEXTE include/linux/types.h 里 面 , 定 义 如 下 : 

示例 代码 40.3.1 设备 号 dev t 
12 typedef  u32 kernel dev t; 













































































I SEtypedetaE cuc M CM. 
可 以 看 出 dev t 是 _u32 类 型 的 ， 而 _u32 定义 在 文件 include/uapi/asm-generic/int-ll64.h 里 
面 ， 定 义 如 下 : 























示例 代码 40.3.2 _ u32 类 型 
26 typedef unsigned int uS g 


综 上 所 述 ，dev t 其 实 就 是 unsigned int 类 型 ， 是 一 个 32 位 的 数据 类 型 。 这 32 位 的 数据 构 
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成 了 主 设备 号 和 次 设备 号 两 部 分 ， 其 中 高 12 位 为 主 设备 号 ， 第 20 位 为 次 设备 号 。 因 此 Linux 











系统 中 主 设备 号 范围 为 0~4095， 所 以 大 家 在 选择 主 设备 号 的 时 候 一 定 不 要 超过 这 个 范围 。 在 文 
TF include/linux/kdev_t.h 中 提供 了 几 个 关于 设备 号 的 操作 函数 (本 质 是 宏 )， 如 下 所 示 : 
示例 代码 40.3.3 设备 号 操作 函数 
































6 ddefine MINORBITS 20 

7 #define MINORMASK ((1U «« MINORBITS) - 1) 

8 

9 define MAJOR (dev) ((unsigned int) ((dev) »» MINORBITS)) 
10 #define MINOR (dev) ( (unsigned int) ((dev) & MINORMASK)) 
11 #define MKDEV(ma,mi) (((ma) << MINORBITS) | (mi)) 














*8 611, 7E MINORBITS 表示 次 设备 号 位 数 ， 一 共 是 20 位 。 

第 7 行 ， 宏 MINORMASK 表示 次 设备 号 掩 码 。 

第 9 行 ， 宏 MAJOR 用 于 从 dev. t 中 获取 主 设备 号 ， 将 dev ft 右 移 20 位 即 可 。 

第 10 行 ， 宏 MINOR 用 于 从 dev. t 中 获取 此 设备 号 ， 取 dev. t 的 低 20 位 的 值 即 可 。 

第 11 行 ， 宏 MKDEV 用 于 将 给 定 的 主 设备 号 和 次 设备 号 的 值 组 合成 dev_t 类 型 的 设备 号 。 
























































40.3.2 设备 号 的 分 配 


l. PSDMR S 

本 小 节 讲 的 设备 号 分 配 主要 是 主 设备 号 的 分 配 。 前 面 讲 解 字 符 设 备 驱 动 的 时 候 说 过 了 ， 注 
册 字 符 设 备 的 时 候 需 要 给 设备 指定 一 个 设备 号 ， 这 个 设备 号 可 以 是 驱动 开发 者 静态 的 指定 一 个 
设备 号 ， 比 如 选择 200 这 个 主 设备 号 。 有 一 些 常 用 的 设备 号 已 经 被 Linux 内 核 开发 者 给 分 配 掉 
了 ， 有 具体 分 配 的 内 容 可 以 查看 文档 Documentation/devices.txt。 并 不 是 说 内 核 开发 者 已 经 分 配 掉 
的 主 设备 号 我 们 就 不 能 用 了 ， 具 体能 不 能 用 还 得 看 我 们 的 硬件 平台 运行 过 程 中 有 没有 使 用 这 个 
主 设备 号 ， 使 用 “cat /proc/devices” 命 令 即 可 查看 当前 系统 中 所 有 已 经 使 用 了 的 设备 号 。 

2、 动 态 分 配 设备 号 
静态 分 配 设备 号 需要 我 们 检查 当前 系统 中 所 有 被 使 用 了 的 设备 号 ， 然 后 挑选 一 个 没有 使 用 
的 。 而且 静态 分 配 设备 号 很 容易 带 来 冲突 问题 ,Linux 社区 推荐 使 用 动态 分 配 设备 号 , 在 注册 字 
符 设备 之 前 先 申 请 一 个 设备 号 , 系统 会 自动 给 你 一 个 没有 被 使 用 的 设备 号 ,这 样 就 避免 了 冲突 。 
和 扼 载 驱 动 的 时 候 释 放 掉 这 个 设备 号 即 可 ,设备 号 的 申请 函数 如 下 : 

intalloc chrdev region(dev t *dev, unsigned baseminor, unsigned count, const char *name) 

函数 alloc_chrdev_ region 用 于 申请 设备 号 ， 此 函数 有 4 个 参数 : 

dev: 保存 申请 到 的 设备 号 。 

baseminor: 次 设备 号 起 始 地 址 ，alloc_chrdev region 可 以 申请 一 段 连 续 的 多 个 设备 号 ， 这 
些 设 备 号 的 主 设备 号 一 样 ， 但 是 次 设备 号 不 同 ， 次 设备 号 以 baseminor 为 起 始 地 址 地 址 开始 递 
增 。 一 般 baseminor 为 0， 也 就 是 说 次 设备 号 从 0 开始 。 

count: 要 申请 的 设备 号 数量 。 

name: 设备 名 字 。 

注销 字符 设备 之 后 要 释放 掉 设备 号 ， 设 备 号 释放 函数 如 下 : 

void unregister chrdev region(dev t from, unsigned count) 

此 函数 有 两 个 参数 : 

from: 要 释放 的 设备 号 。 

count; 表示 从 from 开始 ， 要 释放 的 设备 号 数量 。 
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40.4 chrdevbase 字符 设备 驱动 开发 实验 
字符 设备 驱动 开发 的 基本 步骤 我 们 已 经 了 解 了 ， 本 节 我 们 就 以 chrdevbase 这 个 虚拟 设备 为 




















例 ， 完 整 的 编写 一 个 字符 设备 驱动 模块 。chrdevbase 不 是 实际 存在 的 一 个 设备 ， 是 笔者 为 了 方 
便 讲解 字符 设备 的 开发 而 引入 的 一 个 虚拟 设备 。chrdevbase 设备 有 两 个 缓冲 区 ， 一 个 为 读 缓冲 
区 ， 一 个 为 写 缓冲 区 ， 这 两 个 缓冲 区 的 大 小 都 为 100 字 节 。 在 应 用 程序 中 可 以 向 chrdevbase i 
备 的 写 缓冲 区 中 写 入 数据 ， 从 读 缓冲 区 中 读 取 数据 。chrdevbase 这 个 虚拟 设备 的 功能 很 简单 ， 

但 是 它 包 含 了 字符 设备 的 最 基本 功能 。 









































40.4.1 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光 盘 -> 2. Linux 驱动 例 程 -> 1 _chrdevbase。 

应 用 程序 调用 open 函数 打开 chrdevbase 这 个 设备 ， 打 开 以 后 可 以 使 用 write 函数 癌 
chrdevbase 的 写 缓冲 区 writebuf 中 写 入 数据 (不 超过 100 个 字 节 )， 也 可 以 使 用 read. 函数 读 取 读 
缓冲 区 readbuf 中 的 数据 操作 ， 操 作 完成 以 后 应 用 程序 使 用 close 函数 关闭 chrdevbase 设备 。 

1、 创 建 VSCode 工程 


在 Ubuntu 中 创建 一 个 目录 用 来 存放 Linux 驱动 程序 , 比如 我 创建 了 一 个 名 为 Linux_Drivers 
的 目录 来 存放 所 有 的 Linux 驱动 。 在 Linux. Drivers 目录 下 新 建 一 个 名 为 1 _chrdevbase 的 子 目 录 
来 存放 本 实验 所 有 文件 ， 如 图 40.4.1.1 所 示 : 


































































































> E 
su 
图 40.4.1.1 Linux 实验 程序 目录 


在 1_chrdevbase 目录 中 新 建 VSCode 工程 ， 并 且 新 建 chrdevbase.c 文件 ， 完 成 以 后 
1_chrdevbase 目录 中 的 文件 如 图 40.4.1.2 所 示 : 



































$1ls -a 
1 chrdevbase.code-workspace chrdevbase.c 


$ 
图 40.4.1.2 1_chardevbase 目录 文件 
2、 添 加 头 文件 路 径 
因为 是 编写 Linux 驱动 , 因此 会 用 到 Linux 源码 中 的 函数 。 我 们 需要 在 VSCode 中 添加 Linux 
源码 中 的 头 文件 路 径 。 打 开 VSCode， 按 下 “CrtltShifttP” 打 开 VSCode 的 控制 台 ， 然 后 输入 
“C/C++: Edit configurationsJSON) ”， 打 开 C/C++ 编辑 配置 文件 ， 如 图 40.4.1.3 所 示 : 


>C/C++: Edit fi tions(JSON) 







































图 40.4.1.3 C/C++ 编辑 配置 文件 。 























打开 以 后 会 自动 在 .vscode 目录 下 生成 一 个 名 为 c_cpp_properties.json 的 文件 ， 此 文件 默认 
内 容 如 下 所 示 : 
示例 代码 40.4.1.1 c. cpp. properties.json 文件 原 内 容 


"siente nica eS 


{ 


RCI SESS 


TEN 
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5 "includePath": [ 

6 "S(workspaceFolderj]/**", 

7 l; 

8 aestate s 

9 Wem esek inaa MD /eA ne ne 
10 Me enrol ro W Meli 

IST: "ejssscsumeleseel" s "essel". 

JE "intelliSenseMode": "clang-x64" 
13 ) 

14 e. 

BS) "version": 4 

ou) 


第 5 行 的 includePath 表示 头 文件 路 径 ， 需 要 将 Linux 源码 里 面 的 头 文件 路 径 添 加 进来 ， 也 
就 是 我 们 前 面 移植 的 Linux 源码 中 的 头 文件 路 径 。 添 加 头 文件 路 径 以 后 的 c_cpp_properties.json 
的 文件 内 容 如 下 所 示 : 
示例 代码 40.4.1.2 添加 头 文件 路 径 后 的 c cpp. properties.json 























1 q 

2 ce mee aem omes MA MI 

3 { 

4 "ave T 

5 "amewudebath'" s 

6 "S(workspaceFolderj]/**", 

qj "/home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
tel imz 4.1.15 2.1.0 ga alientek/include", 

8 "/home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
rel imx 4.1.15 2.1.0 ga alientek/arch/arm/include", 

9 "/home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
rel imx 4.1.15 2.1.0 ga alientek/arch/arm/include/gener 
ated/" 

10 l]; 

IA vJefines s EI; 

16 } 

dem lg 

18 Ivers onis 4 

i9: 5 











第 7-9 行 就 是 添加 好 的 Linux 头 文件 路 径 。 分 别 是 开发 板 所 使 用 的 Linux 源码 下 的 include、 
arch/arm/include 和 arch/arm/include/generated 这 三 个 目录 的 路 径 ， 注 意 ， 这 里 使 用 了 绝对 路 径 。 


3、 编 写实 验 程序 


工程 建立 好 以 后 就 可 以 开始 编写 驱动 程序 了 , 新建 chrdevbase.c, 然后 在 里 面 输入 如 下 内 容 : 
示例 代码 40.4.1.3 chrdevbase.c 文件 
1 #include <linux/types.h> 
2  $sinclude «linux/kernel.h» 
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finclude «linux/delay.h» 

#include «linux/ide.h» 

finclude «linux/init.h» 

#include <linux/module.h> 


/玉米 类 火炎 火炎 火炎 火炎 大 大 火炎 类 大 炎炎 大 大 类 类 大 大 类 类 大 大 类 类 大 大 类 类 大 大 类 大 大 大火 大大 大大 大 大 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 


3 
4 
S 
6 
7 
8 


9 

10 
dil 
12 
13 
14 
Jb 
16 
dy 
18 
JS 
20 
2 
2 
23 
24 
25 
26 
27 
28 
29 
30 
Syl 
Oy 
359 
34 
35 
36 
E 
38 
39 
40 
41 
42 
43 
44 
45 





Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 


文件 名 
作者 
版 本 
描述 
其 他 
论坛 


2E 


chrdevbase.c 


8 左 忠 凯 
g yi0 


chrdevbase 驱动 文件 。 


www .openedv.com 


: 初版 V1.0 2019/1/30 左 忠 凯 创建 


KCKCKCKCkCkCk kCk ck kCk Ck k kCk Ck k Ck Ck kk k k kc k k kc k k kk Ck kCk k k kc k k kk k kc k kckck ck kok ck ckck ck ckckck kk kk 














&define CHRDEVBASE MAJOR 200 /* ERRES xi 
&define CHRDEVBASE NAME "chrdevbase" /* 设备 名 e 
SE char mm /* 读 缓冲 区 
static char writebuf[100]; /* 写 缓冲 区 5 
Static char kerneldata[] = ("kernel data!"); 

/ * 


* Qdescription : 打开 设备 
* (param - inode : 传递 给 驱动 的 inode 
* Qparam - filp : 设备 文件 ，file 结构 体 有 个 叫做 Private data 的 成 员 变 量 


* 


一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 


= Qreturn : 0 成 功 ;其 他 失败 
wa 
S tentis int Chrdevbase epe ul vinode, el 
( 
//printk("chrdevbase open! NrNin"); 
return 0; 
) 
/* 


* (description : 从 设备 读 取 数 据 

* QGparam - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 

* Qparam - buf : 返回 给 用 户 空 间 的 数据 缓冲 区 

anam RENE : 要 读 取 的 数据 长 度 

* Qparam - offt : 相对 于 文件 首 地 址 的 偏 移 

* Qreturn : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 
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does sae spize t Chrdevbase iesus: Tile tuli, Ges _ user out, 
size t Gmt, loti t Vedi) 

a A 

48 int retvalue = 0; 

49 

50 /* 向 用 户 空 间 发 送 数据 */ 

Sal, memcpy (readbuf, kerneldata, sizeof(kerneldata)); 

52 retyaluūue 5 copy to user (but, readout, Ent)? 

58 if(retvalue == 0){ 

54 printk("kernel senddata ok!Nr Nn"); 

55 }else{ 

56 printk ("kernel senddata failed!\r\n"); 

57 } 

58 

59 //printk("chrdevbase read!NrNin"); 

60 return 0; 

61 ) 

62 

GS. ue 

64 * Qdescription : 向 设备 写 数据 

65  * (param - filp : 设备 文件 ， 表 示 打 开 的 文件 描述 符 

66 k Rparam pu : 要 写 给 设备 写 入 的 数据 

67  * (param - cnt  : 要 写 入 的 数据 长 度 

68  * Qparam - offt : 相对 于 文件 首 地 址 的 偏 移 

69. —* eee : 写 入 的 字 节 数 ， 如 果 为 负 值 ， 表 示 写 入 失败 

TA sy 

IL tatie size t Chrdevbase writelstruct iile viilp, 
Const Cheas _ user Dui, 
Size © EDE, dieu t vOTTE) 

7 

33) int retvalue = 0; 

74 /* 接收 用 户 空 间 传递 给 内 核 的 数据 并 且 打 印 出 来 * / 

75 retvalue = copy from user(writebuf, buf, cnt); 

76 if(retvalue == 0){ 

EA printk("kernel recevdata:$sNrMn", writebuf); 

78 }else{ 

79 printk ("kernel recevdata failed!\r\n"); 

80 } 

81 

82 //printk("chrdevbase write!\r\n"); 

83 return 0; 

84 ) 

85 
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ee. qe 

87  * (description  : 关闭 /释放 设备 

88  * (param - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 

89  * Qreturn : 0 成 功 ;其 他 失败 

DONE 7 

9 otetic imt Chroevbass ieleese(stuwesi inode toe, 


seruee Eke wirio) 















































g2 

93 //printk("chrdevbase release! \r\n"); 

94 return 0; 

9s 

96 

e qne 

98 — * 设备 操作 函数 结构 体 

Se ep 

10 eteatic gtruct tile operatione Chrdevbase ies = wu 

OL .owner = THIS MODULE, 

102 .open = chrdevbase open, 

103 .read = chrdevbase read, 

104 .write = chrdevbase write, 

105 areleease = Chrodevbeass release, 

3 3g 

107 

i9. es 

109 * Qdescription : 驱动 入 口 函数 

110 * param 8 JE 

111 * GQGreturn : 0 成 功 ;其 他 失败 

ing wy 

ILS statie iar —— init Chrdevoese imit (vore) 

114 { 

INS int retvalue = 0; 

116 

iiio /* 注册 字符 设备 驱动 */ 

118 retvalue - register chrdev(CHRDEVBASE MAJOR, CHRDEVBASE NAME, 
&chrdevbase fops); 

119 if(retvalue < 0)( 

120 printk("chrdevbase driver register failedNrNin"); 

1273 } 

122 printk("chrdevbase init() Nr Nin"); 

1278] return 0; 

124 ] 

125 

ME s 
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127 * Qdescription : 驱动 出 口 函数 

2 ra B B 

129 * Qreturn s Jb 

1.30 Sy 

ISl statie voici _ ee ese (wieso 

1L 9y2. wl 

133 /* 注销 字符 设备 驱动 */ 

134 unregister chrdev(CHRDEVBASE MAJOR, CHRDEVBASE NAME); 
IBS printk("chrdevbase exit ()NrNn"); 

i SS 

31530) 

SB fes 

139 * 将 上 面 两 个 函数 指定 为 驱动 的 入 口 和 出 口 函数 

140 */ 


141b module init (chnhrdevobase imit) y 





142 module exit(chrdevbase exit); 

143 

alal pus 

145 * LICENSE 和 作者 信息 

dA. Ss 

147 MODULE LICENSE ("GPL"); 

148 MODULE AUTHOR ("zuozhongkai"); 

第 32-36 ÍT, chrdevbase open 函数 ， 当 应 用 程序 调用 open 函数 的 时 候 此 函数 就 会 调用 
本 例 程 中 我 们 没有 做 任何 工作 , 只 是 输出 一 串 字 符 , 用 于 调试 。 这 里 使 用 了 printk 来 输出 信息 ， 
而 不 是 printf! 因为 在 Linux 内 核 中 没有 printf 这 个 函数 。printk 相当 于 printf 的 挛 生 兄 妹 ，printf 
运行 在 用 户 态 ，printk 运行 在 内 核 态 。 在 内 核 中 想 要 向 控制 台 输出 或 显示 一 些 内 容 ， 必 须 使 用 

































































































































































printk 这 个 函数 。 不 同 之 处 在 于 ，printk 可 以 根据 日 志 级 别 对 消息 进行 分 类 ， 一 共有 8 个 消息 级 
别 ， 这 8 个 消息 级 别 定 义 在 文件 include/linux/kern_ levels.h 里 面 ， 定 义 如 下 : 
#define KERN. SOH "i001" 
define KERN EMERG KERN SOH "0" /* 紧急 事件 ， 一般 是 内 核 朋 演 */ 
#define KERN_ALERT KERN SOH "I" /* 必须 立即 采取 行动 vi 
ildefine KERN CRIT KERN SOH 2" /* 临界 条 件 ， 比 如 严重 的 软件 或 硬件 错误 */ 
#define KERN. ERR KERN SOH "3" /* 错误 状态 ， 一 般 设 备 驱 动 程序 中 使 用 
KERN ERR 报告 硬件 错误 v 
#define KERN WARNING KERN SOH "4" /* 警告 信息 ， 不 会 对 系统 造成 严重 影响 */ 
ildefine KERN NOTICE KERN SOH "5"  /* 有 必要 进行 提示 的 一 些 信息 a 
#define KERN_INFO KERN SOH "6" /* 提示 性 的 信息 */ 
#define KERN_DEBUG KERN SOH "7". /* 调试 信息 

















v 

一 共 定义 了 8 个 级 别 ， 其 中 0 的 优先 级 最 高 ，7 的 优先 级 最 低 。 如 果 要 设置 消息 级 别 ， 参 

考 如 下 示 
printk(KERN EMERG "gsmi: Log Shutdown Reason"); 

上 述 代码 就 是 设置 “gsmi:Log Shutdown Reasonm” 这 行 消息 的 级 别 为 KERN_EMERG。 在 

具体 的 消息 前 面 加 上 KERN_EMERG 就 可 以 将 这 条 消息 的 级 别 设置 为 KERN_EMERG。 如 果 使 





Es 
G 
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用 printk 的 时 候 不 显 式 的 设置 消息 级 别 ， 那 么 printk 将 会 采用 默认 级 别 
MESSAGE LOGLEVEL DEFAULT, MESSAGE LOGLEVEL DEFAULT 默认 为 4。 
在 include/linux/printk.h 中 有 个 宏 CONSOLE LOGLEVEL DEFAULT, ;E Xl b: 

#define CONSOLE LOGLEVEL DEFAULT 7 

CONSOLE LOGLEVEL DEFAULT 控制 着 哪些 级 别 的 消息 可 以 显示 在 控制 台 上 , RRA 
为 7， 意 味 着 只 有 优先 级 高 于 7 的 消息 才能 显示 在 控制 台 上 。 

这 个 就 是 printk 和 printf 的 最 大 区 别 ， 可 以 通过 消息 级 别 来 决定 哪些 消息 可 以 显示 在 控 仙 
台 上 。 默 认 消息 级 别 为 4，4 的 级 别 比 7 高 ， 所 示 直 接 使 用 printk 输出 的 信息 是 可 以 显示 在 控制 
台 上 的 。 

参数 fip 有 个 叫做 private data 的 成 员 变 量 ，private_data 是 个 void 指针 ， 一 般 在 驱动 中 将 
private data 指向 设备 结构 体 ， 设 备 结构 体会 存放 设备 的 一 些 属性 。 

第 46~61 行 ，chrdevbase_read 函数 ， 应 用 程序 调用 read. 函数 从 设备 中 读 取 数据 的 时 候 此 函 
数 会 执行 。 参 数 buf 是 用 户 空间 的 内 存 ， 读 取 到 的 数据 存储 在 buf 中 ， 参 数 ent 是 要 读 取 的 字 节 
数 ， 参 数 offt 是 相对 于 文件 首 地 址 的 偏 移 。kerneldata 里 面 保存 着 用 户 空 间 要 读 取 的 数据 ,第 51 
行 先 将 kerneldata 数组 中 的 数据 拷贝 到 读 缓冲 区 readbuf 中 ， 第 52 行 通过 函数 copy. to. user 将 
readbuf 中 的 数据 复制 到 参数 buf 中 。 因 为 内 核 空 间 不 能 直接 操作 用 户 空 间 的 内 存 ， 因 此 需要 借 
助 copy. to user 函数 来 完成 内 核 空间 的 数据 到 用 户 空间 的 复制 。copy_to_user 函数 原型 如 下 : 

static inline long copy to user(void — user *to, const void *from, unsigned long n) 

参数 to 表示 目的 ， 参 数 from 表示 源 ， 参 数 n 表示 要 复制 的 数据 长 度 。 如 果 复 制 成 功 ， 返 
值 为 0， 如果 复制 失败 则 返回 负数 。 

第 71-84 行 ，chrdevbase_write 函数 ， 应 用 程序 调用 write 函数 向 设备 写 数据 的 时 候 此 函数 
就 会 执行 。 参 数 buf 就 是 应 用 程序 要 写 入 设备 的 数据 ， 也 是 用 户 空 间 的 内 存 ， 参数 ont 是 要 写 入 
的 数据 长 度 ， 参数 offt 是 相对 文件 首 地 址 的 偏 移 。 第 75 行 通过 函数 copy_from_user 将 buf 中 的 
数据 复制 到 写 缓冲 区 writebuf 中 ， 因 为 用 户 空 间 内 存 不 能 直接 访问 内 核 空 间 的 内 存 ， 所 以 需要 
借助 函数 copy. from user 将 用 户 空间 的 数据 复制 到 writebuf 这 个 内 核 空间 中 。 

第 91~95 行 ，chrdevbase release 函数 ， 应 用 程序 调用 close 关闭 设备 文件 的 时 候 此 函数 会 
执行 ， 一 般 会 在 此 函数 里 面 执行 一 些 释 放 操 作 。 如 果 在 open 函数 中 设置 了 fp 的 private data 
成 员 变 量 指向 设备 结构 体 ， 那 么 在 release 函数 最 终 就 要 释放 掉 。 

第 100-106 行 ， 新 建 chrdevbase 的 设备 文件 操作 结构 体 chrdevbase fops， 初 始 化 
chrdevbase fops. 

第 113-124 行 ， 驱 动 入 口 函 数 chrdevbase init, 第 118 行 调 用 函数 register chrdev 来 注册 字 
符 设 备 。 

第 131-136 行 ， 驱 动 出 口 函 数 chrdevbase_exit, 第 134 行 调 用 函数 unregister chrdev 来 注销 
字符 设备 。 

第 141-142 行 , 通 过 module init FI module exit 这 两 个 函数 来 指定 驱动 的 入 口 和 出 口 函 数 。 
第 147~148 行 ， 添 加 LICENSE 和 作者 信息 。 
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40.4.2 编写 测试 APP 


1、C 库 文件 操作 基本 函数 

编写 测试 APP 就 是 编写 Linux 应 用 ， 需 要 用 到 C 库 里 面 和 文件 操作 有 关 的 一 些 函数 ， 比 如 
open. read. write 和 close 这 四 个 函数 。 

(QD. open 函数 
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open 函数 原型 如 下 : 

int open(const char *pathname, int flags) 

open 函数 参数 含义 如 下 : 

pathname: 要 打开 的 设备 或 者 文件 名 。 

flags: 文件 打开 模式 ， 以 下 三 种 模式 必 选 其 一 : 














O_RDONLY 只 读 模式 
O_WRONLY 只 写 模式 
O RDWR 读 写 模式 





因为 我 们 要 对 chrdevbase 这 个 设备 进行 读 写 操作 ,所 以 选择 O_RDWR。 除了 上 述 三 种 
模式 以 外 还 有 其 他 的 可 选 模式 ， 通 过 人 逻辑 或 来 选择 多 种 模式 : 
O_APPEND 每 次 写 操作 都 写 入 文件 的 末尾 





























O_CREAT 如 果 指 定 文件 不 存在 ， 则 创建 这 个 文件 
O_EXCL 如 果 要 创建 的 文件 已 存在 ， 则 返回 -1， 并 且 修 改 errno 的 值 
O TRUNC 如 果 文 件 存在 ， 并 且 以 只 写 / 读 写 方式 打开 ， 则 清空 文件 全 部 内 容 

















O NOCTTY 如 果 路 径 名 指向 终端 设备 ， 不 要 把 这 个 设备 用 作 控 制 终端 。 
O NONBLOCK 如 果 路 径 名 指向 FIFO/ 块 文件 /字符 文件 ， 则 把 文件 的 打开 和 后 继 

































































VO 设置 为 非 阻塞 
DSYNC 等 待 物理 IO 结束 后 再 write。 在 不 影响 读 取 新 写 入 的 数据 的 前 提 
下 ， 不 等 待 文件 属性 更 新 。 
O RSYNC read 等 待 所 有 写 入 同一 区 域 的 写 操作 完成 后 再 进行 。 
O_SYNC 等 待 物理 IO 结束 后 再 write， 包 括 更 新 文件 属性 的 VO. 
返回 值 : 如 果 文 件 打开 成 功 的 话 返回 文件 的 文件 描述 符 。 












































在 Ubuntu 中 输入 “man 2 open” 即 可 查看 open 函数 的 详细 内 容 ， 如 图 40.4.2.1 所 示 ; 


zuozhongkai@ubuntu: ~ 





Linux Programmer's Manual 
OPEN(2) 


open, openat, creat - open and possibly create a file 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> 
#include <fcntl.h> 


int open(const char *pathname, int flags); 
int open(const char *pathname, int flags, mode_t mode); 


int creat(const char *pathname, mode_t mode); 


int openat(int dirfd, const char *pathname, int flags); 
int openat(int dirfd, const char *pathname, int flags, mode_t mode); 


Feature Test Macro Requirements for glibc (see feature_test_macros(7)): 
openat(): 
Since glibc 2:18: 


Manual page open(2) line 1 (press h for help or q to quit) 
图 40.4.2.1 open 函数 帮助 信息 








©, read 函数 
read 函数 原型 如 下 : 


ssize t read(int fd, void *buf, size t count) 
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read 函数 参数 含 AXI: 
d: 要 读 取 的 文件 描述 符 , 读 取 文 件 之 前 要 先 用 open 函数 打开 文件 ，open 函数 打开 文件 成 


























mu BT] 

buf: 数据 读 取 到 此 buf 中 。 

count: 要 读 取 的 数据 长 度 ， 也 就 是 字 节 数 。 

返回 值 : 读 取 成 功 的 话 返回 读 取 到 的 字 节 数 ， 如 果 返 回 0 表示 读 取 到 了 文件 末尾 ; 如果 返 
回 负 值 ， 表 示 读 取 失 败 。 在 Ubuntu 中 输入 “man 2 read” 命 令 即 可 查看 read 函数 的 详细 内 容 。 

©, write 函数 
write 函数 原型 如 下 : 

ssize t write(int fd, const void *buf, size t count); 

write 函数 参数 含义 如 下 : 

fd: 要 进行 写 操作 的 文件 描述 符 ， 写 文件 之 前 要 先 用 open 函数 打开 文件 ，open 函数 打开 文 
件 成 功 以 后 会 得 到 文件 描述 符 。 

buf: 要 写 入 的 数据 。 

count: 要 写 入 的 数据 长 度 ， 也 就 是 字 节 数 。 

返回 值 ， 写 入 成 功 的 话 返 回 写 入 的 字 节 数 ; 如 果 返 回 0 表示 没有 写 入 任何 数据 ; 如果 返回 
负 值 ， 表 示 写 入 失败 。 在 Ubuntu 中 输入 “man 2 write ”命令 即 可 查看 write 函数 的 详细 内 容 。 
Q). close 函数 
close 函数 原型 如 下 : 

int close(int fd); 
close 函数 参数 含义 如 下 : 

fd: 要 关闭 的 文件 描述 符 。 

返回 值 : 0 表示 关闭 成 功 ， 负 值 表示 关闭 失败 。 在 Ubuntu 中 输入 “man 2 close” 命 令 即 可 
查看 close 函数 的 详细 内 容 。 

2、 编 写 测 试 APP 程序 

驱动 编写 好 以 后 是 需要 测试 的 ， 一 般 编写 一 个 简单 的 测试 APP， 测 试 APP 运行 在 用 户 空 
间 。 测 试 APP 很 简单 通过 输入 相应 的 指令 来 对 chrdevbase 设备 执行 读 或 者 写 操作 。 在 
1 chrdevbase 目录 中 新 建 chrdevbaseApp.c 文件 ， 在 此 文件 中 输入 如 下 内 容 : 

示例 代码 40.4.2.1 chrdevbaseApp.c 文件 
















































































































































































JL eh el le 

2 me lude "unistd.h" 

3 4include "sys/types.h" 

4 d*$include "sys/stat.h" 

5m ediuceq kei 

6 4include "stdlib.h" 

7 s$include "string.h" 

QJ KOC ke kk kk kk kk kk kk kk ko kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk Kk KC KK KK KORR KG 
9o Gopyseigs oe ATIBINIBESRSOO Tear 99921029 ASI 3 qiissmEesembvec. 
10 文件 名 : chrdevbaseApp.c 

T sss : 左 忠 凯 

12 版 本 3 wel 

13 fx : chrdevbase 驱 测 试 APP。 

14 其 他 : 使 用 方法 : ./chrdevbaseApp /dev/chrdevbase <1>|<2> 
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15; argv[2] 1: 读 文件 

16 argv[2] 2: 写 文件 

L FRE : www.openedv.com 

1e Ba : 初版 V1.0 2019/1/30 左 忠 凯 创建 

19 KCKCKCKCkCKCk kCkCk k kk k kk Ck kCkCk kCk Ck k kc k k kc k Ck k Ck Ck kCkc Ck k kk k kk Ck kc kk kck ck kck ck ckck ck ckckck sk ck kk f 
20 

gil Estatus eel cias] = (sr oa 

2 

23r ff 

gui dE S Cr ip eon : main 主 程序 

25 * Qparam - argc  : argv Ae AX 

26 * Q8param - argv  : 有 具体 参数 

27 * Qreturn : 0 成 功 ;其 他 失败 

DONE 

| 

SO 

SHl Lae ol SeeuEwellbsuep 

32 char *filename; 

ES char readbuf[100], writebuf[100]; 

34 

B5 if(argc !- 3)( 

36 printf("Error Usage! NENON) 

37) return -1; 

38 } 

29 

40 filename = argv[1]; 

41 

42 A RAS =y 

43 fd = open(filename, O RDWR); 

44 if(fd « O)( 

45 printf("Can't open file ee filename); 
46 return l, 

47 } 

48 

a9 if (atoi (argv[2]) == 1)( /* 从 驱动 文件 读 取 数 据 */ 
50 retvalue = read(fd, readbuf, 50); 

5A if(retvalue « 0H 

52 printf("read file ss failed!NrNn", filename); 
58 Jelse( 

54 /* 读 取 成 功 ， 打 印 出 读 取 成 功 的 数据 */ 

55 printf("read data:$sNrNMn",readbuf); 

56 } 

55 } 
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58 

59 if(atoi(argv[2]) == 2)( 

60 /* 问 设备 驱动 写 数据 */ 

61 memcpy(writebuf, usrdata, sizeof(usrdata)); 

62 retvalue - write(fd, writebuf, 50); 

63 if(retvalue « ON 

64 printf("write file $s failed!NrNn", filename); 
65 ) 

66 ) 

67 

68 Z5 3S Bye o 

69 retvalue - close(fd); 

"70 if(retvalue < 0)( 

quat printf("Can't close file $sNrWMn", filename); 

12 return -|; 

ES } 

74 

JS return 0; 

yc 


第 21 fr, JH usrdata 是 测试 APP 要 向 chrdevbase 设备 写 入 的 数据 。 





第 35 行 ， 判断 运行 测试 APP. 的 时 候 输入 的 参数 是 不 是 为 3 个 ，mai 
参数 数量 ,argv[] 保 存 着 具体 的 参数 ， 如果 参数 不 为 3 个 的 话 就 表示 测试 
现在 要 从 chrdevbase 设备 中 读 取 数据 ， 需 要 输入 如 下 命令 : 

./chrdevbaseApp /dev/chrdevbase 1 

上 述 命令 一 共有 三 个 参数 “./chrdevbaseApp”、“/dev/chrdevbase” 和 和 
对 应 argv[0]、argv[1] 和 argv[2]。 第 一 个 参数 表示 运行 chrdevbaseAPP 这 






































n 函数 的 argc 参数 表示 
APP 用 法 错误 。 比 如 ， 

















“1”， 这 三 个 参数 分 别 
个 软件 ， 第 二 个 参数 表 








示 测 试 APP 要 打开 /dewchrdevbase 这 个 设备 。 第 三 个 参数 就 是 要 执行 的 操作 ,1 表示 从 chrdevbase 





中 读 取 数 据 ，2 表示 向 chrdevbase 写 数 据 。 
第 40 行 ， 获 取 要 打开 的 设备 文件 名 字 ，argv[1] 保 存 着 设备 名 字 。 
第 43 行 ， 调 用 C 库 中 的 open 函数 打开 设备 文件 : /dev/chrdevbase。 
第 49 行 ， 判 断 argv[2] 参 数 的 值 是 1 还 是 2， 因 为 输入 命令 的 时 候 
的 ， 因 此 需要 借助 atoi 函数 将 字符 串 格 式 的 数字 转换 为 真实 的 数字 。 
































其 参数 都 是 字符 串 格 式 





第 50 行 ， 当 argv[2] 为 1 的 时 候 表 示 要 从 chrdevbase 设备 中 读 取 数据 ， 一 共 读 取 50 字 节 的 





数据 ， 读 取 到 的 数据 保存 在 readbuf 中 ， 读 取 成 功 以 后 就 在 终端 上 打印 


8 读 取 到 的 数据 。 














第 59 行 ， 当 argv[2] 为 2 的 时 候 表 示 要 向 chrdevbase 设备 写 数据 。 
第 69 行 ， 对 chrdevbase 设备 操作 完成 以 后 就 关闭 设备 。 




















chrdevbaseApp.c 内 容 还 是 很 简单 的 ， 就 是 最 普通 的 文件 打开 、 关 闭 和 读 写 操作 。 





40.4.3 编译 驱动 程序 和 测试 APP 
1、 编 译 驱 动 程序 





























Makefile 文件 ， 然 后 在 其 中 输入 如 下 内 容 : 
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示例 代码 40.4.3.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
rel ime 4.51515 2-1-0 ce euaiemuel 
CURRENT PATH := $(shell pwd) 














obj-m := chrdevbase.o 


build: kernel modules 


kernel modules: 
S(MAKE) -C S(KERNELDIR) M=$ (CURRENT PATH) modules 








clean: 
0 $ (MAKE) -C S(KERNELDIR) M=$ (CURRENT_PATH) clean 
第 111, KERNELDIR 表示 开发 板 所 使 用 的 Linux 内 核 源码 目录 ， 使 用 绝对 路 径 ， 大 家 根 
据 自 己 的 实际 情况 填写 即 可 。 
第 2 行 ，CURRENT PATH 表示 当前 路 径 ， 直 接 通过 运行 “pwd” 命 令 来 获取 当前 所 处 路 





le EAI 
























































第 3 行 ，obj-m 表示 将 chrdevbase.c 这 个 文件 ， 并 且 编 译 为 模块 。 

第 8 行 ,具体 的 编译 命令 ， 后 面 的 modules 表示 编译 模块 ，-C 表示 将 当前 的 工作 目录 切 
换 到 指定 目录 中 ， 也 就 是 KERNERLDIR 目录 。M 表示 模块 源码 目录 ,“make modules” 命 令 
中 加 入 M=dir 以 后 程序 会 自动 到 指定 的 dir 目录 中 读 取 模块 的 源码 并 将 其 编译 为 .ko 文件 。 

Makefile 编写 好 以 后 输入 “make” 命 令 编译 驱动 模块 ， 编 译 过 程 如 图 40.4.3.1 所 示 : 






































UD 



























































$ ls 


1_chrdevbase. code- aE chrdevbaseApp.c chrdevbase.c Makefile 


$ make -j32 

ake -C /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux- imx-rel imx 4.1.15 2.1.0 ga alientek M-/home/zuozhongkai/li 
nnux/IMXeULL/Drivers/Linux Drivers/1 chrdevbase modules 

ake[1]: Entering directory '/home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek' 

CC [M] /home/zuozhongkai/linux/IMX6eULL/Drivers/Linux Drivers/1 chrdevbase/chrdevbase.o 

Building modules, stage 2. 

MODPOST 1 modules 

CC /home/zuozhongkai/linux/IMX6ULL/Drivers/Linux Drivers/1_chrdevbase/chrdevbase.mod.o 

LD [M] /home/zuozhongkai/linux/IMX6ULL/Drivers/Linux Drivers/1 chrdevbase/chrdevbase.ko 
ake[1]: Leaving directory '/home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek' 











图 40.4.3.1 驱动 模块 编译 过 程 

编译 成 功 以 后 就 会 生成 一 个 叫做 chrdevbaes.ko 的 文件 ， 此 文件 就 是 chrdevbase 设备 的 驱动 
模块 。 至 此 ，chrdevbase 设备 的 驱动 就 编译 成 功 。 

2、 编 译 测试 APP 

测试 APP 比较 简单 ， 只 有 一 个 文件 ， 因 此 就 不 需要 编写 Makefile 了 ， 直 接 输 入 命令 编译 。 
因为 测试 APP 是 要 在 ARM 开发 板 上 运行 的 ， 所 以 需要 使 用 arm-linux-gnueabihf-gcc 来 编译 ， 
输入 如 下 命令 


arm-linux-gnueabihf-gcc chrdevbaseApp.c -o chrdevbaseApp 
编译 完成 以 后 会 生成 一 个 叫做 chrdevbaseApp 的 可 执行 程序 ， 输 入 如 下 命令 查看 


chrdevbaseAPP 这 个 程序 的 文件 信息 : 
file chrdevbaseApp 


结果 如 图 40.4.3.2 所 示 : 
$ file chrdevbaseApp 


chrdevbaseApp: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpr 
eter /lib/ld-, for GNU/Linux 2.6.31，BuiLdID[shal]=5d017375992cf6c40e8fccb19a238dfd552ca7b6，not s 







































































tripped 


$ 
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图 40.4.3.2 chrdevbaseAPP 文件 信息 

从 图 40.4.3.2 可 以 看 出 ，chrdevbaseAPP 这 个 可 执行 文件 是 32 位 LSB 格式 ，ARM 版 本 
的 ， 因 此 chrdevbaseAPP 只 能 在 ARM 心 片 下 运行 。 














40.4.4 运行 测试 


1、 加 载 驱动 模块 

驱动 模块 chrdevbase.ko 和 测试 软件 chrdevbaseAPP 都 已 经 准备 好 了 ， 接 下 来 就 是 运行 测 
试 。 为 了 方便 测试 ，Linux 系统 选择 通过 TFTP 从 网 络 启动 ， 并 且 使 用 NFS 挂 载 网 络 根 文件 系 
统 ， 确 保 uboot 中 bootcmd 环境 变量 的 值 为 

tftp 80800000 zImage;tftp 83000000 imx6ull-alientek-emmec.dtb;bootz 80800000 - 83000000 

bootrags 环境 变量 的 值 为 : 

console-ttymxc0,115200 root-/dev/nfs rw nfsroot-192.168.1.250:/home/zuozhongkai/linux/nfs/ 
rootfs ip2192.168.1.251:192.168.1.250:192.168.1.1:255.255.255.0::eth0:off 

设置 好 以 后 启动 Linux 系统 , 检查 开发 板 根 文件 系统 中 有 没有 “/lib/modules/4.1.15” 这 个 目 
录 ， 如 果 没 有 的 话 自行 创建 。 因 为 是 通过 NFS 将 Ubuntu 中 的 rootfs( 第 三 十 八 章 制 作 好 的 根 文 
件 系统 ) 目 录 挂 载 为 根 文 件 系统 ， 所 以 可 以 很 方便 的 将 chrdevbase.ko 和 chrdevbaseAPP 复制 到 
rootfs/lib/modules/4.1.15 目录 中 ， 命 令 如 下 : 

sudo cp chrdevbase.ko chrdevbaseApp /home/zuozhongkai/linux/nfs/rootfs/lib/modules/A.1.15/ -f 

拷贝 完成 以 后 就 会 在 开发 板 的 /lib/modules/4.1.15 目录 下 存在 chrdevbase.ko 和 
chrdevbaseAPP 这 两 个 文件 ， 如 图 40.4.4.1 所 示 : 

/lib/modules/4.1.15 # 1s 


chrdevbase.ko | chrdevbaseApp 
/lib/modules/4.1.15 # 







































































图 40.4.4.1 驱动 和 测试 文件 
输入 如 下 命令 加 载 chrdevbase.ko 驱动 文件 : 
insmod chrdevbase.ko 
或 
modprobe chrdevbase.ko 
如 果 使 用 modprobe 加 载 驱动 的 话 ， 可 能 会 出 现 如 图 40.4.4.2 所 示 的 提示 : 


/lib/modules/4.1.15 # modprobe chrdevbase.ko 
—— can't open 'modules.dep': No such file or directory 
/lib/modules/4.1.15 # J 














图 40.4.4.2 modprobe 错误 提示 

从 图 40.4.4.2 可 以 看 出 ，modprobe 提示 无 法 打开 “modules.dep” 这 个 文件 ， 因 此 驱动 挂 载 
失败 了 。 我 们 不 用 手动 创建 modules.dep 这 个 文件 ， 直 接 输 令 depmod 命令 即 可 自动 生成 
modules.dep， 有 些 根 文件 系统 可 能 没有 depmod 这 个 命令 ， 如 果 没 有 这 个 命令 就 只 能 重新 配置 
busybox, 使 能 此 命令 ,然后 重新 编译 busybox。 输 入 “depmod” 命 令 以 后 会 自动 生成 modules.alias、 
modules.symbols 和 modules.dep 这 三 个 文件 ， 如 图 40.4.4.3 所 示 : 


/lib/modules/4.1.15 # depmod 

/lib/modules/4.1.15 # ls 

chrdevbase.ko modules.alias modules.symbols 
chrdevbaseApp modules.dep 

/lib/modules/4.1.15 £ 
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图 40.4.4.3 depmod 命令 执行 结果 
重新 使 用 modprobe 加 载 chrdevbase.ko， 结 果 如 图 40.4.4.4 所 示 : 














/lib/modules/4.1.15 # modprobe chrdevbase.ko 
chrdevbase init! 
/lib/modules/4.1.15 £ 


图 40.4.4.4. 驱动 加 载 成 功 
从 图 40.4.4.4 可 以 看 到 “chrdevbase init!” 这 一 行 ， 这 一 行 正 是 chrdevbase.c 中 模块 入 口 函 
数 chrdevbase init 输出 的 信息 ， 说 明 模块 加 载 成 功 ! 
输入 “lsmod” 命 令 即 可 查看 当前 系统 中 存在 的 模块 ， 结 果 如 图 40.4.4.5 所 示 : 
/lib/modules/4.1.15 # lsmod 
Module Size Used by Tainted: G 


chrdevbase 2096 0 
/lib/modules/4.1.15 £ 














图 40.4.4.5 当前 系统 中 的 模块 
从 图 40.4.4.5 n 可 以 看 出 ， 当前 系统 只 有 “chrdevbase” 这 一 个 模块 。 输 入 如 下 命令 查看 当前 
系统 中 有 没有 chrdevbase 这 个 设备 : 
cat /proc/devices 
结果 如 图 40.4.4.6 所 示 : 
/lib/modules/4.1.15 £ cat /proc/devices | 


OE devices: 
n 4 fü /vc/0 查看 当前 系统 中 的 所 有 


设备 

























5 p AP 
5 /dev/console 
5 /dev/ptmx 
7 vcs 
10 misc 
13 input 

fb 


video4linux 


T RIO 主 设备 号 为 200 的 
200 pe ep Pr chrdevbase 设 备 
E VIT 

图 40.4.4.6 当前 系统 设备 

从 图 40.4.4.6 可 以 看 出 ， 当 前 系统 存在 chrdevbase 这 个 设备 ， 主 设备 号 为 200， 跟 我 们 设置 
的 主 设备 号 一 致 。 

2、 创 建设 备 节点 文件 

驱动 加 载 成 功 需 要 在 /dev 目录 下 创建 一 个 与 之 对 应 的 设备 节点 文件 ， 应 用 程序 就 是 通过 所 
作 这 个 设备 节点 文件 来 完成 对 具体 设备 的 操作 。 输 入 如 下 命令 创建 /dev/chrdevbase 这 个 设备 节 
点 文件 : 
mknod /dev/chrdevbase c 200 0 
其 中 “mknod” 是 创建 节点 命令 ,“/dewchrdevbase” 是 要 创建 的 节点 文件 ,“c” 表 示 这 是 个 
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字符 设备 ,“200” 是 设备 的 主 设备 号 ,“0” 是 设备 的 次 设备 号 。 创 建 完 成 以 后 就 会 存在 
/dev/chrdevbase 这 个 文件 ， 可 以 使 用 “ls /dewchrdevbase -1” 命 令 查 看 ， 结 果 如 图 40.4.4.7 所 示 : 


/1ib/modules/4.1.15 # 1s A ida i -1 
crw-r--r-- 10 200, 0 Jan 1 01:25 /dev/chrdevbase 
/lib/modules/4.1.15 £ 











图 40.4.4.7 /dev/chrdevbase 文件 

如 果 chrdevbaseAPP 想 要 读 写 chrdevbase 设备 , 直接 对 /dev/chrdevbase 进行 读 写 操作 即 可 。 
相当 于 /dewchrdevbase 这 个 文件 是 chrdevbase 设备 在 用 户 空间 中 的 实现 。 前 面 一 直 说 Linux 下 
一 切 丝 文件 ， 包 括 设备 也 是 文件 ， 现 在 大 家 应 该 是 有 这 个 概念 了 吧 ? 


3、chrdevbase 设备 操作 测试 


一 切 准 备 就 绪 ， 接 下 来 就 是 “大 考 ” 的 时 刻 了 。 使 用 E 软件 操作 chrdevbase 这 
个 设备 ， 看 看 读 写 是 否 正 常 ， 首 先进 行 读 操作 ， 输 入 如 下 命令 : 
./chrdevbaseApp /dev/chrdevbase 1 
结果 如 图 40.4.4.8 Bron: 


# S udi /dev/chrdevbase 1 
动 程序 中 chrdevbase read 阔 数 输出 的 信息 


测试 APP 中 输出 的 接收 到 的 数据 : kernel data! 


图 40.4.4.8 读 操作 结果 

从 图 40.4.4.8 可 以 看 出 ， 首 先 输出 “kernel senddata ok!” 这 一 行 信息 ， 这 是 驱动 程序 中 
chrdevbase read 函数 输出 的 信息 ， 因 为 chrdevbaseAPP 使 用 read 函数 从 chrdevbase 设备 读 取 数 
据 ， 因 此 chrdevbase read 函数 就 会 执行 。chrdevbase read 函数 癌 chrdevbaseAPP X% “kernel 
data! " Z1, chrdevbaseAPP 接收 到 以 后 就 打印 出 来 “read data:kernel data! ”就 是 chrdevbaseAPP 
打印 出 来 的 接收 到 的 数据 。 说 明 对 chrdevbase 的 读 操作 正常 ， 接 下 来 测试 对 chrdevbase 设备 的 
写 操作 ， 输 入 如 下 命令 : 

./chrdevbaseApp /dev/chrdevbase 2 


结果 如 图 40.4.4.9 所 示 ; 


/lib/modules/4.1.15 £ . /chrdevbaseApp /dev/chrdevbase 2 
kernel recevdata:usr data! 
/lib/modules/4.1.15 # J 











































































































图 40.4. 4 9 写 操作 结果 
只 有 一 行 “kernel recevdata:usr datal”， 这 个 是 驱动 程序 中 的 chrdevbase write 函数 输出 的 。 
chrdevbaseAPP 使 用 write 函数 向 chrdevbase 设备 写 入 数据 “usr data! ". chrdevbase write 函数 接 
收 到 以 后 将 其 打印 出 来 。 说 明 对 chrdevbase 的 写 操作 正常 ， 既 然 读 写 都 没 问题 ， 说 明 我 们 编写 
的 chrdevbase 驱动 是 没有 问题 的 。 


























4、 钙 载 驱动 模块 
如 果 不 再 使 用 某 个 设备 的 话 可 以 将 其 驱动 印 载 掉 ， 比 如 输入 如 下 命令 卸载 掉 chrdevbase 这 
个 设备 : 


rmmod chrdevbase.ko 
EERME Imod 命令 查看 chrdevbase 这 个 模块 还 存 不 存在 ， 结 果 如 图 40.4.4.10 所 示 : 


/lib/modules/4.1.15 # lsmod 
Module Size Used by Tainted: G 
/lib/modules/4.1.15 # 




















图 40.4.4.10. 系统 中 当前 模块 
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从 图 40.4.4.10 可 以 看 出 , 此 时 系统 已 经 没有 任何 模块 了 , chrdevbase 这 个 模块 也 不 存在 了 ， 
说 明 模 块 邱 载 成 功 。 

至 此 ，chrdevbase 这 个 设备 的 整个 驱动 就 验证 完成 了 ， 驱 动工 作 正常 。 本 章 我 们 详细 的 讲 
解 了 字符 设备 驱动 的 开发 步骤 ， 并 且 以 一 个 虚拟 的 chrdevbase 设备 为 例 ， 带 领 大 家 完成 了 第 一 
个 字符 设备 驱动 的 开发 ， 掌 握 了 字符 设备 驱动 的 开发 框架 以 及 测试 方法 ， 以 后 的 字符 设备 驱动 
实验 基本 都 以 此 为 蓝本 。 
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第 四 十 一 章 RAA Linux LED 驱动 开发 实验 


上 一 章 我 们 详细 的 讲解 了 字符 设备 驱动 开发 步 又 ， 并 且 用 一 个 虚拟 的 chrdevbase 设备 为 例 
带领 大 家 完成 了 第 一 个 字符 设备 驱动 的 开发 。 本 章 我 们 就 开始 编写 第 一 个 真正 的 Linux 字符 设 
备 驱 动 。 在 LMX6U-ALPHA 开发 板 上 有 一 个 LED 灯 , 我 们 在 裸 机 篇 中 已 经 编写 过 此 LED 灯 的 
裸 机 驱动 ， 本 章 我 们 就 来 学 习 一 下 如 何 编写 Linux 下 的 LED 灯 驱 动 。 
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41.1 Linux F LED 灯 驱 动 原理 


Linux 下 的 任何 外 设 驱动 ， 最 终 都 是 要 配置 相应 的 硬件 寄存 器 。 所 以 本 章 的 LED 灯 驱 动 最 
终 也 是 对 IMX6ULL 的 IO 口 进行 配置 ,与 裸 机 实验 不 同 的 是 ,在 Linux 下 编写 驱动 要 符合 Linux 
的 驱动 框架 ,I.MX6U-ALPHA 开发 板 上 的 LED 连接 到 LMX6ULL 的 GPIO1 1003 这 个 引 脚 上 ， 
因此 本 章 实验 的 重点 就 是 编写 Linux 下 LMX6UL 引 脚 控制 驱动 。 关于 I.MX6ULL 的 GPIO 详细 
讲解 请 参考 第 八 章 。 






























































41.1.1 地 址 映射 


在 编写 驱动 之 前 ， 我 们 需要 先 简单 了 解 一 下 MMU 这 个 神器 ，MMU 全 称 叫 做 Memory 
Manage Unit， 也 就 是 内 存 管理 单元 。 在 老 版 本 的 Linux 中 要 求 处 理 器 必须 有 MMU， 但 是 现在 
Linux 内 核 已 经 支持 无 MMU 的 处 理 器 了 。MMU 主要 完成 的 功能 如 下 : 

QD、 完 成 虚拟 空间 到 物理 空间 的 映射 。 

@、 内 存 保护 ， 设 置 存 储 器 的 访问 权限 ， 设 置 虚拟 存储 空间 的 缓冲 特性 。 

我 们 重点 来 看 一 下 第 中 点 ， 也 就 是 虚拟 空间 到 物理 空间 的 映射 ， 也 叫做 地 址 映射 。 首 先 了 
解 两 个 地 址 概念 : 虚拟 地 址 (VA,VirtualAddress)、 物 理 地 址 (PA，Physcical Address)。 对 于 32 位 
的 处 理 器 来 说 , 虚拟 地 址 范围 是 2^32=4GB, 我 们 的 开发 板 上 有 512MB 的 DDR3, 这 512MB 的 
内 存 就 是 物理 内 存 ， 经 过 MMU 可 以 将 其 映射 到 整个 AGB 的 虚拟 空间 ， 如 图 41.1.1 所 示 : 


虚拟 内 存 































































































0X00000000— 





512MB 











OXFEFFFEEF— 





图 41.1.1. 内 存 映 射 
物理 内 存 只 有 512MB, 虚拟 内 存 有 4GB, 那么 肯定 存在 多 个 虚拟 地 址 映射 到 同一 个 物理 地 






































址 上 去 ， 虚 拟 地 址 范围 比 物理 地 址 范围 大 的 问题 处 理 器 自 会 处 理 ， 这 里 我 们 不 要 去 深究 ， 因 为 
MMU 是 很 复杂 的 一 个 东西 ， 后 续 有 时 间 的 话 正点 原子 Linux 团队 会 专门 做 MMU 专题 教程 。 
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Linux 内 核 启动 的 时 候 会 初始 化 MMU， 设 置 好 内 存 映射 ， 设 置 好 以 后 CPU 访问 的 都 是 虚 
拟 地址 。 比 如 LMXeULL 的 gGPIOLIOO 引 脚 的 复 用 寄存 器 
IOMUXC SW MUX CTL PAD_GPIO1 IO03 的 地 址 为 0X020E0068。 如果 没有 开启 MMU 的 话 














直接 向 0X020E0068 这 个 寄存 器 地 址 写 入 数据 就 可 以 配置 GPIO1_IO03 的 复 用 功能 。 现 在 开启 
了 MMU, 并 且 设 置 了 内 存 映射 ， 因此 就 不 能 直接 向 0X020E0068 这 个 地 址 写 入 数据 了 。 我 们 必 
须 得 到 0X020E0068 这 个 物理 地 址 在 Linux 系统 里 面 对 应 的 虚拟 地 址 ， 这 里 就 涉及 到 了 物理 内 
存 和 虚拟 内 存 之 间 的 转换 ， 需 要 用 到 两 个 函数 : ioremap 和 iounmap。 


1、ioremap 函数 


ioremap 函数 用 于 获取 指定 物理 地 址 空间 对 应 的 虚拟 地 址 空间 ， 定 义 在 
arch/arm/include/asm/io.h 文件 中 ， 定 义 如 下 : 
示例 代码 41.1.1 ioremap i žk 

























































































1 deiina ioremap(cookie,size) ^ arm ioremap((cookie), (size), 
MT DEVICE) 
2 
23 void _ iomem ww _ amm ioreneap (phys acode © pays acle, Size © S12; 


unsigned int mtype) 
& 4 
5 return arch ioremap caller(phys addr, size, mtype, 
. builtin return address ) 2 

6) 

ioremap 是 个 宏 ， 有 两 个 参数 : cookie 和 size， 真 正 起 作用 的 是 函数 arm ioremap, JER 
数 有 三 个 参数 和 一 个 返回 值 ， 这 些 参数 和 返回 值 的 含义 如 下 : 

phys_addr: 要 映射 给 的 物理 起 始 地 址 。 

size: 要 映射 的 内 存 空间 大 小 。 

mtype: ioremap 的 类 型 ， 可 以 选择 MT_DEVICE、MT DEVICE NONSHARED、 
MT DEVICE CACHED 和 MT DEVICE WC, ioremap 函数 选择 MT_DEVICE。 

返回 值 : _iomem 类 型 的 指针 ， 指 向 映射 后 的 虚拟 空间 首 地 址 。 

假如 我 们 要 获取 IMX6ULL 的 IOMUXC. SW MUX CTL PAD GPIOI 1003 寄存 器 对 应 
的 虚拟 地 址 ， 使 用 如 下 代码 即 可 : 

#define SW MUX GPIO1 IO03 BASE (0X020E0068) 

static void  iomem* SW MUX GPIO!1 1003; 

SW MUX GPIOI IO03 = ioremap(GPIO1 GDIR BASE, 4); 

宏 SW MUX GPIOI IO03 BASE 是 寄存 器 物理 地 址 ，SW_MUX GPIOI 1003 是 映射 后 
的 虚拟 地 址 。 对 于 ILMX6ULL 来 说 一 个 寄存 器 是 4 字 节 (32 位 ) 的 ， 因 此 映射 的 内 存 长 度 为 4。 
映射 完成 以 后 直接 对 SW_MUX _GPIO1 1003 进行 读 写 操作 即 可 。 

2. iounmap 函数 


卸载 驱动 的 时 候 需 要 使 用 iounmap 函数 释放 掉 ioremap 函数 所 做 的 映射 ，iounmap 函数 原 
型 如 下 : 


































































































示例 代码 41.1.2 iounmap 函数 原型 


void iounmap (volatile void ^ iomem *addr) 
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iounmap 只 有 一 个 参数 addr， 此 参数 就 是 要 取消 映射 的 虚拟 地 址 空间 首 地 址 。 假 如 我 们 现 
在 要 取消 掉 IOMUXC SW MUX CTL PAD GPIOI 1003 寄存 器 的 地 址 映射 ， 使 用 如 下 代码 

















B nf: 
iounmap(SW MUX GPIOI 1003); 


41.1.2 LO 内 存 访问 函数 


这 里 说 的 VO 是 输入 /输出 的 意思 ， 并 不 是 我 们 学 习 单片机 的 时 候 讲 的 GPIO 引 脚 。 这 里 涉 
及 到 两 个 概念 : IO 端口 和 IO 内 存 。 当 外 部 寄存 器 或 内 存 映 射 到 IO 空间 时 ， 称 为 VO 端口 。 
当 外 部 寄存 器 或 内 存 映 射 到 内 存 空间 时 ， 称 为 VO 内 存 。 但 是 对 于 ARM 来 说 没有 IO 空间 这 个 
概念 ， 因 此 ARM 体系 下 只 有 LIO 内 存 (可 以 直接 理解 为 内 存 )。 使 用 ioremap 函数 将 寄存 器 的 物 
理 地 址 映射 到 虚拟 地 址 以 后 ， 我 们 就 可 以 直接 通过 指针 访问 这 些 地 址 ， 但 是 Linux 内 核 不 建议 
这 么 做 ， 而 是 推荐 使 用 一 组 操作 函数 来 对 映射 后 的 内 存 进行 读 写 操作 。 

1、 读 操作 函数 

读 操作 函数 有 如 下 几 个 : 



















































































示例 代码 41.1.2.1 EE RS AC 

Wee lo (eon volatile voici — iomem wace) 
2 ul6 readw(const volatile void X iomem *addr) 
3j 132) readil (const volatile voici  — lomem wacker) 

readb, readw 和 readl 这 三 个 函数 分 别 对 应 8bit、16bit 和 32bit 读 操 作 ， 参 数 addr 就 是 要 
读 取 写 内 存 地 址 ， 返 回 值 就 是 读 取 到 的 数据 。 

2、 写 操作 函数 

写 操作 函数 有 如 下 几 个 : 




















示例 代码 41.1.2.2 写 操作 函数 
1 void writeb(u8 value, volatile void _ iomem *addr) 
2 void writew(ul6 value, volatile void . iomem *addr) 
3 void writel(u32 value, volatile void ^ iomem *addr) 
writeb. writew 和 writel 这 三 个 函数 分 别 对 应 8bit、16bit 和 32bit 写 操作 ， 参 数 value 是 要 
写 入 的 数值 ，addr 是 要 写 入 的 地 址 。 


41.2 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 8.3 小 节 即 可 。 


41.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 2. Linux 驱动 例 程 -> 2_led。 
本 章 实验 编写 Linux 下 的 LED 灯 驱 动 ， 可 以 通过 应 用 程序 对 IMX6U-ALPHA 开发 板 上 的 
LED 灯 进 行 开 关 操 作 。 


















































41.3.1 LED 灯 驱 动 程序 编写 


新 建 名 为 *2_led ”文件 夹 ,然后 在 2_led 文件 夹 里 面 创建 VSCode 工程 , 工作 区 命名 为 “led”。 
工程 创建 好 以 后 新 建 led.c 文件 ， 此 文件 就 是 led 的 驱动 文件 ， 在 led.c 里 面 输入 如 下 内 容 : 
示例 代码 41.3.1.1 led.c 驱动 文件 代码 
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finclude <linux/types.h> 


#include «linux/kernel.h» 
finclude «linux/delay.h» 
#include «linux/ide.h» 
finclude «linux/init.h» 
#include <linux/module.h> 


dinclude «linux/errno.h» 





OON ON E E NN 


#include <linux/gpio.h> 





9 #include <asm/mach/map.h> 

10 #include <asm/uaccess.h> 

11 #include <asm/io.h> 

12 — JO kk KOKCK kk ok kk KK ok kk KICK oko KCKCK kk ok KK KK ok Rok KICK Kool Rok KK 
lsi Copy Gline © AGIN Coop uelis 1908-2029; AUL sexa. sexus wies 
14 文件 名 : led.c 






























































l5 ES : 左 忠 凯 

16 版 本 3 Vis 

17 描述 : LED 驱动 文件 。 

18 其 他 SE 

19 论坛 : www.openedv.com 

20x clos : 初版 V1.0 2019/1/30 左 忠 凯 创建 

2 OKCKCKCKCkCKCkCk kCkCk kCk k Ck k kCk k kk k kc k k kk Ck k k Ck kCk Ck k kc k k kc k Ck kc k Ck kck ck kck ck ckck ck ckck ck kck e ke kk f 
22 #define LED MAJOR 200 J= Ew */ 
23 4define LED NAME Pad M aaar 
24 

25 4define LEDOFF 0 RNT a 
26 4define LEDON il 人 = 
27 

28 /* 寄存 器 物理 地 址 */ 

29 #define CCM CCGR1 BASE (0X020C406C) 
30 4define SW MUX GPIO1 IO03 BASE (0X020E0068) 
31 $define SW PAD GPIO1 IO03 BASE (0X020E02F4) 
32 d4define GPIO1 DR BASE (0x0209C000) 
33 ddefine GPIOI GDIR BASE (0X0209C004) 
34 


35 /* 映射 后 的 寄存 器 虚拟 地 址 指针 */ 

Je pratic voici _ iomem uM. 
37 etaric vorg iomem «SW MUX GPIOL THOSE 
Se reatie voici _ iomem vSwW PAD GPIOL_ TOOS} 
3S9) etaric void _ lomem “CPIOl DR? 

MOR a eeo O Temam CATONE DTR 





41 
dp. - ums 
43  * Qdescription  : LED4j]JT/XH] 
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44  * Q(param - sta  : LEDON(0) 17Jf LED, LEDOFF(1) XH]LED 
45  * Qreturn 8 JB 

46 i 

47 void led switch(u8 sta) 

48 ( 

49 0192 vall = p 

50 if(sta == LEDON) ( 

5i val - readl(GPIOl1 DR); 

52 val &= ~(1 << 3); 

59 writel(val, GPIOI DR); 

54 Jelse if(sta == LEDOFF) ( 

55 val - readl(GPIO1 DR); 

56 valls (1 << 3); 

Su weitel(val, CGPIOL DRJ) 7 

58 } 

ONES 

60 

Gl MS 

62 + @description 打开 设备 


63 * (param - inode : 传递 给 驱动 的 inode 
64  * Qparam - filp : 设备 文件 ，file 结构 体 有 个 叫做 private data 的 成 员 变 量 





65 * 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
66 > Qreturn : 0 成 功 ;其 他 失败 

y. wf 

GA statie imt lee oyexexa((snticuve sr inode alsmoele, struct tile ab 
eS 

70 return 0; 

qb 

pe 

IAE 


74 * Qdescription : 从 设备 读 取 数 据 

75  * Qparam - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 

76  * 8param - buf : 返回 给 用 户 空间 的 数据 缓冲 区 

A/ ara em : 要 读 取 的 数据 长 度 

78  * Qparam - offt : 相对 于 文件 首 地 址 的 偏 移 

79  * Qreturn : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 

SOR A 

Gil eteti Size c lec zeme(st:iuct iile viilp, Char _ user uu 
Gum t Gub, lort © VOTLE) 

















82 m 

83 return 0; 
84 } 

85 
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ee. qe 

87 * Qdescription : 向 设备 写 数据 

88  * @param - filp : 设备 文件 表示 打开 的 文件 描述 符 

SO e parami buf : 要 写 给 设备 写 入 的 数据 

90 oanam FENE : 要 写 入 的 数据 长 度 

91  * @param - offt : 相对 于 文件 首 地 址 的 偏 移 

92  * Qreturn : 写 入 的 字 节 数 ， 如 果 为 负 值 ， 表 示 写 入 失败 

Sse 

9i estatic Selze t lec vrite(struct tile wiils, Const Char UvSer UON, 
size t Cnt, loti t VORTE) 


























e N 

96 int retvalue; 

9, unsigned char databuf[1]; 

98 unsigned char ledstat; 

99 

100 retyalúe 5 copy irom user (cdartabui, but, CMT) y 
INON if(retvalue « 0) ( 

102 printk("kernel write failed!NrNin"); 

103 return -EFAULT; 

104 } 

105 

106 ledstat = databuf[0]; /* 获取 状态 值  */ 
107 

108 if(ledstat == LEDON) { 

109 led switch (LEDON) ; ZI LEDI 7 
110 ) else if(ledstat == LEDOFF) ( 

TT led switch(LEDOFF); /* XH LEDAT */ 
2 } 

ll return 0; 

11:472] 

S 

HE S 


117 * @description : 关闭 /释放 设备 

118 * @param - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 

119 * Qreturn : 0 成 功 ;其 他 失败 

20 

ll2es ee (se nol winode, struct Tile iride 
1272. Wl 

AS return 0; 

124 } 

JUL 

126 /* 设备 操作 函数 */ 


127 tetic gtruct file operations lec tops = d 
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下 28 .owner = THIS MODULE, 

12/9] .open - led open, 

ISKO oread = led reac, 

131 .write = led write, 

10512 Sueltesgsca-uccdEmellesser 

195. E 

134 

JUS fes 

136 * Qdescription : 驱动 出 口 函数 
137 * (param 3 JE 

IS o > (Oe 8 XB 

se 

O statie ee 
141 { 

142 int retvalue = 0; 

143 wu val = 0z 

144 





145 /* 初始 化 LED */ 
146 /* 1、 寄 存 器 地 址 映射 */ 














147 IMX6U CCM CCGR1 = ioremap(CCM CCGR1 BASE, 4); 

148 SW MUX GPIO1 IO03 - ioremap(SW MUX GPIO1 IO03 BASE, 4); 
149 SW PAD GPIOl IO03 = ioremap(SW PAD GPIO1 IO03 BASE, 4); 
150 GPIOI1 DR -2 ioremap(GPIOl1 DR BASE, 4); 

d. 5E GPIOl1 GDIR = ioremap(GPIOl1 GDIR BASE, 4); 

dL 

153 /* 2. BERE GPIOlHBH]PR */ 

154 val = readl(IMX6U CCM CCGR1); 


155 val &= «(3 << 26); /* 清除 以 前 的 设置 */ 
156 val |= (3 << 26);  /* 设置 新 值 */ 





157 weitelgyal, IMXEU CCM CCGRLY 7 

158 

159 /* 3. W'EcPrO1 1003 的 复 用 功能 ， 将 其 复 用 为 
160 * — GPIOl I003， 最 后 设置 IO 属性 。 

161 i 

162 writel(5, SW MUX GPIO1 I003); 

163 

164 /* 寄存 器 SW PAD GPIO1 IO03 设置 IO 属性 */ 
165 writel(0x10B0, SW PAD GPIO1 IO03); 

166 

167 /* 4. WE GPIOl IO03 为 输出 功能 */ 

168 val = readl (GPIO1 GDIR); 


169 val &= «(1 «« 3);  /* 清除 以 前 的 设置 */ 
170 val |= (1 << 3); /* 设置 为 输出 */ 
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TITRE writel(val, GPIOL GDIR); 

ly 

L73 /* 5. A LED */ 

174 val = readl(GPIOl1 DR); 

INS val | (1 «« 3); 

176 weitel(yal, GPRIOL DR) 7 

IT 

178 /* 6、 注 册 字 符 设备 驱动 */ 

ITS retvalue = register chrdev(LED MAJOR, LED NAME, &led fops); 
180 if(retvalue < 0){ 

isal printk("register chrdev failed!NrMn"); 
182 return -EIO; 

183 } 

184 return 0; 

IBS N 

186 

dS) fes 

188 * Qdescription  : 驱动 出 口 函 数 

189 * @param TE 

190 * @return e JE 

ILS oe 

19/7 iEENEIO. voici exit lel exte (vorc) 

LOS N 

194 /* 取消 映射 */ 

195 iounmap(IMX6U CCM CCGR1); 

ROIG iounmap(SW MUX GPIO1 IO03); 

397) iounmap(SW PAD GPIO1 IO03); 

198 iounmap(GPIO1 DR); 

d9o iounmap(GPIOl GDIR); 

200 

201 /* 注销 字符 设备 驱动 */ 

202 unregister chrdev(LED MAJOR, LED NAME); 
205) 

204 


205 module sbaone (le! 3sedb p 
206 module ezit (deel exu) 
207 MODULE LICENSE ("GPL"); 
208 MODULE AUTHOR ("zuozhongkai"); 
第 22~26 行 ， 定 义 了 一 些 宏 ， 包 括 主 设备 号 、 设 备 名 字 、LED 开 / 关 宏 。 
第 29~33 行 ， 本 实验 要 用 到 的 寄存 器 宏 定 义 。 
第 36-40 行 ， 经 过 内 存 映 射 以 后 的 寄存 器 地 址 指针 。 
第 47-59 ÍF, led_switch 函数 ， 用 于 控制 开发 板 上 的 LED 灯亮 灭 ， 当 参数 sta 为 LEDON(0) 
的 时 候 打 开 LED X, sta 为 LEDOFF(1) 的 时 候 关 闭 LED 灯 。 
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第 68~71 行 ，led_open 函数 ， 为 空 函 数 ， 可 以 自行 在 此 函数 中 添加 相关 内 容 ， 一 般 在 此 函 
数 中 将 设备 结构 体 作 为 参数 filp 的 私有 数据 (filp->private_ data). 

第 81-84 fT, led read 函数 ， 为 空 函数 ， 如 果 想 在 应 用 程序 中 读 取 LED 的 状态 ， 那 么 就 可 
以 在 此 函数 中 添加 相应 的 代码 ， 比 如 读 取 GPIO1_DR 寄存 器 的 值 ， 然 后 返回 给 应 用 程序 。 

第 94~114 行 ，led_write 函数 ， 实 现 对 LED 灯 的 开关 操作 ， 当 应 用 程序 调用 write 函数 向 
led 设备 写 数据 的 时 候 此 函数 就 会 执行 。 首 先 通过 函数 copy from. user 获取 应 用 程序 发 送 过 来 
的 操作 信息 (打开 还 是 关闭 LED)， 最 后 根据 应 用 程序 的 操作 信息 来 打开 或 关闭 LED 灯 。 

第 121-124 fT. led release 函数 ， 为 空 函数 ， 可 以 自行 在 此 函数 中 添加 相关 内 容 ， 一 般 关 
闭 设 备 的 时 候 会 释放 掉 led open 函数 中 添加 的 私有 数据 。 

第 127-133 行 ， 设 备 文件 操作 结构 体 led fops 的 定义 和 初始 化 。 

第 140-185 行 ， 驱动 入 口 函 数 led_init， 此 函数 实现 了 LED 的 初始 化 工作 ，147~151 行 通过 
ioremap 函数 获取 物理 寄存 器 地 址 映射 后 的 虚拟 地 址 ， 得 到 寄存 器 对 应 的 虚拟 地 址 以 后 就 可 以 
完成 相关 初始 化 工作 了 。 比如 是 能 GPIO1 时 钟 、 设置 GPIO1 IO03 复 用 功能 、 配 置 GPIO1 IO03 
的 属性 等 等 。 最 后 ， 最 重要 的 一 步 ! 使 用 register_ chrdev 函数 注册 led 这 个 字符 设备 。 

第 192-202 行 ， 驱 动 出 口 函数 led_exit， 首 先 使 用 函数 iounmap 取消 内 存 映 射 ， 最 后 使 用 函 
数 unregister chrdev 注销 led 这 个 字符 设备 。 

第 205-206 行 ， 使 用 module init 和 module exit 这 两 个 函数 指定 led 设备 驱动 加 载 和 伸 载 

第 207-208 行 ， 添 加 LICENSE 和 作者 信息 。 







































































41.3.2 编写 测试 APP 


编写 测试 APP, led 驱动 加 载 成 功 以 后 手动 创建 /dev/led 节点 ， 应 用 APP 通过 操作 /dev/led 
文件 来 完成 对 LED 设备 的 控制 。 向 /dev/led 文件 写 0 表示 关闭 LED XT, 写 1 表示 打开 LED 灯 。 
新 建 ledApp.c 文件 ， 在 里 面 输 入 如 下 内 容 : 
示例 代码 41.3.2.1 ledApp.c 文件 代码 










































































melde "engl iac" 

2) —wpabevelbuXokei ne 

3 4$include "sys/types.h" 

4 #include "sys/stat.h" 

5 #include "fcntl.h" 

6 4include "stdlib.h" 

uo aaeocae st ce 

B Kk Rok KCKCk kk ok K KK kk oko K KK KK ok A KCK KC odo K KCKCK KOC dok XR KCK Kok KK KK 
9 Copyright O ALUENBEK Co, dtd. 1998-2029. A r«"ghts reserved. 
10 文件 名 : TedApp.e 

11 : 左 忠 凯 

12 版 本 3 VLO 

13 描述 : LED 驱 测 试 APP。 

14 其 他 天 

15 使 用 方法 : ./ledtest /dev/led a 

16 ./ledtest /dev/led 1 打开 LED 

1,7) VE : www.openedv.com 

18 Hx : 初版 V1.0 2019/1/30 左 忠 凯 创建 
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19 KCKCKCKCkCKCk kCkCk k kk k kk Ck kCk Ck k kk k kk k kc k Ck k Ck Ck kCkCk k kc k k k k Ck kc k Ck kck ck kck ck ckck ck ckck ck kck e k kx f 


20 
21 £$define LEDOFF 0 
22 $define LEDON il 








PE 

2A hse 

25 * Qdescription : main 主 程序 

26 * Qparam - argo  : argv MARIAL 
27 * Qparam - argv  : AAS 

28 * Qreturn : 0 成 功 ;其 他 失败 
2 

30 int main(int arge, char *argv[]l) 
EET 

92 me del, vee we oes 

ES char *filename; 

34 unsigned char databuf[1]; 

E 

36 if(argc !- 3)( 

y 二 人 
38 return -1; 

29 } 

40 

41 filename = argv[1]; 

42 

43 /* 打开 led 驱动 */ 

44 fd 2 open(filename, O RDWR); 
45 if(fd « O)( 

46 printf("file $s open failed!NrMn", argv[1]); 
47 return -1; 

48 } 

49 


50 databuf[0] = atoi(argv[2]); /* 要 执行 的 操作 : 打开 或 关闭 */ 
Sal 





52 /* 向 /dev/1eqd 文件 写 入 数据 */ 

5 retvalue = write(fd, databuf, sizeof(databuf)); 
54 if(retvalue « 0)( 

55 prine ( TED COnero l kai led NENAU) 

56 close (fd); 

Sy return -i|; 

58 ) 

59 

60 retvalue = close(fd); /* AADA */ 

61 if(retvalue « 0)( 
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62 printf("file $s close failed!NrNn", argv[1]); 

63 return -1|; 

64 ) 

65 return 0; 

SS 




















ledApp.c 的 内 容 还 是 很 简单 的 ， 就 是 对 led 的 驱动 文件 进行 最 基本 的 打开 、 关 闭 、 写 操作 





4B 


41.4 运行 测试 
41.4.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 

编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m AE 
量 的 值 改 为 led.o，Makefile 内 容 如 下 所 示 : 
示例 代码 41.4.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 






































cel ime 4-115 2-1-0 ga aliesntelk 




















1:2 i (MAKE) -C S(KERNELDIR) M=$ (CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 led.o。 

输入 如 下 命令 编译 出 驱动 模块 文件 : 

make -j32 

编译 成 功 以 后 就 会 生成 一 个 名 为 “led.ko” 的 驱动 模块 文件 。 

、 编 译 测试 APP 

输入 如 下 命令 编译 测试 ledApp.c 这 个 测试 程序 : 


arm-linux-gnueabihf-gcc ledApp.c -o ledApp 
编译 成 功 以 后 就 会 生成 led A pp 这 个 应 用 程序 。 








N 











41.4.2 运行 测试 


将 上 一 小 节 编 译 出 来 的 led.ko 和 1ledApp 这 两 个 文件 拷贝 到 rootfs/lib/modules/4.1.15 目录 中 ， 
重启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输入 如 下 合 命令 加 载 led.ko 驱动 模块 : 























depmod // 第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 
modprobe led.ko // 加 载 驱 动 

驱动 加 载 成 功 以 后 创建 “/dev/led” 设 备 节点 ， 命 令 如 下 : 
mknod /dev/led c 200 0 























驱动 节点 创建 成 功 以 后 就 可 以 使 用 ledApp 软件 来 测试 驱动 是 否 工作 正常 ,输入 如 下 命令 打 
开 LED 灯 ; 

/ledApp /dev/led 1 /打开 LED 4T 

输入 上 述 命令 以 后 观察 LMX6U-ALPHA 开发 板 上 的 红色 LED 灯 是 否 点 亮 ， 如 果 点 亮 的 话 
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说 明 驱 动工 作 正常 。 在 输入 如 下 命令 关闭 LED 灯 : 

./ledApp /dev/led 0 /关闭 LED 灯 

输入 上 述 命令 以 后 观察 LMX6U-ALPHA 开发 板 上 的 红色 LED 灯 是 否 熄灭 ， 如 果 炉 灭 的 话 
说 明 我 们 编写 的 LED 驱动 工作 完全 正常 ! 至 此 , 我 们 成 功 编写 了 第 一 个 真正 的 Linux 驱动 设备 











程序 。 
如 果 要 郝 载 驱动 的 话 输 入 如 下 命令 即 可 : 


rmmod led.ko 
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第 四 十 二 章 新 字符 设备 驱动 实验 


经 过 前 两 章 实 验 的 实战 操作 ， 我 们 已 经 掌握 了 Linux 字符 设备 驱动 开发 的 基本 步骤 ， 字 符 
设备 驱动 开发 重点 是 使 用 register chrdev 函数 注册 字符 设备 ， 当 不 再 使 用 设备 的 时 候 就 使 用 
unregister chrdev 函数 注销 字符 设备 ， 驱 动 模块 加 载 成 功 以 后 还 需要 手动 使 用 mknod 命令 创建 
设备 节点 。register_chrdev 和 unregister chrdev 这 两 个 函数 是 老 版 本 驱动 使 用 的 函数 ， 现 在 新 的 
字符 设备 驱动 已 经 不 再 使 用 这 两 个 函数 ,而 是 使 用 Linux 内 核 推荐 的 新 字符 设备 驱动 API 函数 。 
本 节 我 们 就 来 学 习 一 下 如 何 编 写 新 字符 设备 驱动 ， 并 且 在 驱动 模块 加 载 的 时 候 自动 创建 设备 节 
点 文件 。 
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42.1 新 字符 设备 驱动 原理 


42.1.1 分 配 和 释放 设备 号 


使 用 register_chrdev 函数 注册 字符 设备 的 时 候 只 需要 给 定 一 个 主 设备 号 即 可 ， 但 是 这 样 会 
带 来 两 个 问题 : 

(D、 需 要 我 们 事先 确定 好 哪些 主 设备 号 没有 使 用 。 

包 、 会 将 一 个 主 设备 号 下 的 所 有 次 设备 号 都 使 用 掉 ， 比 如 现在 设置 LED 这 个 主 设备 号 为 
200， 那 么 0~1048575(2^20-1) 这 个 区 间 的 次 设备 号 就 全 部 都 被 LED 一 个 设备 分 走 了 。 这 样 太 浪 
费 次 设备 号 了 ! 一 个 LED 设备 肯定 只 能 有 一 个 主 设备 号 ， 一 个 次 设备 号 。 

解决 这 两 个 问题 最 好 的 方法 就 是 要 使 用 设备 号 的 时 候 向 Linux 内 核 申 请 ， 需 要 几 个 就 申请 
JLA, Bi Linux 内 核 分 配 设备 可 以 使 用 的 设备 号 。 这 个 就 是 我 们 在 40.3.2 小 节 讲 解 的 设备 号 的 
分 配 ， 如 果 没 有 指定 设备 号 的 话 就 使 用 如 下 函数 来 申请 设备 号 : 

intalloc chrdev region(dev t *dev, unsigned baseminor, unsigned count, const char *name) 

如 果 给 定 了 设备 的 主 设备 号 和 次 设备 号 就 使 用 如 下 所 示 函 数 来 注册 设备 号 即 可 : 

int register chrdev region(dev t from, unsigned count, const char *name) 

参数 from 是 要 申请 的 起 始 设备 号 ， 也 就 是 给 定 的 设备 号 ; 参数 count 是 要 申请 的 数量 ， 
般 都 是 一 个 ; 参数 name 是 设备 名 字 。 

注销 字符 设备 之 后 要 释放 掉 设 备 号 ， 不 管 是 通过 alloc chrdev region. 函数 还 是 
register chrdev region 函数 申请 的 设备 号 ， 统 一 使 用 如 下 释放 函数 : 

void unregister chrdev region(dev t from, unsigned count) 
新 字符 设备 驱动 下 ， 设 备 号 分 配 示例 代码 如 下 : 

示例 代码 42.1.1.1 新 字符 设备 驱动 下 设备 号 分 配 




































































HT 































































































1 ine majors /* 主 设备 号 2 
2 int minorş /* 次 设备 号 wy 
3 dev t devid; /* 设备 号 i 
4 

5 sies (uumjox) í /* 定义 了 主 设备 号 m 
6 devid = MKDEV (major, 0); /* 大 部 分 驱动 次 设备 号 都 选择 0 */ 
T register chrdey ee en (le 1, "ues 

8 ) else ( WE ini 
9 alloc chrdev region(&devid, 0, 1, "test"); /* 申请 设备 号 */ 
10 major = MAJOR (devid); /* 获取 分 配 号 的 主 设备 号 */ 
ial minor 2 MINOR (devid); /* 获取 分 配 号 的 次 设备 号 A 
quy 


第 1-3 行 ， 定 义 了 主 / 次 设备 号 变量 major 和 minor， 以 及 设备 号 变量 devido 

第 5 行 ， 判 断 主 设备 号 major 是 否 有 效 ， 在 Linux 驱动 中 一 般 给 出 主 设备 号 的 话 就 表示 这 
个 设备 的 设备 号 已 经 确定 了 ， 因 为 次 设备 号 基本 上 都 选择 0， 这 算 个 Linux 驱动 开发 中 约定 俗 
成 的 一 种 规定 了 。 

第 6 行 ， 如 果 major 有 效 的 话 就 使 用 MKDEYV 来 构建 设备 号 ， 次 设备 号 选择 0。 

第 7 行 ， 使 用 register chrdev region 函数 来 注册 设备 号 。 

第 9~11 行 , 如 果 major 无 效 , 那 就 表示 没有 给 定 设备 号 。 此 时 就 要 使 用 alloc_chrdev_region 
函数 来 申请 设备 号 。 设 备 号 申请 成 功 以 后 使 用 MAJOR 和 MINOR 来 提取 出 主 设备 号 和 次 设备 
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号 ， 当 然 了 ， 第 10 和 11 行 提 取 主 设备 号 和 次 设备 号 的 代码 可 以 不 要 。 
如 果 要 注销 设备 号 的 话 ， 使 用 如 下 代码 即 可 : 
示例 代码 42.1.1.2 cdev 结构 体 
1 unregister chrdev region(devid, 1); /* 注销 设备 号 */ 
注销 设备 号 的 代码 很 简单 。 











42.1.2 新 的 字符 设备 注册 方法 


1、 字 符 设备 结构 


在 Linux 中 使 用 cdev 结构 体 表示 一 个 字符 设备 ，cdev 结构 体 在 include/linux/cdev.h 文件 中 
的 定义 如 下 : 











示例 代码 42.1.2.1 cdev 结构 体 


1 struct cdev ( 

2 struct kobject kog g 

3 struct module *owner; 

4 Const ptruct tile operations "AOI 
5 struct list head liste 

6 qey E dev; 

] unsigned int COUE 

8 }; 





在 cdev 中 有 两 个 重要 的 成 员 变 量 : ops 和 dev， 这 两 个 就 是 字符 设备 文件 操作 函数 集合 
file operations 以 及 设备 号 dev_t。 编 写字 符 设备 驱动 之 前 需要 定义 一 个 cdev 结构 体 变量 ， 这 个 
变量 就 表示 一 个 字符 设备 ， 如 下 所 示 : 

struct cdev test cdev; 


2. cdev init 函数 
定义 好 cdev 变量 以 后 就 要 使 用 cdev init 函数 对 其 进行 初始 化 ，cdev_init 函数 原型 如 下 : 
void cdev init(struct cdev *cdev, const struct file operations *fops) 
参数 cdev 就 是 要 初始 化 的 cdev 结构 体 变量 ， 参 数 fops 就 是 字符 设备 文件 操作 函数 集合 。 
使 用 cdev init 函数 初始 化 cdev 变量 的 示例 代码 如 下 : 
示例 代码 42.1.2.2 cdev_init 函数 使 用 示例 代码 


struct cdev testcdev; 



































/* 设备 操作 函数 */ 
statie struct iile Operations de Topa = j| 


.owner — THIS MODULE, 


/* 其 他 具体 的 初始 项 */ 








DE 





testcdev.owner - THIS MODULE; 
0 cdev init(&testcdev, &test fops); /* 初始 化 cdev 结构 体 变量 */ 
3. cdev add 函数 


cdev add 函数 用 于 向 Linux 系统 添加 字符 设备 (cdev 结构 体 变量 )， 首 先 使 用 cdev init 函数 


ESMEECONECORES DECIES COLTS US MU ISO MESS 
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完成 对 cdev 结构 体 变量 的 初始 化 ， 然 后 使 用 cdev add 函数 癌 Linux 系统 添加 这 个 字符 设备 。 

















cdev add 函数 原型 如 下 : 
int cdev_ add(struct cdev *p, dev t dev, unsigned count) 
参数 p 指向 要 添加 的 字符 设备 (cdev 结构 体 变 量 )， 参 数 dev 就 是 设备 所 使 用 的 设备 号 ， 参 
数 count 是 要 添加 的 设备 数量 。 完 善 示例 代码 42.1.2.2， 加 入 cdev_add 函数 ， 内 容 如 下 所 示 : 
示例 代码 42.1.2.2 cdev_add 函数 使 用 示例 























struct cdev testcdev; 


/* 设备 操作 函数 */ 
Static struct tile operationes test Tops - d 


il 
2 
3 
4 
5 .owner — THIS MODULE, 
6 
9 
8 
9) 





/* 其 他 具体 的 初始 项 * / 





testcdev.owner = THIS MODULE; 
10 cdev init(&testcdev, &test fops); /* 初始 化 cdev 结构 体 变 量 */ 
11 edev add(&testcdev, devid, 1); /* 添加 字符 设备 e 
示例 代码 42.1.2.2 就 是 新 的 注册 字符 设备 代码 段 , Linux 内 核 中 大 量 的 字符 设备 驱动 都 是 采 
用 这 种 方法 向 Linux 内 核 添加 字符 设备 。 如 果 在 加 上 示例 代码 42.1.1.1 中 分 配 设备 号 的 程序 ， 
那么 就 它们 一 起 实现 的 就 是 函数 register chrdev 的 功能 。 
3. cdev del 函数 
ERIKS BJ SE PS EE cdev del 函数 从 Linux 内 核 中 删除 相应 的 字符 设备 ，cdev del 
函数 原型 如 下 : 
void cdev del(struct cdev *p) 
参数 p 就 是 要 删除 的 字符 设备 。 如 果 要 删除 字符 设备 ， 参 考 如 下 代码 : 
示例 代码 42.1.2.3 cdev_del 函数 使 用 示例 
1 cdev del(&testcdev); ea 
cdev del 和 unregister chrdev region 这 两 个 函数 合 起 来 的 功能 相当 于 unregister chrdev P 
42.2 自动 创建 设备 节点 
在 前 面 的 Linux 驱动 实验 中 ， 当 我 们 使 用 modprobe 加 载 驱 动 程序 以 后 还 需要 使 用 命令 
“mknod” 手 动 创 建设 备 节点 。 本 节 就 来 讲解 一 下 如 何 实现 自动 创建 设备 节点 ， 在 驱动 中 实现 


自动 创建 设备 节点 的 功能 以 后 ， 使 用 modprobe 加 载 驱动 模块 成 功 的 话 就 会 自动 在 /de 目录 下 创 
建 对 应 的 设备 文件 。 







































































42.2.1 mdev 机 制 


udev 是 一 个 用 户 程 序 ， 在 Linux 下 通过 udev 来 实现 设备 文件 的 创建 与 删除 ，udev 可 以 检 
测 系统 中 硬件 设备 状态 ， 可 以 根据 系统 中 硬件 设备 状态 来 创建 或 者 删除 设备 文件 。 比 如 使 用 
modprobe 命令 成 功 加 载 驱动 模块 以 后 就 自动 在 /dev 目录 下 创建 对 应 的 设备 节点 文件 ,使 用 
rmmod 命令 卸载 驱动 模块 以 后 就 删除 掉 /dev 目录 下 的 设备 节点 文件 。 使 用 busybox 构建 根 文件 
系统 的 时 候 ，busybox 会 创建 一 个 udev 的 简化 版 本 一 mdev， 所 以 在 庶 入 式 Linux 中 我 们 使 用 
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mdev 来 实现 设备 节点 文件 的 自动 创建 与 删除 ，Linux 系统 中 的 热 插 拔 事件 也 由 mdev 管理 ， 在 
letc/init.d/rcS 文件 中 如 下 语句 : 

echo /sbin/mdev > /proc/sys/kernel/hotplug 

上 述 命令 设置 热 插 拔 事件 由 mdev 来 管理 ， 关 于 udev 或 mdev 更 加 详细 的 工作 原理 这 里 就 
不 详细 探讨 了 ， 我 们 重点 来 学 习 一 下 如 何 通过 mdev 来 实现 设备 文件 节点 的 自动 创建 与 删除 。 
















































































42.2.1 创建 和 删除 类 


自动 创建 设备 节点 的 工作 是 在 驱动 程序 的 入 口 函数 中 完成 的 , 一 般 在 cdev_add 函数 后 面 添 
加 自动 创建 设备 节点 相关 代码 。 首 先 要 创建 一 个 class 类 ，class 是 个 结构 体 ， 定 义 在 文件 
include/linux/device.h 里 面 。class_create 是 类 创建 函数 ，class_create 是 个 宏 定义 ， 内 容 如 下 : 
示例 代码 42.2.1.1 class. create 函数 
*define class create(owner, name) N 


(t \ 

























































































i 

2 

3 guste struct lock eless key Jue? 

4 class create(owner, name, & key); N 

5] 

6 
T struct eless w class exests(stiuc: module '"euweer, Const Char snene, 
8 struct lock Class key key) 

根据 上 述 代码 ， 将 宏 class create 展开 以 后 内 容 如 下 : 


struct class *class create (struct module *owner, const char *name) 
class create 一 共有 两 个 参数 ， 参 数 owner ~AN THIS MODULE. 25$ name 是 类 名 字 。 


























返回 值 是 个 指向 结构 体 class 的 指针 ， 也 就 是 创建 的 类 。 
印 载 驱 动 程序 的 时 候 需 要 删除 掉 类 ， 类 删除 函数 为 class_destroy， 函 数 原 型 如 下 : 
void class destroy(struct class *cls); 
参数 cls 就 是 要 删除 的 类 。 

42.2.2 创建 设备 

















上 一 小 节 创 建 好 类 以 后 还 不 能 实现 自动 创建 设备 节点 ， 我 们 还 需要 在 这 个 类 下 创建 一 个 设 
备 。 使 用 device create 函数 在 类 下 面 创建 设备 ，device_create 函数 原型 如 下 : 


struct device *device create(struct class *class, 








struct device ^ *parent, 


dev t devt, 
void *drvdata, 
const char *fmt, ...) 





device create 是 个 可 变 参 数 函 数 ， 参 数 class 就 是 设备 要 创建 哪个 类 下 面 ， 参数 parent 是 父 
设备 ， 一 般 为 NULL， 也 就 是 没有 父 设 备 ; 参数 devt 是 设备 号 ; 参数 drvdata 是 设备 可 能 会 使 用 
的 一 些 数据 ， 一 般 为 NULL; 参数 fmt 是 设备 名 字 ， 如 果 设 置 fmtexxx 的 话 ， 就 会 生成 /dev/xxx 
这 个 设备 文件 。 返 回 值 就 是 创建 好 的 设备 。 

同样 的 ， 印 载 驱 动 的 时 候 需 要 删除 掉 创 建 的 设备 ， 设 备 删 除 函数 为 device_destroy， 函 数 原 
型 如 下 : 

void device destroy(struct class *class, dev t devt) 






































1058 


LMX6U SA XR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
参数 classs 是 要 删除 的 设备 所 处 的 类 ， 参 数 devt 是 要 删除 的 设备 号 。 


42.2.3 参考 示例 


在 驱动 入 口 函数 里 面 创 建 类 和 设备 ， 在 驱动 出 口 函数 里 面 删除 类 和 设备 ， 参 考 示例 如 下 : 
示例 代码 42.2.3.1 创建 /删除 类 /设备 参考 代码 
































1 struct class *class; /* 2& f 

2 struct device *device; /* 设备 E 

3 dev t devid; /* 设备 号 */ 

4 

5 /* 驱动 入 口 函 数 */ 

© otatie tee (oe) 

wt 

8 /* 创建 类  */ 

9 class = class create(THIS MODULE, "xxx"); 
10 /* 创建 设备 */ 

dt device - device create(class, NULL, devid, NULL, "xxx"); 
12 return 0; 

lea 

14 

15 /* 驱动 出 口 函 数 */ 

le ertatie voici _ eirt (eel) 

A, 

18 /* 删除 设备 */ 

1:9 device destroy(newchrled.class, newchrled.devid); 
20 /* 删除 类  */ 

2 Clases destroy (me we eles 

zo N 

28 

24 module init(led init); 


23 module exit (ate desc NT 


42.3 设置 文件 私有 数据 


每 个 硬件 设备 都 有 一 些 属性 , 比如 主 设备 号 (dev_t), 类 (class)、 设备 (device)、 开关 状态 (state) 
等 等 ， 在 编写 驱动 的 时 候 你 可 以 将 这 些 属性 全 部 写成 变量 的 形式 ， 如 下 所 示 : 
示例 代码 42.3.1 变量 形式 的 设备 属性 





























dev t devid; /* 设备 号 */ 
struct cdev cdev; /* cdev ea 
struct Glass velass? /* 次 a 
struct device *device; /* 设备 5 
iL majoz? /* 主 设备 号 */ 
dang mimor? /* 次 设备 号 */ 

















这 样 写 肯定 没有 问题 ， 但 是 这 样 写 不 专业 ! 对 于 一 个 设备 的 所 有 属性 信息 我 们 最 好 将 其 做 
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成 一 个 结构 体 。 编 写 驱 动 open. 函数 的 时 候 将 设备 结构 体 作为 私有 数据 添加 到 设备 文件 中 , 如 下 
所 示 : 








示例 代码 42.3.2 设备 结构 体 作 为 私有 数据 
/* 设备 结构 体 */ 





X. Exe test Cevi 

g dev t devid; /* 设备 号 2, 
E struct eee edev? /* cdev am 
4 Gite Class velass,; [> 并 ud 
5 struct device *device;  /* 设备 */ 
6 siue major? /* 主 设备 号 A 
7 inane. minory /* 次 设备 号 A 
8 hn 

9 





IO struct test dey estoev;? 

Lal 

12 /* open K% */ 

1.3 statice int en (ue inode winode, struct tile vg) 
14 ( 


lis filp-»private data = &testdev; /* 设置 私有 数据 */ 
16 return 0; 
dy 


在 open 函数 里 面 设置 好 私有 数据 以 后 , 在 write. read, close 等 函数 中 直接 读 取 private data 
即 可 得 到 设备 结构 体 。 


42.4 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 8.3 小 节 即 可 。 


42.5 实验 程序 编写 

本 实验 对 应 的 例 程 路 径 为 ， 开 发 板 光盘 -> 2、Linux 驱动 例 程 -> 3_newchrled。 

本 章 实 验 在 上 一 章 实 验 的 基础 上 完成 ， 重 点 是 使 用 了 新 的 字符 设备 驱动 、 设 置 了 文件 私有 
数据 、 添 加 了 自动 创建 设备 节点 相关 内 容 。 



































42.5.1 LED 灯 驱 动 程序 编写 


新 建 名 为 “3 _newchrled” 文 件 夹 ， 然 后 在 3_newchrled 文件 夹 里 面 创建 vscode TFE, TE 
区 命名 为 “newchrled”。 工 程 创 建 好 以 后 新 建 newchrled.c 文件 ， 在 newchrled.c 里 面 输入 如 下 内 









































示例 代码 42.5.1.1 newchtled.c 文件 
1 #include <linux/types.h> 
2m ime lude Xlinux/kernel.h» 
3 #include <linux/delay.h> 
4  $include Xlinux/ide.h» 
5  $include Xlinux/init.h» 
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6  d4include <linux/module.h> 


7 | $include Xlinux/errno.h» 
8 #include «linux/gpio.h» 
9  $include «Xlinux/cdev.h» 
10 #include Xlinux/device.h» 
11 d4include «asm/mach/map.h» 
12 #include «asm/uaccess.h» 


13 4include «asm/io.h» 


15 /大 大 大 大 炎炎 炎炎 火炎 大火 炎 大 炎炎 炎炎 大 火炎 火炎 大火 炎炎 大 炎炎 大大 炎炎 大 炎炎 大 大 大 大 大大 大 大 大 大 大 炎炎 大 大 大 大 大 大 大 大 大 大 大 大 大 


16 Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 


















































17 文件 名 : newchrled.c 

DOSES : 左 忠 凯 

19 版 本 s Vl 

20 描述 : LED 驱动 文件 。 

21 Zh 3 JE 

22 EUER : www.openedv.com 

25 Ba : 初版 V1.0 2019/6/27 左 忠 凯 创建 

24 OKCKCKCKCkCKCkCk kCkCk kCk k Ck kCkCk k kk k kc k k kk Ck kc k Ck kCk Ck k kc k kck kk kc k Ck kck ck kck ck ckck ck ckckck sk ck ke kx f 
25 $define NEWCHRLED CNT 1 EOS Ue 
26 $define NEWCHRLED NAME "newchrled" /* 名 字 */ 
27 s4define LEDOFF 0 ZEE ey 
28 #define LEDON 1 TERRA xii 
29 

30 /* 寄存 器 物理 地 址 */ 

31 #define CCM CCGR1 BASE (0X020C406C) 

32 #define SW MUX GPIO1 IO03 BASE (0X020E0068) 

33 #define SW PAD GPIO1 IO03 BASE (0X020E02F4) 

34 $define GPIO1 DR BASE (0X0209C000) 

35 define GPIO1 GDIR BASE (0x0209C004) 


37 /* 映射 后 的 寄存 器 虚拟 地 址 指针 */ 

SS Statie vorg Tomenm *IDMPXQOU! CCM (CCIGIEUIL p 
59 ā etate Mom cr 0 
40 Statie void  — lomem US PAD GPTOL 0037; 
A tatie void _ iomem “CPIOlL DR 

42 teem me nmol CDU? 





44 /* newchrled 设备 结构 体 */ 


45 struct newchrled dev( 


46 dev t devid; /* 设备 号 */ 
47 struct cdev cdev; /* cdev */ 
48 struct class *class; /* 3& */ 
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49 struct device *device; /* 设备 */ 
50 int major; /* 主 设备 号 */ 
51 int minor; /* 次 设备 号 */ 
52 y; 

53 

54 struct newchrled dev newchrled; /* led 设备 */ 
55 

SG 

57  * Qdescription  : LED4j]Jf/XH] 

58  * @param - sta  : LEDON(0) JJF LED. LEDOFF(1) 关闭 LED 
59  * Qreturn 8 b 

60 Sai 

61 void led switch(u8 sta) 

62 ( 

63 u32 val = 0; 

64 if(sta == LEDON) ( 

65 val -2 readl(GPIOl DR); 

66 val &- «(| << 3); 

67 weitelyval, (NOS DR) P 

68 Jelse if(sta == LEDOFF) ( 

69 val - readl(GPIOl DR); 

70 val|2 (1 «« 3); 

ql wreitel{val, CRIOL_ DR) P 

T2 } 

Ts} 

74 

"E qne 

76  * Qdescription :打开 设备 


77  * Qparam - inode : 传递 给 驱动 的 inode 
78  * Qparam - filp : 设备 文件 ， file 结构 体 有 个 叫做 private data 的 成 员 变 量 








7 一 般 在 open 的 时 候 将 private data 指 癌 设备 结构 体 。 
80 * Qreturn : 0 成 功 ;其 他 失败 
81 */ 


82 static int led open(struct inode *inode, struct file *filp) 
83S í 


84 filp-»private data = &newchrled; /* 设置 私有 数据 */ 
85 return 0; 

86 ) 

87 

Gel. we 


89  * QGdescription  : 从 设备 读 取 数据 
90 * @param - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 
91  * Qparam - buf  : 返回 给 用 户 空间 的 数据 缓冲 区 
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92  * Qparam - cnt  : 要 读 取 的 数据 长 度 

93  * Qparam - offt : 相对 于 文件 首 地 址 的 偏 移 

94  * Qreturn : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 

SS 

25 Statie Gee t lec zeec(suiuct iile TViiljp, Char _ user Aout, 
size t Cmt, loti E VOX) 


OE, 

98 return 0; 

DONE 

100 

dL. y 

102 * Qdescription : 向 设备 写 数据 

103 * 8param - filp : 设备 文件 ， 表 示 打 开 的 文件 描述 符 

104 * Qparam - buf  : 要 写 给 设备 写 入 的 数据 

105 * @param - cnt : 要 写 入 的 数据 长 度 

106 * eparam - offt : 相对 于 文件 首 地 址 的 偏 移 

107 * Qreturn : 写 入 的 字 节 数 ， 如 果 为 负 值 ， 表 示 写 入 失败 

TOB ay 

ToS statie gsize 1 leo vritel(struct tile vifilp, Const cle _ User Dui, 
Size č Cmt, loti t vort) 


























i9) 1 

Lal int retvalue; 

Z unsigned char databuf[1]; 

TIS unsigned char ledstat; 

114 

dL. retvalue = copy from user(databuf, buf, cnt); 
116 if(retvalue « 0) ( 

TET) printk("kernel write failed!NrNin"); 

TES] return -EFAULT; 

WLS } 

120 

121 ledstat = databuf[0]; /* 获取 状态 值  */ 
10222 

123 if(ledstat == LEDON) { 

124 led_switch (LEDON) ; J5s sa AED] 
T25 } else if(ledstat == LEDOFF) { 

126 led switch (LEDOFF) ; /* XH]LEDXJ  */ 
127 } 

3028 return 0; 

129 

T30 

15i cris 


132 * @description : 关闭 /释放 设备 
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133 * @param - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 

134 * Qreturn : 0 成 功 ;其 他 失败 

i55 € 

1.9365 tatie int Lad :zelesse(sirucit inode vinode, struct tile vrtila) 
Sv 

138 return 0; 

3:99). 3 

140 

141 /* 设备 操作 函数 */ 

14:7. tetic struct iile operatione newchrled tops 3 i 
143 .owner = THIS MODULE, 

144 .open = led open, 

145 .read = led read, 

146 .write > led write, 

147 muacilegscc-accdgmeskecdsor 

148 py; 

149 

150s 

151 * @description : 驱动 出 口 函 数 

5 8 JE 

lgs ence 8 Àb 

db. ms 

15/5 starie ime — imite les 3t (voto) 

T SIME 

LSF u32 val 2 0; 

T58 


159 /* 初始 化 LED */ 
160 /* 1、 寄 存 器 地 址 映射 */ 




















161 IMX6U CCM CCGRI 2 ioremap(CCM CCGR1 BASE, 4); 

162 SW MUX GPIO1 IO03 = ioremap(SW MUX GPIO1 1003 BASE, 4); 
163 SW PAD GPIOl IO03 = ioremap(SW PAD GPIO1 1003 BASE, 4); 
164 GPIOL1 DR -2 ioremap(GPIOl1 DR BASE, 4); 

JE) GPIOI1 GDIR = ioremap(GPIO1 GDIR BASE, 4); 

166 

167 /* 2、 使 能 GBIO1T mieh */ 

168 val = readl(IMX6U CCM CCGR1); 

169 val &- «(3 << 26); /* 清楚 以 前 的 设置 */ 

170 val |= (3 << 26);  /* WES */ 

JE LE writel(val, IMX6U CCM CCGRI1); 

12 

US /* 3. RE cP1O1 1003 的 复 用 功能 ， 将 其 复 用 为 

174 * — GPIOl IT003， 最 后 设置 TO 属性。 

dy) +y 
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176 writel(5, SW MUX GPIO1 IO03); 

dog 

178 /* 寄存 器 SW PAD GPIO1 IO03 设置 Io 属性 */ 
179 writel(0x10B0, SW PAD GPIOl IO03); 

180 

181 /* 4, W'EGPIOl 1003 为 输出 功能 */ 

1192 val —- readl(GPIO1 GDIR); 

183 val &= «(1 << 3);  /* 清除 以 前 的 设置 */ 
184 val |= (1 << 3); /* 设置 为 输出 */ 

15 writel(val, GPIO1 GDIR); 

186 

187 /* 5. BNWKHI LED */ 

188 val = readl(GPIO1 DR); 

199 val | (1 «« 3); 

190 weitel (val, CGPIOL DR) g 

Toi 


192 /* 注册 字符 设备 驱动 */ 
193 /* 1、 创 建设 备 号 */ 


194 if (newchrled.major) { /* 定义 了 设备 号 */ 

195 newchrled.devid = MKDEV (newchrled.major, 0); 

196 register chrdev region(newchrled.devid, NEWCHRLED CNT, 

NEWCHRLED NAME); 

197 ) else ( /* 没有 定义 设备 号 */ 

198 alloc chrdev region(&newchrled.devid, 0, NEWCHRLED CNT, 
NEWCHRLED NAME); /* 申请 设备 号 */ 

199 newchrled.major = MAJOR(newchrled.devid); /* 获取 主 设备 号 */ 

200 newchrled.minor = MINOR(newchrled.devid); /* 获取 次 设备 号 */ 

201 } 

202 printk("newcheled major=%d,minor=%d\r\n",newchrled.major, 


newchrled.minor); 


203 

204 /* 2、 初 始 化 cdev */ 

205 newchrled.cdev.owner = THIS MODULE; 

206 cdev init(&newchrled.cdev, &newchrled fops); 

207 

208 /* 3、 添 加 一 个 cdev */ 

209 cdev add(&newchrled.cdev, newchrled.devid, NEWCHRLED CNT); 
210 

a /* 4、 创 建 类 */ 

212 newchrled.class = class create(THIS MODULE, NEWCHRLED NAME); 
213 if (IS ERR(newchrled.class)) ( 

214 return PTR ERR(newchrled.class); 

215 } 
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216 

217 /* 5、 创 建设 备 */ 

218 newchrled.device = device create(newchrled.class, NULL, 
newchrled.devid, NULL, NEWCHRLED NAME); 

219 if (IS ERR(newchrled.device)) ( 

220 return PTR ERR(newchrled.device); 

227 } 

222 

2 return 0; 

2243 

29215) 

2o gu 

227 * Qdescription : JkzJt Heg 

228 * Gparam S JE 

229 * Qreturn & JE 

ISDN UA 

22i ertacie voci — ekir led exit (votcii) 

232 ( 

Pss /* 取消 映射 */ 

294 iounmap(IMX6U CCM CCGR1); 

235 iounmap(SW MUX GPIO1 1003); 

236 iounmap(SW PAD GPIO1 IO03); 

2 iounmap(GPIO1 DR); 

238 iounmap(GPIOl GDIR); 

289 

240 /* 注销 字符 设备 */ 

241 cdev del(&newchrled.cdev);/* 删除 cdev */ 

242 unregister chrdev region(newchrled.devid, NEWCHRLED CNT); 

243 

244 device destroy (newchrled.class, newchrled.devid); 

245 class destroy (newchrled.class); 

246 } 

247 

248 module init(led rnit); 

24/5 module ext (led exi) 

250 MODU ER LICENSE ("GPL") E 

251 MODULE AUTHOR ("zuozhongkai"); 


第 25 ÍT, Z NEWCHRLED CNT 表示 设备 数量 ， 在 申请 设备 号 或 者 向 Linux. 内 核 添 加 字 























符 设 备 的 时 候 需 要 设置 设备 数量 ， 一 般 我 们 一 个 驱动 一 个 设备 ， 所 以 这 个 宏 为 1。 


第 26 fT. "E NEWCHRLED NAME 表示 设备 名 字 ， 本 实验 的 设备 名 为 “newchrdev” 为 了 
理 ， 所 有 使 用 到 设备 名 字 的 地 方 统一 使 用 此 宏 ， 当 驱动 加 载 成 功 以 后 就 生成 


方便 


AY 
^E 
二 | 









































/dev/newchrled 这 个 设备 文件 。 
第 44—52 行 ， 创 建设 备 结构 体 newchrled_dev。 
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第 54 行 ， 定义 一 个 设备 结构 体 变 量 newchrdev， 此 变量 表示 led 设备 。 














第 82~86 行 ， 在 led_open 函数 中 设置 文件 的 私有 数据 private_data 指向 newchrdev。 

第 194-221 行 ， 根 据 前 面 讲解 的 方法 在 驱动 入 口 函数 led. init 中 申请 设备 号 、 2r 
备 、 创 建 类 和 设备 。 本 实验 我 们 采用 动态 申请 设备 号 的 方法 ， 第 202 行使 用 printk 在 终端 上 显 
示 出 申请 到 的 主 设备 号 和 次 设备 号 。 

第 241~245 行 ， 根 据 前 面 讲解 的 方法 ， 在 驱动 出 口 函数 led_exit 中 注销 字符 新 设备 、 删 除 
类 和 设备 。 
总 体 来 说 newchrled.c 文件 中 的 内 容 不 复杂 , LED 灯 驱 动 部 分 的 程序 和 上 一 章 一 样 。 重 点 就 
是 使 用 了 新 的 字符 设备 驱动 方法 。 




































































p 











42.5.2 编写 测试 APP 
本 章 直 接 使 用 上 一 章 的 测试 APP， 将 上 一 章 的 ledApp.c 文件 复制 到 本 章 实验 工程 下 即 可 。 






































42.6 运行 测试 
42.6.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱 动 程序 
编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 newchrled.o，Makefile 内 容 如 下 所 示 : 
示例 代码 42.6.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
rel imk 4al- ilb 25.150 ee esemuek 






































4 obj-m := newchrled.o.o 
11 clean: 
12 $(MAKE) -C $(KERNELDIR) M=$ (CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 newchrled.o。 
输入 如 下 命令 编译 出 驱动 模块 文件 : 
make -j32 
编译 成 功 以 后 就 会 生成 一 个 名 为 “newchrled.ko” 的 驱动 模块 文件 。 
、 编 译 测试 APP 
输入 如 下 命令 编译 测试 ledApp.c 这 个 测试 程序 : 


arm-linux-gnueabihf-gcc ledApp.c -o ledApp 
编译 成 功 以 后 就 会 生成 led A pp 这 个 应 用 程序 。 























N 











42.6.2 运行 测试 


将 上 一 小 节 编 译 出 来 的 newchrled.ko 和 ledApp 这 两 个 文件 拷贝 到 rootfs/lib/modules/4.1.15 
目录 中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 加 载 newchrled.ko 驱动 
模块 : 

depmod // 第 一 次 加 载 驱动 的 时 候 需 要 运行 此 命令 
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modprobe newchrled.ko /加 载 驱 动 
驱动 加 载 成 功 以 后 会 输出 申请 到 的 主 设备 号 和 次 设备 号 ， 如 图 42.6.2.1 所 示 : 


/lib/modules/4.1.15 # modprobe newchrled.ko 
newcheled majorz249,minorzO 
/lib/modules/4.1.15 # 


图 42.62.1 申请 到 的 主 设备 号 和 次 设备 号 
从 图 42.6.2.1 可 以 看 出 ， 申 请 到 的 主 设备 号 为 249， 次 设备 号 为 0。 驱动 加 载 成 功 以 后 会 自 
动 在 /dev 目录 下 创建 设备 节点 文件 /dev/newchrdev， 输 入 如 下 命令 查看 /dev/newchrdev 这 个 设备 
节点 文件 是 否 存 在 : 
ls /dev/newchrled -1 
结果 如 图 42.6.2.2 所 示 : 


dead 1.15 £ 1s NI a -] 
Ccrw-rw---- 10 0 249, 0 Jan 1 05:56 /dev/newchrled 
/lib/modules/4.1.15 # 


























图 42.6.2.2 /dev/newchrled 设备 节点 文件 

从 图 42.6.2.2 中 可 以 看 出 ，/devnewchrled 这 个 设备 文件 存在 ， 而 且 主 设备 号 为 249， 此 设 
备 号 为 0， 说 明 设 备 节点 文件 创建 成 功 。 

驱动 节点 创建 成 功 以 后 就 可 以 使 用 ledApp 软件 来 测试 驱动 是 否 工 作 正 常 ,输入 如 下 命令 打 
F LED A]: 

/ledApp /dev/newchrled 1 /打开 LED 4T 

输入 上 述 命令 以 后 观察 LMX6U-ALPHA 开发 板 上 的 红色 LED 灯 是 否 点 亮 ， 如 果 点 亮 的 话 
说 明 驱 动工 作 正常 。 在 输入 如 下 命令 关闭 LED 灯 : 

.ledApp /dev/newchrled 0 IRA LED 灯 
输入 上 述 命令 以 后 观察 LMX6U-ALPHA 开发 板 上 的 红色 LED TEREK B AR SEE BUE 
动 的 话 输入 如 下 命令 即 可 : 


Immod newchrled.ko 























ES 
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第 四 十 三 章 Linux 设备 树 


因为 时 机 未 到 ， 所 以 当时 并 没有 详细 的 讲 





前 面 章 节 中 我 们 多 次 提 到 “设备 树 ” 这 个 概念 ， 





备 的 技能 ! 








ERARE Linux 驱动 开发 人 员 必 
因为 在 新 版 本 的 Linux F, ARM 相关 的 驱动 全 部 采用 了 设备 树 (也 有 文 持 老式 驱动 
HE STM32MP157、 





的 谈 一 谈 设备 树 。 学 





解 什么 是 “设备 树 ” 本章 我 们 就 来 详 














的 , 比较 少 ), 最 新 出 的 CPU 其 驱动 开发 也 基本 都 是 基于 设备 树 的 ,比如 ST 新 
NXP 的 IMX8 系列 等 ,我 们 所 使 用 的 Linux 版 本 为 4.1.15, 其 支持 设备 树 , 所 以 了 
ALPHA 开发 板 的 所 有 Linux 驱动 都 是 基于 设备 树 的 。 本 章 我 们 就 来 了 解 一 下 设备 树 的 起 源 、 
点 学 习 一 下 设备 树 语 法 。 




















limi 
Wd 
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43.1 什么 是 设备 树 ? 


设备 树 (Device Tree), 将 这 个 词 分 开 就 是 “设备 ”和 “ 树 ”, 描述 设备 树 的 文件 叫做 DTS(Device 
Tree Source)， 这 个 DTS 文件 采用 树 形 结构 描述 板 级 设备 ， 也 就 是 开发 板 上 的 设备 信息 ， 比 如 
CPU 数量 、 内 存 基地 址 、IC 接口 上 接 了 哪些 设备 、SPI 接口 上 接 了 哪些 设备 等 等 ,如 图 43.1.1 
所 示 : 











图 43.1.1 设备 树 结 构 示 意图 
在 图 43.1.1 中 ， 树 的 主干 就 是 系统 总 线 ，IIC 控制 器 、GPIO 控制 器 、SPI 控制 器 等 都 是 接 
到 系统 主线 上 的 分 支 .IIC 控制 器 有 分 为 ICl 和 ItC2 两 种 ,其 中 IICl 上 接 了 FT5206 和 AT24C02 
这 两 个 IIC 设备 ，IIC2 上 值 接 了 MPU6050 这 个 设备 。DTS 文件 的 主要 功能 就 是 按照 图 43.1.1 




















所 示 的 结构 来 描述 板子 上 的 设备 信息 ，DTS 文件 描述 设备 信息 是 有 相应 的 语法 规则 要 求 的 ， 稍 
后 我 们 会 详细 的 讲解 DTS 语法 规则 。 
在 3.x 版 本 (有 具体 哪个 版 本 笔者 也 无 从 考证 ) 以 前 的 Linux 内 核 中 ARM 架构 并 没有 采用 设备 
树 。 在 没有 设备 树 的 时 候 Linux 是 如 何 描述 ARM 架构 中 的 板 级 信息 呢 ? 在 Linux 内 核 源码 中 
大 量 的 arch/arm/mach-xxx 和 arch/arm/plat-xxx 文件 夹 ， 这 些 文件 夹 里 面 的 文件 就 是 对 应 平台 下 
的 板 级 信息 。 比 如 在 arch/arm/mach-smdk2440.c 中 有 如 下 内 容 ( 有 缩减 ): 

示例 代码 43.1.1 mach-smdk2440.c 文件 代码 段 
90 static struct s3c2410fb display smdk2440 lcd cfg X initdata = ( 
el 


























92 .lcdcon5 — 5$3C2410 LCDCON5 FRM565 | 
93 S3C2410 LCDCON5 INVVLINE | 
94 S3C2410 LCDCON5 INVVFRAME | 
95 S3C2410 LCDCON5 PWREN | 

96 S3C2410 LCDCON5 HWSWP, 

Tuus 

114 
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155 gtatic struct plattorm device vewaclhs2440 devices ntEeEES — i 


116 .displays = &smdk2440 lcd cfg, 
db gi .num displays  -2 1, 
118 .default display = 0, 
195. h 

134 

1536 &cccadevsccleh ene 

ES CSC Cevice ec 

138 &s3c device wdt, 

19 CSIC Cevice 12c0, 

Ieo tese Cevice Lis, 

141 s 











上 述 代码 中 的 结构 体 变 量 smdk2440 fb info 就 是 描述 SMDK2440 这 个 开发 板 上 的 LCD 信 
息 的， 结构 体 指针 数组 smdk2440 devices 描述 的 SMDK2440 这 个 开发 板 上 的 所 以 平台 相关 信 
息 。 这 个 仅仅 是 使 用 2440 这 个 芯片 的 SMDK2440 开发 板 下 的 LCD 信息 ，SMDK2440 开发 板 
还 有 很 多 的 其 他 外 设 硬 件 和 平台 硬件 信息 。 使 用 2440 这 个 芯片 的 板子 有 很 多 ,每 个 板子 都 有 描 
述 相应 板 级 信息 的 文件 ， 这 仅仅 只 是 一 个 2440。 随 着 智能 手机 的 发 展 ， 每 年 新 出 的 ARM 架构 















































e 


gu 








芯片 少 说 都 在 数 十 、 数 百 款 ，Linux 内 核 下 板 级 信息 


文件 将 



































会 成 指数 级 增长 ! 这 些 板 级 信息 文件 


都 是 .c 或 .hb 文件 ， 都 会 被 硬 编码 进 Linux 内 核 中 ， 导 致 Linux 内 核 “ 虚 胖 ”。 就 好 比 你 喜欢 吃 自 














助 餐 ， 然 后 花 了 100 a dob 自助 餐厅 ， 结 果 你 想 吃 的 牛排 、 海 鲜 、 烤 肉 基 
Et 时 肯定 会 脱口 而 出 一 句 “F*k!”、 
区 向 Linux 内 核 添 加 了 大 量 “ 无 用 ” 元 余 





d 





本 没 多 少 , 全 都 是 一 些 凉菜 、 炒 面 、 





























j 瓜 、 饮 料 等 小 吃 , 相信 你 此 
“骗子 !”。 同 样 的 ， 当 Linux 之 父 linus 看 到 ARM žE 















































的 板 级 信息 文件 ， 不 禁 的 发 出 了 一 名 “This whole ARM thing is a f*cking pain intheass”。 从 此 以 
后 ARM 社区 就 引入 了 PowerPC 等 架构 已 经 采用 的 设备 树 (Flattened Device Tree)， 将 这 些 描述 
板 级 硬件 信息 的 内 容 都 从 Linux 内 中 分 离开 来 ， 用 一 个 专属 的 文件 格式 来 描述 ， 这 个 专属 的 文 





























件 就 叫做 设备 树 ， 文 件 扩展 名 为 .dts。 一 个 SOC 可 以 作出 很 多 不 同 的 板子 ， 这 些 不 同 的 板子 肯 





定 是 有 共同 的 信息 ， 将 这 些 共 < 同 的 信 ， 忆 提 取出 来 作为 一 个 通用 的 文件 ， 其 他 的 .dts 文件 直接 引 



































JLA CPU、 主 频 是 多 少 、 各 个 外 设 控 制 器 信息 等 )。 














用 这 个 通用 文件 即 可 ， 这 个 通用 文件 就 是 .dtsi 文件 ， 类 似 于 C 语言 中 的 头 文件 。 一 般 .dts 描述 
板 级 信息 (也 就 是 开发 板 上 有 哪些 IC 设备 、SPI 设备 等 )，.dtsi 描述 SOC 级 信息 (也 就 是 SOC 有 





这 个 就 是 设备 树 的 由 来 ,， 简 而 言 之 就 是 ， Linux 内 核 中 ARM 架构 下 有 太 多 的 了 元 余 的 垃圾 板 
级 信息 文件 ， 导 致 linus 震怒 ， 然 后 ARM 社区 引入 了 设备 树 。 


43.2 DTS, DTB 和 DTC 








上 一 小节 说 了 ， 设 备 树 源 文件 扩展 名 为 .dts， 但 是 我 们 在 前 面 移植 Linux 的 时 候 却 一 直 在 使 












































用 到 gcc 编译 器 ， 那 么 将 .dts 编译 为 .dtb 需要 什么 














HR. 





一 一 一 

















用 .dtb 文件 ， 那 么 DTS 和 DTB 这 两 个 文件 是 什么 关系 呢 ? DTS 是 设备 树 源 码 文件 ，DTB 是 将 
DTS 编译 以 后 得 到 的 二 进 制 文件 ，Linux 内 核 和 uboot 


只 能 DTB 文件 。 将 .c 文件 编译 为 .o 需要 














HE? TE) 











到 DTC 工具 ! DTC 工具 源码 


在 Linux 内 核 的 scripts/dtc 目录 下 ，scripts/dtc/Makefile 文件 内 容 如 下 : 
示例 代码 43.2.1 scripts/dtc/Makefile 文件 代码 段 





es Y= oue 
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2 always se (ne ere s) 

3 

4 dtc-objs:- dtc.o flattree.o fstree.o data.o livetree.o treesource.o \ 
5 Guecpxos.0 cleclke.o CELLO 

6 dtc-objs ts dtc-lexer.lex.o dtc-parser.tab.o 


可 以 看 出 ，DTC 工具 依赖 于 dtc.c. flattree.c. fstree.c 等 文件 ， 最 终 编译 并 链接 出 DTC 这 
个 主机 文件 。 如 果 要 编译 DTS 文件 的 话 只 需要 进入 到 Linux 源码 根 目录 下 ， 然 后 执行 如 下 命 
































make all 

或 者 : 

make dtbs 

“make all” 命 令 是 编译 Linux 源码 中 的 所 有 东西 ， 包 括 zImage，.ko 驱动 模块 以 及 设备 
树 ， 如 果 只 是 编译 设备 树 的 话 建议 使 用 “make dtbs” 命 令 。 
基于 ARM 架构 的 SOC 有 很 多 种 ， 一 种 SOC 又 可 以 制作 出 很 多 款 板子 ， 每 个 板子 都 有 一 
个 对 应 的 DTS 文件 ， 那 么 如 何 确定 编译 哪 一 个 DTS 文件 呢 ? 我 们 就 以 LMX6ULL 3X xoc Hr] 
应 的 板子 为 例 来 看 一 下 ， 打 开 arch/arm/boot/dts/Makefile， 有 如 下 内 容 : 
示例 代码 43.2.2 arch/arm/boot/dts/Makefile 文件 代码 段 

































































381 dtb-$(CONFIG SOC IMX6UL) += \ 

382 imx6ul-14x14-ddr3-arm2.dtb \ 

383 imx6ul-14x14-ddr3-arm2-emmc.dtb N 

400 dtb-S$(CONFIG SOC IMX6ULL) t= N 

401 imx6ull-14x14-ddr3-arm2.dtb N 

402 imx6ull-14x14-ddr3-arm2-adc.dtb N 

403 imx6ull-14x14-ddr3-arm2-cs42888.dtb Y 
404 imx6ull-14x14-ddr3-arm2-ecspi.dtb N 
405 imx6ull-14x14-ddr3-arm2-emmc.dtb \ 

406 Imel- 1L 4] — dele -arm -cpeele solis N 

407 imx6ull-14x14-ddr3-arm2-flexcan2.dtb N 
408 imx6ull-14x14-ddr3-arm2-gpmi-weim.dtb 
409 imx6ull-14x14-ddr3-arm2-lcdif.dtb VN 
410 imx6ull-14x14-ddr3-arm2-ldo.dtb N 

411 imx6ull-14x14-ddr3-arm2-qspi.dtb N 

412 sluges oo 1L 1. 1L Als 1L 4L — elebe; S — eet 2 -gepi -all dts \ 
413 imx6ull-14x14-ddr3-arm2-tsc.dtb \ 

414 imx6ull-14x14-ddr3-arm2-uart2.dtb N 
415 imx6ull-14x14-ddr3-arm2-usb.dtb Yy 

416 imx6ull-14x14-ddr3-arm2-wm8958.dtb N 
417 imx6ull-14xl4-evk.dtb \ 

418 imx6ull-14xl4-evk-btwifi.dtb \ 

419 imx6ull-14xl4-evk-emmc.dtb \ 

420 imx6ull-14xl4-evk-gpmi-weim.dtb \ 
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421 imx6ull-14xl4-evk-usb-certi.dtb N 

422 imx6ull-alientek-emmc.dtb \ 

423 imx6ull-alientek-nand.dtb \ 

424 imx6ull-9x9-evk.dtb y 

125 imx6ull-9x9-evk-btwifi.dtb N 

426 imx6ull-9x9-evk-ldo.dtb 

427 dtb-$ (CONFIG SOC IMX6SLL) += \ 

428 imx6sll-lpddr2-arm2.dtb N 

429 imx6sll-lpddr3-arm2.dtb \ 





可 以 看 出 ， 当 选中 LMX6ULL 这 个 SOC 以 后 (CONFIG SOC IMX6ULL=y)， 所 有 使 用 到 
LMX6ULL 这 个 SOC 的 板子 对 应 的 .dts 文件 都 会 被 编译 为 .dtb。 如 果 我 们 使 用 ILMX6ULL 新 做 
了 一 个 板子 ， 只 需要 新 建 一 个 此 板子 对 应 的 .dts 文件 ， 然 后 将 对 应 的 .dtb 文件 名 添加 到 dtb- 
$(CONFIG_SOC_IMX6ULL) F , 这 样 在 编译 设备 树 的 时 候 就 会 将 对 应 的 .dts 编译 为 二 进 制 的 .dtb 
文件 。 

示例 代码 43.2.2 中 第 422 和 423 行 就 是 我 们 在 给 正点 原子 的 IMX6U-ALPHA 开发 板 移植 
Linux 系统 的 时 候 添 加 的 设备 树 。 关 于 .dtb 文件 怎么 使 用 这 里 就 不 多 说 了 ， 前 面 讲 解 Uboot 移 
IH. Linux 内 核 移植 的 时 候 已 经 无 数 次 的 提 到 如 何 使 用 .dtb 文件 了 (uboot 中 使 用 bootz 或 bootm 
命令 向 Linux 内 核 传 递 二 进 制 设备 树 文 件 (.dtb))。 



















































































43.3 DTS 语法 


虽然 我 们 基本 上 不 会 从 头 到 尾 重 写 一 个 .dts 文件 ， 大 多 时 候 是 直接 在 SOC 厂商 提供 的 .dts 
文件 上 进行 修改 。 但 是 DIS 文件 语法 我 们 还 是 需要 详细 的 学 习 一 遍 , 因为 我 们 肯定 需要 修改 .dts 
文件 。 大 家 不 要 看 到 要 学 习 新 的 语法 就 觉得 会 很 复杂 ，DTS 语法 非常 的 人 性 化 ， 是 一 种 ASCII 
文本 文件 ， 不 管 是 阅读 还 是 修改 都 很 方便 。 

本 节 我 们 就 以 imx6ull-alientek-emmc.dts 这 个 文件 为 例 来 讲解 一 下 DTS 语法 。 关 于 设备 树 
详细 的 语法 规则 请 参考 《 Devicetree SpecificationV02pdf 》 和 
(Power ePAPR. APPROVED _v1.12.pdf》 这 两 份 文档 ， 此 两 份 文档 已 经 放 到 了 开发 板 光盘 中 ， 
路 径 为 : 4、 参 考 资 料 ->Devicetree SpecificationV0.2.pdf 、4 、 参 考 资 料 -> 

Power ePAPR APPROVED vl.12.pdf 










































































43.3.1 .dtsi 头 文件 


TI C 语言 一 样 ， 设 备 树 也 支持 头 文件 ， 设 备 树 的 头 文件 扩展 名 为 .dtsi。 在 imx6ull-alientek- 

emmc.dts 中 有 如 下 所 示 内 容 : 
示例 代码 43.3.1.1 imx6ull-alientek-emmc.dts 文件 代码 段 

12 #include <dt-bindings/input/input.h> 
13 £$include mo 

第 12 fr, EH "stinclude" 2K5| H]. "input.h" XSh 头 文件 。 

第 13 fT, WEH "include" 5&5] H]. *imxóull.dtsi" 3X4P.dtsi 头 文件 。 

看 到 这 里 ， 大 家 可 能 会 疑惑 ， 不 是 说 设备 树 的 扩展 名 是 .dtsi B? 为 什么 也 可 以 直接 引用 C 
语言 中 的 .h 头 文件 呢 ? 这 里 并 没有 错 ，.dts 文件 引用 C 语言 中 的 .h 文件 , 甚至 也 可 以 引用 .dts X 
牛 ， 打 开 imx6ull-14x14-evk-gpmi-weim.dts 这 个 文件 ， 此 文件 中 有 如 下 内 容 : 
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示例 代码 43.3.1.2 imx6ull-14x14-evk-gpmi-weim.dts 文件 代码 段 
9 d$include "imx6ull-14x14-evk.dts" 
可 以 看 出 ， 示 例 代码 43.3.1.2 中 直接 引用 了 .dts 文件 ， 因 此 在 .dts 设备 树 文 件 中 ， 可 以 通过 
“#include” 2K.h. .dtsi 和 .dts 文件 。 只是, 我 们 在 编写 设备 树 头 文件 的 时 候 最 好 选择 .dtsi Je: 28 

















一 般 .dtsi 文件 用 于 描述 SOC 的 内 部 外 设 信息 ， 比 如 CPU 架构 、 主 频 、 外 设 寄存 器 地 址 范 
围 ， 比 如 UART, IC 等 等 。 比 如 imx6ull.dtsi 就 是 描述 LMX6ULL 这 果 SOC. 内 部 外 设 情况 信息 
的 ， 内 容 如 下 : 









































示例 代码 43.3.1.3 imxGull.dtsi 文件 代码 段 
10 #include «dt-bindings/clock/imx6ul-clock.h» 
11  £$include «dt-bindings/gpio/gpio.h» 
312 finclude «dt-bindings/interrupt-controller/arm-gic.h» 
13 finclude "imx6ull-pinfunc.h" 
14 finclude "imx6ull-pinfunc-snvs.h" 


WS #include "skeleton.dtsi" 





16 

D: 

18 aliases ( 

1.9 can0 = &flexcanl; 

48 }; 

49 

50 cpus ( 

Sal #address-cells = <1>; 

J2 #size-cells = <0>; 

S 

54 cpu0: cpuGO ( 

55 compatible = "arm,cortex-a7"; 
56 device type -2 "cpu"; 

89 }; 

90 }; 

om 

D7 intc: interrupt-controller800a01000 ( 
93 compatible = "arm,cortex-a7-gic"; 
94 finterrupt-cells = «3»; 

95 interrupt-controller; 

96 reg = «0x00a01000 0x1000», 

97 «0x00a02000 0x100»; 

98 }; 

99 

100 cile eas 

101 faddress-cells = «1»; 

102 fsize-cells = «0»; 
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103 

104 Gkils qeleee 1 

105 compatible = "fixed-clock"; 

106 reg = «0»; 

ON #clock-cells = <0>; 

108 clock-frequency = <32768>; 

TOS) clock-output-names - "ckil"; 
110 }; 

T5 bs 

136 

ey soc ( 

138 #address-cells = <1>; 

NS fsize-cells = «1»; 

140 compatible = "simple-bus"; 

141 interrupt-parent = X«&gpc»; 

142 ranges; 

143 

144 busfreq ( 

145 compatible 2 "fsl,imx busfreq"; 
162 }; 

15977 

198 gpmi: gpmi-nand801806000( 

LIS Som ele em ne nl O 
nand" 

200 #address-cells = <1>; 

201 #size-cells = <1>; 

202 reg = «0x01806000 0x2000», «0x01808000 0x4000»; 
216 }; 

ol F 

MVE Ip 





示例 代码 43.3.1.3 中 第 54-89 cpu0 这 个 设备 节点 信息 ， 这 个 节点 信息 描述 了 
I.MX6ULL 这 颗 SOC 所 使 用 的 CPU 信息 , 比如 架构 是 cortex-A7, 频率 支持 996MHz、792MHz、 
528MHz、396MHz 和 198MHz 等 等 ,在 imx6ull.dtsi 文件 中 不 仅仅 描述 了 cpu0 这 一 个 节点 信息 ， 
LMX6ULL 这 颗 SOC 所 有 的 外 设 都 描述 的 清 清楚 楚 , 比如 ecspil~4、uartl~8、usbphy1~2、i2c1~4 
等 等 ， 关 于 这 些 设备 节点 信息 的 具体 内 容 我 们 稍 后 在 详细 的 讲解 。 
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43.3.2 设备 节点 
设备 树 是 采用 树 形 结构 来 描述 板子 上 的 设备 信息 的 文件 ， 每 个 设备 都 是 一 个 节点 ， 叫 做 设 























备 节 点 ， 每 个 节点 都 通过 一 些 属 性 信息 来 描述 节点 信息 ， 属 性 就 是 键 一 值 对 。 一 下 是 从 
imx6ull.dtsi 文件 中 缩减 出 来 的 设备 树 文件 内 容 : 
示例 代码 43.3.2.1 设备 树 模板 











L y 

2 aliases { 

3 can0 = &flexcanl; 

4 }; 

5 

6 cpus ( 

y #address-cells = <1>; 

8 #size-cells = <0>; 

9 

10 ejow 0S Gu | 

BUNTE compatible = "arm,cortex-a7"; 
12 device type 5 "cpu"; 

JS reg = «0»; 

14 }; 

5 Ig 

16 

I intc: interrupt-controller&800a01000 ( 
18 compatible - "arm,cortex-a7/-gic"; 
1139) #interrupt-cells = <3>; 

20 interrupt-controller; 

2al reg = <0x00a01000 0x1000>, 

2 <0x00a02000 0x100>; 

25 Dg 

24 } 


第 1 行 ,“/” 是 根 节点 ,每 个 设备 树 文件 只 有 一 个 根 节点 ,细心 的 同学 应 该 会 发 现 ,imx6ull.dtsi 
和 imx6ull-alientek-emmc.dts 这 两 个 文件 都 有 一 个 “/” 根 节点 ， 这 样 不 会 出 错 吗 ? 不 会 的 ， 因 为 
这 两 个 “/” 根 节点 的 内 容 会 合并 成 一 个 根 节点 。 

第 2、6 和 17 行 ，aliases、cpus 和 intc 是 三 个 子 节 点 ， 在 设备 树 中 节点 命名 格式 如 下 ; 

node-name@unit-address 

其 中 “node-name” 是 节点 名 字 ,， 为 ASCII 字符 串 ， 节 点 名 字 应 该 能 够 清晰 的 描述 出 节点 的 
功能 ， 比 如 “uartl ”就 表示 这 个 节点 是 UART1 外 设 。“unit-address ”一般 表示 设备 的 地 址 或 寄 
存 器 首 地 址 ， 如 果 某 个 节点 没有 地 址 或 者 寄存 器 的 话 “unit-address” 可 以 不 要 , 比如 “cpu@0”、 
“interrupt-controller@00a01000”。 

但 是 我 们 在 示例 代码 43.3.2.1 中 我 们 看 到 的 节点 命名 却 如 下 所 示 : 

cpu0:cpu(a)0 

上 述 命令 并 不 是 “node-name@unitraddress” 这 样 的 格式 , 而 是 用 “:” 隔 开 成 了 两 部 分 ,“:” 
前 面 的 是 节点 标签 (label),“: ”后 面 的 才 是 节点 名 字 ， 格 式 如 下 所 示 : 
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label: node-name(@unit-address 

引入 label 的 目的 就 是 为 了 方便 访问 节点 , 可 以 直接 通过 &label 来 访问 这 个 节点 ， 比 如 通过 
&cpu0 就 可 以 访问 “cpu@0” 这 个 节点 ， 而 不 需要 输入 完整 的 节点 名 字 。 再 比如 节点 “inte: 
interrupt-controller@00a01000”， 节 点 label 是 intc， 而 节点 名 字 就 很 长 了 ， 为 “interrupt- 
controller@00a01000”。 很 明显 通过 &intc 来 访问 “interrupt-controller@00a01000” 这 个 节点 要 方 
便 很 多 ! 

第 10 行 ，cpu0 也 是 一 个 节点 ， 只 是 cpu0 是 cpus 的 子 节点 。 

每 个 节点 都 有 不 同属 性 ， 不 同 的 属性 又 有 不 同 的 内 容 ， 属 性 都 是 键 值 对 ， 值 可 以 为 空 或 任 
意 的 字 节 流 。 设 备 树 源码 中 常用 的 几 种 数据 形式 如 下 所 示 : 

D, FR 

compatible = "arm,cortex-a7"; 

上 述 代 码 设 置 compatible 属性 的 值 为 字符 串 “arm,cortex-a7”。 

Q. 32 位 无 符号 整数 

reg = «0»; 

上 述 代 码 设置 reg 属性 的 值 为 0，reg 的 值 也 可 以 设置 为 一 组 值 ， 比 如 : 

reg = «0 0x123456 100>; 

@、 字 符 串 列表 

属性 值 也 可 以 为 字符 串 列 表 ， 字 符 串 和 字符 串 之 间 采 用 “,” 隔 开 ， 如 下 所 示 : 

compatible = "fsl,imx6ull-gpmi-nand", "fsl, imx6ul-gpmi-nand"; 

上 述 代 码 设置 属性 compatible 的 值 为 “fsl,imx6ull-gpmi-nand” 和 “fsl, imx6ul-gpmi-nand ". 











































































































43.3.3 标准 属性 


节点 是 由 一 堆 的 属性 组 成 ， 节 点 都 是 具体 的 设备 ， 不 同 的 设备 需要 的 属性 不 同 ， 用 户 可 以 
自 定义 属性 。 除了 用 户 自 定 义 属性 ， 有 很 多 属性 是 标准 属性 ，Linux 下 的 很 多 外 设 驱 动 都 会 使 用 
这 些 标准 属性 ， 本 节 我 们 就 来 学 习 一 下 几 个 常用 的 标准 属性 。 

1、compatible 属性 

compatible 属性 也 叫做 “兼容 性 ”属性 ， 这 是 非常 重要 的 一 个 属性 ! compatible 属性 的 值 是 
一 个 字符 串 列 表 ，compatible 属性 用 于 将 设备 和 驱动 绑 定 起 来 。 字 符 串 列表 用 于 选择 设备 所 要 
使 用 的 驱动 程序 ，compatible 属性 的 值 格式 如 下 所 示 : 

"manufacturer,model" 
其 中 manufacturer 表示 厂商 ，model 一 般 是 模块 对 应 的 驱动 名 字 。 比 如 imx6ull-alientek- 
emmc.dts 中 sound 节点 是 LIMX6U-ALPHA 开发 板 的 音频 设备 节点 ，LMX6U-ALPHA 开发 板 上 
的 音频 芯片 采用 的 欧 胜 (WOLFSON) 出 品 的 WM8960，sound 节点 的 compatible 属性 值 如 下 : 

compatible = "fsl,imx6ul-evk-wm8960","fsl,imx-audio-wm8960"; 

属性 值 有 两 个 ， 分 别 为 “fsl,imx6ul-evk-wm8960” 和 “fsl,imx-audio-wm8960” 其 中 “fs1” 
表示 厂商 是 飞 思 卡 尔 ,“imx6ul-evk-wm8960” 和 “imx-audio-wm8960” 表 示 驱 动 模块 名 字 。sound 
这 个 设备 首先 使 用 第 一 个 兼容 值 在 Linux 内 核 里 面 查找 , 看 看 能 不 能 找到 与 之 匹配 的 驱动 文件 ， 
如 果 没 有 找到 的 话 就 使 用 第 二 个 兼容 值 查找 ， 直 到 找到 或 者 查找 完整 个 Linux 内 核 也 没有 找到 
对 应 的 驱动 。 

一 般 驱 动 程序 文件 都 会 有 一 个 OF 匹配 表 , 此 OF 匹配 表 保 存 着 一 些 compatible 值 ， 如果 设 
备 节 点 的 compatible 属性 值 和 OF 匹配 表 中 的 任何 一 个 值 相等 ， 那 么 就 表示 设备 可 以 使 用 这 个 
驱动 。 比 如 在 文件 imx-wm8960.c 中 有 如 下 内 容 : 
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示例 代码 43.3.3.1 imx-wm8960.c. 文件 代码 段 


6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
6 


匹配 表 只 有 一 个 匹配 值 “fsl,imx-audio-wm8960”。 如 果 在 设备 树 中 有 哪个 节点 的 compatible 属 
性 值 与 此 相等 ， 那 么 这 个 节点 就 会 使 用 此 驱动 文件 。 























32 static const struct of device id imx wm8960 dt ids[] = ( 
33 { .compatible = "fsl,imx-audio-wm8960", }, 

34 { /* sentinel */ } 

35 J; 

36 MODULE DEVICE TABLE(of, imx wm8960 dt ids); 

37 

38 static struct platform driver imz wm8960 driver = ( 
9 sonienre £3 ( 

40 .name = "imx-wm8960", 

41 .pm = &snd soc pm ops, 

42 .of match table = imx wm8960 dt ids, 

43 }, 

44 .probe = imx wm8960 probe, 

45 .remove = imx wm8960 remove, 

doc 


第 632-635 行 的 数组 imx. wm8960 dt ids 就 是 imx-wm8960.c 这 个 驱动 文件 的 匹配 表 ， 此 














第 642 行 ，wm8960 采用 了 platform driver 驱动 模式 ， 关 于 platform driver 驱动 后 面 会 讲 














解 。 此 行 设置 .of match table 7j imx wm8960 dt ids， 也 就 是 设置 这 个 platform_ driver 所 使 用 的 


OF 匹配 表 。 


2、model 属性 
model 属性 值 也 是 一 个 字符 串 ， 一 般 model 属性 描述 设备 模块 信息 ， 比 如 名 字 什 么 的 ， 比 








如 : 


model = "wm8960-audio"; 


3. status 属性 








status 属性 看 名 字 就 知道 是 和 设备 状态 有 关 的 ，status 属性 值 也 是 字符 串 ， 字 符 串 是 设备 的 





状态 信息 ， 可 选 的 状态 如 表 43.3.3.1 所 示 : 


“okay” 表明 设备 是 可 操作 的 。 





表明 设备 当前 是 不 可 操作 的 , 但 是 在 未 来 可 以 变 为 可 操作 的 ， 比 如 热 插 拔 设备 








éé ^ l » : 
disabled" | 插入 以 后 。 至 于 disabled 的 具体 含义 还 要 看 设备 的 绑 定 文档 。 
supe | 表明 设备 不 可 操作 ,设备 检测 到 了 一 系列 的 错误 ， 而 且 设备 也 不 天 可 能 变 得 可 


操作 。 

















“fail-sss” | 含义 和 “fail” 相 同 ， 后 面 的 sss 部 分 是 检测 到 的 错误 内 容 。 








表 43.3.3.1 status 属性 值 表 
4, #address-cells 和 #size-cells 属性 
这 两 个 属性 的 值 都 是 无 符号 32 位 整形 ，#address-cells 和 #size-cells 这 两 个 属性 可 以 用 在 任 

















何 拥有 子 节点 的 设备 中 , 用 于 描述 子 节 点 的 地 址 信息 。#address-cells 属性 值 决定 了 子 节点 reg 属 




















t 


中 地 址 信息 所 占用 的 字 长 32 位 )，#size-cells 属性 值 决 定 了 子 节点 reg 属性 中 长 度 信息 所 占 的 
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字 长 (32 位 )。#address-cells 和 #size-cells 表明 了 子 节点 应 该 如 何 编写 reg 属性 值 ， 一 般 reg 属性 
都 是 和 地 址 有 关 的 内 容 , 和 地 址 相关 的 信息 有 两 种 :起 始 地 址 和 地 址 长 度 ,reg 属性 的 格式 一 为 : 
reg = <address1 lengthl address2 length2 address3 length3:-:::- > 
每 个 “address lengtp” 组 合 表示 一 个 地 址 范围 ， 其 中 address 是 起 始 地 址 ，length 是 地 址 长 
度 ，#address-cells 表明 address 这 个 数据 所 占用 的 字 长 ，#size-cells 表明 length 这 个 数据 所 占用 
的 字 长 ， 比 如 : 



































示例 代码 43.3.3.2 #address-cells fez£size-cells 属性 


1 spi4 { 

2 compatible = "spi-gpio"; 

3 #address-cells = «41»; 

4 #size-cells = «0»; 

5 

6 gpio spi: gpio spiet q 

7 compatible - "fairchild,74hc595"; 
8 reg = «0»; 

9 }; 

MOR); 

al 

12 aips3: aips-bus(002200000 ( 

13 compatible - "fsl,aips-bus", "simple-bus"; 
14 #address-cells = «41»; 

15 #size-cells = «1i»; 

16 

187 dep: dcp802280000 ( 

18 compatible - "fsl,imxó6sl-dcp"; 
19 reg = «0x02280000 0x4000»; 

20 b E 

2b JXg 





第 2，3 行 ， 节 点 spi4 的 #address-cells = «1», #size-cells = «0», WAH spi4 的 子 节点 reg 属 
起 始 地 址 所 占用 的 字 长 为 1， 地 址 长 度 所 占用 的 字 长 为 0。 

第 8 行 ， 子 节点 gpio spi: gpio_spi@0 的 reg 属性 值 为 <0>， 因 为 父 节 点 设置 了 加 ddress- 
cells=<1>，#size-cells=<0>， 因 此 addres=0， 没 有 length 的 值 ， 相 当 于 设置 了 起 始 地 址 ， 而 没 
有 设置 地 址 长 度 。 

第 14，15 行 ， 设 置 aips3: aips-bus@02200000 节点 #address-cells = <1>, #size-cells = «1», 
说 明 aips3: aips-bus@02200000 节点 起 始 地 址 长 度 所 占用 的 字 长 为 1， 地 址 长 度 所 占用 的 字 长 也 
为 1。 

第 19 行 , 子 节点 dep: dcp@02280000 的 reg 属性 值 为 <0x02280000 0x4000>， 因 为 父 节点 设 
置 了 #address-cells = <1>，#size-cells =<1>，address= 0x02280000，length= 0x4000， 相 当 于 设置 
了 起 始 地 址 为 0x02280000， 地 址 长 度 为 0x40000。 


5. reg 属性 

reg 属性 前 面 已 经 提 到 过 了 ，reg 属性 的 值 一 般 是 (address，length) 对 。reg 属性 一 般 用 于 描 
述 设备 地 址 空间 资源 信息 ,一 般 都 是 某 个 外 设 的 寄存 器 地 址 范围 信息 ， 比 如 在 imx6ull.dtsi 中 有 
如 下 内 容 : 





La 
FE 
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示例 代码 43.3.3.3 uart? 节点 信息 


论坛 :www.opendev.com 











EVEL HIGH»; 














323 uarti: serial02020000 ( 

324 compatible - "fsl,imx6ul-uart", 

92/5 "ESL. amor eae ME amos? 1L wieueie ^ p 
326 reg = «0x02020000 0x4000»; 

Bo ijmnbewrxeUpice C3 <GIC_ SPE 25 IRO TYEE Jh 

328 clocks = «&clks IMX6UL CLK UART1 IPG>, 

E X&clks IMX6UL CLK UART1 SERIAL»; 

330 clock-names = "ipg", "per"; 

S9 status = "disabled"; 

DOPO 





上 述 代码 是 节点 uartl，uartl 节点 描述 了 I.MX6ULL 的 UARTI 相关 信息 ， 重 点 是 第 

















Ax 














326 íT 





的 reg 属性 。 其 中 uartl 的 父 节 点 aipsl: aips-bus(2202000000 设置 了 加 ddress-cells = «17. fsize- 
cells=<1>, 因此 reg 属性 中 address-0x02020000, length-0x4000. 查阅 《LMX6ULL 参考 手册 》 
可 知 ，LMX6ULL 的 UARTI 寄存 器 首 地 址 为 0x02020000， 但 是 UARTI 的 地 址 长 度 (范围 ) 并 没 
有 0x4000 这 么 多 ， 这 里 我 们 重点 是 获取 UART. 寄存 器 首 地 址 。 


























6、ranges 属性 























ranges 属 性 值 可 以 为 空 或 者 按照 (child-bus-address,parent-bus-address,length) 格 式 编写 的 数字 





这 三 部 分 组 成 : 


child-bus-address: 子 总 线 地 址 空间 的 物理 地 址 ， 由 父 节 点 的 #address-cells 确 


所 占用 的 字 长 。 








ERE, ranges 是 一 个 地 址 映射 /转换 表 ，ranges 属性 每 个 项 目 由 子 地 址 、 父 地 址 和 地 址 空间 长 度 














定 此 物理 地 址 





parent-bus-address: 父 总 线 地 址 空间 的 物理 地 址 ， 同 样 由 父 节 点 的 #address-cells 确定 此 物 








理 地 址 所 占用 的 字 长 。 











length: 子 地 址 空间 的 长 度 ， 由 父 节 点 的 #size-cells 确定 此 地 址 长 度 所 占用 的 字 长 。 
如 果 ranges 属性 值 为 空 值 ,说 明子 地 址 空间 和 父 地 址 空间 完全 相同 ,不 需要 进行 地 址 转换 ， 














对 于 我 们 所 使 用 的 ILMX6ULL 来 说 ， 子 地 址 空间 和 父 地 址 空间 完全 相同 ， 因 此 会 在 imx6ull.dtsi 











中 找到 大 量 的 值 为 空 的 ranges 属性 ， 如 下 所 示 : 
示例 代码 43.3.3.4 imx6ull.dtsi 文件 代码 段 











ISo Soc 

138 faddress-cells = «1»; 

139 #size-cells = «1»; 

140 compatible = "simple-bus"; 
141 interrupt-parent = <&gpc>; 
142 ranges; 

LLU T 











第 142 行 定 义 了 ranges 属性 ， 但 是 ranges 属性 值 为 空 。 


ranges 属性 不 为 空 的 示例 代码 如 下 所 示 : 





示例 代码 43.3.3.5 ranges 属性 不 为 空 


i eoe / 
2 compatible = "simple-bus"; 
E daddress-cells = «1»; 


1080 


LMX6U 嵌入 式 Linux 驱动 开发 指南 O ERAF 








原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
4 #size-cells = «1»; 

5 ranges = <0x0 0xe0000000 0x00100000>; 
6 

7 serial { 

8 devie ibype e "seis" 

9 compatible - "ns16550"; 

10 reg = «0x4600 0x100»; 

11 clock-frequency = «0»; 

T2 interrupts = <0xA 0x8>; 

ls interrupt-parent = <&ipic>; 

El }; 

IS »& 


第 5 行 ， 节 点 soc 定义 的 ranges 属性 ， 值 为 <0x0 0xe0000000 0x00100000>， 





此 属性 值 指定 


了 一 个 1024KB(0x00100000) 的 地 址 范围 ， 子 地 址 空间 的 物理 起 始 地 址 为 0x0， 父 地 址 空间 的 物 


理 起 始 地 址 为 0xe0000000。 


Ax 




















第 6 1T, serial 是 串口 设备 节点 ，reg 属性 定义 了 serial 设备 寄存 器 的 起 始 地 址 为 0x4600, 











寄存 器 长 度 为 0x100。 经 过 地 址 转换 ，serial 设备 可 以 从 0xe0004600 开始 i 
Oxe0004600=0x4600+0xe0000000。 


7、name 属性 


name 属性 值 为 字符 串 ，name Ja H 
name 属性 ， 一 些 老 的 设备 树 文 件 可 能 会 使 用 此 属性 。 
8、device_type 属性 
































FE 用 于 记录 节点 名 字 ，name 属性 已 经 被 弃 用 ， 不 推荐 使 用 


行 读 写 操 作 ， 





device type 属性 值 为 字符 串 ，IEEE 1275 会 用 到 此 属性 ， 用 于 描述 设备 的 FCode， 但 是 设 
备 树 没 有 FCode， 所 以 此 属性 也 被 扫 弃 了 。 此 属性 只 能 用 于 cpu 节点 或 者 memory 节点 。 























imx6ull.dtsi 的 cpu0 节点 用 到 了 此 属性 ， 内 容 如 下 所 示 : 
示例 代码 43.3.3.6 imx6ull.dtsi 文件 代码 段 
54 cpu0: cpuGO ( 


55 compatible - "arm,cortex-a7"; 
56 deyices cM 

EN reg = «0»; 

89 Dg 























关于 标准 属性 就 讲解 这 么 多 ， 其 他 的 比如 中 断 、IIC、SPI 等 使 用 的 标准 属性 等 到 具体 的 例 














程 在 讲解 。 





43.3.4 根 节 点 compatible 属性 








每 个 节点 都 有 compatible 属性 ， 根 节点 “/” 也 不 例外 ，imx6ull-alientek-emmec.dts 文件 中 根 








节点 的 compatible 属性 内 容 如 下 所 示 : 
示例 代码 43.3.4.1 imx6ull-alientek-emmc.dts 根 节 点 compatible 属性 





wA 
iS model = "Freescale i.MX6 ULL 14x14 EVK Board"; 
16 compatible = "fsl,imx6ull-14xl4-evk", "fsl,imx6ull"; 
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148 ] 

可 以 看 出 ，compatible 有 两 个 值 :“fsl,imx6ull-14x14-evk” 和 “fsl,imx6ull”。 前 面 我 们 说 了 ， 
设备 节点 的 compatible 属性 值 是 为 了 匹配 Linux 内 核 中 的 驱动 程序 , 那么 根 节点 中 的 compatible 
属性 是 为 了 做 什么 工作 的 ? 通过 根 节 点 的 compatible 属性 可 以 知道 我 们 所 使 用 的 设备 , 一 般 第 
个 值 描述 了 所 使 用 的 硬件 设备 名 字 ， 比 如 这 里 使 用 的 是 “imx6ull-14x14-evk” 这 个 设备 ， 第 二 
个 值 描述 了 设备 所 使 用 的 SOC， 比 如 这 里 使 用 的 是 “imx6ull” 这 颗 SOC. Linux 内 核 会 通过 根 
节点 的 compoatible 属性 查看 是 否 支 持 此 设备 ， 如 果 支 持 的 话 设 备 就 会 启动 Linux 内 核 。 接 下 来 
我 们 就 来 学 习 一 下 Linux 内 核 在 使 用 设备 树 前 后 是 如 何 判 断 是 否 支 持 某 球 设 备 的 。 

1、 使 用 设备 树 之 前 设备 匹配 方法 


在 没有 使 用 设备 树 以 前 ，uboot 会 向 Linux 内 核 传 递 一 个 叫做 machine id 的 值 ，machine id 
也 就 是 设备 ID， 告诉 Linx 内 核 自 己 是 个 什么 设备 ， 看 看 Linux 内 核 是 否 文 持 。Linux 内 核 是 
文 持 很 多 设备 的 , 针对 每 一 个 设备 (板子 ),Linux 内 核 都 用 MACHINE_ START 和 MACHINE_END 
来 定义 一 个 machine desc 结构 体 来 描述 这 个 设备 ， 比 如 在 文件 arch/arm/mach-imx/mach- 
mx35 3ds.c 中 有 如 下 定义 : 










































































































































































示例 代码 43.3.4.2 MX35_3DS 设备 
613 MACHINE START(MX35 3DS, "Freescale MX35PDK") 





614 /* Maintainer: Freescale Semiconductor, Inc */ 
S .atag offset = 0x100, 

616 .map io = mx35 map io, 

617 cimit early = Tix imit early, 

618 odmi Lee C3 WIS imie LEE, 

619 -ni time SS moo Eimer inik, 

620 -Anlte machine = wExS Sas init, 

Ia 2Doesenves-umx395ESdsEmesemve 

622 .restart = mxc restart, 








623 MACHINE END 
上 述 代码 就 是 定义 了 “Freescale MX35PDK ”这 个 设备 ， 其 中 MACHINE START 和 
MACHINE END 定义 在 文件 arch/arm/include/asm/mach/arch.h 中 ， 内 容 如 下 : 
示例 代码 43.3.4.3 MACHINE_START 和 MACHINE_END 宏 定 义 























*define MACHINE START( type, name) Y 
Statie Conget Struct machine dese mach dese s INS N 
= used Y 
Deen Louse ((_ section (V arch. mro imit) = 4 N 
aiie = MACH TYPE ##_type, \ 
.name — _ neme; 
#define MACHINE END N 


}; 
根据 MACHINE START 和 MACHINE END 的 宏 定义 ,将 示例 代码 43.3.4.2 展开 后 如 下 所 
ZN: 
示例 代码 43.3.4.3 展开 以 后 


1 tatic Const sicuri: machine dese mach Cese M35 SDS N 
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论坛 :www.opendev.com 





2 _ used N 
S . artrite  — ((( — eectiom (H arca sume snumabe p) Ex gd 
4 .nr = MACH TYPE MX35 3DS, 
E . name = "Freescale MX35PDK", 
6 /* Maintainer: Freescale Semiconductor, Inc */ 
7 .atag offset = 0x100, 
8 .map io 2 mx35 map io, 
9 -mle early c2 Ln lmit early, 
IO) odmiet ire = m35 imit Tei, 
Iial -mE time — — MID timer init, 
1122 cinit machine < wiES 3e init, 
S .reserve = mx35 3ds reserve, 
14 .restart = mxc restart, 
15 p 
从 示例 代码 43.3.4.3 中 可 以 看 出 ， 这 里 定义 了 一 个 machine dese 类 型 的 结构 体 变 量 
mach desc MX35 3DS ， 这 个 变量 存储 在 “:archinfoinit ” 段 中 。 第 4 行 的 
MACH TYPE MX35 3DS 就 是 “ Freescale MX35PDK ”这 个 板子 的 machine id. 








MACH TYPE MX35 3DS 定义 在 文件 include/generated/mach-types.h 中 ， 此 文件 定义 了 大 量 的 


machine id， 内 容 如 下 所 示 : 


示例 代码 43.3.4.3 mach-types.h 文件 中 的 machine id 







































































15 #define MACH TYPE EBSA110 0 

16 #define MACH TYPE RISCPC 1 

17 #define MACH TYPE EBSA285 4 

18  4define MACH TYPE NETWINDER 5 

19  4define MACH TYPE CATS 6 

20  4define MACH TYPE SHARK 15 
21  4define MACH TYPE BRUTUS 16 
22 #define MACH TYPE PERSONAL SERVER 17 
287 ddefine MACH TYPE MX35 3DS 1645 
1000 £define MACH TYPE PFLAO3 4575 





第 287 行 就 是 MACH TYPE MX35 3DS 的 值 ， 为 1645。 
前 面 说 了 ，uboot 会 给 Linux 内 核 传递 machine id 这 个 参数 , Linux 内 核 会 检查 这 个 machine 


id， 其 实 就 是 将 machine id 与 示例 代码 43.3.4.3 中 的 这 些 MACH. TYPE XXX 宏 进行 对 比 ， 看 
看 有 没有 相等 的 ， 如 果 相 等 的 话 就 表示 Linux 内 核 支持 这 个 设备 ， 如 果 不 支 持 的 话 那么 这 个 设 








备 就 没 法 启动 Linux 内 核 。 
2、 使 用 设备 树 以 后 的 设备 匹配 方法 

















当 Linux 内 核 引入 设备 树 以 后 就 不 











jf) 











] MACHINE START 了 ， 而 是 换 为 了 





DT MACHINE START. DT MACHINE START 也 定义 在 文件 arch/arm/include/asm/mach/arch.h 














*define DT MACHIN 


示例 代码 43.3.4.4 DT MACHINE, START 宏 





E START( name,  namestr) 
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gcatic const struct machine desc mach desc ik name N 
_ used N 
. @rtei botre —q(( section (Varen ino Tne))) = q N 
gms = a. Y 
.name = namestr, 


可 以 看 出 ，DT_ MACHINE START 和 MACHINE START 基本 相同 ， 只 是 .nr 的 设置 不 同 ， 
在 DT MACHINE START 里 面 直接 将 .nr 设置 为 ~-0。 说 明 引 入 设备 树 以 后 不 会 再 根据 machine 
id 来 检查 Linux UE f c HEAR T. 
打开 文件 arch/arm/mach-imx/mach-imx6ul.c， 有 如 下 所 示 内 容 : 
示例 代码 43.3.4.5 imx6ull 设备 
































206 sareeeonse Char oemnee eens te = 
209 "fsl,imx6ul", 

210 "fsl,imx6ull", 

2T NULL, 

Za jug 

2S 

2114. JDMP TWENCISIINS, S TARNIMA SU Ee Eea eN e e ECETES) 
25 .map io = imxóul map io, 

216 oimit irea — = dnb ub mit Lre 

AA me machine = imxóul init machine, 

218 saLmurie late = innepxwuL init lats, 

219 .dt_compat = imx6ul_dt_compat, 





220 MACHINE END 

machine desc 结构 体 中 有 个 .dt_compat 成 员 变 量 ， 此 成 员 变 量 保存 着 本 设备 兼容 属性 ， 示 
例 代 码 43.3.4.5 中 设置 .dt_compat =imx6ul dt compat，imx6ul dt compat 表 里 面 有 "fsl,imx6ul" 
和 "fsl,imx6ull" 这 两 个 兼容 值 。 只 要 某 个 设备 (板子 ) 根 节点 “/” 的 compatible 属性 值 与 
imx6ul_dt_compat 表 中 的 任何 一 个 值 相等 , 那么 就 表示 Linux 内 核 支 持 此 设备 。 imx6ull-alientek- 
emmc.dts 中 根 节点 的 compatible 属性 值 如 下 : 

compatible = "fsl,imx6ull-14x14-evk", "fsl,imx6ull"; 

其 中 “fslimx6ull” 与 imx6ul dt compat PHY *fsLimx6ull" VLW, [Xll LMX6U-ALPHA FF 
发 板 可 以 正常 启动 Linux 内 核 。 如 果 将 imx6ull-alientek-emmc.dts 根 节点 的 compatible 属性 改 为 
其 他 的 值 ， 比 如 : 

compatible = "fsl,imx6ull-14x14-evk", "fsl,imx6ullll" 

重新 编译 DTS， 并 用 新 的 DTS 启动 Linux 内 核 ， 结 果 如 图 43.3.4.1 所 示 的 错误 提示 : 
transferred = 36298 (8dca hex) 
Kernel image @ 0x80800000 [ 0x000000 - 0x54ale0 ] 
## Flattened Device Tree blob at 83000000 


Booting using the fdt blob at 0x83000000 
Using Device Tree in place at 83000000, end 8300bdc9 


输出 Starting kernel... 以 后 再 无 任何 信息 输出 ， 


i Linux Kernel 启 动 失败 。 


图 43.3.4.1 系统 启动 信息 
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当 我 们 修改 了 根 节点 compatible 属性 内 容 以 后 ， 因 为 Linux 内 核 找 不 到 对 应 的 设备 ， 因 此 

















Linux 内 核 无 法 启动 。 在 uboot 输出 Starting kernel... 以 后 就 再 也 没有 其 他 信息 输出 了 。 

接 下 来 我 们 简单 看 一 下 Linux 内 核 是 如 何 根据 设备 树 根 节 点 的 compatible 属性 来 匹配 出 对 
应 的 machine desc, Linux 内 核 调 用 start kernel 函数 来 启动 内 核 ，start kernel 函数 会 调用 
setup arch 函数 来 匹配 machine desc, setup arch 函数 定义 在 文件 arch/arm/kernel/setup.c F, PR 
数 内 容 如 下 (有 缩减 ): 



































示例 代码 43.3.4.6 setup. arch 函数 内 容 


9L5, wounel  3ümabe setup archa(ehar em 





914 ( 

2115; eon een Cese na 

916 

97157 setup processor(); 

918 mdesc = setup machine fdt(  atags pointer); 

919 if (!mdesc) 

920 mdesc = setup machine tags(  atags pointer, 
. machine arch iue 

DII machine desc = mdesc; 

922 machine name = mdesc-»name; 

Soe D 


第 918 行 ， 调 用 setup machine fdt 函数 来 获取 匹配 的 machine_desc， 参 数 就 是 atags 的 首 
地 址 ， 也 就 是 uboot 传递 给 Linux 内 核 的 dtb 文件 首 地 址 ，setup_machine_fdt 函数 的 返回 值 就 是 
找到 的 最 匹配 的 machine desc. 

函数 setup machine fdt 定义 在 文件 arch/arm/kernel/devtree.c 中 ， 内 容 如 下 (有 缩减 ): 

示例 代码 43.3.4.7 setup. machine. fdt Až A X 









































204 const gteuct machine dese w init setup machine tot (eee 
dt phys) 
Zio ti 
206 const struct machine desc *mdesc, *mdesc best = NULL; 
214 
25 "ms (Vee joe [|| Jeariy init chc verityiponys to wow ((ehe phys) )) 
216 return NULL; 
Zu 
218 mdesc = of flat dt match machine (mdesc best, 
arch get next mach); 
29 
247 — sehumeagmcehayr ens c p 
248 
249 return mdesc; 
250 ) 
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第 218 行 , 调 用 函数 of flat dt match machine 来 获取 匹配 的 machine desc, 参数 mdesc_best 
是 默认 的 machine desc， 参 数 arch get next mach 是 个 函数 ， 此 函数 定义 在 定义 在 
arch/arm/kernel/devtree.c 文件 中 。 找 到 匹配 的 machine desc 的 过 程 就 是 用 设备 树 根 节点 的 
compatible 属性 值 和 Linux 内 核 中 保存 的 所 以 machine desc 结构 的 . dt compat 中 的 值 比较 ， 看 
看 那个 相等 , 如 果 相 等 的 话 就 表示 找到 匹配 的 machine desc, arch get next mach 函数 的 工作 就 






































是 获取 Linux 内 核 中 下 一 个 machine desc 结构 体 。 
最 后 在 来 看 一 下 of flat dt match machine 函数 ， 此 函数 定义 在 文件 drivers/of/fdt.c 中 ， 内 
容 如 下 (有 缩减 ): 























示例 代码 43.3.4.8 of flat dt match. machine 函数 内 容 
1/005; Const voici w _ imit ot flat che macchi machine (Const Vore 


Pxelesrenulbw: mareh, 


706 rome w (wget next Compoat) (Const em ceo eR BY 
TOT A 

708 const void *data = NULL; 

709 Const VOLE est Cata = deraunle matei 

A100] const Ciais tegmen epe s 

yal wasignecl Long qht Toor, 

el unsigned int best score = «1, score = 0; 

Tae; 

714 dt root = of get flat dt root(); 

TIS while ((data = get_next_compat (&compat))) { 
716 score = of flat dt match(dt root, compat) ; 
galgi if (score > 0 && score < best_score) { 

718 best data = data; 

719 best_score = score; 

720 } 

721 } 

TSS 

740 pe imito Machine ne sehn, Ot tlar ot get machine name (0) B) 
741 

742 return best data; 

uas) 


第 714 行 ， 通 过 函数 of get flat dt root 获取 设备 树 根 节点 。 

第 715—720 行 , 此 循环 就 是 查找 匹配 的 machine desc 过程 , 第 716 行 的 of flat dt match Pf 
数 会 将 根 节 点 compatible 属性 的 值 和 每 个 machine desc 结构 体 中 . dt compat 的 值 进 行 比 较 ， 直 
至 找到 匹配 的 那个 machine desc. 

总 结 一 下 ，Linux 内 核 通过 根 节点 compatible 属性 找到 对 应 的 设备 的 函数 调用 过 程 ， 如 图 
43.3.4.2 所 示 : 
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start kernel() 


setup arch() 


| setup machine fdt() 


of flat dt match machine () 








具体 的 查找 machine_desc 的 过 程 


43.3.4.2 查找 匹配 设备 的 过 程 


43.3.5 向 节点 追加 或 修改 内 容 


产品 开发 过 程 中 可 能 面临 着 频繁 的 需求 更 改 ， 比 如 第 一 版 硬件 上 有 一 个 IIC 接口 的 六 轴 芯 
片 MPU6050， 第 二 版 硬件 又 要 把 这 个 MPU6050 更 换 为 MPU9250 等 。 一 旦 硬件 修改 了 ， 我 们 
就 要 同步 的 修改 设备 树 文 件 ， 上 毕竟 设备 树 是 描述 板子 硬件 信息 的 文件 。 假 设 现 在 有 个 六 轴 世 片 
fxs8471, fxls8471 要 接 到 LMX6U-ALPHA 开发 板 的 12C1 接口 上 上， 那么 相当 于 需要 在 i201 这 
个 节点 上 添加 一 个 fxls8471 子 节点 。 先 看 一 下 I2C1 接口 对 应 的 节点 ， 打 开 文 件 imx6ull.dtsi X 
件 ， 找 到 如 下 所 示 内 容 : 

示例 代码 43.3.5.1 i2c1 节点 

oea el e000 


938 faddress-cells = «1»; 

999 #size-cells = «0»; 

940 compatible c fm E S a E p 
941 reg = <0x021a0000 0x4000>; 

942 interrupts = «GIC SPI 36 IRQ TYPE LEVEL HIGH»; 
943 clocks = «&clks IMX6UL CLK I2Cl»; 

944 status = onsale 

gas. Jig 


示例 代码 43.3.5.1 就 是 ILMX6ULL 的 D2C1 节点 ， 现 在 要 在 i2cl 节点 下 创建 一 个 子 节点 ， 
这 个 子 节点 就 是 多 ls8471， 最 简单 的 方法 就 是 在 i2cl 下 直接 添加 一 个 名 为 fxIs8471 的 子 节点 ， 
如 下 所 示 : 
示例 代码 43.3.5.2 添加 fxls8471 子 节点 
957 st2XedLg i1266021a0000 1 

















938 #address-cells = «1»; 

929 #size-cells = <0>; 

940 compair le nn 
941 reg = «0x021a0000 0x4000»; 

942 iugiEeuéiewES - “IC SEL 5 IRO DYEE LEVEL SICH 
943 clocks = «&clks ME 

944 status = "disabled"; 
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945 


946 //f£x1s8471 f 
947 fxls847101e ( 


948 compatible = "fsl,fx1s8471"; 
949 reg = «0xie»; 

950 DES 

D R 

















第 947-950 行 就 是 添加 的 fx188471 这 个 芯片 对 应 的 子 节点 。 但 是 这 样 会 有 个 问题 ! i2cl 节 
点 是 定义 在 imx6ull.dtsi 文件 中 的 , 而 imx6ull.dtsi 是 设备 树 头 文件 ， 其 他 所 有 使 用 到 I.MX6ULL 
这 颗 SOC 的 板子 都 会 引用 imx6ull.dtsi 这 个 文件 。 直 接 在 i2cl 节点 中 添加 fxls8471 就 相当 于 在 
其 他 的 所 有 板子 上 都 添加 了 fxls8471 这 个 设备 ， 但 是 其 他 的 板子 并 没有 这 个 设备 啊 ! 因此 ， 按 
照 示 例 代 码 43.3.5.2 这 样 写 肯定 是 不 行 的 。 

这 里 就 要 引入 另外 一 个 内 容 ， 那 就 是 如 何 向 节点 追加 数据 ， 我 们 现在 要 解决 的 就 是 如 何 向 
i2cl 节点 追加 一 个 名 为 fxls8471 的 子 节点 ， 而 且 不 能 影响 到 其 他 使 用 到 I.MX6ULL 的 板子 。 
LMX6U-ALPHA 开发 板 使 用 的 设备 树 文件 为 imx6ull-alientek-emmc.dts ， 因 此 我 们 需要 在 
imx6ull-alientek-emmc.dts 文件 中 完成 数据 追加 的 内 容 ， 方 式 如 下 : 

示例 代码 43.3.5.3 节点 追加 数据 方法 







































































i miZel í 
2  /* 要 追加 或 修改 的 内 容 */ 
S IF 


第 1 行 ，&i2cl 表示 要 访问 i201 这 个 label 所 对 应 的 节点 ， 也 就 是 imx6ull.dtsi 中 的 “i2cl: 
i2c@021a0000”。 
第 2 行 ， 花 括号 内 就 是 要 问 i2cl 这 个 节点 添加 的 内 容 ， 包 括 修改 某 些 属性 的 值 。 
打开 imx6ull-alientek-emmc.dts， 找 到 如 下 所 示 内 容 : 
示例 代码 43.3.5.4 向 i2cl 节点 追加 数据 

















224 &i2c1l ( 


225 clock-frequency = <100000>; 

226 pinctrl-names = "default"; 

2:20) jgabeweEiEl—(0) e3 «Segesbaxeesell aL281D5 
228 status s "okay"; 

DID 

290 mag3110@0e ( 

25d compatible - "fsl,mag3110"; 
ZI reg = «0x0e»; 

22515] position = «2»; 

234 ); 

DES 

236 fxls8471801e y 

2SN compatible - "fsl,fx1s8471"; 
236 reg = <0xle>; 

269 position = «0»; 

240 interrupt-parent = «&gpio5»; 
241 interrupts = «0 8»; 
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242 pes 
2S 
示例 代码 43.3.5.4 就 是 向 i2cl 节点 添加 /修改 数据 , 比如 第 225 行 的 属性 “clock-frequency” 
就 表示 i2cl 时 钟 为 100KHz。“clock-frequency” 就 是 新 添加 的 属性 。 
第 228 行 ， 将 status 属性 的 值 由 原来 的 disabled 改 为 okay。 
第 230-234 17, i2cl 子 节 点 mag3110， 因 为 NXP 官方 开发 板 在 DCI 上 接 了 一 个 磁力 计 芯 





cel 
































片 mag3110， 正 点 原子 的 LIMX6U-ALPHA 开发 板 并 没有 使 用 mag3110. 

第 236-242 fT, i2cl 子 节点 全 ls88471， 同 样 是 因为 NXP 官方 开发 板 在 DCI 上 接 了 fxIs8471 
JOB SUUS Fr o 

因为 示例 代码 43.3.5.4 中 的 内 容 是 imx6ull-alientek-emmc.dts 这 个 文件 内 的 ， 所 以 不 会 对 
使 用 LMX6ULL 这 颗 SOC 的 其 他 板子 造成 任何 影响 。 这 个 就 是 向 节点 追加 或 修改 内 容 ， 重 点 
就 是 通过 &label 来 访问 节点 ， 然 后 直接 在 里 面 编写 要 追加 或 者 修改 的 内 容 。 


43.4 创建 小 型 模板 设备 树 


上 一 节 已 经 对 DTS 的 语法 做 了 比较 详细 的 讲解 ， 本 节 我 们 就 根据 前 面 讲解 的 语法 ， 从 头 到 
尾 编写 一 个 小 型 的 设备 树 文 件 。 当 然 了 ， 这 个 小 型 设备 树 没 有 实际 的 意义 ， 做 这 个 对 的 目的 是 
为 了 掌握 设备 树 的 语法 。 在 实际 产品 开发 中 ， 我 们 是 不 需要 完 完全 全 的 重 写 一 个 .dts 设备 树 文 
件 ， 一 般 都 是 使 用 SOC 厂商 提供 好 的 .dts 文件 ， 我 们 只 需要 在 上 面 根据 自己 的 实际 情况 做 相应 
的 修改 即 可 。 在 编写 设备 树 之 前 要 先 定义 一 个 设备 , 我 们 就 以 IMX6ULL 这 个 SOC 为 例 , 我 们 
需要 在 设备 树 里 面 描述 的 内 容 如 下 : 

(D. LMX6ULL 这 个 Cortex-A7 架构 的 32 位 CPU. 

©, LMX6ULL 内 部 ocram， 起 始 地 址 0x00900000， 大 小 为 128KB(0x20000)。 

®©, LMX6ULL 内 部 aipsl 域 下 的 ecspil 外 设 控制 器 ， 寄 存 器 起 始 地 址 为 0x02008000， 大 
小 为 0x4000。 

由 、LMX6ULL 内 部 aips2 域 下 的 usbotgl 外 设 控 制 器 ， 寄 存 器 起 始 地 址 为 0x02184000， 大 
小 为 0x4000。 

©, LMX6ULL 内 部 aips3 域 下 的 mgb 外 设 控制 器 ， 寄 存 器 起 始 地 址 为 0x02284000， 大 小 
为 0x4000。 

为 了 简单 起 见 ， 我 们 就 在 设备 树 里 面 就 实现 这 些 内 容 即 可 ， 首 先 ， 搭 建 一 个 仅 含 有 根 节点 

“J” 的 基础 的 框架 ， 新 建 一 个 名 为 myfirst.dts 文件 ， 在 里 面 输入 如 下 所 示 内 容 : 
示例 代码 43.4.1 设备 树 基础 框架 







































































































































































































































































compatible - "fsl,imx6ull-alientek-evk", "fsl,imxóull"; 


(pep Jes [3 




















设备 树 框架 很 简单 ， 就 一 个 根 节 点 “/”% 根 节点 里 面 只 有 一 个 compatible 属性 。 我们 就 在 这 
个 基础 框架 上 面 将 上 面 列 出 的 内 容 一 点 点 添加 进来 。 
1、 添 加 cpus 节点 
首先 添加 CPU 节点 ，LMX6ULL 采用 Cortex-A7 架构 ， 而 且 只 有 一 个 CPU， 因 此 只 有 一 个 
cpu0 节点 ， 完 成 以 后 如 下 所 示 : 
示例 代码 43.4.2 添加 CPUO0 节点 



















































































ow 


2 compatible - "fsl,imxó6ull-alientek-evk", "fsl,imxóull"; 
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4 cpus { 

5 #address-cells = <1>; 

6 #size-cells = <0>; 

7 

8 / / CPUO 节点 

9 cpu0: cpuQO ( 

10 compatible = "arm,cortex-a7"; 
TT device type = "cpu"; 

12 reg = «0»; 

13 ] 

14 hé 

15 ] 


第 4-14 £T, cpus 节点 ， 此 节点 用 于 描述 SOC 内 部 的 所 有 CPU， 因 为 LIMX6ULL 只 有 一 个 
CPU， 因 此 只 有 一 个 cpu0 子 节 点 。 
2、 添 加 soc 节点 


像 uart, iic 控制 器 等 等 这 些 都 属于 SOC 内 部 外 设 ， 因 此 一 般 会 创建 一 个 叫做 soc 的 父 节点 
来 管理 这 些 SOC 内 部 外 设 的 子 节点 ， 添 加 soc 节点 以 后 的 myfirst.dts 文件 内 容 如 下 所 示 : 
示例 代码 43.4.3 添加 soc 节点 














E AGE 

2 compatible - "fsl,imx6ull-alientek-evk", "fsl,imxóull"; 
3 

4 Gone i 

5 #address-cells = «1»; 

6 #size-cells = <0>; 

7 

8 / /CPUO W 

9 cpu0: Tau ( 

10 compatible - "arm,cortex-a7"; 
Jl deyice type = "epu" 

12 reg = <0>; 

iE; De 

14 }; 

ilS 

16 laoet Hi 

17 soc { 

18 #address-cells = <1>; 

19 #size-cells = <1>; 

20 compatible = "simple-bus"; 
21 ranges; 

22 } 

23. 
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第 17-22 fT. soc 节点 ，soc 节点 设置 #address-cells=<1>，#size-cells=<1>， 这 样 soc 子 节 
点 的 reg 属性 中 起 始 地 占用 一 个 字 长 ， 地 址 空间 长 度 也 占用 一 个 字 长 。 

第 21 行 ，ranges 属性 ，ranges 属性 为 空 ， 说 明子 空间 和 父 空间 地 址 范围 相同 。 


























3、 添 加 ocram 节点 
根据 第 @ 点 的 要 求 ， 添 加 ocram 节点 ，ocram 是 LMX6ULL 内 部 RAM， 因 此 ocram 节点 应 
该 是 soc 节点 的 子 节点 。ocram 起 始 地 址 为 0x00900000， 大 小 为 128KB(0x20000)， 添 加 ocram 
节点 以 后 myfirst.dts 文件 内 容 如 下 所 示 : 
示例 代码 43.4.4. 添加 ocram 节点 





El 

2 compatible - "fsl,imxó6ull-alientek-evk", "fsl,imxóull"; 
8 

4 cpus ( 

5 faddress-cells = «1»; 

6 fsize-cells = «0»; 

qj 

8 / /CPUO 75 zx 

9 cpu0: cpuGO ( 

10 compatible - "arm,cortex-a7"; 
ll device ye = ene 

12 reg = «0»; 

1L }; 

14 }; 

15 

16 leote Tm 

107 soc ( 

18 faddress-cells = «1»; 

19 #size-cells = «1»; 

20 compatible = "simple-bus"; 

2l ranges; 

22 

B3 / /ocram Ti pi 

24 ocram: sramQ800900000 ( 

25 compatible = "fsl,lpm-sram"; 
26 reg = «0x00900000 0x20000»; 
27 ); 

28 } 

29 


第 24-27 ÍT, ocram 节点 , 第 24 行 节 点 名 字 @ 后 面 的 0x00900000 就 是 ocram 的 起 始 地 址 。 
第 26 行 的 reg 属性 也 指明 了 ocram 内 存 的 起 始 地 址 为 0x00900000， 大 小 为 0x20000. 


4、 添 加 aips1、aips2 和 aips3 这 三 个 子 节 点 


LMX6ULL 内 部 分 为 三 个 域 : aipsl~3， 这 三 个 域 分 管 不 同 的 外 设 控制 器 ，aipsl~3 这 三 个 域 
对 应 的 内 存 范围 如 表 43.4.1 所 示 : 
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AIPSI 0X02000000 0X100000 





AIPS2 0X02100000 0X100000 
AIPS3 0X02200000 0X100000 
表 43.4.1 aips1~3 地 址 范围 
我 们 先 在 设备 树 中 添加 这 三 个 域 对 应 的 子 节点 aipsl~3 这 三 个 域 都 属于 soc 节点 的 子 节点 ， 
完成 以 后 的 myfirst.dts 文件 内 容 如 下 所 示 : 
示例 代码 43.4.5 添加 aips1~3 节点 
































| 

2 compatible - "fsl,imx6ull-alientek-evk", "fsl,imxóull"; 
3 

4 cpus ( 

5 faddress-cells = «1»; 

6 dsize-cells 2 «0»; 

7 

8 / /CPUO 节点 

9 cpu0: cou ( 

10 compatible = "arm,cortex-a7"; 
al cdevice type = cpu? 

112 reg = «0»; 

13 }; 

1S }; 

15 

16 leoc WA 

37) soc ( 

18 faddress-cells = «1»; 

19 henee elitse 

20 compatible = "simple-bus"; 

2T ranges; 

2 

2 / /ocram Ti ji 

24 ocram: sram800900000 ( 

2 compatible = "fsl,lpm-sram"; 
26 reg = «0x00900000 0x20000»; 
2 bs 

28 

29 //aipsl 节点 

30 aipsl: aips-bus802000000 ( 

3i compatible = "fsl,aips-bus", "simple-bus"; 
32 #address-cells = <1>; 

33 #size-cells = <1>; 

34 reg = <0x02000000 0x100000>; 
35 ranges; 
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36 } 

m 

38 //aips2 节点 

39 aips2: aips-bus8Q02100000 ( 

40 compatible = "fsl,aips-bus", "simple-bus"; 
41 #address-cells = «i»; 

42 #size-cells = «i»; 

43 reg = «0x02100000 0x100000»; 

44 ranges; 

45 } 

46 

47 //aips3 节点 

48 aips3: aips-busQ02200000 ( 

49 compatible = "fsl,aips-bus", "simple-bus"; 
50 #address-cells = «1i»; 

5 #size-cells = «1»; 

52 reg = <0x02200000 0x100000>; 

53 ranges; 

54 } 

55 } 

SION 


第 30-36 ÍF, aipsl 节点 。 

第 39-45 ÍT, aips2 节点 。 

第 48-54 ÍF, aips3 节点 。 

5. WS ecspil, usbotgl 和 rngb 这 三 个 外 设 控制 器 节点 

最 后 我 们 在 myfirst.dts 文件 中 加 入 ecspil, usbotgl 和 mgb 这 三 个 外 设 控制 器 对 应 的 节点 ， 
其 中 ecspil 属于 aipsl 的 子 节 点 ，usbotgl 属于 aips2 的 子 节点 ，rngb 属于 aips3 的 子 节 点 。 最 终 


的 myfirst.dts 文件 内 容 如 下 : 
示例 代码 43.4.6 添加 ecspil、usbotgl fe rngb 这 三 个 节点 











TT 

2 compatible =< "fsl,imx6ull-alientek-evk", "fsl,imxóull"; 
3 

4 cpus ( 

5 #address-cells = «1»; 

6 #size-cells = <0>; 

7 

8 CETO 

9 cpu0: cpuGO ( 

10 compatible - "arm,cortex-a7"; 
Ial device type 5 "cpu"; 

12) reg = «0»; 

1S) ] 

14 }; 
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is; 

16 MESE 7 ES 

dg) soc ( 

18 faddress-cells = «1»; 

19 #size-cells = <1>; 

20 compatible = "simple-bus"; 

2l ranges; 

2 

28 //ocram Ti ji 

24 ocram: sramQ00900000 ( 

25 compatible = "fsl,lpm-sram"; 

26 reg = «0x00900000 0x20000»; 

27 }; 

28 

29 7 ED TIR 

30 aipsl: aips-busQ02000000 ( 

Su compatible - "fsl,aips-bus", "simple-bus"; 
32 #address-cells = «1»; 

39 #size-cells = «1»; 

34 reg = <0x02000000 0x100000>; 

35 ranges; 

36 

37 //ecspil WA 

38 ecspil: ecspi(02008000 ( 

39 #address-cells = «41»; 

40 #size-cells = «0»; 

41 compatible = "fsl,imx6ul-ecspi", "fsl,imx5l-ecspi"; 
42 reg = «0x02008000 0x4000»; 

43 status = "disabled"; 

44 lg 

45 } 

46 

47 Jd ads "ip 

48 aips2: aips-busQ02100000 ( 

49 compatible - "fsl,aips-bus", "simple-bus"; 
50 faddress-cells = «1»; 

5A #size-cells = <1>; 

52 reg = <0x02100000 0x100000>; 

59 ranges; 

54 

55 / l'asbotgl Ti 5i 

56 usbotgl1: usb802184000 ( 

57 compatible = "fsl,imx6ul-usb", "fsl,imx27-usb"; 
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reg = «0x02184000 0x200»; 


59 status = "disabled"; 
60 }; 
61 } 
62 
63 /laipe3 WA 
64 aips3: aips-bus@02200000 ( 
65 compatible - "fsl,aips-bus", 
66 faddress-cells = «1»; 
67 dsize-cells = «1»; 
68 reg = «0x02200000 0x100000»; 
69 ranges; 
70 
71 / / xngb E 
72 rngb: rngb802284000 ( 
73 compatible = "fsl,imxósl-rng", 
Tg 
74 reg = «0x02284000 0x4000»; 
75 hg 
76 } 
sini } 
qe. 
第 38-44 行 ，ecspil 外 设 控制 器 节点 。 
第 56-60 行 ，usbotgl 外 设 控制 器 节点 。 
第 72~75 行 ，mgb 外 设 控制 器 节点 。 






































f$ IC 接口 ,SPI 接口 
同 ， 这 














个 等 到 具体 的 实验 在 详细 讲解 。 
43.5 设备 树 在 系统 中 的 体现 


Linux 内 核 启 动 的 时 候 会 解析 设备 树 中 各 个 节点 的 信息 ， 并 





tree 目录 下 根据 节点 名 字 创 建 不 同文 件 夹 ， 如 图 





/ # cd proc/device-tree/ 
sys/firmware/devicetree/base £ 
caddress-ce 


























43.5.1 所 示 : 


ls 


memory 


model 

name 

pxp. v412 
regulators 


NESL imx rng, 


"simple-bus"; 


"imx- 





至 此 ，myfirst.dts 这 个 小 型 的 模板 设备 树 就 编号 好 了 ， 基 本 和 imx6ull.dtsi 很 像 ， 可 以 看 做 
是 imx6ull.dtsi 的 缩小 版 。 在 myfirst.dts 里 面 我们 仅仅 是 编写 了 LMXeULL 的 外 设 控制 器 节点 ， 


下 所 连接 的 具体 设备 我 们 并 没有 写 , 因为 具体 的 设备 其 设备 树 属 性 内 容 不 





且 在 根 文件 系统 的 /proc/device- 





根 节点 "/" 的 所 有 属性 
和 子 节点 


reserved-memory 


cpus 
interru 
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图 43.5.1 根 节点 “/” 的 属性 以 及 子 节 点 

图 43.5.1 就 是 目录 /proc/device-tree 目录 下 的 内 容 ，/proc/device-tree 目录 下 是 根 节点 “/” 的 
所 有 属性 和 子 节点 ， 我 们 依次 来 看 一 下 这 些 属性 和 子 节 点 。 




















1、 根 节点 “/” 各 个 属性 

在 图 43.5.1 中 ， 根 节点 属性 属性 表现 为 一 个 个 的 文件 (图 中 细 字 体 文件 )， 比 如 图 43.5.1 中 
HJ “#address-cells”, "£size-cells". “compatible”, “model” £l “name” X 5 个 文件 ， 它 们 在 设 
备 树 中 就 是 根 节 点 的 5 个 属性 .既然 是 文件 那么 肯定 可 以 查看 其 内 容 ,输入 cat 命令 来 查看 model 
和 Sompatible > 这 两 个 文件 的 内 容 ， 结果 如 图 43.5.2 所 示 : 


model 









































| 
一 RUE wu base £ 


compatible 文 件 内 容 
devicetree/base # 


图 43.5.2 model 和 compatible 文件 内 容 

从 图 43.5.2 可 以 看 出 ， 文 件 model 的 内 容 是 “Freescale i.MX6 ULL 14x14 EVK Board”, X 
^t compatible 的 内 容 为 “fsl,imx6ull-14x14-evkfsl,imx6ull”。 打 开 文 件 imx6ull-alientek-emmc.dts 
查看 一 下 ， 这 不 正 是 根 节 点 “/” 的 model 和 compatible 属性 值 吗 ! 


2、 根 节点 “/” 各 子 节点 


图 43.5.1 中 各 个 文件 夹 (途中 粗 字 体 文件 夹 ) 就 是 根 节点 “/” 的 各 个 子 节点 , 比如 “aliases”、 
“backlight”、“chosen” 和 “clocks ”等 等 。 大 家 可 以 查看 一 下 imxóull-alientek-emmc.dts 和 
imx6ull.dtsi 这 两 个 文件 ， 看 看 根 节点 的 子 节点 都 有 哪些 ， 看 看 是 否 和 图 43.5.1 中 的 一 致 。 

/proc/device-tree 目录 就 是 设备 树 在 根 文件 系统 中 的 体现 ， 同 样 是 按照 树 形 结构 组 织 的 ， 进 


入 /proc/device-tree/soc 目录 中 就 可 以 看 到 soc 节点 的 所 有 子 节 点 ， 如 图 43.5.3 所 示 : 
/sys/firmware/devicetree/base # cd soc 
/sys/firmware/devicetree/base/soc # ls 
#address-cells compatible ranges 
#size-cells dma-apbhQ01804000 sram@a00900000 
aips-bus@02000000 gpmi-nand@01806000 sram@00904000 
aips-bus@02100000  interrupt-parent sramà00905000 
aips-bus&$02200000 . name 
busfreq pmu 
Tayri i riirn vied Er usa lene # 

图 43.5.3 soc 节点 的 所 有 属性 和 子 节点 
和 根 节点 “/” 一 样 ， 图 43.5.3 中 的 所 有 文件 分 别 为 soc 节点 的 属性 文件 和 子 节点 文件 夹 。 
大 家 可 以 自行 查看 一 下 这 些 属性 文件 的 内 容 是 否 和 imx6ull.dtsi 中 soc 节点 的 属性 值 相同 ， 也 可 


以 进入 “busfreq” 这 样 的 文件 夹 里 面 查看 soe 节点 的 子 节点 信息 。 


43.6 特殊 节点 


在 根 节点 “/” 中 有 两 个 特殊 的 子 节点 : aliases 和 chosen， 我 们 接 下 来 看 一 下 这 两 个 特殊 的 
TO A. 







IW e e e L) 
Frssscala 3 x ULL 14x14 EVK Board 






















































































43.6.1 aliases 子 节点 


打开 imx6ull.dtsi XF, aliases 节点 内 容 如 下 所 示 : 
示例 代码 43.6.1.1 aliases 子 节点 





18 aliases ( 


19 can0 = &flexcanl; 
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20 canl = &flexcan2; 
zi ethernetO0 = &fecl; 
22 ethernetl = &fec2; 
25 gpio0 = &gpiol; 

24 gpiol = &gpio2; 

42 spi0 = &ecspil; 

43 spil = &ecspi2; 

44 spi2 = &ecspi3; 

45 spi3 = &ecspi4; 

46 usbphy0 = &usbphyl; 
47 usbphyl = &usbphy2; 
SE Dg 





单词 aliases 的 意思 是 “别名 ” 因此 aliases 节点 的 主要 功能 就 是 定义 别名 ， 定 义 别 名 的 目 
的 就 是 为 了 方便 访问 节点 。 不 过 我 们 一 般 会 在 节点 命名 的 时 候 会 加 上 label， 然 后 通过 &label 
来 访问 节点 ， 这 样 也 很 方便 ， 而 且 设备 树 里 面 大 量 的 使 用 &label 的 形式 来 访问 节点 。 


















































43.6.2 chosen 子 节点 


chosen 并 不 是 一 个 真实 的 设备 ，chosen 节点 主要 是 为 了 uboot 向 Linux 内 核 传 递 数 据 ， 习 
点 是 bootargs 参数 。 一 般 .dts 文件 中 chosen 节点 通常 为 空 或 者 内 容 很 少 ，imx6ull-alientek- 
emmc.dts 中 chosen 节点 内 容 如 下 所 示 : 
示例 代码 43.6.2.1 chosen 子 节点 





mili 
Tap 

















18 chosen ( 
19 stdout-path = &uartl; 
20m7 
从 示例 代码 43.6.2.1 中 可 以 看 出 ，chosen 节点 仅仅 设置 了 属性 “stdout-path”， 表 示 标 准 输 

出 使 用 uart1。 但 是 当 我 们 进入 到 /proc/device-tree/chosen 目录 里 面 ， 会 发 现 多 了 bootargs 这 个 
属性 ， 如 图 43.6.2.1 所 示 : 

sys/firmware/devicetree/base/chosen £ 1s 
name stdout-path 


sys/firmware/devicetree/base/chosen £ J 























图 43.6.2.1 chosen 节点 目录 
输入 cat 命令 查看 bootargs 这 个 文件 的 内 容 ， 结 果 如 图 43.6.2.2 所 示 : 


/sys/firmware/devicetree/base/chosen # cat bootargs 

console=ttymxc0,115200 root=/dev/nfs rw nfsroot=192.168.1.250:/home/zuozhongkai/ 
linux/nfs/rootfs ip=192.168.1.251:192.168.1.250:192.168.1.1:255.255.255.0::eth0: 
off/sys/firmware/devicetree/base/chosen £ J 


图 43.6.2.2 bootargs 文件 内 容 
从 图 43.6.2.2 可 以 看 出 ，bootargs 这 个 文件 的 内 容 为 “console=ttymxc0,115200..……. ” 这 个 
不 就 是 我 们 在 uboot 中 设置 的 bootargs 环境 变量 的 值 吗 ? 现在 有 两 个 疑点 : 
QD、 我 们 并 没有 在 设备 树 中 设置 chosen 节点 的 bootargs 属性 ， 那 么 图 43.6.2.1 中 bootargs 
这 个 属性 是 怎么 产生 的 ? 
©, KIT bootargs 文件 的 内 容 和 uboot 中 bootargs 环境 变量 的 值 一 样 ? 它们 之 间 有 什么 关 
系 ? 
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前 面 讲解 uboot 的 时 候 说 过 , uboot 在 启动 Linux 内 核 的 时 候 会 将 bootargs 的 值 传递 给 Linux 
内 核 , bootargs 会 作为 Linux 内 核 的 命令 行 参数 , Linux 内 核 启 动 的 时 候 会 打印 出 命令 行 参数 (也 























就 是 uboot 传递 进来 的 bootargs 的 值 )， 如 图 43.6.2.3 所 示 : 


Booting Linux on physical CPU 0x0 
Linux version 4.1.15 (zuozhongkaiQubuntu) (gcc version 4.9.4 (Linaro GCC 4.9-201 
7.01) ) #2 SMP PREEMPT Thu Jun 27 20:43:04 CST 2019 
CPU: ARMv7 Processor [410fc075] revision 5 (ARMv7), crz10c5387d 
CPU: PIPT / VIPT nonaliasing data cache, VIPT aliasing instruction cache 
Machine model: Freescale i.MX6 ULL 14x14 EVK Board 
Reserved memory: created CMA — pool at Ox8c000000, size 320 MiB 
inux,cma, compatible id shared-dma-pool 


PERCPU: Embedded 12 pages/cpu Q8bb32000 s16768 r8192 d24192 u49152 9555 





0048 

ine: console=ttymx n 2.168.1.2 
50: /home/zuozhongkai /linux/nfs/rootfs ip-2192.168.1.251:192.168.1.250:192.168.1.1 
* 0**e C) 





图 43.6.2.3 命令 行 参数 

既然 chosen 节点 的 bootargs 属性 不 是 我 们 在 设备 树 里 面 设置 的 ， 那 么 只 有 一 种 可 能 ， 那 就 
是 uboot 自己 在 chosen 节点 里 面 添加 了 bootargs 属性 ! 并 且 设 置 bootargs 属性 的 值 为 bootargs 
环境 变量 的 值 。 因为 在 启动 Linux 内 核 之 前 , 只 有 uboot 知道 bootargs 环境 变量 的 值 , 并 且 uboot 
也 知道 .dtb 设备 树 文件 在 DRAM 中 的 位 置 ， 因 此 uboot 的 “作案 ”嫌疑 最 大 。 在 uboot 源码 中 
全 局 搜索 “chosen ”这 个 字符 串 ， 看 看 能 不 能 找到 一 些 蛛丝马迹 。 果 然 不 出 所 料 ， 在 
common/fdt support.c 文件 中 发 现 了 “chosen” 的 身影 ，fdt_support.c 文件 中 有 个 fdt_chosen FÉ 
数 ， 此 函数 内 容 如 下 所 示 : 

示例 代码 43.6.2.2 uboot 源码 中 的 fdt_chosen 函数 

2/5 le noes en (oe) 

























































































TG 

ANT uot ë modeotieet; 

279 me Se 

279 ehar te /* used to set string properties */ 
280 

2em err = fdt check header(fdt); 

282 if (enr <0) 1 

283 printi ("fdt chosen: Son far Strerror (erry)y 
284 return err; 

285 } 

286 

287 /* find or create "/chosen" node. */ 

288 mwoleoiiset < idt iind or acc sme (iot, (0, V"chmosem") 
289 if (nodeoffset < 0) 

290 return nodeoffset; 

ZION 

292 str = getenv("bootargs"); 

293 eu (Quee) Ti 

294 err = idt setprop (lide, ioeleoiiset, "loorsies", SIE 
DS strlen (str) + 1): 

296 if (err « O) ( 
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ZI printf("WARNING: could not set bootargs $s.Mn", 
298 tdt strerror (eue 

299 return err; 

300 } 

ZOM! } 

302 

303 return fdt fixup stdout(fdt, nodeoffset); 

304 ) 





第 288 行 ， 调 用 函数 fat find or add subnode 从 设备 树 (.dtb) 中 找到 chosen 节点 ， 如 果 没 有 





找到 的 话 就 会 自己 创建 一 个 chosen 节点 。 
第 292 行 ， 读 取 uboot 中 bootargs 环境 变量 的 内 容 。 




















第 294 行 ， 调 用 函数 fdt setprop 向 chosen 节点 添加 bootargs 属性 ， 并 且 bootargs 属性 的 值 





就 是 环境 变量 bootargs 的 内 容 。 




















RIE HELE J bootargs 属性 值 。 接 下 来 我 们 顺 着 fdt chosen 函数 一 点 点 的 抽 丝 剥 草 ， 
































整个 流程 是 怎么 样 的 ， 见 图 43.6.2.4: 


bootz 命 令 


do_bootz() 
do. bootm states() do bootm linux 函 数 


boot selected os() 
boot. fnzdo. bootm. linux sj žk 

BooL TN() = 有 辽 实际 运行 函数 do_bootm_linux() 
启动 Linux 之 前 做 一 些 其 他 处 
理 ， 比 如 在 设备 树 的 chosen 


boot. prep linuxO Ris a t 节点 下 添加 子 节点 bootatgs， 
bootargs 子 节点 存放 bootargs 
image setup linux() 环境 变量 


image setup libfat() 


加 bootargs 属 性 








3X 238 JE fdt. chosen 
fdt chosen()----- 区 数 在 chosen 节 点 中 添 


UEH AHE” T, 就 是 uboot 中 的 fdt chosen 函数 在 设备 树 的 chosen 节点 中 加 入 了 bootargs 





看 都 有 哪些 函数 调用 了 fdt chosen, 一 直 找 到 最 终 的 源头 。 这 里 我 就 不 卖 关 子 了 , 直接 告诉 大 家 

















图 43.6.2.4 fdt chosen 函数 调用 流程 











图 43.6.2.4 中 框 起 来 的 部 分 就 是 函数 do bootm linux 函数 的 执行 流程 ， 也 就 是 说 








do bootm linux 函数 会 通过 一 系列 复杂 的 调用 ， 最 终 通 过 fdt chosen 函数 在 chosen 节点 中 力 








IL 


了 bootargs 属性 。 而 我 们 通过 bootz 命令 启动 Linux 内 核 的 时 候 会 运行 do_bootm linux 函数 ， 














至 此 ， 真 相 大 白 ， 一 切 事情 的 源头 都 源 于 如 下 命令 : 
bootz 80800000 - 83000000 














当 我 们 输入 上 述 命令 并 执行 以 后 ，do_bootz 函数 就 会 执行 ， 然 后 一 切 就 按照 图 43.6.2.4 中 











所 示 的 流程 开始 运行 。 


43.7 Linux 内 核 解析 DTB 文件 


Linux 内 核 在 启动 的 时 候 会 解析 DTB 文件 ， 然 后 在 /proc/device-tree 目录 下 生成 相应 的 设备 
树 节 点 文件 。 接 下 来 我 们 简单 分 析 一 下 Linux 内 核 是 如 何 解析 DTB 文件 的 , 流程 如 图 43.7.1 所 














ZN: 
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start kernel() 


setup arch() 


nflatten device tree() 


论坛 :www.opendev.com 


. unflatten device tree() 


图 43.7.1. 设备 树 节 点 解析 流程 








从 图 43.7.1 中 可 以 看 出 ， 在 start. kernel 函数 中 完成 了 
作 的 函数 为 unflatten dt node. 


43.8 绑 定 信息 文档 


设备 树 是 用 来 描述 板子 上 的 设备 信息 的 ， 不 同 的 设备 
不 同 。 那 么 我 们 在 设备 树 中 添加 一 个 硬 们 























É 





CERE 
F 对 应 的 节点 的 时 候 从 哪里 查阅 相关 的 说 明 呢 ? 在 


unflatten dt node () 





o 


设备 树 节 点 解析 的 工作 ， 最 终 实 际 工 


不 同 ， 反 映 到 设备 树 中 就 是 属 


ZNIÀIBH 4s 





Linux 内 核 源码 中 有 详细 的 .txt 文档 描述 了 如 何 添加 节点 , 这 些 .txt 文档 叫做 绑 定 文档 , 路 径 为 ; 
Linux 源码 目录 /Documentation/devicetree/bindings， 如 图 43.8.1 所 示 : 





^| sz |bindings 





主页 x5 ”查看 
+ B % 59 | x Í Th 新 建 项 目 
固定 到 ' 快 复制 ”粘贴 rise 移动 到 复制 到 MER 新 建 Le 
ESI" 复制 A x " 动 到 复制 到 R Bun i 
eig" [e] 粘贴 快捷 方式 ~ ~ ~ use 
剪贴 板 组 织 新 建 
€ ~ ^ . « Documentation > devicetree > bindings 
A Em ^ 修改 日 其 
x 快速 访问 
m 桌面 $ J arc 2019-06-03 
"um P T arm 2019-06-03 
i: W ata 9-06-03 
B 文档 * T bus 9-06-03 
& 图片 * T c6x 9-06-03 


T 第 15 讲 Linux Ci 
三 第 16 讲 make 工 
看 开发 手册 


E mermini 


88 个 项 目 


T clock 
T cpufreq 
T cris 

^ crypto 


2019-06-03 
9-06-03 
9-06-03 
9-06-03 








图 43.8.1 绑 定 文档 
比如 我 们 现在 要 想 在 LMX6ULL 这 颗 SOC 的 Dc 
Documentation/devicetree/bindings/i2c/i2c-imx.txt, Jb X FA 


在 设备 树 中 添加 2C 设备 节点 ， 文 档 内 容 如 下 所 示 : 
(I2C) 





* Freescale Inter IC and High Speed In 


Required properties: 


- compatible 


= Wigl.abgexil—3.2€" for L20 cxomuosiedxiole Wien En 


SOC 

















如 打开 - Memez 
编辑 全 部 取消 
已 历史 记录 C 反 向 选择 


打开 





iv] 
mt 

选择 
v O 搜索 "bindings” 


大 小 


分 门 别 类 存放 的 绑 定 
文档 

















下 添加 一 个 节点 ， 那 么 就 可 以 查看 
EF 细 的 描述 了 IMX 系列 的 SOC 如 何 








ter IC (El eV 





one integrated on i.MX1 





- "fsl,imx21-i2c" for I2C compatible with the one integrated on i.MX21 


Se 
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= "iel.wi610-i2eV" fox T20 (cowostilelce wira ile ne el 





VESLO SOG 

= see 8 Should contain I2(€/15-—12( registers location and lenden 
= interrupts Snove contain T2C/HS=12C sbeueeseseiuioe 

= &locks s Should comrama the I2C/HBS$-I2(C Clock sypxeeu:ier 


Optional properties: 
= clock-frequency : Constains desired I2C/HS-I2C bus clock frequency in 
IU o 

The absence of the propoerty indicates the default frequency 100 kHz. 
- dmas: A list of two dma specifiers, one for each entry in dma-names. 


~ dma-names: should contain "tx" and "rx". 





Examples: 


aser lSis ed 000 A /= T2C2 DECIMI 
Cowgpetisle -— Ufsl,:uwps51-i2e", "isl,im21-—12e"7 
reg = «0x83fc4000 0x4000»; 
interrupts - «63»; 

}; 


126070038000 1 on/ 
Cowmpetisle — VUfsgl,iwps51-i2e",. Visl,im:21-—12e"5 
reg = «0x70038000 0x4000»; 
interrupts = «64»; 
clock-frequency - «400000»; 
}; 


L20; 12c0/0066000 { /= i2e0 om vielo */ 
compati oiei Vis witl10-iu2g"rp 
reg = <0x40066000 0x1000>; 
interrupts =<0 71 0x04>; 
dmas = <&edma0 0 50>, 
«&edma0 0 51»; 
Ohus-ieunes e "ux" E 


hg 








有 时 候 使 用 的 一 些 忌 片 在 Documentation/devicetree/bindings. 目录 下 找 不 到 对 应 的 文档 ， 这 
个 时 候 就 要 咨询 芯片 的 提供 商 ， 让 他 们 给 你 提供 参考 的 设备 树 文件 。 


43.9 设备 树 常用 OF 操作 函数 


设备 树 描 述 了 设备 的 详细 信息 ， 这 些 信息 包括 数字 类 型 的 、 字 符 串 类 型 的 、 数 组 类 型 的 ， 
我 们 在 编写 驱动 的 时 候 需 要 获取 到 这 些 信 息 。 比 如 设备 树 使 用 reg 属性 描述 了 某 个 外 设 的 寄存 
器 地 址 为 0X02005482， 长 度 为 0X400， 我 们 在 编写 驱动 的 时 候 需要 获取 到 reg 属性 的 
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0X02005482 和 0X400 这 两 个 值 ， 然 后 初始 化 外 设 。Linux 内 核 给 我 们 提供 了 一 系列 的 函数 来 获 























取 设 备 树 中 的 节点 或 者 属性 信息 ， 这 一 系列 的 函数 都 有 一 个 统一 的 前 级 “of ”， 所 以 在 很 多 资 
料 里 面 也 被 叫做 OF 函数 。 这 些 OF 函数 原型 都 定义 在 include/linux/of.h 文件 中 。 




















43.9.1 查找 节点 的 OF 函数 


设备 都 是 以 节点 的 形式 “ 挂 ” 到 设备 树 上 的 ， 因 此 要 想 获 取 这 个 设备 的 其 他 属性 信息 ， 必 
须 先 获取 到 这 个 设备 的 节点 。Linux 内 核 使 用 device node 结构 体 来 描述 一 个 节点 ， 此 结构 体 定 
义 在 文件 include/linux/of.h F, E XWF: 
示例 代码 43.3.9.1 device_node 节点 








Se Glewuce ioo d 














50 const char *name; /* 节点 名 字 */ 
5l const char *type; /* 设备 类 型 on] 
2 phandle phandle; 

53 const char *full name; /* 节点 全 名 
54 struct fwnode handle fwnode; 

55 

56 struct property *properties; /* 属性 */ 
57 struct property *deadprops; /* removed 属性 */ 
58 struct device node *parent; /* SE xy 
59 struct device_node *child; /* ER a 
60 strict Cevice node vso ime? 

61 StEruee leyes «9 Pp 

62 unsigned long flags; 

63 void "elei e 

64 #if defined(CONFIG SPARC) 

65 Const Char voath Component Neme, 

66 unsigned int unique id; 

67 SEUVEE OF ira Conroe wire Eranss 

68 endif 

o9 





与 查找 节点 有 关 的 OF 函数 有 5 个 ， 我 们 依次 来 看 一 下 。 
1. of find node by name 函数 
of find node by name 函数 通过 节点 名 字 查 找 指定 的 节点 ， 函 数 原 型 如 下 ; 








struct device node *of find node by name(struct device node *from, 
const char *name); 
函数 参数 和 返回 值 含义 如 下 : 





from: 开始 查找 的 节点 ， 如 果 为 NULL 表示 从 根 节点 开始 查找 整个 设备 树 。 
name: 要 查找 的 节点 名 字 。 

返回 值 ， 找 到 的 节点 ， 如 果 为 NULL 表示 查找 失败 。 

2. of find node by type 函数 

of find node by type 函数 通过 device type 属性 查找 指定 的 节点 ， 函 数 原型 如 下 : 
struct device node *of find node by type(struct device node *from, const char *type) 











1102 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
函数 参数 和 返回 值 含 义 如 下 : 
from: 开始 查找 的 节点 ， 如 果 为 NULL 表示 从 根 节 点 开始 查找 整个 设备 树 。 
type: 要 查找 的 节点 对 应 的 type 字符 串 ， 也 就 是 device_ type 属性 值 。 
返回 值 : 找到 的 节点 ， 如 果 为 NULL 表示 查找 失败 。 











3. of find compatible node 函数 


of find compatible node 函数 根据 device type 和 compatible 这 两 个 属性 查找 指定 的 节点 ， 
函数 原型 如 下 : 


struct device node *of find compatible node(struct device node ^ *from, 





const char *type, 
const char *compatible) 
函数 参数 和 返回 值 含义 如 下 : 
from: 开始 查找 的 节点 ， 如 果 为 NULL 表示 从 根 节 点 开始 查找 整个 设备 树 。 
type: 要 查找 的 节点 对 应 的 type 字符 串 ， 也 就 是 device type 属性 值 ， 可 以 为 NULL， 表 示 
忽略 掉 device type 属性 。 
compatible: 要 查找 的 节点 所 对 应 的 compatible 属性 列表 。 
返回 值 ， 找 到 的 节点 ， 如 果 为 NULL 表示 查找 失败 
4. of find matching node and match 函数 
of find matching node and match 函数 通过 of device id 匹配 表 来 查找 指定 的 节点 , 函数 原 
型 如 下 : 


struct device node *of find matching node and match(struct device node *from, 









































const struct of device id *matches, 
const struct of device id **match) 

函数 参数 和 返回 值 含义 如 下 : 

from: 开始 查找 的 节点 ， 如 果 为 NULL 表示 从 根 节点 开始 查找 整个 设备 树 。 

matches: of device id 匹配 表 ， 也 就 是 在 此 匹配 表 里 面 查找 节点 。 

match: 找到 的 匹配 的 of device id. 

返回 值 ， 找 到 的 节点 ， 如 果 为 NULL 表示 查找 失败 

5. of find node by path 函数 


of find node by path 函数 通过 路 径 来 查找 指定 的 节点 ， 函 数 原型 如 下 : 
inline struct device node *of find node by path(const char *path) 
函数 参数 和 返回 值 含义 如 下 : 
path: 带 有 全 路 径 的 节点 名 ， 可 以 使 用 节点 的 别名 ， 比 如 “/backlight” 就 是 backlight 这 个 
节点 的 全 路 径 。 
返回 值 ; 找到 的 节点 ， 如 果 为 NULL 表示 查找 失败 









































43.9.2 查找 父子 节点 的 OF 函数 


Linux 内 核 提 供 了 几 个 查找 节点 对 应 的 父 节点 或 子 节 点 的 OF 函数 ， 我 们 依次 来 看 一 下 。 
1. of get parent 函数 
of get parent 函数 用 于 获取 指定 节点 的 父 节 点 (如 果 有 父 节 点 的 话 )， 函 数 原型 如 下 ; 


struct device node *of get parent(const struct device node *node) 


函数 参数 和 返回 值 含 义 如 下 : 
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node: 要 查找 的 父 节点 的 节点 。 
返回 值 : 找到 的 父 节 点 。 
2. of get next child 函数 























of get next child 函数 用 迭代 的 查找 子 节点 ， 函 数 原 型 如 下 : 








struct device node *of get next child(const struct device node *node, 
struct device node *prev) 
函数 参数 和 返回 值 含 义 如 下 : 


node: 父 节 点 。 

prev: 前 一 个 子 节点 ， 也 就 是 从 哪 一 个 子 节点 开始 迭代 的 查找 下 一 个 子 节点 。 可 以 设置 为 
NULL， 表 示 从 第 一 个 子 节点 开始 。 

返回 值 ， 找 到 的 下 一 个 子 节点 。 








43.9.3 提取 属性 值 的 OF 函数 


节点 的 属性 信息 里 面 保存 了 驱动 所 需要 的 内 容 , 因此 对 于 属性 值 的 提取 非常 重要 , Linux 内 
核 中 使 用 结构 体 property 表示 属性 ， 此 结构 体 同 样 定义 在 文件 include/linux/of.h 中 ， 内 容 如 下 : 
示例 代码 43.9.3.1 property 结构 体 





















































53/5) Se ee oul oe en | 








36 char *name; /* 属性 名 字 
B int length; /* 属性 长 度 
38 void *value; /* 属性 值 i 
39 struct property *next; /* 下 一 个 属性 uff 
40 unsigned long flags; 

41 uasigpoecl Lat ne 

42 StruGE binm attribute attr} 

Zr. 








Linux 内 核 也 提供 了 提取 属性 值 的 OF 函数 ， 我 们 依次 来 看 一 下 。 
1. of find property 函数 


of find property 函数 用 于 查找 指定 的 属性 ， 函 数 原型 如 下 ; 
property *of find property(const struct device node *np, 








const char *name, 
int *lenp) 
函数 参数 和 返回 值 含义 如 下 : 


np: 设备 节点 。 

name: ”属性 名 字 。 

lenp: 属性 值 的 字 节 数 

返回 值 : 找到 的 属性 。 

2. of property count elems of size 函数 


of property count elems of size 函数 用 于 获取 属性 中 元 素 的 数量 ， 比 如 reg 属性 值 是 一 个 
数组 ， 那 么 使 用 此 函数 可 以 获取 到 这 个 数组 的 大 小 ， 此 函数 原型 如 下 : 


int of property count elems of size(const struct device node *np, 





























const char *propname, 


1104 


I.MX6U HX Linux 驱动 开发 指南 e» 1E za [m T 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
int elem size) 
函数 参数 和 返回 值 含义 如 下 : 


np: 设备 节点 。 

proname: ”需要 统计 元 素数 量 的 属性 名 字 。 

elem_size: 元 素 长 度 。 

返回 值 ， 得 到 的 属性 元 素数 量 。 

3. of property read u32 index 函数 

of property read u32 index 函数 用 于 从 属性 中 获取 指定 标号 的 u32 类 型 数据 值 (无 符号 32 
位 )， 比 如 某 个 属性 有 多 个 u32 类 型 的 值 ， 那 么 就 可 以 使 用 此 函数 来 获取 指定 标号 的 数据 值 ， 此 
函数 原型 如 下 : 


int of property read u32 index(const struct device node *np, 




































































const char *propname, 
u32 index, 
u32 *out value) 


函数 参数 和 返回 值 含 义 如 下 : 
np: 设备 节点 。 
proname: ”要 读 取 的 属性 名 字 。 
index: 要 读 取 的 值 标号 。 
out_value: 读 取 到 的 值 
返回 值 : 0 读 取 成 功 ， 负 值 ， 读 取 失 败 ，-EINVAL 表示 属性 不 存在 ，-ENODATA 表示 没有 
要 读 取 的 数据 ，-EOVERFLOW 表示 属性 值 列表 太 小 。 
4. of property read u8 array 函数 
of property read ul6 array 函数 
of property read u32 array 函数 
of property read u64 array 函数 
这 4 个 函数 分 别 是 读 取 属性 中 u8、u16、u32 和 u64 类 型 的 数组 数据 ， 比 如 大 多 数 的 reg 属 
性 都 是 数组 数据 ， 可 以 使 用 这 4 个 函数 一 次 读 取出 reg 属性 中 的 所 有 数据 。 这 四 个 函数 的 原型 
如 下 : 


int of property read u8 array(conststruct device node — *np, 









































const char *propname, 
u8 *out values, 
size t SZ) 


int of property read ul6 array(const struct device node *np, 


const char *propname, 
ul6 *out values, 
size t SZ) 


int of property read u32 array(const struct device node *np, 


const char *propname, 
u32 *out values, 
size t SZ) 


int of property read u64 array(const struct device node *np, 
const char *propname, 
u64 *out values, 
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size t SZ) 
函数 参数 和 返回 值 含义 如 下 : 


np: 设备 节点 。 
proname: ”要 读 取 的 属性 名 字 。 
out value: 读 取 到 的 数组 值 ， 分 别 为 u8、u16、u32 和 u64。 
sz: 要 读 取 的 数组 元 素数 量 。 
返回 值 ， 0， 读 取 成 功 ， 负 值 ， 读 取 失 败 ，-EINVAL 表示 属性 不 存在 ，-ENODATA 表示 没 
有 要 读 取 的 数据 ，-EOVERFLOW 表示 属性 值 列 表 太 小 。 
5. of property read u8 函数 
of property read ul6 函数 
of property read u32 函数 
of property read u64 函数 
有 些 属性 只 有 一 个 整形 值 ， 这 四 个 函数 就 是 用 于 读 取 这 种 只 有 一 个 整形 值 的 属性 ， 分 别 用 
于 读 取 u8、u16、u32 和 u64 类 型 属性 值 ， 函 数 原型 如 下 : 
int of property read u8(const struct device node *np, 

























































































const char *propname, 

u8 *out value) 
int of property read ul6(const struct device node ^ *np, 

const char *propname, 

ul6 *out value) 
int of property read u32(conststruct device node ^ *np, 

const char *propname, 

u32 *out value) 


int of property read u64(conststruct device node ^ *np, 


const char *propname, 
u64 *out value) 
函数 参数 和 返回 值 含义 如 下 : 


np: 设备 节点 。 

proname: ”要 读 取 的 属性 名 字 。 

out_value: 读 取 到 的 数组 值 。 

返回 值 ，0， 读 取 成 功 ， 负 值 ， 读 取 失 败 ，-EINVAL 表示 属性 不 存在 ，-ENODATA 表示 没 
有 要 读 取 的 数据 ，-EOVERFLOW 表示 属性 值 列表 太 小 。 


6. of property read string 函数 


of property read string 函数 用 于 读 取 属 性 中 字符 串 值 ， 函 数 原 型 如 下 : 
int of property read string(struct device node — *np, 



































const char *propname, 
const char **out string) 
函数 参数 和 返回 值 含义 如 下 : 
np: 设备 节点 。 
proname: ”要 读 取 的 属性 名 字 。 
out string: 读 取 到 的 字符 串 值 。 
返回 值 : 0， 读 取 成 功 ， 负 值 ， 读 取 失 败 。 
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7. of n addr cells 函数 


of n addr cells 函数 用 于 获取 #address-cells 属性 值 ， 函 数 原型 如 下 : 
int of n addr cells(struct device node *np) 

函数 参数 和 返回 值 含 义 如 下 : 
np: 设备 节点 。 








论坛 :www.opendev.com 








返回 值 ， 获取 到 的 加 ddress-cells 属性 值 。 
8. of n size cells 函数 
F3kBUtsize-cells 属性 值 ， 函 数 原 型 如 下 : 


of size cells 函数 
































int of n size cells(struct device node *np) 
函数 参数 和 返回 值 含义 如 下 : 
np: 设备 节点 。 





返回 值 ， 获 取 到 的 #size-cells 属性 值 。 


43.9.4 其 他 常用 的 OF 函数 





1、of device is_compatible 函数 
of device is_compatible 函数 用 于 查看 节点 的 compatible 属性 是 否 有 包含 compat 指定 的 字 
符 串 ， 也 就 是 检查 设备 节点 的 兼容 性 ， 函 数 原型 如 下 : 
































int of device is compatible(const struct device node *device, 
const char *compat) 
函数 参数 和 返回 值 含义 如 下 : 
device: 设备 节点 。 
compat: 要 查看 的 字符 串 。 











返回 值 : 0, 节点 的 compatible 属性 中 包含 compat 指定 的 字符 串 ; 其 他 值 , 节点 的 compatible 




















"uni 
e 
Lar 


不 包含 compat 指定 的 字符 


2. of get address 函数 
of get address 函数 月 


值 ， 函 数 属 





生 如 下 : 





H 
Ho 














日 于 获取 地 址 相关 属性 ， 主 要 是 “reg” 或 者 “assigned-addresses” 属 性 








const  be32 *of get address(struct device node *dev, 


函数 参数 和 返回 值 含 义 如 下 : 
dev: 设备 节点 。 


index: 





size: 地 址 长 度 。 
flags: 参数 ， 比 如 IORESOURCE IO. IORESOURCE MEM 等 
读 取 到 的 地 址 数据 首 地 址 ， 为 NULL 的 话 表 示 读 取 失 败 。 
3. of translate address 函数 

of translate address 函数 负责 
u64 of translate address(struct device node *dev, 


返回 值 : 


要 读 取 的 地 址 标号 。 


int index, 
u64 *size, 
unsigned int *flags) 




















将 从 设备 树 读 取 到 的 地 址 转换 为 物理 地 址 ， 函 数 原型 如 下 : 
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const  be32 *in addr) 
函数 参数 和 返回 值 含 义 如 下 : 
dev: 设备 节点 。 
in_addr: 要 转换 的 地 址 。 
返回 值 ， 得 到 的 物理 地 址 ， 如 果 为 OF BAD ADDR 的 话 表示 转换 失败 。 





4. of address to resource 函数 


IC, SPI, GPIO 等 这 些 外 设 都 有 对 应 的 寄存 器 ,这 些 寄 存 器 其 ，Linux 
内 核 使 用 resource 结构 体 来 描述 一 段 内 存 空间 ,“resource ”翻译 出 来 就 是 “资源 ”, 因此 用 resource 
结构 体 描述 的 都 是 设备 资源 信息 ，resource 结构 体 定义 在 文件 noui de diens 中 ， 定 义 如 
T: 




































































示例 代码 43.9.4.1 resource 结构 体 


Ner SEruUcE resource 








ENS resource Size t start, 

20 ESGUEGES Size t endie 

al const char *name; 

D» unsigned long flags; 

23 struct resource *parent, *sibling, *child; 
2H 











对 于 32 位 的 SOC OK. resource size t 是 u32 类 型 的 。 其 中 start 表示 开始 地 址 ，end 表示 
结束 地 址 ，name 是 这 个 资源 的 名 字 ，flags 是 资源 标志 位 ， 一 般 表 示 资 源 类 型 ， 可 选 的 资源 标志 
定义 在 文件 include/linux/ioport.h 中 ， 如 下 所 示 : 
示例 代码 43.9.4.2 资源 标志 


























































































































































































































1 #define IORESOURCE BITS 0x000000ff 
2 define IORESOURCE TYPE BITS 0x00001£00 
3 4define IORESOURCE IO 0x00000100 
4 $define IORESOURCE M 0x00000200 
5 define IORESOURCE REG 0x00000300 
6 4define IORESOURCE IRQ 0x00000400 
7 4define IORESOURCE DMA 0x00000800 
8 4define IORESOURCE BUS 0x00001000 
9 4define IORESOURCE PREFETCH 0x00002000 
10 4define IORESOURCE READONLY 0x00004000 
11 #define IORESOURCE CACHEABLE 0x00008000 
12 #define IORESOURCE RANGELENGTH  0x00010000 
13 &define IORESOURCE SHADOWABLE ^ 0x00020000 
14 #define IORESOURCE SIZEALIGN  — 0x00040000 
15 #define IORESOURCE STARTALIGN ^ 0x00080000 
16 #define IORESOURCE MEM 64 0x00100000 
17 $define IORESOURCE WINDOW 0x00200000 
18 4define IORESOURCE MUXED 0x00400000 
19 $define IORESOURCE EXCLUSIVE  0x08000000 
20 4$define IORESOURCE DISABLED 0x10000000 
21 $define IORESOURCE UNSET 0x20000000 
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22 4$define IORESOURCE AUTO 0x40000000 
23 4$define IORESOURCE BUSY 0x80000000 











大 家 一 般 最 常见 的 资源 标志 就 是 IORESOURCE MEM . IORESOURCE REG 和 
IORESOURCE IRQ 等 。 接 下 来 我 们 回 到 of address to resource 函数 ， 此 函数 看 名 字 像 是 从 设 
备 树 里 面 提取 资源 值 ， 但 是 本 质 上 就 是 将 reg 属性 值 ， 然 后 将 其 转换 为 resource 结构 体 类 型 ， 
函数 原型 如 下 所 示 


int of address to resource(struct device node — *dev, 

















int index, 
struct resource *r) 
函数 参数 和 返回 值 含义 如 下 : 


dev: 设备 节点 。 

index: 地 址 资源 标号 。 

r: 得 到 的 resource 类 型 的 资源 值 。 

返回 值 : 0， 成 功 ， 负 值 ， 失 败 。 

5. of iomap 函数 

of iomap 函数 用 于 直接 内 存 映 射 ， 以 前 我 们 会 通过 ioremap 函数 来 完成 物理 地 址 到 虚拟 地 
址 的 映射 ， 采 用 设备 树 以 后 就 可 以 直接 通过 of iomap 函数 来 获取 内 存 地 址 所 对 应 的 虚拟 地 址 ， 
不 需要 使 用 ioremap 函数 了 。 当 然 了 ， 你 也 可 以 使 用 ioremap 函数 来 完成 物理 地 址 到 虚拟 地 址 
的 内 存 映 射 ， 只 是 在 采用 设备 树 以 后 ， 大 部 分 的 驱动 都 使 用 of iomap 函数 了 。of iomap 函数 本 
质 上 也 是 将 reg 属性 中 地 址 信息 转换 为 虚拟 地 址 ， 如 果 reg 属性 有 多 段 的 话 ， 可 以 通过 index 参 
数 指定 要 完成 内 存 映射 的 是 那 一 段 ，of iomap 函数 原型 如 下 : 


void  iomem *of iomap(struct device node ^ *np, 




































































int index) 

函数 参数 和 返回 值 含 义 如 下 : 

np: 设备 节点 。 

index: reg 属性 中 要 完成 内 存 映 射 的 段 ， 如 果 reg 属性 只 有 一 段 的 话 index 就 设置 为 0。 

返回 值 ， 经 过 内 存 映 射 后 的 虚拟 内 存 首 地 址 ， 如 果 为 NULL 的 话 表示 内 存 映射 失败 。 

关于 设备 树 常用 的 OF 函数 就 先 讲解 到 这 里 ，Linux 内 核 中 关于 设备 树 的 OF 函数 不 仅仅 只 
有 前 面 讲 的 这 几 个 ， 还 有 很 多 OF 函数 我 们 并 没有 讲解 ， 这 些 没有 讲解 的 OF 函数 要 结合 具体 
的 驱动 ， 比 如 获取 中 断 号 的 OF 函数 、 获 取 GPIO 的 OF 函数 等 等 ， 这 些 OF 函数 我 们 在 后 面 的 
驱动 实验 中 再 详细 的 讲解 。 

关于 设备 树 就 讲解 到 这 里 ， 关 于 设备 树 我 们 重点 要 了 解 一 下 几 点 内 容 : 

(D. DTS, DTB 和 DTC 之 间 的 区 别 ， 如 何 将 .dts 文件 编译 为 .dtb 文件 。 

名 、 设 备 树 语法 ， 这 个 是 重点 ， 因 为 在 实际 工作 中 我 们 是 需要 修改 设备 树 的 。 

(9、 设 备 树 的 几 个 特殊 子 节 点 。 

(、 关 于 设备 树 的 OF 操作 函数 ， 也 是 重点 ， 因 为 设备 树 最 终 是 被 驱动 文件 所 使 用 的 ， 而 
驱动 文件 必须 要 读 取 设 备 树 中 的 属性 信息 ， 比 如 内 存 信息 、GPIO 信息 、 中 断 信 息 等 等 。 要 想 在 
驱动 中 读 取 设备 树 的 属性 值 ， 那 么 就 必须 使 用 Linux 内 核 提供 的 众多 的 OF 函数 。 

从 下 一 章 开始 所 以 的 Linux 驱动 实验 都 将 采用 设备 树 ， 从 最 基本 的 点 灯 ， 到 复杂 的 音频 、 
网 络 或 块 设备 等 驱动 。 将 会 带领 大 家 由 简 入 深 ， 深 度 剖析 设备 树 ， 最 终 掌 握 基 于 设备 树 的 驱动 
开发 技能 。 
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第 四 十 四 章 设备 树 下 的 LED 驱动 实验 


上 一 章 我 们 详细 的 讲解 了 设备 树 语法 以 及 在 驱动 开发 中 常用 的 OF 函数 ， 本 章 我 们 就 开始 
第 一 个 基于 设备 树 的 Linux 驱动 实验 。 本 章 在 第 四 十 二 章 实验 的 基础 上 完成 ， 只 是 将 其 驱动 开 
发 改 为 设备 树 形 式 而 已 。 
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44.1 设备 树 LED 驱动 原理 
在 《第 四 十 二 章 新 字符 设备 驱动 实验 》 中 ， 我 们 直接 在 驱动 文件 newchrled.c 中 定义 有 关 


























寄存 器 物理 地 址 ， 然 后 使 用 io remap 函数 进行 内 存 映射 ， 得 到 对 应 的 虚拟 地 址 ， 最 后 操作 寄存 
器 对 应 的 虚拟 地 址 完成 对 GPIO 的 初始 化 。 本 章 我 们 在 第 四 十 二 章 实 验 基 础 上 完成 ， 本 章 我 们 
使 用 设备 树 来 向 Linux 内 核 传递 相关 的 寄存 器 物理 地 址 ，Linux 驱动 文件 使 用 上 一 章 讲解 的 OF 
函数 从 设备 树 中 获取 所 需 的 属性 值 ， 然 后 使 用 获取 到 的 属性 值 来 初始 化 相关 的 IO 。 本 章 实 验 还 
是 比较 简单 的 ， 本 章 实验 重点 内 容 如 下 ; 

(D. Æ imx6ull-alientek-emmec.dts 文件 中 创建 相应 的 设备 节点 。 

包 、 编 写 驱动 程序 (在 第 四 十 二 章 实 验 基础 上 完成 )， 获 取 设 备 树 中 的 相关 属 ! 

(3)、 使 用 获取 到 的 有 关 属 性 值 来 初始 化 LED 所 使 用 的 GPIO. 


44.2 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 8.3 小 节 即 可 。 


44.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 :， 开发 板 光 盘 -> 2. Linux 驱动 例 程 -> 4_dtsled。 
本 章 实 验 在 四 十 二 章 实验 的 基础 上 完成 ， 重 点 是 将 驱动 改 为 基于 设备 树 的 . 

































































-=> 


生 值 。 









































44.3.1 修改 设备 树 文 件 


在 根 节 “/” 下 创建 一 个 名 为 “alphaled” 的 子 节点 ， 打 开 imx6ull-alientek-emmc.dts 文件 ， 
在 根 节点 “/” 最 后 面 输入 如 下 所 示 内 容 : 
示例 代码 44.3.1.1 alphaled 节点 




















1 alphaled { 

2 #address-cells = <1>; 

E fsize-cells = «1»; 

4 compatible = "atkalpha-led"; 

S Status - "okay"; 

6 reg = < 0X020C406C 0X04 /ECMCCGRT PASE mf 
7 0X020E0068 0X04 /* SW MUX GPIOl IO03 BASE  */ 
8 0X020E02F4 0X04 /* SW PAD GPIOl IO03 BASE  */ 
9 0X0209C000 0X04 VS GETOOI DE PASE mu 
10 0xX0209C004 0X04 >; /* GETOOI GDIR BASE */ 











aT 

58 2. 3 行 ， 属 性 加 ddress-cells 和 #size-cells 都 为 1， 表示 reg 属性 中 起 始 地 址 占用 要 给 字 长 
(cel)， 地 址 长 度 也 占用 一 个 字 长 (cel)。 

第 4 行 ， 属 性 compatbile 设置 alphaled 节点 兼容 性 为 “atkalpha-led ". 

第 5 fT, TE status 设置 状态 为 “okay ”。 

第 6~10 1T, reg 属性， 非常 重要 ! reg 属性 设置 了 驱动 里 面 所 要 使 用 的 寄存 器 物理 地 址 ， 比 
如 第 6 行 的 “0X020C406C 0X04” 表 示 LMX6ULL 的 CCM CCGRI 寄存 器 ， 其 中 寄存 器 首 地 
址 为 0X020C406C， 长 度 为 4 个 字 节 。 

设备 树 修 改 完成 以 后 输入 如 下 命令 重新 编译 一 下 imx6ull-alientek-emmc.dts: 
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Imake dtbs 
编译 完成 以 后 得 到 imx6ull-alientek-emmc.dtb， 使 用 新 的 imx6ull-alientek-emmc. 动 

















Linux 内 核 。Linux 启动 成 功 以 后 i 
结果 如 图 44.3.1.1 所 示 : 








HW, 


/ € cd /proc/device-tree/ 
/sys/firmware/devicetree/base £ 
&address-cells 

roje- -cells 





compatible 
cpus 
interrupt-controller@00a01000 


入 到 /proc/device-tree/ 目 录 中 查看 


论坛 :Www.opendev.com 





ANH 


是 ee 


AE 


fmt 





*alphaled " 








ls 


memory 

mode] 

name 

pxp. v412 
regulators 
reserved-memory 
soc 

sound 

spi4 


图 44.3.1.1 alphaled 节点 


如 果 没 有 “alphaled” 








©, REE 
可 以 进入 到 图 44.3.1 中 的 alphaled 目录 中 ， 
所 示 : 


节点 的 话 请 重点 下 面 两 点 : 
Q(、 检 查 设备 树 修 改 是 否 成 功 ， 也 就 是 alphaled 节点 
否 使 用 新 的 设备 树 启动 的 Linux 内 核 。 


El 
AE 





否 为 根 节点 “/” 的 子 节点 。 


查看 一 下 都 有 哪些 属性 文件 ,结果 如 图 





44.3.1.2 











/sys/firmware/devicetree/base/alphaled # 1s 


Zaddress-cells 


compatible 
#size-cells 


name 


reg 


y; I PRPPR hn Ma fe he Te # 
图 44.3.1.2 alphaled 节点 文件 


大 家 可 以 查看 一 下 compatible、status 等 





44.3.2 LED 灯 驱 动 程序 编写 


属性 





值 是 否 和 我 们 设置 的 一 致 。 








设备 树 准 备 好 以 后 就 可 以 编写 好 
newchrled.c 的 基础 上 修改 而 来 。 





























K 动 程序 了 ， 本 章 实验 在 第 
新 建 名 为 “4_dtsled” 文 件 夹 ， 然 后 在 4_dtsled 文件 夹 里 面 创建 


四 十 二 章 实验 驱动 文件 









































vscode 工程 ， 工 作 区 命名 为 “dtsled”。 
如 下 内 容 : 











工程 创建 好 以 后 新 建 dtsled.c 文件 ， 在 dtsled.c 里 面 输入 











示例 代码 44.3.2.1 dtsled.c 文件 内 容 


de 
de 
de 
de 
de 
de 
de 
de 
de 


fincl <linux/types.h> 
x/kernel.h» 
x/delay.h» 
x/ide.h» 
x/init.h» 


x/module.h» 


#inclu «linu 


#inclu «linu 


dinclu «linu 


#inclu «linu 


dinclu «linu 


dinclu «linux/errno.h» 


fincl «linux/gpio.h» 
x/cdev.h» 
«linux/device.h» 
«linux/of.h» 


«linux/of address.h» 


EOUECOUE- TOC ES CODES ILS 














#inclu Er 


本 
Ce 


dinclude 


m 
p 


#include 


EX 
N 


#include 
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13 #include «asm/mach/map.h» 


14 d£include «asm/uaccess.h» 
15 4$include «asm/io.h» 


16 /大 大 大 炎炎 炎炎 火炎 炎炎 火炎 火炎 火炎 炎炎 火炎 火炎 火炎 大 大 火炎 火炎 大 大 大 大 大大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 


us Gor vastes NIE Co re Eo 2202 A ES essere 














18 文件 名 ES 

IRE : AE 

20 版 本 s E 

21 描述 : LED 驱动 文件 。 

22 ”其 他 e JE 

23 iex : www.openedv.com 

24 Ba : 初版 V1.0 2019/7/9 左 忠 凯 创建 

A KOKCKCKCKCkCKCkCk kCkCk k kc k Ck kCkCk k kk k kc k k kk Ck k k Ck kCk Ck k kc k k kc k Ck kc k Ck kck ck kck ck ckck ck ckck ck kck c ke kk f 
26 4define DTSLED CNT il /[* ea RE */ 
27 4define DTSLED NAME acele sso ay 
28 define LEDOFF 0 SC ay 
29 #define LEDON i SAT m 
30 


31 /* 映射 后 的 寄存 器 虚拟 地 址 指针 */ 

32, pratic woe! _ iomem 和 CCM COERL? 
33) Statie voici _ iomem "SN MUX (GIO 0037 
34 static void . iomem *SW PAD GPIOT IO03; 
35 tarie void lomem “CEPIOl DR 

J SEAaELE Voie Temem “EPIOlL CDIR? 

27 

38 /* dtsled 设备 结构 体 */ 

S9) gno GOhcsJeel cevi 

















40 dev t devid; /* 设备 号 
41 struct cdev cdev; /* cdev Sr] 
42 reme Class vClass, pamm a 
43 struct device *device;  /* 设备 un 
44 int major; /* 主 设备 号 A7 
45 iw maor /* 次 设备 号 By 
46 struct device node *nd; /* 设备 节点 */ 
zT dg 

48 

49 struct dtsled dev dtsled;  /* led &$& */ 

50 

Su 4 

52  * Qdescription : LED 打开/ 关闭 

53  * (param - sta  : LEDON(0) ADi LED, LEDOFF(1) XH] LED 
54  * Qreturn e JE 

55 i 
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56 void led switch(u8 sta) 

SN 

58 u32 val 2 0; 

59 if(sta == LEDON) ( 

60 val -2 readl(GPIOl1 DR); 
61 val &- «(| << 3); 

62 weitelval, (GEO IR) 
63 Jelse if(sta == LEDOFF) ( 
64 val = readl(GPIO1 DR); 
65 val|2 (1 «« 3); 

66 writel(val, GPIO1 DR); 
67 } 

6am} 

69 

qo. quee 

71  * Qdescription  : 打开 设备 


72  * Qparam - inode : 传递 给 驱动 的 inode 
73  * Qparam - filp : 设备 文件 ， file 结构 体 有 个 叫做 private data 的 成 员 变 量 





74 | * 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
J5 ats este US : 0 成 功 ; 其 他 失败 
EIS =y 


(d) tetic int lec el vinode, struct iile wiilp) 
qve x 


79 filp-»private data = &dtsled; /* 设置 私有 数据 */ 
80 return 0; 

81 ) 

82 

99. gue 


84 * Qdescription : 从 设备 读 取 数 据 

85  * @param - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 

86  * @param - buf : 返回 给 用 户 空间 的 数据 缓冲 区 

87 * (param - cnt : 要 读 取 的 数据 长 度 

88  * @param - offt : 相对 于 文件 首 地 址 的 偏 移 

89  * Qreturn : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 

DONE 

9 es © lee rəad(srcruct iile virili, Char _ (eer oui, Sume t 


Cnty loti "E vorit) 





om Y 

DE return 0; 
94 } 

D 

PIOS 


97 * Qdescription : 向 设备 写 数据 
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98  * @param - filp : 设备 文件 ， 表 示 打 开 的 文件 描述 符 

99  * aran - buf : 要 写 给 设备 写 入 的 数据 

100 * Qparam - cnt : 要 写 入 的 数据 长 度 

101 * @param - offt : 相对 于 文件 首 地 址 的 偏 移 

102 * Qreturn : 写 入 的 字 节 数 ， 如 果 为 负 值 ， 表 示 写 入 失败 

103 y 

lo starcie gsize © led vritel(struct file iili. Const cle _ User Jout, 
Size t Cnt, loti t Woxitt) 


























WS NET 

106 int retvalue; 

IO unsigned char databuf[1]; 

108 unsigned char ledstat; 

ROIG 

110 retvalue = copy from user(databuf, buf, cnt); 
dtt if(retvalue « 0) ( 

1102) printk("kernel write failed!Nr*in"); 

ISS return -EFAULT; 

114 } 

S 

116 ledsrat = darabra [os /* 获取 状态 值 ir 
deir, 

LIS if(ledstat == LEDON) { 

119 led switch (LEDON) ; Js SPEED) d] 5 
120 ) else if(ledstat == LEDOFF) ( 

1.2 led switch (LEDOFF); /* 关闭 LED 灯  */ 
125 } 

12S return 0; 

Tay 

2S 

iA diss 


127 * Qdescription  : 关闭 /释放 设备 

128 * @param - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 

2 : 0 成 功 ;其 他 失败 

TEO ay 

ISi statie imt led releaselstruct imods vinode, struct tile virile) 
T2 

133 return 0; 

1940] 

1S5 

136 /* 设备 操作 函数 */ 

1.37 statie struct tile operations ohslec| tops = q 

138 .owner — THIS MODULE, 





1 S39) .open = led open, 
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140 eae = led cud 

141 .write = led write, 

142 saclecsee = lec! release, 

143 ); 

144 

un 

146 * Qdescription  : 驱动 出 口 函数 
147 * @param B8 JE 

148 * QGreturn 3 JE 

JL Gay 

JL5(0 statie ime — tate leci stie (voeh) 
TSi 

Jd u32 val 2 0; 

IGS int ret; 

154 u32 regdata[14];: 

T55 const Tenem .oes 

SG struct property *proper; 

Tsy 


158 /* 获取 设备 树 中 的 属性 数据 */ 
159 /* 1、 获 取 设 备 节 点 : alphaled */ 


160 dtsled.nd = of find node by path("/alphaled"); 
161 if(dtsled.nd == NULL) ( 

162 printk("alphaled node nost find!NrMn"); 
163 return -EINVAL; 

164 ) else ( 

165 printk("alphaled node find!Nr Mn"); 

166 ) 

167 


168 /* 2、 获 取 compatible 属性 内 容 */ 
169 proper = of find property (dtsled.nd, "compatible", NULL); 
170 if (proper == NULL) ( 


171 printk ("compatible property find failed\r\n"); 

172 } else { 

L73 printk ("compatible = %s\r\n", (char*)proper-»value); 
174 } 

175 

176 /* 3、 获 取 status 属性 内 容 */ 

19777 ret — of property read string(dtsled.nd, "status", &str); 
178 if(ret < O)( 

179 printk ("status read failed!NMr Nn"); 

180 ) else ( 

181 printk ("status = %s\r\n",str); 


182 } 
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183 

184 /* 4、 获 取 reg 属性 内 容 */ 

185 ret — of property read u32 array(dtsled.nd, "reg", regdata, 10); 
186 if(ret < 0) { 

187 printk ("reg property read failed!NVr Mn"); 

188 ) else ( 

189 u8 i = 0; 

190 printk ("reg data:\r\n"); 

191 for(i = 0; i < 10; i++) 

192 printk("%#X ", regdata[i]); 

193 printk(" Mr An"); 

194 } 

195 

196 /* 初始 化 LED */ 

197 dif O 

198 /* 1I、 寄 存 器 地 址 映射 */ 

199 IMX6U CCM CCGR1 = ioremap(regdata[0], regdata[i]); 
200 SW MUX GPIO1 IO03 = ioremap(regdata[?], regdata[3]); 
201 SW PAD GPIO1 IO03 = ioremap(regdata[4], regdata[5]); 
202 GPIO1 DR = ioremap(regdata[6], regdata[/]); 

203 GPIO1 GDIR = ioremap(regdata[98], regdata[9?]):; 

204 #else 

205 IMX6U CCM CCGR1 = of iomap(dtsled.nd, 0); 

206 SW MUX GPIO1 IO03 = of iomap(dtsled.nd, 1); 

207 SW PAD GPIO1 IO03 = of iomap(dtsled.nd, 2); 

208 GPIO1 DR = of iomap(dtsled.nd, 3); 

209 GPIO1 GDIR = of iomap(dtsled.nd, 4); 

210 #endif 

Aala 

212 /* 2、 使 能 GPIO1 时 钟 */ 

2 val = readl(IMX6U CCM CCGRI1); 

214 val &- «(3 << 26); /* 清楚 以 前 的 设置 */ 

215 val |= (3 << 26); /* 设置 新 值 */ 

216 writel(val, IMX6U CCM CCGR1); 

2l y 

218 /* 3. RE GPIO1_ 1003 的 复 用 功能 ， 将 其 复 用 为 

219 * ”GPIO1 I003， 最 后 设置 IO 属性。 

220 il 

2o writel(5, SW MUX GPIO1 IO03); 

222 

223 /* 寄存 器 SW PAD GPIO1 IO03 设置 Io 属性 */ 

224 writel(0x10B0, SW PAD GPIO1 IO03); 


225 
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226 /* 4. WE GPIOl IO03 为 输出 功能 */ 
2/2: qi val = readl(GPIO1 GDIR); 
228 val &= «(1 << 3); /* 清除 以 前 的 设置 */ 
229 val |- < 
230 writel(val, GPIO1 GDIR); 
2o 
232 /* 5、 默 认 关 闭 LED */ 
29 val = readl(GPIO1 DR); 
234 val |» (1 «« 3); 
295 writel(val, GPIO1 DR); 
236 
237 /* 注册 字符 设备 驱动 */ 
238 /* 1、 创 建设 备 号 */ 
239 if (dtsled.major}) { /* 定义 了 设备 号 */ 
240 dtsled.devid = MKDEV(dtsled.major, 0); 
241 register chrdev region(dtsled.devid, DTSLED CNT, 
DTSLED NAME); 
242 ) else ( /* Te */ 
243 alloc chroey ssexuiexe((Crheslhexl.okewanel, (0, DISLED CNT} 
DTSLED NAME); /* 申请 设备 号 */ 
244 dtsled.major = MAJOR(dtsled.devid); /* 获取 分 配 号 的 主 设备 号 */ 
245 dtsled.minor = MINOR(dtsled.devid); /* 获取 分 配 号 的 次 设备 号 */ 
246 ) 
227 printk("dtsled major-$d,minor-$dNrNMn",dtsled.major, 
dtsled.minor); 
248 
249 /* 2、 初 始 化 caev */ 
250 dtsled.cdev.owner = THIS MODULE; 
Asd cdev init(&dtsled.cdev, &dtsled fops); 
292 
258 /* 3. iA cdev */ 
254 cdev add(&dtsled.cdev, dtsled.devid, DTSLED CNT); 
255 
256 /* 4、 创 建 类 */ 
25 dtsled.class = class create(THIS MODULE, DTSLED NAME); 
258 if (IS ERR(dtsled.class)) ( 
2, return PTR ERR(dtsled.class); 
260 ) 
2/61 
262 /* 5. BEA */ 
263 dtsled.device = device create(dtsled.class, NULL, dtsled.devid, 
NULL, DTSLED NAME); 
264 if (IS ERR(dtsled.device)) d 
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265 return PTR ERR(dtsled.device); 

266 } 

267 

268 return 0; 

2690 

200 

ZW ges 

272 * Q8description : 驱动 出 口 函 数 

273 * param B JE 

274 * Qreturn 3 26 

QS wy 

2G SeaeLe seuil exit lel exe (veu 

DUNT 

218 /* 取消 映射 */ 

DEO iounmap(IMX6U CCM CCGR1); 

280 iounmap(SW MUX GPIO1 IO03); 

ZION iounmap(SW PAD GPIOl1 IO03); 

282 iounmap(GPIO1 DR); 

PIOS iounmap(GPIO1 GDIR); 

284 

285 /* 注销 字符 设备 驱动 */ 

286 cdev del(&dtsled.cdev);/* 删除 cdev */ 

2g unregister chrdev region(dtsled.devid, DTSLED CNT);/* 注 销 设备 号 */ 
288 

289 deyice destroy (dAtrelec class, esles.cewic 
290 clases cesuzoy(csleel.eclsss)y 7 

25109 

292 


2905 module imit (lel imit)? 
294 module exit(led exit); 
295 MODULE LICENSE ("GPL"); 
296 MODULE AUTHOR ("zuozhongkai"); 
dtsled.c 文件 中 的 内 容 和 第 四 十 二 章 的 newchrled.c 文件 中 的 内 容 基 本 一 样 ,只 是 dtsled.c 中 
包含 了 处 理 设备 树 的 代码 ， 我 们 重点 来 看 一 下 这 部 分 代码 。 
第 46 fT. 在 设备 结构 体 dtsled_dev 中 添加 了 成 员 变 量 nd, nd 是 device node 结构 体 类 型 指 
针 ， 表 示 设 备 节 点 。 如 果 我 们 要 读 取 设备 树 某 个 节点 的 属性 值 ， 首 先 要 先 得 到 这 个 节点 ， 一 般 
在 设备 结构 体 中 添加 device node 指针 变量 来 存放 这 个 节点 。 
第 160~166 行 , 通过 of find node by path 函数 得 到 alphaled 节点 ， 后 续 其 他 的 OF 函数 要 
使 用 device node. 
第 169~174 行 ， 通 过 of find property 函数 获取 alphaled 节点 的 compatible 属性 ， 返 回 值 为 
property 结构 体 类 型 指针 变量 ，property 的 成 员 变量 value 表示 属性 值 。 
第 177-182 行 ， 通 过 of property read string 函数 获取 alphaled 节点 的 status 属性 值 。 





























邢 






























































1119 


LMX6U SA XR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教学 : www.yuanzige.com 论坛 :www.opendev.com 

第 185-194 行 , 通 过 of property read u32 array 函数 获取 alphaled 节点 的 reg 属性 所 有 值 ， 
并 且 将 获取 到 的 值 都 存放 到 regdata 数组 中 。 第 192 行将 获取 到 的 reg 属性 值 依次 输出 到 终端 
Nur 

第 199-203 行 ， 使 用 “古老 ”的 ioremap 函数 完成 内 存 映射 ， 将 获取 到 的 regdata 数组 中 的 
寄存 器 物理 地 址 转换 为 虚拟 地 址 。 

第 205-209 行 ， 使 用 of iomap 函数 一 次 性 完成 读 取 reg 属性 以 及 内 存 映射 ，of iomap 函数 





















































是 设备 树 推荐 使 用 的 OF 函数 。 
44.3.3 编写 测试 APP 


本 章 直接 使 用 第 四 十 二 章 的 测试 APP, 将 上 一 章 的 ledApp.c 文件 复制 到 本 章 实验 工程 下 即 
可 。 


44.4 运行 测试 






































44.4.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 

编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 dtsled.o，Makefile 内 容 如 下 所 示 : 
示例 代码 44.4.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 






































rel imz 4.1.15 2.1.0 ge alientek 
4 obj-m :- dtsled.o.o 
11 clean: 
12 S$(MAKE) -C S(KERNELDIR) M=$ (CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 dtsled.o。 
输入 如 下 命令 编译 出 驱动 模块 文件 : 
make -j32 
编译 成 功 以 后 就 会 生成 一 个 名 为 “dtsled.ko” 的 驱动 模块 文件 。 
、 编 译 测 试 APP 
输入 如 下 命令 编译 测试 ledApp.c 这 个 测试 程序 : 
arm-linux-gnueabihf-gcc ledApp.c -o ledApp 
编译 成 功 以 后 就 会 生成 led A pp 这 个 应 用 程序 。 


























N 








44.4.2 运行 测试 


将 上 一 小 节 编 译 出 来 的 dtsled.ko 和 1ledApp 这 两 个 文件 拷贝 到 rootfs/lib/modules/4.1.15 目录 
， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 加 载 dtsled.ko 驱动 模块 : 

depmod /第 一 次 加 载 驱动 的 时 候 需 要 运行 此 命令 

modprobe dtsled.ko /加载 驱 动 

驱动 加 载 成 功 以 后 会 在 终端 中 输出 一 些 信息 ， 如 图 44.4.2.1 所 示 ; 
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/lib/modules/4.1.15 # depmod 
/lib/modules/4.1.15 £ roba dtsled.ko 
alphaled node find! 

compatible - atkalpha-led 

status - okay 

reg data: 


0x20c406c Ox4 OX20E0068 0X4 OX20E02F4 Ox4 0X209c000 0x4 0x209c004 Ox4 
dtsled major=249 ,minor=0 
/lib/modules/4.1.15 # J 


图 44.4.2.1 驱动 加 载 成 功 以 后 输出 的 信息 

从 图 44.4.2.1 可 以 看 出 ,alpahled 这 个 节点 找到 了 , 并 且 compatible 属性 值 为 “atkalpha-led”， 
status 属性 值 为 “okay”，reg 属性 的 值 为 “0X20C406C 0X4 0X20E0068 0X4 0X20E02F4 0X4 
0X209C000 0X4 0X209C004 0X4”， 这 些 都 和 我 们 设置 的 设备 树 一 致 。 

驱动 加 载 成 功 以 后 就 可 以 使 用 ledApp 软件 来 测试 驱动 是 否 工作 正常 ， 输 入 如 下 命令 打开 
LED 4T: 

/ledApp /dev/dtsled 1 /打开 LED 4T 

输入 上 述 命令 以 后 观察 LIMX6U-ALPHA 开发 板 上 的 红色 LED 灯 是 否 点 亮 ， 如 果 点 亮 的 话 
说 明 驱 动工 作 正常 。 在 输入 如 下 命令 关闭 LED 4T: 

.ledApp /dev/dtsled 0 /关闭 LED XT 
输入 上 述 命令 以 后 观察 LIMX6U-ALPHA 开发 板 上 的 红色 LED EREK. WRAEK 
动 的 话 输入 如 下 命令 即 可 : 

rmmod dtsled.ko 
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第 四 十 五 章 pinctrl 和 gpio 子 系统 实验 


上 一 章 我 们 编写 了 基于 设备 树 的 LED 驱动 ， 但 是 驱动 的 本 质 还 是 没 变 ， 都 是 配置 LED AT 























所 使 用 的 GPIO 寄存 器 ， 驱 动 开 发 方式 和 裸 机 基本 没 啥 区 别 。Linux 是 一 个 庞大 而 完善 的 系统 ， 
尤其 是 驱动 框架 ， 像 GPIO 这 种 最 基本 的 驱动 不 可 能 采用 “原始 ”的 裸 机 驱动 开发 方式 ， 否 则 
就 相当 于 你 买 了 一 辆 车 ， 结 果 每 天 推荐 车 去 上 班 。Linux 内 核 提 供 了 pinctrl 和 gpio 子 系统 用 于 
GPIO 驱动 ， 本 章 我 们 就 来 学 习 一 下 如 何 借助 pinctrl 和 gpio 子 系统 来 简化 GPIO 驱动 开发 。 
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45.1 pinctrl 子 系统 


45.1.1 pinctrl 子 系统 简介 


Linux 驱动 讲究 驱动 分 离 与 分 层 ,pinctrl 和 gpio 子 系统 就 是 驱动 分 离 与 分 层 思想 下 的 产物 ， 
驱动 分 离 与 分 层 其 实 就 是 按照 面向 对 象 编程 的 设计 思想 而 设计 的 设备 驱动 框架 ， 关 于 驱动 的 分 
离 与 分 层 我 们 后 面 会 讲 。 本 来 pinctrl 和 gpio 子 系统 应 该 放 到 驱动 分 离 与 分 层 章节 后 面 讲 解 , 但 
是 不 管 什么 外 设 驱动 ，GPIO 驱动 基本 都 是 必须 的 ， 而 pinctrl 和 gpio 子 系统 又 是 GPIO 驱动 必 
须 使 用 的 ， 所 以 就 将 pintrcl 和 gpio 子 系统 这 一 章节 提前 了 。 

我 们 先 来 回顾 一 下 上 一 章 是 怎么 初始 化 LED 灯 所 使 用 的 GPIO， 步 又 如 下 : 

QD、 修 改 设备 树 ， 添 加 相应 的 节点 ， 节 点 里 面 重 点 是 设置 reg 属性 ，reg 属性 包括 了 GPIO 
相关 寄存 器 。 

Q 、 获 取 reg 属性 中 IOMUXC SW MUX CTL PAD GPIOI IO03 和 
(IOMUXC SW PAD CTL PAD GPIOI IO03 这 两 个 寄存 器 地 址 ， 并 且 初 始 化 这 两 个 寄存 器 ， 
这 两 个 寄存 器 用 于 设置 GPIO1 IO03 这 个 PIN 的 复 用 功能 、 上 下 拉 、 速 度 等 。 

图、 在 他 里 面 将 GPIO1_IO03 这 个 PIN 复 用 为 了 GPIO 功能 ， 因 此 需要 设置 GPIO1 IO03 
这 个 GPIO 相关 的 寄存 器 ， 也 就 是 GPIO1 DR 和 GPIO1_GDIR 这 两 个 寄存 器 。 
总 结 一 下 ，@ 中 完成 对 GPIO1 IO03 这 个 PIN 的 初始 化 ， 设 置 这 个 PIN 的 复 用 功能 、 上 下 
拉 等 ,比如 讲 GPIO IO03 这 个 PIN 设置 为 GPIO 功能 。 @@ 中 完成 对 GPIO 的 初始 化 , 设置 GPIO 
为 输入 /输出 等 。 如 果 使 用 过 STM32 的 话 应 该 都 记得 ，STM32 也 是 要 先 设置 某 个 PIN 的 复 用 功 
能 、 速 度 、 上 下 拉 等 ,然后 再 设置 PIN 所 对 应 的 GPIO。 其 实 对 于 大 多 数 的 32 位 SOC 而 言 ， 引 
脚 的 设置 基本 都 是 这 两 方面 , 因此 Linux 内 核 针 对 PIN 的 配置 推出 了 pinctrl 子 系统 , 对 于 GPIO 
的 配置 推出 了 gpio 子 系统 。 本 节 我 们 来 学 习 pinctrl 子 系统 ， 下 一 节 再 学 习 gpio 子 系统 。 

大 多 数 SOC 的 pin 都 是 支持 复 用 复 用 的 , 比如 I.MX6ULL 的 GPIO1 IO03 既 可 以 作为 普通 
的 GPIO 使 用 ， 也 可 以 作为 12C1 的 SDA 等 等 。 此 外 我 们 还 需要 配置 pin 的 电气 特性 ， 比 如 上 / 
下 拉 、 速 度 、 驱 动能 力 等 等 。 传 统 的 配置 pin 的 方式 就 是 直接 操作 相应 的 寄存 器 ， 但 是 这 种 配 
置 方式 比较 繁琐 、 而 且 容 易 出 问题 (比如 pin 功能 冲突 )。pinctrl 子 系统 就 是 为 了 解决 这 个 问题 而 
引入 的 ，pinctrl 子 系 统 主要 工作 内 容 如 下 : 

GD、 获 取 设 备 树 中 pin 信息 。 

多、 根据 获取 到 的 pin 信息 来 设置 pin 的 复 用 功能 

©, WERKER pin 信息 来 设置 pin 的 电气 特性 ， 比 如 上 /下 拉 、 速 度 、 驱 动能 力 等 。 

对 于 我 们 使 用 者 来 讲 ， 只 需要 在 设备 树 里 面 设置 好 某 个 pin 的 相关 属性 即 可 ， 其 他 的 初始 
化 工作 均 由 pinctrl 子 系统 来 完成 ，pinctrl 子 系统 源码 目录 为 drivers/pinctrl。 










































































































































































































































































































































































45.1.2 LMX6ULL 的 pinctrl 子 系统 驱动 


1, PN 配置 信息 详解 
要 使 用 pinctrl 子 系 统 , 我 们 需要 在 设备 树 里 面 设置 PIN 的 配置 信息 ， 毕 竟 pinctrl 子 系统 要 
根据 你 提供 的 信息 来 配置 PIN 功能 ， 一 般 会 在 设备 树 里 面 创建 一 个 节点 来 描述 PIN 的 配置 信 
息 。 打 开 imx6ull.dtsi 文件 ， 找 到 一 个 叫做 iomuxc 的 节点 ， 如 下 所 示 : 
示例 代码 45.1.2.1 iomuxc 节点 内 容 1 
756 iomuxc: iomuxcQ8020e0000 ( 



































TEN compatible - "fsl,imx6ul-iomuxc"; 
TIE reg = <0x020e0000 0x4000>; 
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759 }; 








iomuxc 节点 就 是 LMX6ULL 的 IOMUXC 外 设 对 应 的 节点 ， 看 起 来 内 容 很 少 ， 没 看 出 什么 
跟 PIN 的 配置 有 关 的 内 容 啊 ， 别 急 ! 打开 imx6ull-alientek-emmc.dts， 找 到 如 下 所 示 内 容 : 
示例 代码 45.1.2.2 iomuxc 节点 内 容 2 











311 &iomuxc ( 





















































SL pinctrl-names = "default"; 

es |osbaxewesel-i0 r3 cseshmcneelb loe 155-6 

314 imx6ul-evk ( 

315 pinctrl hog 1: hoggrp-1 ( 

316 fsl,pins = < 

SHL MXSUTE-ADEVAR TERRE OON O05 
318 MX6UL PAD GPIO1 IO05 USDHC1 VSELECT 0x17059 
S39 MX6UL PAD GPIO1 IO09 CPIOL IO09 (5:1 
320 MX6UL PAD GPIO1 IO00 ANATOP OTG1 ID  0x13058 
E »; 

922 }; 

37 pinctrl flexcanl: flexcanlgrp( 

SI fsl,pins = < 

978 MX6UL PAD UART3 RTS B FLEXCAN1 RX 0x1b020 
374 MX6UL PAD UART3 CTS B  FLEXCAN1 TX 0x1b020 
2375 >; 

376 }; 

587 pinctrl wdog: wdoggrp { 

588 fsl,pins - < 

589 MX6UL PAD LCD RESET  WDOG1 WDOG ANY 0x305b0 
590 >; 

SO }; 

5992 ES 

SS WB 





示例 代码 45.1.2.2 就 是 向 iomuxc 节点 追加 数据 ,不 同 的 外 设 使 用 的 PIN 不 同 、 其 配置 也 不 
同 ， 因 此 一 个 萝卜 一 个 坑 ， 将 某 个 外 设 所 使 用 的 所 有 PIN 都 组 织 在 一 个 子 节点 里 面 。 示 例 代 码 
45.1.2.2 中 pinctrl hog 1 子 节 点 就 是 和 热 插 拔 有 关 的 PIN 集合 ， 比 如 USB OTG 的 ID 引 脚 。 
pinctrl flexcanl 子 节 点 是 flexcanl 这 个 外 设 所 使 用 的 PIN，pinctrl wdog 子 节点 是 wdog 外 设 所 
使 用 的 PN。 如 果 需 要 在 iomuxc 中 添加 我 们 自 定义 外 设 的 PIN， 那么 需要 新 建 一 个 子 节点 ， 然 
后 将 这 个 自 定义 外 设 的 所 有 PIN 配置 信息 都 放 到 这 个 子 节点 中 。 

将 其 与 示例 代码 45.1.2.1 结合 起 来 就 可 以 得 到 完成 的 iomuxc 节点 ， 如 下 所 示 : 

示例 代码 45.1.2.3 完整 的 iomuxc 节点 






















































































1 iomuxc: iomuxcQ020e0000 ( 

2 compatible = "fsl,imx6ul-iomuxc"; 
3 reg = «0x020e0000 0x4000»; 

4 pinctrl-names = "default"; 


1124 


LMX6U AÑ Linux 驱动 开发 指南 





原子 哥 在 线 教 学 ，www.yuanzige.com 


e31E m B 


论坛 :www.opendev.com 


5 pinctrl-0 2 «&pinctrl hog 1»; 

6 imx6ul-evk ( 

qj ponte cora Aog TTE Cr rra po TY 

8 fsl,pins - « 

9 MX6UL PAD UART1 RTS B GPIOl1 IO19 0x17059 
10 MX6UL PAD GPIO1 IO05 USDHC1 VSELECT  0x17059 
alat MX6UL PAD GPIO1 IO09  GPIO1 IO09 0x17059 
12 MX6UL PAD _GPIO1_IO00__ANATOP_OTG1_ID  0x13058 
JL 2; 

16 }; 

i ); 

1G pg 


第 2 1T, compatible 属性 值 为 “fsl,imx6ul-iomuxc”， 前 
核 会 根据 compatbile 属性 值 来 查找 对 应 的 驱动 文件 ， 所 以 我 们 在 Linux 内 核 源码 中 全 局 搜索 字 
符 串 “fsl,imx6ul-iomuxc” 就 会 找到 I.MX6ULL 这 颗 SOC 的 pinctrl 驱动 文件 。 稍 后 我 们 会 讲解 
这 个 pinctrl 驱动 文件 。 
第 9~12 行 ,pinctrl hog 1 子 节点 所 使 用 的 PIN 配置 信息 ,我 们 就 以 入 
这 个 PIN 为 例 ， 讲 解 一 下 如 何 添加 PIN 的 配置 信 ， 
MX6UL PAD UARTI RTS B GPIOI IO19 






























































可 以 检测 到 SD 卡 是 否 有 插入 。 UARTI RTS B 
MX6UL PAD UARTI RTS B GPIOI IO19 和 0x17059 














我 们 重点 来 看 一 下 这 两 部 分 是 什么 含义 ,前 面 说 了 ,对 于 一 个 PIN 的 配置 主要 包括 两 方面 ， 
一 个 是 设置 这 个 PIN 的 复 用 功能 ， 另 一 个 就 是 设置 这 个 PIN 的 电气 特性 。 所 以 我 们 可 以 大 胆 的 
个 是 设置 UART1 RTS B 的 复 用 功能 , 一 个 是 用 来 





























arch/arm/boot/dts/imx6ul-p 





设备 树 中 引用 C 语言 中 .h 文件 中 的 内 容 。MX6UL PAD UART1 RTS B GPIOI 1019 WEE 


义 内 容 如 下 : 


190 #define 


191 #define 


192 #define 


193 #define 





194 #define 


MX6 


MX6 


MX6 


MX6 








MX6 


猜测 UARTI_RTS_B 的 这 两 部 分 配置 信息 
设置 UART1_RTS_B 的 电气 特性 。 
首先 来 看 一 下 MX6UL PAD UARTI RTS B. GPIOI IO19, 这 是 一 个 宏 定义 , 定义 在 文件 
infunc.h 中 ，imx6ull.dtsi 会 引用 imx6ull-pinfunc.h 这 个 头 文件 ， 而 
imx6ull-pinfunc.h 又 会 引用 imx6ul-pinfunc.h 这 个 头 文件 〈( 绕 啊 绕 !)。 从 这 里 可 以 看 出 ， 可 以 在 







































































Vd 


Vd 


Vd 


Vd 








J 
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| PAD UART1 RTS B ENET1 TX E 


讲解 设备 树 的 时 候 说 过 ，Linux 内 





的 配置 信 





















































首先 说 明 一 下 ，UARTI1_RTS_B 这 个 PIN 是 作为 SD 卡 的 检测 引 脚 ， 也 就 是 通过 此 PIN 就 
息 分 为 两 部 分 : 


























示例 代码 45.1.24 UARTI, RTS B. 引 脚 定义 




















| PAD VARTI RTS B USDRCL CD | 


























PAD UART1 RTS B CSI DATAO05 


1125 





B 


| PAD UART1 RTS B UART] DCE RTS0x0090 0x031C 0x0620 


0x0 5c 


| PAD UART1 RTS B UART1 DTE CTS 0x0090 0x031C 0x0000 


0xO 0x0 
0x0090 0x031C 0x0000 
Oxl 0x0 
0x0090 0x031C 0x0668 
(pez. Ozal 
0x0090 0x031C 0x04CC 
(sca Obi 


8 9 行 的 UART1 RTS B 
息 ，UART1_RTS B 的 配置 信息 如 下 : 
0x17059 
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195 $define MX6UL PAD UART1 RTS B ENET2 1588 EVENTI OUT 0x0090 0x031C 
0x0000 0x4 0x0 
196 #define MX6UL PAD UART]1 RTS B GPIO1 IO19 0x0090 0x031C 0x0000 
0x5 0x0 
197 #define MX6UL PAD UART1 RTS B USDHC2 CD B  0x0090 0x031C 0x0674 
0x8 0x2 
示例 代码 45.1.24 TO 8 个 以 “MX6UL PAD UARTI RTS _B” 开 头 的 宏 定 义 ， 大 家 
仔细 观察 应 该 就 能 发 现 ， 这 8 个 宏 定 义 分 别 对 应 UART1_RTS B 这 个 PIN 的 8 个 复 用 IO. E 
阅 《I.MX6ULL 参考 手册 》 可 以 知 UART1 RTS B 的 可 选 复 用 IO 如 图 45.1.2.1 所 示 : 


MUX MODE |MUX Mode Select Field. 












































Select 1 of 10 iomux modes to be used for pad: UART1 RTS B. 


0000 ALTO — Select mux mode: ALTO mux port: UART1 RTS B of instance: uart1 

0001 ALT1 — Select mux mode: ALT1 mux port: ENET1 TX ER of instance: enet1 

0010 ALT2 — Select mux mode: ALT2 mux port: USDHC1 CD B of instance: usdhc1 

0011  ALTS3 — Select mux mode: ALT3 mux port: CSI DATAOS5 of instance: csi 

0100 ALT4 — Select mux mode: ALT4 mux port: ENET2 1588 EVENT1. OUT of instance: enet2 
0101  ALT5 — Select mux mode: ALT5 mux port: GPIO1 1O19 of instance: gpio1 

1000 ALT8 — Select mux mode: ALT8 mux port: USDHC2 CD B of instance: usdhc2 

1001  ALT9 — Select mux mode: ALT9 mux port: UART5 RTS B of instance: uart5 











图 45.1.2.1 UARTI RTS B 引 脚 复 用 

示例 代码 196 行 的 宏 定 义 MX6UL PAD UARTI RTS B. GPIOI 1019 表示 将 
UARTI RTS B 这 个 IO 复 用 为 GPIO1 IO19。 此 安定 义 后 面 跟着 5 个 数字 ， 也 就 是 这 个 宏 定 义 
的 具体 值 ， 如 下 所 示 : 

0x0090 0x031C 0x0000 0x5 0x0 

这 5 个 值 的 含义 如 下 所 示 : 

<mux reg conf reg input reg mux mode input val> 

综 上 所 述 可 知 : 

0x0090: mux reg 寄存 器 偏 移 地 址 ， 设 备 树 中 的 iomuxc 节点 就 是 IOMUXC 外 设 对 应 的 节 
点 ， 根 据 其 reg 属性 可 知 IOMUXC 外 设 寄存 器 起 始 地 址 为 0x020e0000 。 因 此 
0x020e0000+0x0090=0x020e0090，IOMUXC SW MUX CTL PAD T RTS_B 寄存 器 地 址 
正好 是 0x020e0090 , K X mf U Æ < IMX6ULL 参考 手册 》 中 找到 
IOMUXC SW MUX CTL PAD UARTI RTS B 3 这 个 寄存 器 的 位 域 图 ， 如 图 45.1.2.2 所 示 : 


32.6.00 SW MUX CTL PAD UART1 RTS B SW MUX Control 
Register (JOMUXC SW MUX CTL PAD UART1 RTS B) 


SW. MUX CTL Register 


Address[20E 0000h base] ME [20E 0090h| oe] 


Bit 31 25 24 23 22 21 20 19 18 17 16 
R 
Ww 


Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 























Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


Reset 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 1 


45.1.2.2 寄存 器 位 域 图 
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因此 可 知 ，0x020e0000+mux reg 就 是 PIN 的 复 用 寄存 器 地 址 。 

0x031C: conf reg 寄存 器 偏 移 地 址 ， 和 mux reg 一 样 ，0x020e0000+0x031c=0x020e031c， 
这 个 就 是 寄存 器 IOMUXC SW PAD CTL PAD UARTI RTS B 的 地 址 。 














0x0000: input reg 寄存 器 偏 移 地 址 ， 有 些 外 设 有 input reg 寄存 器 ， 有 input reg 寄存 器 的 
外 设 需要 配置 input reg 寄存 器 。 没 有 的 话 就 不 需要 设置 ，UART1_RTS B 这 个 PIN 在 做 
GPIO1 IO19 的 时 候 是 没有 input reg 寄存 器 ， 因 此 这 里 intput_ reg 是 无 效 的 。 

0x5 : muxreg 寄存 器 值 ， 在 这 里 就 相当 于 设置 
IOMUXC SW MUX CTL PAD UARTI RTS B 寄存 器 为 0x5， 也 即 是 设置 UART1_RTS B 这 
个 PIN 复 用 为 GPIO1 IO19。 

0x0: input reg 寄存 器 值 ， 在 这 里 无 效 。 

这 就 是 宏 MX6UL PAD UARTI RTS B_GPIO1 IO19 的 含义 ， 看 的 比较 仔细 的 同学 应 该 
会 发 现 并 没有 conf reg 寄存 器 的 值 ，config reg 寄存 器 是 设置 一 个 PIN 的 电气 特性 的 ， 这 人 么 习 
要 的 寄存 器 怎么 没有 值 呢 ? 回 到 示例 代码 45.1.2.3 中 ， 第 9 行 的 内 容 如 下 所 示 : 

MX6UL PAD UART1 RTS B GPIOI IOI9 0x17059 

MX6UL PAD UARTI RTS B GPIOI IO19 我 们 上 面 已 经 分 析 了 ,就 剩 下 了 一 个 0x17059, 
反应 快 的 同学 应 该 已 经 猜 出 来 了 ，0x170595 就 是 conf reg 寄存 器 值 ! 此 值 由 用 户 自 行 设置 ， 通 
过 此 值 来 设置 一 个 IO 的 上 /下 拉 、 了 驱动 能 力 和 速度 等 。 在 这 里 就 相当 于 设置 寄存 器 
IOMUXC SW PAD CTL PAD UARTI RTS B 的 值 为 0x17059。 

2. PIN 驱动 程序 讲解 

本 小 节 会 涉及 到 Linux 驱动 分 层 与 分 离 、 平 台 设备 驱动 等 还 未 讲解 的 知识 ， 所 以 本 小 节 教 
程 可 以 不 用 看 ， 不 会 影响 后 续 的 实验 。 如 果 对 Linux 内 核 的 pinctrl 子 系统 实现 原理 感 兴趣 的 话 
以 看 本 小 节 。 

所 有 的 东西 都 已 经 准备 好 了 ， 包 括 寄存 器 地 址 和 寄存 器 值 ，Linux 内 核 相 应 的 驱动 文件 就 
会 根据 这 些 值 来 做 相应 的 初始 化 。 接 下 来 就 找 一 下 哪个 驱动 文件 来 做 这 一 件 事 情 ，iomuxc 节点 
compatible 属性 的 值 为 “Limx6ul-iomuxc”， 在 Linux 内 核 中 全 局 搜索 “fsl,imx6ul-iomuxc” 
字符 串 就 会 找到 对 应 的 驱动 文件 ,在 文件 drivers/pinctrl/freescale/pinctrl-imx6ul.c 中 有 如 下 内 容 : 

示例 代码 45.1.2.5 pinctrl-imx6ul.c 文件 代码 段 


326 static struct of device id imx6ul pinctrl of match[] = ( 


























































































































Pap 




























































































- 


















































327 { .compatible = "fsl,imx6ul-iomuxc", .data = 
&imx6ul pinctrl info, ], 
328 ( .compatible = "fsl,imx6ull-iomuxc-snvs", .data = 


&imx6ull snvs pinctrl info, ], 


329 ( /* sentinel */ } 

3308) 

NI 

33/2. Statie imt 3bwbxOWLL pinetrl probel(struct pleatiorm device vgdev)) 
323S 

334 GlowkSe Sewer Oi leac abel mecen; 

SS) Struct ime pinctrl soe into vpincecrl intop 

336 

99 match = of match device(imx6ul pinctrl of match, &pdev-»dev); 
ESO 

339 if (!match) 
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340 return -ENODEV; 

341 

342 pimnetrl inito S (struct ims pPlinertrl soe inio w) waeucelu-cxelenss 
343 

344 return imx pinctrl probe(pdev, pinctrl info); 

345 ) 

346 

347 static struct platform driver imx6ul pinctrl driver - ( 

348 .driver - ( 


349 .name = "imx6ul-pinctrl", 

350 .owner — THIS MODULE, 

351 .of match table = of match ptr(imx6ul pinctrl of match), 
352 r 

353 .probe = imx6ul pinctrl probe, 

354 .remove = imx pinctrl remove, 

3551); 


第 326~330 ÍT, of device id 结构 体 数组 , 第 四 十 三 章 讲解 设备 树 的 时 候 说 过 了 ,of device id 
里 面 保存 着 这 个 驱动 文件 的 兼容 性 值 ， 设 备 树 中 的 compatible 属性 值 会 和 of device id 中 的 所 
有 兼容 性 字符 串 比 较 , 查看 是 否 可 以 使 用 此 了 驱动。 imx6ul_pinctrl_of_match 结构 体 数 组 一 共有 两 
个 兼容 性 字符 串 ， 分 比 为 “fsl,imx6ul-iomuxc” 和 “fsl,imx6ull-iomuxc-snvs”， 因 此 iomuxc 节点 
与 此 驱动 匹配 ， 所 以 pinctrl-imx6ul.c 会 完成 LMX6ULL 的 PIN 配置 工作 。 

第 347~355 行 ，platform driver 是 平台 设备 驱动 ， 这 个 是 我 们 后 面 章节 要 讲解 的 内 容 ， 
platform driver 是 个 结构 体 ， 有 个 probe 成 员 变 量 。 在 这 里 大 家 只 需要 知道 ， 当 设备 和 驱动 匹配 
成 功 以 后 platform. driver 的 probe 成 员 变 量 所 代表 的 函数 就 会 执行 , 在 353 行 设 置 probe 成 员 变 
量 为 imx6ul pinctrl probe 函数 ,因此 在 本 章 实验 中 imx6ul_pinctrl_probe 这 个 函数 就 会 执行 ， 可 
以 认为 imx6ul pinctrl probe 函数 就 是 LMX6ULL 这 个 SOC 的 PIN 配置 入 口 函数 .以 此 为 入 口 ， 
有 如 图 45.1.2.3 所 示 的 函数 调用 路 径 : 


imx6ul pinctrl probe () 





















































































































































imx pinctrl probe() 
imx pinctrl probe at() 


imx pinctrl parse functions() 解析 设备 树 中 关于 PIN 的 配置 信 
; ; 息 ， 也 就 是 6 个 u32 类 型 的 数据 
imx pinctrl parse groups(---------------------- > dh. dudbXmux reg. conf reg. 
input reg. mux mode. input val 
和 config 值 
pirebrtegister()" Se > 向 Linux 内 核 注册 pinctrl 





图 45.1.2.3 imx6ul pinctrl probe 函数 执行 流程 
在 图 45.1.2.3 中 函数 imx_pinctrl parse. groups 负责 获取 设备 树 中 关于 PIN 的 配置 信息 ， 也 
就 是 我 们 前 面 分 析 的 那 6 个 u32 类 型 的 值 。 处 理 过 程 如 下 所 示 ; 

示例 代码 45.1.2.6 imx_pincttl_pbatse_gtoups 函数 代码 段 












































ZO EX 

48:9) s dhexelm mesensea ns sn sor 5 TS IEJUN TDIUNNKC, JEID) 
da900 -amd S2 ONBIG SO Aty pes in jt Que on Ee ae S TS 

291. X 
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492 #define FSL PIN SIZE 24 

493 &define SHARE FSL PIN SIZE 20 

494 


ee ine imz Ppincetrl parse groups (etruct Ceyice node "up; 











496 struct imx pin_group *grp, 
497 struct imx pinctrl_soc_info *info, 
498 u32 index) 

499 ( 

500 law Size, pin S1267 

50 conc "lse32 vig, 

502 aba 3b 

503 v9 (pinu ip 

537 

538 toram (uma M Cc RIO MEET 

5 SIS 132 müz reg = 19952 to Cpu (ans) p 
540 u32 CONE mec. 

541 (usse! iat pim iel 

542 Strut ime Pim reg spin reg} 

543 struct imx pin *pin - &grp-»pins[i]; 
544 

555 

556 pin_id = (mux_reg != -1) ? mux reg / 4 : conf reg / 4; 
DSN pin reg = &info-»pin regs[pin id]; 

5908 pin-»pin = pin id; 

EX grp-»pin ids[i] < pin id; 

560 pin reg-»mux reg = mux reg; 

561 pin reg-»conf reg = conf reg; 

562 pin-»input reg = be32 to cpu(*listtt); 
563 pin-»mux mode = be32 to cpu(*listtt); 
564 pin-»input val = be32 to cpu(*listtt); 
565 

566 /.* STON P b3t eos 

567. contig = be32 to cou ligtia) 7 

568 if (config & IMX PAD SION) 

569 pin-»mux mode |2 IOMUXC CONFIG SION; 
570 pin-»config = config & -IMX PAD SION; 
574 } 

SUIS 

576 return 0; 

5E 
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第 496 和 497 行 ， 设 备 树 中 的 mux reg 和 conf reg 值 会 保存 在 info 参数 中 ，input reg. 
mux mode、input val 和 config 值 会 保存 在 grp 参数 中 。 

第 560—564 行 ， 获取 mux reg. conf reg. input reg. mux mode 和 input val 值 。 

第 570 行 ， 获 取 config fH. 
接 下 来 看 一 下 函数 pinctrl register， 此 函数 用 于 办 Linux 内 核 注册 一 个 PIN 控制 器 ， 此 函数 














原型 如 下 : 
struct pinctrl dev *pinctrl register(struct pinctrl desc *pctldesc, 


struct device *dev, 
void *driver data) 









































参数 pctldesc 非常 重要 ， 因 为 此 参数 就 是 要 注册 的 PIN 控制 器 ，PIN 控制 器 用 于 配置 SOC 
的 PIN 复 用 功能 和 电气 特性 。 参 数 pctldesc 是 pinctrl_ desc 结构 体 类 型 指针 ，pinctrl desc 结构 体 
如 下 所 示 : 











示例 代码 45.1.2.7 pinctrl desc 结构 体 
lze sue ee ee desc d 


32:9) constiehari Ename 

1L S10) SEE Pincrcil pim dese const pump 
ia unsigned int npins; 

132 const struct pinctrl ops *pctlops; 
T33 const struct pinmux ops *pmxops; 

134 const struct pinconf ops *confops; 

JL SN) struct module *owner; 





136 £fifdef CONFIG GENERIC PINCONF 











Sm unsigned int num custom params; 

138 Const struct pinconit generic parans eu omnes 
1S9 Const Struct pin Contig item wcustom Coni Itens? 
140 endif 

RA 





48 132-124 行 ， 这 三 个 “_ops” 结构 体 指针 非常 重要 !11 因为 这 三 个 结构 体 就 是 PIN 控制 
器 的 “工具 ”这 三 个 结构 体 里 面包 含 了 很 多 操作 函数 ， 通 过 这 些 操作 函数 就 可 以 完成 对 某 一 个 
PIN 的 配置 。pinctrl_desc 结构 体 需 要 由 用 户 提供 ， 结 构 体 里 面 的 成 员 变 量 也 是 用 户 提供 的 。 但 
是 这 个 用 户 并 不 是 我 们 这 些 使 用 芯片 的 程序 员 ， 而 是 半导体 广 商 ， 半 导体 三 商 发 布 的 Linux 内 
核 源 码 中 已 经 把 这 些 工 作 做 完了 。 比 如 在 imx pinctrl probe 函数 中 可 以 找到 如 下 所 示 代 码 : 

示例 代码 45.1.2.8 imx. pinctrl. probe 函数 代码 段 


GHG iaw ime pinetrl prolbel(struct platiorm eee MET GI 
















































































649 struct ims pinerri goe inito winto) 
SOR 

isl struct device node *dev np = pdev-»dev.of node; 
6927 grruet device node -nes 

653 struct imz Dinetrl ee 

654 SEruUCE iIesOUutCe "9g 

655 struct pinctrl desc *imx pinctrl desc; 

663 
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664 imx pinctrl desc = devm kzalloc(&pdev-»dev, 
sizeof(*imx pinctrl desc), 
665 GFP KERNEL); 
666 sus (Uime pincetrl desc) 
667 return -ENOMEM; 
705 
706 imx pinctrl desc-»name = dev name (&pdev-»dev); 
707 imx pinctrl desc-»pins = info-»pins; 
708 imx pinctrl desc-»npins = info-»npins; 
709 imx pinctrl desc-»pctlops = &imx pctrl ops; 
710 imx pinctrl desc-»pmxops = &imx pmx ops; 
Via tab imx pinctrl desc-»confops = &imx pinconf ops; 
qat imx pinctrl desc-»owner = THIS MODULE; 
123 ipctl->pctl = pinctrl register(imx pinctrl desc, &pdev->dev, 
ipctl); 
qe 


第 655 行 ， 定 义 结构 体 指针 变量 imx pinctrl. desc. 

第 664 行 ， 向 指针 变量 imx pinctrl. desc 分 配 内 存 。 

第 706—712 行 ,初始 化 imx_pinctrl_desc 结构 体 指 针 变 量 , 重点 是 pctlops、pmxops 和 confops 
这 三 个 成 员 变 量 ， 分 别 对 应 imx pctrl ops. imx pmx ops 和 imx pinconf ops 这 三 个 结构 体 。 

第 723 行 ,调用 函数 pinctrl_ register 向 Linux 内 核 注 册 imx_pinctrl_desc, 注册 以 后 Linux 内 
核 就 有 了 对 LMX6ULL 的 PIN 进行 配置 的 工具 。 

imx pctrl ops. imx pmx ops 和 imx pinconf ops 这 三 个 结构 体 定 义 如 下 : 

示例 代码 45.1.2.9 imx pctrl ops. imx pmx ops 和 imx pinconf ops 结构 体 

































































1 72 gratie Const ue Pinetrl ops im: percel ops = i 
TS; .get groups count = imx get groups count, 

TG .get group name = imx get group name, 

TE T) .get group pins = imx get group pins, 

178 -Pin dbg show = imx pin dbg show, 

TOTES .dt node to map = imx dt node to map, 

180 .dt free map = imx dt free map, 

dE 

1/0209) 

374 static const struct pinmux ops imx pmx ops = i 
SS .get functions count = imx pmx get funcs count, 
SG .get function name = imx pmx get func name, 
BH .get function groups = imx pmx get groups, 

378 .set mux —- imx pmx set, 


ES, -gpio request enable = ims pmx gpio request enable, 
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380 -Dio set direction = im: pm Golo set direetlon, 

Sos 

481 static const struct pinconf ops imx pinconf ops = ( 

482 .pin config get = Tn pinconf get, 

483 opua. Contig set = im: pinconi Set, 

484 .pin config dbg show = imx pinconf dbg show, 

485 .pin config group dbg show - im: pinconf group dbg show, 
486 ); 














示例 代码 45.1.2.9 中 这 三 个 结构 体 下 的 所 有 函数 就 是 LMX6ULL 的 PIN 配置 函数 ， 我 们 就 


























此 打住 ， 不 在 去 分 析 这 些 函 数 了 ， 和 否则 本 章 就 没完 没 了 了 ， 有 兴趣 的 可 以 去 看 一 下 。 


45.1.3. 设备 树 中 添加 pinctrl 节点 模板 


我 们 已 经 对 pinctrl 有 了 比较 深入 的 了 解 ， 接 下 来 我 们 学 习 一 下 如 何在 设备 树 中 添加 某 个 外 
设 的 PIN 信息 。 关 于 LMX 系列 SOC 的 pinctrl 设备 树 绑 定 信 息 可 以 参考 文档 
Documentation/devicetree/bindings/pinctrl/fsl,imx-pinctrl.txt。 这 里 我 们 虚拟 一 个 名 为 “test” 的 设 





























备 ，test 使 用 了 GPIO1 IO00 这 个 PIN 的 GPIO 功能 ，pinctrl 节点 添加 过 程 如 下 : 
1、 创 建 对 应 的 节点 























同一 个 外 设 的 PIN 都 放 到 一 个 节点 里 面 ， 打 开 imx6ull-alientek-emmc.dts， 在 iomuxc 节点 
中 的 “imx6ul-evk” 子 节点 下 添加 “pinctrl test” 节 点 ， 注 意 ! 节点 前 级 一 定 要 为 “pinctrl ". X5 














加 完成 以 后 如 下 所 示 : 
示例 代码 45.1.2.10 test 设备 pinctrl 节点 
l pinctrl test: tese | 


2  /* HAMPIN Ea */ 
3g 
2、 添 加 “fsl, pins” 属 性 
设备 树 是 通过 属性 来 保存 信息 的 , 因此 我 们 需要 添加 一 个 属性 , 属性 名 字 一 定 要 为 “fsl,pins”， 















































置信 息 ， 完 成 以 后 如 下 所 示 : 
示例 代码 45.1.2.11 添加 "fsl,pins" 属 性 


la ls es 

2 fsl,pins = < 

3 /* 设备 所 使 用 的 PIN 配置 信息 */ 
4 21 

5 }; 


3、 在 “fsl,pins” 属 性 中 添加 PIN 配置 信息 
最 后 在 “fsl,pins” 属 性 中 添加 具体 的 PIN 配置 信息 ， 完 成 以 后 如 下 所 示 : 
示例 代码 45.1.2.13 完整 的 test 设备 pincttl 子 节点 


























la ls "uestem d 

2 fsl,pins < 

3 MX6UL PAD GPIO1 IO00 GPIO1 IO00 config /*config 是 具体 设置 值 */ 
4 2; 


1132 


因为 对 于 IMX 系列 SOC ifi zi. pinctrl 驱动 程序 是 通过 读 取 “fsl,pins” 属 性 值 来 获取 PIN 的 配 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 











原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
5H 
至 此 , 我 们 已 经 在 imx6ull-alientek-emmc.dts 文件 中 添加 好 了 test 设备 所 使 用 的 PIN 配置 信 
B. 
45.2 gpio 子 系统 
45.2.1 gpio 子 系统 简介 


上 一 小 节 讲 解 了 pinctrl 子 系统 ，pinctrl 子 系统 重点 是 设置 PIN( 有 的 SOC 叫做 PAD) 的 复 用 
和 电气 属性 ， 如 果 pinctrl 子 系统 将 一 个 PIN 复 用 为 GPIO 的 话 ， 那 么 接 下 来 就 要 用 到 gpio TA 
统 了 。gpio 子 系统 顾名思义 ， 就 是 用 于 初始 化 GPIO 并 且 提 供 提供 相应 的 API 函数 ， 比 如 设置 
GPIO 为 输入 输出 ， 读 取 GPIO 的 值 等 。gpio 子 系统 的 主要 目的 就 是 方便 驱动 开发 者 使 用 gpio， 
驱动 开发 者 在 设备 树 中 添加 gpio 相关 信息 ， 然 后 就 可 以 在 驱动 程序 中 使 用 gpio 子 系统 提供 的 
API 函数 来 操作 GPIO, Linux 内 核 向 驱动 开发 者 屏蔽 掉 了 GPIO 的 设置 过 程 ， 极 大 的 方便 了 了 驱 
动 开 发 者 使 用 GPIO。 























































































































45.2.2 LMX6ULL 的 gpio 子 系统 驱动 


1、 设 备 树 中 的 gpio 信息 
LMX6ULL-ALPHA 开发 板 上 的 UARTI. RTS B 做 为 SD 卡 的 检测 引 脚 , UARTI RTS B 复 
用 为 GPIO1 IO19， 通 过 读 取 这 个 GPIO 的 高 低 电 平 就 可 以 知道 SD 卡 有 没有 插入 。 首 先 肯 定 是 
将 UARTI RTS B 这 个 PIN 复 用 为 GPIO1 IO19， 并 且 设 置 电气 属性 ， 也 就 是 上 一 小 节 讲 的 
pinctrl 节点 。 打 开 imx6ull-alientek-emmc.dts, UART1 RTS B 这 个 PIN 的 pincrtl 设置 如 下 : 
示例 代码 45.2.2.1 SD 卡 CD 引 脚 PIN 配置 参数 
31$ ppulebil. Imexg :een wW 



















































































Suy ico im M S 

318 MX6UL PAD UART1 RTS B GPIO1 IO19  0x17059 /* SD1 CD */ 
OU > 

SS WB 


第 318 行 ， 设置 UARTI RTS B 这 个 PIN 为 GPIO1 IO19。 

pinctrl 配置 好 以 后 就 是 设置 gpio f, SD 卡 驱 动 程序 通 过 读 取 GPIO1_IO19 的 值 来 判断 SD 
卡 有 没有 插入 ， 但 是 SD 卡 驱动 程序 怎么 知道 CD 引 脚 连接 的 GPIOI IO19 呢 ?” 肯 定 是 需要 设 
备 树 告诉 驱动 啊 ! 在 设备 树 中 SD 卡 节 点 下 添加 一 个 属性 来 描述 SD RÉI CD 引 脚 不 就 行 了 ， 
SD 卡 驱 动 直接 读 取 这 个 属性 值 就 知道 SD 卡 的 CD 引 脚 使 用 的 哪个 GPIO f. SD FERE 
I.MX6ULL 的 usdhcl 接口 上 ， 在 imx6ull-alientek-emmc.dts 中 找到 名 为 “usdhcl1” 的 节点 ， 这 个 
节点 就 是 SD 卡 设备 节点 ， 如 下 所 示 : 

示例 代码 45.2.2.2 设备 树 中 SD 卡 节 点 





















































760 &usdhcl ( 


761 pamiec ll nam eben m o rennin 
762 pinctrl-0 2 «&pinctrl usdhci»; 

763 pinctrl-i - «&pinctrl usdhcl 100mhz»; 

764 pinctrl-2 2 «&pinctrl usdhcl 200mhz»; 

765 /* pinctrl-3 = «&pinctrl hog 1»; */ 
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766 cd-gpios = «&gpiol 19 GPIO ACTIVE LOW»; 

767 keep-power-in-suspend; 

768 enable-sdio-wakeup; 

769 vmmc-supply = <&reg sql vmmc»; 

9 00) status £2 "rele p 

qua. Mg 





第 765 行 ， 此 行 本 来 没有 ， 是 作者 添加 的 ，usdhcl 节点 作为 SD 卡 设 备 总 节点 ，usdhcl 节 
点 需要 描述 SD 卡 所 有 的 信息 ， 因 为 驱动 要 使 用 。 本 行 就 是 描述 SD 卡 的 CD 引 脚 pinctrl 信息 
所 在 的 子 节点 ,因为 SD 卡 驱动 需要 根据 pincrtl 节点 信息 来 设置 CD 引 脚 的 复 用 功能 等 .762~764 
行 的 pinctrl-0-2 都 是 SD 卡其 他 PIN 的 pincrtl 节点 信息 。 但 是 大 家 会 发 现 ， 其 实在 usdhcl 节点 
中 并 没有 “pinctrl-3=<&pinctrl_ hog_1>” 这 一 行 , 也 就 是 说 并 没有 指定 CD 引 脚 的 Pinctrl 信息 ， 
那么 SD 卡 驱 动 就 没 法 设置 CD 引 脚 的 复 用 功能 啊 ? 这 个 不 用 担心 ， 因 为 在 “iomuxc” 节 点 下 
引用 了 pinctrl hog 1 这 个 节点 , 所 以 Linux 内 核 中 的 iomuxc 驱动 就 会 自动 初始 化 pinctrL_ hog 1 
节点 下 的 所 有 PIN。 

第 766 行 ， 属性 “cd-gpios” 描 述 了 SD 卡 的 CD 引 脚 使 用 的 哪个 IO 。 属 性 值 一 共有 三 个 ， 
我 们 来 看 一 下 这 三 个 属性 值 的 含义 “&gpio1” 表 示 CD 引 脚 所 使 用 的 IO 属于 GPIO1 组 ,“19?” 
表示 GPIOI 组 的 第 19 号 IO, 通过 这 两 个 值 SD 卡 驱 动 程序 就 知道 CD 引 脚 使 用 了 GPIO1 IO19 
这 GPIO. *GPIO ACTIVE _ LOW” 表示 低 电 平 有 效 ， 如 果 改 为 “GPIO_ACTIVE_HIGH” 就 表 
示 高 电 平 有 效 。 

根据 上 面 这 些 信息 ，SD 卡 驱 动 程序 就 可 以 使 用 GPIO1_IO19 来 检测 SD 卡 的 CD 信号 了 ， 
打开 imx6ull.dtsi， 在 里 面 找到 如 下 所 示 内 容 : 

示例 代码 45.2.2.2 gpiol 节点 

504 gpiol: gpio80209c000 ( 

























































































































































































































































































505 compatible: Sa nu ee ST e O; 
506 reg = <0x0209c000 0x4000>; 

507 interrupts 2 «GIC SPI 66 IRQ TYPE LEVEL HIGH», 
508 SCIC SUE (57 ERODE EE BEGA 

509 gpio-controller; 

510 dgpio-cells = «2»; 

ddl interrupt-controller; 

Sg finterrupt-cells = «2»; 

Susi rp 





























gpiol 节点 信息 描述 了 GPIOI 控制 器 的 所 有 信息 ， 重 点 就 是 GPIO1 外 设 寄存 器 基地 址 以 及 
FR TE. X T IMX 系列 SOC 的 GPIO 控制 器 绑 定 信息 请 查看 文档 
Documentation/devicetree/bindings/gpio/ fsl-imx-gpio.txt. 

第 505 4T, 设置 gpiol 节点 的 compatible 属性 有 两 个 ,分别 为 “fsl,imx6ul-gpio” 和 “fsl,imx35- 
gpio", 在 Linux 内 核 中 搜索 这 两 个 字符 串 就 可 以 找到 I.MX6UL 的 GPIO 驱动 程序 。 

第 506 行 ， 的 reg 属性 设置 了 GPIO1 控制 器 的 寄存 器 基地 址 为 0X0209C000， 大 家 可 以 打 
开 《LMX6ULL 参考 手册 》 找 到 “Chapter 28:General Purpose Input/Output(GPIO) " 3& 4125 28.5 小 
节 ， 有 如 图 45.2.2.1 所 示 的 寄存 器 地 址 表 : 


limi 
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=_=- eHe 
(hex) page 

209_C000 |GPIO data register (GPIO1_DR) 0000 0000h | 28.5.1/1358 
209 C004 |GPIO direction register (GPIO1 GDIR) 32 R/W | 0000 0000h | 28.5.2/1359 
209 C008 |GPIO pad status register (GPIO1 PSR) 32 R 0000. 0000h | 28.5.3/1359 

| 209 COOC |GPIO interrupt configuration register! (GPIO1 ICR1) | 32 | RW | 0000 O000h |28.5.4/1360 | 
209 C010 |GPIO interrupt configuration register2 (GPIO1 ICR2) 32 R/W | 0000 0000h | 28.5.5/1364 
209 C014 |GPIO interrupt mask register (GPIO1 IMR) 32 R/W | 0000 0000h | 28.5.6/1367 
209 C018 |GPIO interrupt status register (GPIO1 ISR) 32 wic | 0000 0000h |28.5.7/1368 
209 CO1C |GPIO edge select register (GPIO1 EDGE SEL) 32 R/W | 0000 0000h | 28.5.8/1369 


























图 45.2.2.1 GPIO1 寄存 器 表 

从 图 45.2.2.1 可 以 看 出 ，GPIO1 控制 器 的 基地 址 就 是 0X0209C000。 

第 509 行 ,“gpio-controller” 表 示 gpiol 节点 是 个 GPIO 控制 器 。 

第 S10 行 ,，“#gpio-cells” 属 性 和 “#address-cells” 类 似 ，#gpio-cells 应 该 为 2， 表示 一 共有 
两 个 cell， 第 一 个 cell 为 GPIO 编号 ， 比 如 “&gpiol 3” 就 表示 GPIO1 IO03 。 第 二 个 cell 表示 
GPIO 极 性 如 果 为 0 的 话 表示 高 电 平 有 效 ， 如 果 为 1 的 话 表示 低 电 平 有 效 。 

2. GPIO 驱动 程序 简介 

本 小 节 会 涉及 到 Linux 驱动 分 层 与 分 离 、 平 台 设备 驱动 等 还 未 讲解 的 知识 ， 所 以 本 小 节 教 
程 可 以 不 用 看 ， 不 会 影响 后 续 的 实验 。 如 果 对 Linux 内 核 的 GPIO 子 系统 实现 原理 感 兴趣 的 话 
可 以 看 本 小 节 。 

gpiol 节点 的 compatible 属性 描述 了 兼容 性 ， 在 Linux 内 核 中 搜索 “fsl,imx6ul-gpio” 和 

“fsl,imx35-gpio” 这 两 个 字符 串 ， 查找 GPIO 驱动 文件 。drivers/gpio/gpio-mxc.c 就 是 IMX6ULL 
的 GPIO 驱动 文件 ， 在 此 文件 中 有 如 下 所 示 of device id 匹配 表 : 
示例 代码 45.2.2.3 mxc_gpio_dt_ids 匹配 表 
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1527 tetic Const SETCE (ue devices id me goio che idefi e 

3S] ( .compatible —- "fsl,imxl-gpio", .data - 
&mxc goio devtype[IMX1 GPIO], Dg 

154 ( .compatible S "fsl,imx21-gpio", -data = 
&mxc Golo devtype[IMX21 GPIO], ], 

HS ( .compatible - "fsl,imx3l1-gpio", .data - 
&mxc gpio devtype[IMX31 GPIO], ], 

156 ( .compatible - "fsl,imx35-gpio", .data - 
&mxc gpio devtype[IMX35 GPIO], ], 

ISa ( /* sentinel */ ) 

JUS. B 





第 156 行 的 compatible 值 为 “fsl,imx35-gpio”， 和 gpiol 的 compatible 属性 匹配 ， 因 此 gpio- 
mxc.c 就 是 LIMX6ULL 的 GPIO 控制 器 驱动 文件 。 gpio-mxc.c 所 在 的 目录 为 drivers/gpio, 打开 这 
个 目录 可 以 看 到 很 多 芯片 的 gpio 驱动 文件 ， “gpiolib” 开 始 的 文件 是 gpio 驱动 的 核心 文件 ， 
如 图 45.2.2.2 所 示 : 
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à gpiolib.c 


@ gpiolib.h 

e gpiolib-acpi.c 
Ø gpiolib-legacy.c 
Ø gpiolib-of.c 

e gpiolib-sysfs.c 


2019-05-25 10:26 
2019-05-25 10:26 
2019-05-25 10:26 
2019-05-25 10:26 
2019-05-25 10:26 
2019-05-25 10:26 


O ERAF 
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sourceinsight.c file 
H 文件 

sourceinsight.c file 
sourceinsight.c file 
sourceinsight.c file 


sourceinsight.c file 


图 45.2.2.2 gpio 核心 驱动 文件 
我 们 重点 来 看 一 下 gpio-mxc.c 这 个 文件 ， 在 gpio-mxc.c 文件 中 有 如 下 所 示 内 容 : 
示例 代码 45.2.2.4 mxc. gpio. driver 结构 体 
a I 


49/5 statie struct platiorm driver me Golo river 


497 .driver = { 
498 -name  - "gpio-mxc", 
499 .of match table > mxc golo dt ids, 
500 m 
501 . probe = mxc_gpio_probe, 
502 cig teble = bue ggeio deyvtype, 
SOS E 
可 以 看 出 GPIO 驱动 也 是 个 平台 设备 驱动 ， 因 此 当 设 备 树 中 的 设备 节点 与 驱动 的 











of device id 匹配 以 后 probe 函数 就 会 执行 ， 在 这 里 就 是 mxc gpio probe 函数 ， 这 个 函数 就 是 
LMX6ULL 的 GPIO 驱动 入 口 函 数 。 我 们 简单 来 分 析 一 下 mxc_gpio_probe 这 个 函数 ， 函 数 内 容 
如 下 : 

示例 代码 45.2.2.5 mxc_gpio_probe 函数 
























































403 static int mxc gpio probe(struct platform device *pdev) 
404 ( 

405 struct device node *np - pdev-»dev.of node; 

406 StruUCt Me GolO POr POTE? 

407 struct resource *iores; 

408 iae Lre bese; 

409 aho 7 

410 

411 mxc gpio get hw(pdev); 

412 

413 port = devm kzalloc(&pdev-»dev, sizeof(*port), GFP KERNEL); 
414 sus (xoi) 

ls return -ENOMEM; 

416 

417 iores — platform get resource(pdev, IORESOURCE MEM, 0); 
418 port-»base = devm ioremap resource(&pdev-»dev, iores); 
419 if (IS ERR(port-»base)) 

420 return PTR ERR(port-»base); 

421 

422 port-»irq high = platform get irq(pdev, 1); 

423 port-»irq = platform get irq(pdev, 0); 

424 sus (ipowiE-c3xegr «S 0) 
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425 return port-»irg; 

426 

427 /* disable the interrupt and clear the status */ 

428 Witel (0 GEE=DDaSS r GPIO IMR)? 

429 weabtxelL(ic0, BOort=->oase y GPIO TSR) p 

430 

431 if (mxc gpio hwtype == IMX21 GPIO) { 

432 Js 

433 * Setup one handler for all GPIO interrupts. Actually 
434 * setting the handler is needed only once, but doing it for 
435 * every port is more robust and easier. 

436 Pr 

437 irg Set Chained imeunolle((oxoscib-c-3lzep; m2 yeso ira hancer)? 
438 } else { 

439 /* setup one handler for each entry */ 

440 iie; eet Chainec! nhanciler(port->1rc; m3 goio ira hmeumlleue) ? 
441 irg set nenciler data (eeu, POTT) $ 

442 de (port zirg arga > O) i 

443 eeu handier Cor CETORI Eo Sb 57 

444 Lrg set chained ane > ee ny 

445 mx3 gpio irq handler); 

446 iraq set handler data (porc >irg high, POTE) p 

447 } 

448 } 

449 

450 err o bgpio init(&port-»bgc, &pdev-»dev, 4, 

451 poxtt--1oege «r (GIO IPSI. 

452 port-»base + GPIO DR, NULL, 

453 port-»base * GPIO GDIR, NULL, 0); 

454 if (err) 

25 goto out bgio; 

456 

457 Demme >on LO Lro = mE Golo tO Lre 

458 port-»bgc.gc.base = (pdev-»id < 0) ? of alias get id(np, "gpio") 
459 w 32 g pieveic w Sp 

460 

461 err = gpiochip add(&port-»bgc.gc); 

462 if (err) 

i63 goto out bgpio remove; 

464 

465 irg bese = irg alloc eeses(-i, 0; 32, mima nede al) 
466 da (Lecq base < Oh q 

467 err c irg lease, 
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468 goto out gpiochip remove; 

469 } 

470 

471 port-»domain - irq domain add legacy(np, 32, irq base, O0, 
472 &irq domain simple ops, NULL); 

473 if (!port-»domain) ( 

474 err - -ENODEV; 

475 goto out irqdesc free; 

476 ) 

477 

478 /* gpio-mxc can be a generic irq chip */ 

479 me GjouLo init geport, irg base) s 

480 

481 list add tail(&port-»node, &mxc gpio ports); 

482 

483 return 0; 

494 } 


第 405 行 ， 设 备 树 节点 指针 。 

第 406 行 ， 定 义 一 个 结构 体 指 针 port， 结 构 体 类 型 为 mxc_gpio_port。gpio-mxc.c 的 重点 工 
作 就 是 维护 mxc gpio port, mxc gpio port 就 是 对 IMX6ULL GPIO 的 抽象 。mxc_gpio_port 结 
构 体 定义 如 下 : 








[Rh 








示例 代码 45.2.2.6 mxc. gpio. port 结构 体 
GL erTTUCE me gopio port i 


62 Seue ee dist need! node; 

63 void . iomem *base; 

64 stent eee 

65 sume iro nigaz 

66 StruUCE ire Comain vdomeiny 
67 struct bgpio_chip bgc; 

68 u32 born edges, 

Gi Jp 





mxc gpio port 的 bgc 成 员 变 量 很 重要 ， 因 为 稍 后 的 重点 就 是 初始 化 bgc。 
继续 回 到 mxc_gpio_probe 函数 函数 ， 第 411 行 调用 mxc_gpio_get_hw 函数 获取 gpio 的 硬 
件 相关 数据 ， 其 实 就 是 gpio 的 寄存 器 组 ， 函 数 mxc gpio get hw 里 面 有 如 下 代码 : 
示例 代码 45.2.2.7 mxc. gpio. get hw 函数 


364 static void mxc gpio get hw(struct platform device *pdev) 









































Soo 

366 Const ue (ur device id vot ie = 

367 of match device(mxc gpio dt ids, &pdev-»dev); 
368 enum mxc gpio hwtype hwtype; 

383 
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384 if (hwtype == IMX35 GPIO) 

385 mxc gpio hwdata = &imx35 gpio hwdata; 

386 else if (hwtype == IMX31 GPIO) 

387 mxc gpio hwdata = &imx3l gpio hwdata; 

388 else 

3989 mxc gpio hwdata = &imxl imx21 gpio hwdata; 

390 

391 mxc gpio hwtype = hwtype; 

EON) 

















注意 第 385 fT, mxc gpio hwdata 是 个 全 局 变量 ， 如 果 硬 件 类 型 是 IMX35_GPIO 的 话 设置 


























mxc gpio hwdat 为 imx35_gpio_hwdata。 对 于 LMX6ULL 而 言 ， 硬 件 类 型 就 是 IMX35 GPIO, 











imx35 gpio hwdata 是 个 结构 体 变量 ， 描 述 了 GPIO 寄存 器 组 ， 内 容 如 下 : 
示例 代码 45.2.2.8 imx35_gpio_hwdata 结构 体 
101 static struct mxc goio hwdata imx35 gpio hwdata = i 





102 Sclence = 0x00, 
103 -iE reg = 0x04, 
104 -SE Led = 0x08, 
TOS DG reg = 0x0c, 
106 mtem LG = 0x10, 
107 ome Eeg) = 0x14, 
108 alse ee = 0x18, 
109 -SO sel reg = Olor 
110 .low level = 0x00, 
TEL ein = 0x01, 
16302 oriee edge = 0x02, 
113 otal edge = 0x03, 
ARY 











大 家 将 imx35_gpio_hwdata 中 的 各 个 成 员 变 量 和 图 45.2.2.1 中 的 GPIO 寄存 器 表 对 比 就 会 发 























Ji, imx35 gpio hwdata 结构 体 就 是 GPIO 寄存 器 组 结构 。 这 样 我 们 后 面 就 可 以 通过 


mxc_gpio_hwdata 这 个 全 局 变量 来 访问 GPIO 的 相应 寄存 器 了 。 
继续 回 到 示例 代码 45.2.2.5 的 mxc gpio probe 函数 中 ， 第 



































417 行 ， 调 用 函数 











platform get resource 获取 设备 树 中 内 存 资源 信息 ， 也 就 是 reg 属性 值 。 前 面 说 了 reg 属性 指定 
了 GPIOI 控制 器 的 寄存 器 基地 址 为 0X0209C000， 在 配合 前 面 已 经 得 到 的 mxc_gpio_hwdata， 














这 样 Linux 内 核 就 可 以 访问 gpiol 的 所 有 寄存 器 了 。 

















第 418 行 ， 调 用 devm ioremap resource 函数 进行 内 存 映射 ， 得 到 0x0209C000 在 Linux 内 

















核 中 的 虚拟 地 址 。 











第 422、423 行 ， 通 过 platform. get irg 函数 获取 中 断 号 ,第 422 行 获取 高 16 位 GPIO 的 中 





断 号 ， 第 423 行 获取 底 16 位 GPIO 中 断 号 。 


第 428. 429 行 ， 操 作 GPIO1 的 IMR 和 ISR 这 两 个 寄存 器 ， 关 闭 GPIOI 所 有 IO 中 断 ， 并 





且 清 除 状态 寄存 器 。 





第 438-448 行 ， 设 置 对 应 GPIO 的 中 断 服 务 函 数 ， 不 管 是 高 16 位 还 是 低 16 位 ， 中 断 服 务 


函数 都 是 mx3 gpio irq handler. 








第 450-453 行 ，bgpio_init 函数 第 一 个 参数 为 bgc， 是 bgpio chip 结构 体 指针 。bgpio_chip 
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结构 体 有 个 gc 成 员 变 量 , gc 是 个 gpio chip 结构 体 类 型 的 变量 。gpio_chip 结构 体 是 抽象 出 来 的 
GPIO 控制 器 ，gpio_chip 结构 体 如 下 所 示 ( 有 缩减 ): 

示例 代码 45.2.2.9 gpio. chip 结构 体 

















qd  mücruiet goto ehe i 





31; (eom reuera *label; 

76 struct device *dev; 

TA struct module *owner; 

78 SEEUGE list head listy 

TS 

80 aiae (vrsguest) (Struct goio Chip wehi, 

81 unsigned offset); 

82 void (Hires) (struct gopio Chip temp, 

83 unsigned offset); 

84 Liae (gert Cirsctionj (struct goio Chip vchi, 
85 unsigned offset); 

86 int (ence one (Struct goio chip weni, 
87 unsigned offset); 

88 iaie (etreacrion output) (struct gopio Chai wehi, 
89 unsigned offset, int value); 
90 int (get) ((encirwxedr goio Chip *Xelmie, 

91 unsigned offset); 

92 void (scm (Struct goio chip vAeleuuge, 

OS unsigned offset, int value); 

TASTI 


可 以 看 出 ，gpio_chip 大 量 的 成 员 都 是 函数 ， 这 些 函 数 就 是 GPIO 操作 函数 。bgpio_init 函数 
主要 任务 就 是 初始 化 bgc->gc bgpio init 里 面 有 三 个 setup 函数 : bgpio setup io 、 
bgpio setup accessors 和 bgpio_setup_direction。 这 三 个 函数 就 是 初始 化 bgc->gc 中 的 各 种 有 关 
GPIO 的 操作 ， 比 如 输出 ,输入 等 等 。 第 451-453 行 的 GPIO_PSR、GPIO_DR 和 GPIO GDIR 都 
是 IMX6ULL 的 GPIO 寄存 器 。 这 些 寄存 器 地 址 会 赋值 给 bgc 参数 的 reg dat. reg set. reg clr 
和 reg. dir 这 些 成 员 变量 。 至 此 , bgc 既 有 了 对 GPIO 的 操作 函数 , 又 有 了 IMX6ULL 有 关 GPIO 
的 寄存 器 ， 那 么 只 要 得 到 bgc 就 可 以 对 LMX6ULL 的 GPIO 进行 操作 。 

继续 回 到 mxc_gpio_probe 函数 ,第 461 行 调用 函数 gpiochip_add 向 Linux 内 核 注 册 gpio_chip， 
也 就 是 port->bgc.gc。 注 册 完 成 以 后 我 们 就 可 以 在 驱动 中 使 用 gpiolib 提供 的 各 个 API 函数 。 
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45.2.3 gpio TRA API 函数 


的 GPIO, gpio 子 系统 向 驱动 开发 人 员 屏 蔽 了 有 具体 的 读 写 寄存 器 过 程 。 这 就 是 

















对 于 驱动 开发 人 员 , 设置 好 设备 树 以 后 就 可 以 使 用 gpio 子 系统 提供 的 API 
























































的 好 处 ， 大 家 各 司 其 职 ， 做 好 自己 的 本 职工 作 即 可 。gpio 子 系统 提供 的 常用 的 
Aj 














1. gpio request 函数 





论坛 :www.opendev.com 


函数 来 操作 指定 
驱动 分 层 与 分 离 
API 函数 有 下 面 


























gpio request 函数 用 于 申请 一 个 GPIO 管 脚 ,在 使 用 一 个 GPIO 之 前 一 定 要 使 用 gpio_request 








进行 申请 ， 函 数 原型 如 下 : 


int gpio_request(unsigned gpio, const char *label) 


函数 参数 和 返回 值 含 义 如 下 : 








gpio: 要 申请 的 gpio 标号 ， 使 用 of get named gpio 函数 从 设备 树 获 取 指 定 GPIO 属性 信 


此 函数 会 返回 这 个 GPIO 的 标号 。 
label: 给 gpio 设置 个 名 字 。 
返回 值 ，0， 申 请 成 功 ， 其 他 值 ， 申 请 失败 。 


2. gpio free 函数 


























如 果 不 使 用 某 个 GPIO 了 ， 那 么 就 可 以 调用 gpio free 函数 进行 释放 。 函 数 原型 如 下 : 








void gpio free(unsigned gpio) 
函数 参数 和 返回 值 含义 如 下 : 
gpio: 要 释放 的 gpio 标号 。 
返回 值 : 无 。 
3. gpio direction input 函数 
此 函数 用 于 设置 某 个 GPIO 为 输入 ， 函 数 原型 如 下 所 示 : 
int gpio direction input(unsigned gpio) 
函数 参数 和 返回 值 含 义 如 下 : 
gpio: 要 设置 为 输入 的 GPIO 标号 。 
返回 值 : 0， 设 置 成 功 ， 负 值 ， 设 置 失败 。 


4. gpio direction output 函数 









































此 函数 用 于 设置 条 个 GPIO 为 输出 ， 并 且 设置 默认 输出 值 ， 函 数 原 型 如 下 : 




















int gpio_direction output(unsigned gpio, int value) 
函数 参数 和 返回 值 含义 如 下 : 

gpio: 要 设置 为 输出 的 GPIO 标号 。 

value: GPIO 默认 输出 值 。 

返回 值 : 0， 设 置 成 功 ， 负 值 ， 设 置 失败 。 

5. gpio get value 函数 


此 函数 用 于 获取 某 个 GPIO 的 值 (0 或 1)， 此 函数 是 个 宏 ， 定 义 所 示 : 
#define gpio get value — gpio get value 




















. gpio get value(unsigned gpio) 
CDTTTTS 回 值 含 义 如 下 : 
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gpio: 要 获取 的 GPIO 标号 。 
返回 值 ， 非 负 值 ， 得 到 的 GPIO 值 ， 负 值 ， 获 取 失 败 。 


6. gpio set value 函数 
此 函数 用 于 设置 某 个 GPIO 的 值 ， 此 函数 是 个 宏 ， 定义 如 下 


#define gpio set value _ gpio set value 

















void  gpio set value(unsigned gpio, int value) 

函数 参数 和 返回 值 含 义 如 下 : 

gpio: 要 设置 的 GPIO 标号 。 

value: 要 设置 的 值 。 

RE: 无 

关于 gpio 子 系统 常用 的 API 函数 就 讲 这 些 ， 这 些 是 我 们 用 的 最 多 的 。 























45.2.4 设备 树 中 添加 gpio 节点 模板 

继续 完成 45.1.3 中 的 test 设备 ， 在 45.1.3 中 我 们 已 经 讲解 了 如 何 创 建 test 设备 的 pinctrl 节 
点 。 本 节 我 们 来 学 习 一 下 如 何 创建 test 设备 的 GPIO 节点 。 

1、 创 建 test 设备 节点 


在 根 节点 “/” 下 创建 test 设备 子 节点 ， 如 下 所 示 : 
示例 代码 45.2.4.1 test 设备 节点 

















Ieeseol 
a Je rz 
3r p 


2、 添 加 pinctrl 信息 
在 45.1.3 中 我 们 创建 了 pinctrl_test 节点 ， 此 节点 描述 了 test 设备 所 使 用 的 GPIO_IO00 这 个 
PIN 的 信息 ， 我 们 要 将 这 节点 添加 到 test 设备 节点 中 ， 如 下 所 示 : 

示例 代码 45.2.4.2 向 test 节点 添加 pinctrl 信息 


























test ( 


pinctrl-names = "default"; 


/* 其 他 节点 内 容 */ 
] 
第 2 行 ， 添 加 pinctrl-names 属性 ， 此 熟悉 描述 pinctrl 名 字 为 “default”。 
第 3 行 ， 添 加 pinctrl-0 节点 ， 此 节点 引用 45.1.3 中 创建 的 pinctrl test 节点 ， 表 示 tset 设备 
的 所 使 用 的 PIN 信息 保存 在 pinctrl_test 节点 中 。 
3、 添 加 GPIO 属性 信息 


我 们 最 后 需要 在 test 节点 中 添加 GPIO 属性 信息 , 表明 test 所 使 用 的 GPIO 是 哪个 引 脚 , 添 
加 完成 以 后 如 下 所 示 : 


1 
2 
So ne le test} 
4 
5 



































示例 代码 45.2.4.3 向 test 节点 添加 gpio 属性 
Meest 
2 pinctrl-names = "default"; 
3 Pinet 0 < eest, 
4  gpio = <&gpiol 0 GPIO ACTIVE LOW» 
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5}; 
第 4 行 ，test 设备 所 使 用 的 gpio。 
关于 pinctrl 子 系统 和 gpio 子 系统 就 讲解 到 这 里 ， 接 下 来 就 使 用 pinctrl 和 gpio TRARY 














ipa 





动 LMX6ULL-ALPHA 开发 板 上 的 LED 4T. 


45.1.5 与 gpio 相关 的 OF 函数 


在 示例 代码 45.2.4.3 中 ， 我 们 定义 了 一 个 名 为 “gpio” 的 属性 ，gpio 
备 所 使 用 的 GPIO. 在 驱动 程序 中 需要 读 取 gpio 属性 内 容 ，Linux 内 核 提 
的 OF 函数 ， 常 用 的 几 个 OF 函数 如 下 所 示 : 
1. of gpio named count 函数 
of gpio named count 函数 用 于 获取 设备 树 某 个 属 ! 
是 空 的 GPIO 信息 也 会 被 统计 到 ， 比 如 : 
gpios = «0 
&gpiol 12 
0 
&gpio2 3 4>; 
上 述 代码 的 “gpios” 节 点 一 共 定义 了 4 个 GPIO， 但 是 有 2 个 是 空 的 ， 没 有 实际 的 含义 。 
通过 of gpio named count 函数 统计 出 来 的 GPIO 数量 就 是 4 个 ， 此 函数 原型 如 下 : 
int of gpio named count(struct device node *np, const char *propname) 
函数 参数 和 返回 值 含义 如 下 : 
nd: 设备 节点 。 
propname: 要 统计 的 GPIO 属性 。 
返回 值 : 正 值 ， 统 计 到 的 GPIO 数量 ， 负 值 ， 失 败 。 
2. of gpio count 函数 
和 of gpio named count 函数 一 样 ， 但 是 不 同 的 地 方 在 于 ， 此 函数 统计 的 是 “gpios” 这 个 属 
性 的 GPIO 数量 ， 而 of gpio named count 函数 可 以 统计 任意 属性 的 GPIO 信息 ， 函 数 原型 如 下 
所 示 : 
int of gpio count(struct device node *np) 
函数 参数 和 返回 值 含义 如 下 : 
nd: 设备 节点 。 
返回 值 : 正 值 ， 统 计 到 的 GPIO 数量 ， 负 值 ， 失 败 。 
3. of get named gpio 函数 
此 函数 获取 GPIO 编号 ， 因 为 Linux 内 核 中 关于 GPIO 的 API 函数 都 要 使 用 GPIO 编号 ， 
此 函数 会 将 设备 树 中 类 似 <&gpio5 7 GPIO ACTIVE LOW> 的 属性 信息 转换 为 对 应 的 GPIO 编 
号 ， 此 函数 在 驱动 中 使 用 很 频繁 ! 函数 原型 如 下 : 














述 了 test 这 个 设 
了 几 个 与 GPIO HX 




















zE m 
HE 























-=> 


生 里 面 定义 了 几 个 GPIO 信息 ， 要 注意 的 














































































































int of get named gpio(struct device node *np, 
const char *propname, 
int index) 
函数 参数 和 返回 值 含 义 如 下 : 
nd: 设备 节点 。 








propname: 包含 要 获取 GPIO 信息 的 属性 名 。 
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index: GPIO 索引 ， 因 为 一 个 属性 里 面 可 能 包含 多 个 GPIO， 此 参数 指定 要 获取 哪个 GPIO 
的 编号 ， 如 果 只 有 一 个 GPIO 信息 的 话 此 参数 为 0。 
返回 值 ， 正 值 ， 获 取 到 的 GPIO 编号 ， 负 值 ， 失 败 。 


45.3 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 8.3 小 节 即 可 。 


45.4 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 2. Linux 驱动 例 程 -> 5_gpioled。 

本 章 实验 我 们 继续 研究 LED 灯 ， 在 第 四 十 四 章 实 验 中 我 们 通过 设备 树 向 dtsled.c 文件 传递 
相应 的 寄存 器 物理 地 址 , 然后 在 驱动 文件 中 配置 寄存 器 。 本 章 实验 我 们 使 用 pinctrl 和 gpio TA 
统 来 完成 LED 灯 了 驱动 。 





































































































45.4.1 修改 设备 树 文件 


1、 添 加 pinctrl 节点 

LMX6U-ALPHA 开发 板 上 的 LED 灯 使 用 了 GPIO1 IO03 这 个 PIN， 打 开 imx6ull-alientek- 
emmc.dts， 在 iomuxc 节点 的 imx6ul-evk 子 节点 下 创建 一 个 名 为 “pinctrl led” 的 子 节点 ， 节 点 
内 容 如 下 所 示 : 











示例 代码 45.4.1.1 GPIO1_IO03 pincttl 节点 





i pinctii lec: ec | 

2 fsl,pins - « 

3 MX6UL PAD GPIO1 IO03 GPIO1 IO03 D1080 SIS 
4 2; 

5}; 





第 3 行 ， 将 GPIO1 IO03 这 个 PIN 复 用 为 GPIO1 IO03， 也 就 是 GPIO，GPI1O 1003 这 个 
PIN 的 电气 属性 值 为 0X10B0， 也 就 是 设置 IOMUXC SW PAD CTL PAD GPIOI 1003 寄存 器 
的 值 为 0X10B0。 
2、 添 加 LED 设备 节点 
在 根 节 点 “/” 下 创建 LED 灯节 点 ， 节 点 名 为 “gpioled”， 节 点 内 容 如 下 : 
示例 代码 45.4.1.2 创建 LED 灯节 点 


























1 gpioled ( 

2 faddress-cells = «1»; 

3 fsize-cells = «1»; 

4 compatible = "atkalpha-gpioled"; 

5 pinctrl-names — "default"; 

6 pinctrl-0 = «&pinctrl led»; 

1 led-gpio = «&gpiol 3 GPIO ACTIBE LOW»; 
8 status = "okay"; 

2E 








第 7 fT, pinctrl-0 属性 设置 LED 灯 所 使 用 的 PIN 对 应 的 pinctrl 节点 。 
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第 8 fT, led-gpio 属性 指定 了 LED 灯 所 使 用 的 GPIO， 在 这 里 就 是 GPIO1 的 IO003， 低 电 平 











有 效 。 稍 后 编写 驱动 程序 的 时 候 会 获取 led-gpio 属性 的 内 容 来 得 到 GPIO 编号 ， 因 为 gpio 子 系 
统 的 API 操作 函数 需要 GPIO 编号 。 

3、 检 查 PIN 是 否 被 其 他 外 设 使 用 

这 一 点 非常 重要 !1!! 

很 多 初次 接触 设备 树 的 驱动 开发 人 员 很 容易 因为 这 个 小 问题 栽 了 大 跟 涉 ! 因为 我 们 所 使 用 
的 设备 树 基 本 都 是 在 半导体 厂商 提供 的 设备 树 文件 基础 上 修改 而 来 的 ， 而 半导体 厂商 提供 的 设 
备 树 是 根据 自己 官方 开发 板 编写 的 ， 很 多 PIN 的 配置 和 我 们 所 使 用 的 开发 板 不 一 样 。 比 如 A 这 
个 引 脚 在 官方 开发 板 接 的 是 PC 的 SDA， 而 我 们 所 使 用 的 硬件 可 能 将 A 这 个 引 脚 接 到 了 其 他 
的 外 设 ， 比 如 LED 灯 上 ， 接 不 同 的 外 设 ，A 这 个 引 脚 的 配置 就 不 同 。 一 个 引 脚 一 次 只 能 实现 一 
个 功能 , 如 果 A 引 脚 在 设备 树 中 配置 为 了 I2C 的 SDA 信号 ,那么 A 引 脚 就 不 能 再 配置 为 GPIO， 
否则 的 话 驱 动 程序 在 申请 GPIO 的 时 候 就 会 失败 。 检 查 PIN 有 没有 被 其 他 外 设 使 用 包括 两 个 方 
H: 






































































































































































































































CD、 检查 pinctrl 设置 。 
©, WRA PIN 配置 为 GPIO 的 话 ， 检 查 这 个 GPIO 有 没有 被 别 的 外 设 使 用 。 
在 本 章 实验 中 LED 灯 使 用 的 PIN 为 GPIO1 IO03， 因 此 先 检查 GPIO_IO03 这 个 PIN 有 没 
有 被 其 他 的 pinctrl 节点 使 用 ， 在 imx6ull-alientek-emmc.dts 中 找到 如 下 内 容 : 

示例 代码 45.4.1.3 pinctrl tsc 节点 
4/5/0, SEE tects SEO d 


























F 





























481 fsl,pins = « 

482 MX6UL PAD GPIO1 IO01 GPIO1 IO01 0xb0 
483 MX6UL PAD GPIOI1 IO02 GPIOl1 IO02 0xb0 
484 MX6UL PAD GPIO1 IO03  GPIO1 IO03 OxbO 
485 MX6UL PAD GPIOl1 IO04 GPIO1 IO04 0xb0 
486 >; 

487 }; 


























pinctrl tsc 节点 是 TSC( 电 阻 触摸 屏 接口 ) 的 pinctrl 节点 ， 从 第 484 行 可 以 看 出 ， 默 认 情 况 下 
GPIO1 IO03 作为 了 TSC 外 设 的 PIN。 所 以 我 们 需要 将 第 484 行 屏 蔽 掉 ! 和 C 语言 一 样 ， 在 要 
屏蔽 的 内 容 前 后 加 上 “/*” 和 “*/” 符 号 即 可 。 其 实在 IMX6U-ALPHA 开发 板 上 并 没有 用 到 TSC 
接口 ， 所 以 第 482-485 行 的 内 容 可 以 全 部 屏蔽 掉 。 

因为 本 章 实验 我 们 将 GPIO1 IO03 这 个 PIN 配置 为 了 GPIO， 所 以 还 需要 查找 一 下 有 没有 
其 他 的 外 设 使 用 了 GPIOI IO03, fE imx6ull-alientek-emmc.dts 中 搜索 ol 3” 找到 如 下 内 





















































X: 
示例 代码 45.4.1.4 tsc 节点 
723 &tsc ( 
724 pinctrl-names - "default"; 
31225; pinctrl-0 2 «&pinctrl tsc»; 
726 xnur-gpio = «&gpiol 3 GPIO ACTIVE LOW»; 
TAN measure-delay-time = <0xffff>; 
PAE pre-charge-time = <0xfff>; 
72:8) status - "okay"; 
TSOI 
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tsc 是 TSC 的 外 设 节 点 ， 从 726 行 可 以 看 出 ，tsc 外 设 也 使 用 了 GPIO1 IO03， 同 样 我 们 需 
要 将 这 一 行 屏蔽 掉 。 然 后 在 继续 搜索 “gpiol 3”, 看 看 除了 本 章 的 LED 灯 以 外 还 有 没有 其 他 的 
地 方 也 使 用 了 GPIO1 IO03， 找 到 一 个 屏蔽 一 个 。 

设备 树 编写 完成 以 后 使 用 “make dtbs” 命 令 重 新 编译 设备 树 ， 然 后 使 用 新 编译 出 来 的 
imx6ull-alientek-emmc.dtb 文件 启动 Linux 系统 。 局 动 成 功 以 后 进入 “/proc/device-tree” 目 录 中 
查看 “gpioled” 节 点 是 否 存在 ,如 果 存 在 的 话 就 说 明 设备 树 基本 修改 成 功 (具体 还 要 驱动 验证 )， 
结果 如 图 45.4.1.1 所 示 : 































































































x 




















/ € cd /proc/device-tree/ 

/sys/firmware/devicetree/base # ls 

#address-cells interrupt-controller@00a01000 
#size-cells memory 

aliases model 

alphaled name 

backlight pxp. v412 

chosen regulators 

clocks : Pri reserved-memory 

compatible gpioled 子 节点 soc 









sound 


s 
1rmware/devicetree/base # i 
图 45.4.1.1 gpio 子 节点 





45.4.2 LED 灯 驱 动 程序 编写 


设备 树 准 备 好 以 后 就 可 以 编写 驱动 程序 了 , 本 章 实 验 在 第 四 十 四 章 实 验 驱动 文件 dtsled.c 的 
基础 上 修改 而 来 。 新 建 名 为 “5_gpioled” 文 件 夹 ， 然 后 在 5_gpioled 文件 夹 里 面 创建 vscode T 
程 ， 工 作 区 命名 为 “gpioled”。 工 程 创建 好 以 后 新 建 gpioled.c 文件 ， 在 gpioled.c 里 面 输入 如 下 
内 容 : 
























































示例 代码 45.4.2.1 gpioled.c 驱动 文件 代码 
finclude <linux/types.h> 
finclude <linux/kernel.h> 
#include <linux/delay.h> 
finclude «linux/ide.h» 
finclude <linux/init.h> 
finclude <linux/module.h> 
tine iude «linux/errno.h» 
#include <linux/gpio.h> 
#include <linux/cdev.h> 
#include <linux/device.h> 
#include <linux/of.h> 
#include <linux/of_address.h> 


OO S CODES | 














e e 
BD o 


rp 
N 


#include «linux/of gpio.h» 
finclude «asm/mach/map.h» 
finclude «asm/uaccess.h» 


dinclude Xasm/io.h» 


/大 大 大 大 炎炎 炎炎 炎炎 炎炎 大大 大 火炎 大 大 火炎 大 炎炎 炎炎 大大 大 大 炎炎 大 大 大 大 大 大大 大 大 大 大 大 大 大 炎炎 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 








FF PP 上 户 
= en On TO 


m 
co 





Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
文件 名 : gpioled.c 


fex 
O 
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20 作者 : 左 忠 凯 

21 版 本 3 Log 

22 ”描述 : 采用 pinctrl 和 gpio 子 系统 驱动 LED 灯 。 

23 其 他 

DAE UOS : www.openedv.com 

25 Ba : 初版 V1.0 2019/7/13 左 忠 凯 创建 

26 类 火炎 火炎 火炎 火炎 大 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 类 大 类 火炎 大 类 大 类 大 类 大 类 大 火炎 类 大 类 大 类 大 类 大 类 大 大大 类 大 大 大 大 大 大 大 类/ 
27 #define GPIOLED CNT 1 /* VES MR */ 

28 #define GPIOLED NAME Jopolla f= AS a 

29 #define LEDOFF 0 de RIT ey 

30 #define LEDON 1 EAE = 

E 


32 /* gpioled 设备 结构 体 */ 
35 Sw ggolee! devi 


34 dev t devid; /* 设备 号 ej 
35 struct cdev cdev; /* cdev mf 
36 struct class *class; RSS ui 
3 struct device *device; /* 设备 žy 
38 int major; /* 主 设备 号 i 
39 inot minor? /* 次 设备 号 AA 
40 struct device node *nd; /* 设备 节点 
41 int led gpio; /* led 所 使 用 的 GPIO 编号 */ 
22 dg 

43 

44 struct gpioled dev gpioled; /* led K4* */ 

45 

Ae cues 

47  * Qdescription  : 1]JfW4& 


48  * Qparam - inode : 传递 给 驱动 的 inode 
49  * Qparam - filp : 设备 文件 ，file 结构 体 有 个 叫做 private data 的 成 员 变 量 





50 * 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
51 * @return : 0 成 功 ;其 他 失败 
52 a 


53 tatic int led open (struct 1noce vinode, struct iile wiilp) 
54 ( 


55 filp-»private data = &gpioled; /* 设置 私有 数据 */ 
56 return 0; 

EE 

58 

39 5 


60  * Q(Gdescription : 从 设备 读 取 数 据 
61  * Q8param - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 
62  * Q8param - buf : 返回 给 用 户 空 间 的 数据 缓冲 区 
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63 ** [Bioeueewp — (ex : 要 读 取 的 数据 长 度 

64  * @param - offt : 相对 于 文件 首 地 址 的 偏 移 

65  * Qreturn : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 

616 Se 

Gos ees t lec zeec(suiuct iile wiil, char sn 


eizo © Cmt, loti t le) 


68 ( 

69 return 0; 
TORE) 

gl 

TA f 


73 * Qdescription : 向 设备 写 数据 

74 * Qparam - filp : 设备 文件 ， 表 示 打 开 的 文件 描述 符 

T8) * (üiparam - buf : 要 写 给 设备 写 入 的 数据 

76 nena ent : 要 写 入 的 数据 长 度 

7] * eparam - offt : 相对 于 文件 首 地 址 的 偏 移 

78  * @return : 写 入 的 字 节 数 ， 如 果 为 负 值 ， 表 示 写 入 失败 

U S. 

a statie See t lee write(struct tile wiilo, Const Char _ User Aui, 


Size © Cmt, loti 1E VOIE) 











gU 
82 int retvalue; 

83 unsigned char databuf[1]; 

84 unsigned char ledstat; 

85 struct gpioled dev *dev = filp-»private data; 

86 

87 retvalue = copy from user(databuf, buf, cnt); 

88 if(retvalue « 0) ( 

89 printk("kernel write failed!NrWMn"); 

90 return -EFAULT; 

gu } 

92 

93 ledstat = databuf[0]; /* 获取 状态 值 */ 
94 

93 if(ledstat == LEDON) { 

96 gpio set value (dev->led gpio, 0);  /* 打开 ZED 灯 */ 
or } else if(ledstat == LEDOFF) { 

98 gpio_set_value (dev->led_gpio, 1); /* 关闭 ZED 灯 */ 
99 } 

100 return 0; 

ion 

TOZ 

TOSA 
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104 * Qdescription  : 关闭 /释放 设备 

105 * Qparam - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 

106 * @return : 0 成 功 ;其 他 失败 

Oy eu 

lo statie int led releaselstruct Tnode winode, struct Tile wi1lio) 
OSE 

110 return 0; 

111 ) 

Z 

113 /* 设备 操作 函数 */ 


Wid statie gtruct tile operations Gololed tops = { 



































TIS .owner = THIS MODULE, 

dto .open - led open, 

T .read = led read, 

118 .write < led write, 

ITO oFelease = lec! release, 

305200) 8 

2 

12 e 

123 * Qdescription  : IK3) H O K ži 

124 * @param 3 JE 

125 * Qreturn 3 Jb 

JS fy 

177 gis: aum —  sbeube Jiexeb 3cmibu (voie 

E EET 

129 int ret = 0; 

130 

Dod /* 设置 LED 所 使 用 的 GPIO */ 

132 /* 1. NKHO A Hi: gpioled */ 

133 gpioled.nd = of find node by path("/gpioled"); 
ISA if(gpioled.nd == NULL) { 

T35 printk("gpioled node not find!Nrin"); 
MESI return -EINVAL; 

1:97 ) else ( 

138 printk("gpioled oe 

19 } 

140 

141 /* 2. 获取 设备 树 中 的 gpio 属性 ， 得 到 LED 所 使 用 的 LED 编号 */ 
142 gpioled.led gpio = of get named gpio(gpioled.nd, "ied-gpio", 0); 
143 if(gpioled.led gpio « 0) ( 

144 printk("can't get led-gpio"); 

145 return -EINVAL; 

146 ) 
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147 
148 
149 
150 
JUS 
1527 
dS] 
154 
AUS 
156 
157] 
158 
IUS 


160 
161 


162 
163 
164 
"es 


166 
167 
168 
169 
dE RO 
A 
IZ 
LS 
174 
1578] 
JL TAS 
IT 
IS 
NO 
180 
181 


182 
dE SS] 
184 
185 


ROLE 


/* 3, A GPIO1_I003 为 输出 ， 并 且 输 出 高 电 平 ， 默 认 关闭 IED 灯 */ 
ret = gpio direction output(gpioled.led gpio, 1); 
aloa aee «s (0) 4 





prince (Cean esec pii d mm) 


/* 注册 字符 设备 驱动 */ 

/* 1. 创建 设备 号 */ 

if (gpioled.major) ( f EN AS 
gpioled.devid = MKDEV(gpioled.major, 0); 











register chrdev region(gpioled.devid, GPIOLED CNT, 
GPIOLED NAME); 
) else ( /* 没有 定义 设备 号 
alloc chrdev region(&gpioled.devid, 0, GPIOLED CNT, 
GPIOLED NAME); /* 申请 设备 号 





























论坛 :www.opendev.com 


站 


i 


wy 


gpioled.major = MAJOR(gpioled.devid); /* 获取 分 配 号 的 主 设备 号 */ 


gpioled.minor 
} 
printk("gpioled major-$d,minor-$dNrWMn",gpioled.major, 


gpioled.minor); 


/* 2. 初始 化 scaev */ 
gpioled.cdev.owner = THIS MODULE; 





cdev init(&gpioled.cdev, &gpioled fops); 


/* 3. WN edew */ 
cdev add(&gpioled.cdev, gpioled.devid, GPIOLED CNT); 








/* 4、 创 建 类 */ 
gpioled.class = class create(THIS MODUL 
eus (el(enne ES EA 








irs] 

















return PTR ERR(gpioled.class); 





/* 5. 创建 设备 */ 
gpioled.device - device create(gpioled.class, NULL, 





, GPIOLED NAME); 


MINOR(gpioled.devid); /* 获取 分 配 号 的 次 设备 号 */ 





gpioled.devid, NULL, GPIOL 





ED NAME 











if (IS ERR(gpioled.device)) ( 





return PTR ERR(gpioled.device); 
} 


return 0; 
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186 } 

187 

Jg fem 

189 * Qdescription  : 驱动 出 口 函 数 

EA OE tamaen 3 JE 

191 * GQGreturn ES 

TOZ 

195, gracie vorl ^ exit led exit (vonc) 

194 { 

195 /* 注销 字符 设备 驱动 */ 

196 cdev del(&gpioled.cdev); /* 删除 cdqev */ 

197 unregister chrdev region(gpioled.devid, GPIOLED CNT); /* ikíf */ 
198 

199 device destroy(gpioled.class, gpioled.devid); 

200 Elass destroy (roseis. class) 7 

ZAO y 

202 


205 module init (leel imit) p 
204 module exit(led exit); 
205 MODULE LICENSE ("GPL"); 
206 MODULE AUTHOR ("zuozhongkai"); 























第 41 行 ， 在 设备 结构 体 gpioled dev 中 加 入 led gpio 这 个 成 员 变 量 ， 此 成 员 变 量 保存 LED 




















等 所 使 用 的 GPIO 编号 。 
第 55 行 ， 将 设备 结构 体 变量 gpioled 设置 为 filp 的 私有 数据 private data. 

















第 85 行 ， 通 过 读 取 filp 的 private data 成 员 变 量 来 得 到 设备 结构 体 变量 ， 也 就 是 gpioled。 




















这 种 将 设备 结构 体 设 置 为 filp 私有 数据 的 方法 在 Linux. 内 核 驱动 里 面 非常 常见 。 


第 96. 97 fT, 直接 调用 gpio set value 函数 来 向 GPIO 写 入 数据 , 实现 开 / 关 LED 的 效果 。 














不 需要 我 们 直接 操作 相应 的 寄存 器 。 
第 133 行 ， 获 取 节 点 “/gpioled”。 




















第 142 行 ， 通 过 函数 of get named gpio 函数 获取 LED 所 使 用 的 LED 编号 。 相 当 于 将 














gpioled 节点 中 的 “led-gpio” 属 性 值 转换 为 对 应 的 LED 编号 。 
第 150 行 ， 调 用 函数 gpio direction output 设置 GPIO1 IO03 这 个 GPIO 2355; H 
高 电 平 ， 这 样 默认 就 会 关闭 LED 灯 。 











bh ， 并 且 默 认 


可 以 看 出 gpioled.c 文件 中 的 内 容 和 第 四 十 四 章 的 dtsled.c 差不多 ， 只 是 取消 掉 了 配置 寄存 
器 的 过 程 ， 改 为 使 用 Linux 内 核 提供 的 API 函数 。 在 GPIO 操作 上 更 加 的 规范 化 ， 符 合 Linux 
代码 框架 ， 而 且 也 简化 了 GPIO 驱动 开发 的 难度 ， 以 后 我 们 所 有 例 程 用 到 GPIO 的 地 方 都 采用 























此 方法 。 


44.4.3 编写 测试 APP 











本 章 直 接 使 用 第 四 十 二 章 的 测试 APP, 将 上 一 章 的 ledApp.c 文件 复制 到 本 章 实验 工程 下 即 














可 。 
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45.5 运行 测试 


45.5.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱 动 程序 

编写 Makefile 文件 ， 本 章 实 验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 gpioled.o, Makefile 内 容 如 下 所 示 : 
示例 代码 45.5.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 


























rel imz 4.1.15 2,150 ga alisntek 
4 obj-m := gpioled.o.o 
11 clean: 
12 a (MAKE) -C $(KERNELDIR) M=$ (CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 gpioled.o。 
输入 如 下 命令 编译 出 驱动 模块 文件 : 
make -j32 
编译 成 功 以 后 就 会 生成 一 个 名 为 “gpioled.ko” 的 驱动 模块 文件 。 
2、 编 译 测试 APP 
输入 如 下 命令 编译 测试 ledApp.c 这 个 测试 程序 : 
arm-linux-gnueabihf-gcc ledApp.c -o ledApp 
编译 成 功 以 后 就 会 生成 led A pp 这 个 应 用 程序 。 
































45.5.2 运行 测试 


将 上 一 小 节 编 译 出 来 的 gpioled.ko 和 ledApp 这 两 个 文件 拷贝 到 rootfs/lib/modules/4.1.15 H 
录 中 , 重启 开发 板 , 进入 到 目录 lib/modules/4.1.15 中 ， 输入 如 下 命 命令 加 载 gpioled.ko 驱动 模块 : 

depmod /第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 

modprobe gpioled.ko /加 载 驱动 

驱动 加 载 成 功 以 后 会 在 终端 中 输出 一 些 信息 ， 如 图 45.5.2.1 所 示 : 
/lib/modules/4.1.15 # depmod 
/lib/modules/4.1.15 # modprobe gpioled.ko 
fea: oled node fi al ! 

noe num = 


ed maj lorz249. minorzO 
9 ya 4. 1.15 # E 











[E 




















图 45.5.2.1 驱动 加 载 成 功 以 后 输出 的 信息 
从 图 45.5.2.1 可 以 看 出 ，gpioled 这 个 节点 找到 了 ， 并 且 GPIO1 IO03 这 个 GPIO 的 编号 为 
3。 驱 动 加 载 成 功 以 后 就 可 以 使 用 ledApp 软件 来 测试 驱动 是 否 工作 正常 ,输入 如 下 命令 打开 LED 
灯 : 
/ledApp /dev/gpioled 1 /打开 LED 4T 
输入 上 述 命令 以 后 观察 LMX6U-ALPHA 开发 板 上 的 红色 LED 灯 是 否 点 亮 ， 如 果 点 亮 的 话 
说 明 驱 动工 作 正常 。 在 输入 如 下 命令 关闭 LED 4T: 
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.ledApp /dev/gpioled0 //X M] LED 灯 

输入 上 述 命令 以 后 观察 LMX6U-ALPHA 开发 板 上 的 红色 LED TEBEK WREIK 
动 的 话 输入 如 下 命令 即 可 : 

rmmod gpioled.ko 





x 


第 四 十 六 章 Linux 蜂 鸣 器 实验 


上 一 章 实验 中 我 们 借助 pinctrl 和 gpio 子 系统 编写 了 LED 灯 驱 动 , LMX6U-ALPHA FRIR 
上 还 有 一 个 蜂 鸣 器 ， 从 软件 的 角度 考虑 ， 蜂 鸣 器 驱动 和 LED 灯 驱 动 其 实 是 一 摸 一 样 的 ， 都 是 控 
制 IO 输出 高 低 电 平 , 本 章 我 们 就 来 学 习 编 写 蜂 鸣 器 的 Linux 驱动 ,也 算是 对 上 一 章 讲解 的 pinctrl 
和 gpio 子 系统 的 巩固 。 
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46.1 蜂 鸣 器 驱动 原理 


蜂 鸣 器 驱动 原理 已 经 在 第 十 四 章 有 了 详细 的 讲解 , LMX6U-ALPHA 开发 板 上 的 蜂 鸣 器 通过 
SNVS_TAMPER1 引 脚 来 控制 ， 本 节 我 们 来 看 一 下 如 果 在 Linux 下 编写 蜂 鸣 器 驱动 需要 做 哪些 
工作 : 

Q@、 在 设备 树 中 添加 SNVS_TAMPER1 引 脚 的 pinctrl 信息 。 

名 、 在 设备 树 中 创建 蜂 鸣 器 节点 ， 在 蜂 鸣 器 节点 中 加 入 GPIO 信息 。 

@、 编 写 驱 动 程序 和 测试 APP， 和 第 四 十 五 章 的 LED 驱动 程序 和 测试 APP 基本 一 样 。 

接 下 来 我 们 就 根据 上 面 这 三 步 来 编写 蜂 鸣 器 Linux 驱动 。 


46.2 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 14.3 小 节 即 可 。 


46.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 :， 开发 板 光盘 -> 2. Linux 驱动 例 程 -> 6_beep。 
本 章 实 验 在 四 十 二 章 实验 的 基础 上 完成 ， 重 点 是 将 驱动 改 为 基于 设备 树 的 . 








































































































46.3.1 修改 设备 树 文 件 


1、 添 加 pinctrl 节点 

LMX6U-ALPHA 开发 板 上 的 BEEP 使 用 了 SNVS_TAMPER1 这 个 PIN, 打 开 imx6ull-alientek- 
emmc.dts， 在 iomuxc 节点 的 imx6ul-evk 子 节点 下 创建 一 个 名 为 “pinctrl_beep” 的 子 节点 ， 节 点 
内 容 如 下 所 示 : 





示例 代码 46.3.1.1 SNVS_TAMPER1 pincttl 节点 
i pinectrl besp: ee 
2 fsl,pins - « 
MX6ULL PAD SNVS TAMPER1 GPIO5 IO01 0x10B0 /* beep */ 





第 3 行 (T$ SNVS TAMPERI X ^ PIN £€ H  GPIOSIO001 , X 
MX6ULL PAD SNVS TAMPERI GPIOS IO01 定义 在 arch/arm/boot/dts/imx6ull-pinfunc-snvs.h 
文件 中 。 

2、 添 加 BEEP 设备 节点 
在 根 节点 “/” 下 创建 BEEP 节点 ， 节 点 名 为 “beep” 节点 内 容 如 下 : 

示例 代码 46.3.1.2 创建 BEEP 蜂 鸣 器 节点 














1 beep ( 

2 faddress-cells = «1»; 

3 #size-cells = «1»; 

4 compatible = "atkalpha-beep"; 

5 pinctrl-names = "default"; 

6 pinctrl-0 2 «&pinctrl beep»; 

7 beep-gpio = «&gpio5 1 GPIO ACTIVE HIGH»; 
8 status = "okay"; 
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Sup 





F 6 1T, pinctrl-0 属性 设置 蜂 鸣 器 所 使 有 
第 7 行 ，beep-gpio 属性 指定 了 蜂 鸣 器 所 使 月 





3、 检 查 PIN 是 否 被 其 他 外 设 使 用 























设备 树 编写 完成 以 后 使 用 

















H 


在 本 章 实验 中 蜂 鸣 器 使 用 的 PIN 为 SNVS_TAMPER1, 因 
这 个 PIN 有 没有 被 其 他 的 pinctrl 节点 使 用 ， 如 果 有 使 ) 
GPIOS IO01 这 个 GPIO 有 没有 被 其 
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的 PIN 对 应 的 pinctrl 节点 。 


此 先 检查 PIN 为 SNVS_TAMPER1 
j 的话 就 要 屏蔽 掉 ， 然 后 再 检查 
他 外 设 使 用 ， 如 果 有 的 话 也 要 屏蔽 掉 。 

“make dtbs ”命令 重新 编 














译 设备 树 ， 然 后 使 用 新 编译 出 来 的 


imx6ull-alientek-emmc.dtb 文件 启动 Linux 系统 。 启 动 成 功 以 后 进入 “/proc/device-tree” 上 目录 中 





查看 “beep” 节 点 是 否 存 在 ， 如 














果 如 图 46.3.1.1 所 示 : 








46.3.2 蜂 鸣 器 驱动 程序 编写 


设备 树 准 备 好 以 后 就 可 以 编写 驱动 程序 了 ， 本 章 实 验 在 第 四 十 五 章 实验 驱动 文件 gpioled.c 

的 基础 上 修改 而 来 。 新 建 名 为 “6_beep” 的 文件 来， 然后 在 6 beep 文件 夹 里 面 创建 vscode T 

工作 区 命名 为 “beep”。 工 程 创建 好 以 后 新 建 beep.c 文件 ， 在 beep.c 里 面 输入 如 下 内 容 : 
示例 代码 46.3.2.1 beep.c 文件 代码 段 


程 





CONES OC CoN ND ES 


[ES ees 
N H|B o 


e RH Hm 
Oo Oi e C) 


, 












































finclude <linux/types.h> 
finclude «linux/kernel.h» 
finclude «linux/delay.h» 
finclude «linux/ide.h» 
finclude «linux/init.h» 
finclude <linux/module.h> 
finclude <linux/errno.h> 
finclude «linux/gpio.h» 
finclude «linux/cdev.h» 








dinclude «linux/device.h» 
include «linux/of.h» 


*include «linux/of address.h» 
*include «linux/of gpio.h» 


finclude «asm/mach/map.h» 
finclude «asm/uaccess.h» 


include Xasm/io.h» 








/ € 1s /proc/device-tree/ 
Zaddress-cells 
#size-cells memory 
al i M. model 
alphale 3i name 
backlighi beep ^m pxp_v412 
D regulators 

chosen reserved-memory 
clocks soc 
compatible sound 
cpus spi4 

pioled 
TN 


图 46.3.1.1 beep 子 节点 












































果 存 在 的 话 就 说 明 设 备 树 基本 修改 成 功 (具体 还 要 驱动 验证 )， 结 


interrupt-controller@00a01000 
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18 Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 


























19 文件 名 : beep.c 

20 作者 : 左 忠 凯 

21 版 本 3 Vi Ô 

22 描述 : 蜂 鸣 器 驱动 程序 。 

23 其 他 3 JE 

QUI WEdES : www.openedv.com 

25 BOR : 初版 V1.0 2019/7/15 左 忠 凯 创 建 

26 KCKCKCKCKCKCkCk Ck kCkCk Ck k Ck k Ck k Ck k Ck k kk kCkCkCk Ck kCkCk Ck k kc k Ck k Ck k kc k kc k Ck k k ck kc kckckckckck ck ok ck kk ke x ke f 
27 4define BEEP CNT it /* 设备 号 个 数 */ 
28 #define BEEP NAME "beep" [hs AT 7 
29 #define BEEPOFF 0 /* AMENS b 
30 4define BEEPON i /* JPWEIS dE y 
g 

32 


33 /* beep 设备 结构 体 */ 
5S4 ā erruct besp devi 


35 dev t devid; /* 设备 号 2 
36 struct cdev cdev; /* cdev "y 
3 struct class *class; Ja ES 9 
38 struct device *device;  /* 设备 aA 
39 int major; /* 主 设备 号 hu 
40 int minor; /* 次 设备 号 rA 
41 struct device node *nd; /* WA SET 
42 int beep gpio; /* beep 所 使 用 的 GPIO 编号 x 
$3. ng 

44 

45 erruct besp deyv beep; /* beep 设备 */ 

46 

ay ques 


48  * Qdescription : 打开 设备 
49  * Qparam - inode : 传递 给 驱动 的 inode 
50 * @param - filp : 设备 文件 file 结构 体 有 个 叫做 private data 的 成 员 变 量 





[5 NES 一 般 在 open 的 时 候 将 private data 指 疝 设备 结构 体 。 
52 * Q@return : 0 成 功 ; 其 他 失败 
53 ef 


sams eat int besp open lerctruct inode vinode, struct tile ELp) 
S507 


56 filp-»private data = &beep; /* 设置 私有 数据 */ 
i return 0; 

OMEN 

59 
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GO. y 


61 * Qdescription : 向 设备 写 数据 

62 * Qparam - filp : 设备 文件 ， 表 示 打 开 的 文件 描述 符 

OSEE Maa ame Vs : 要 写 给 设备 写 入 的 数据 

64 ama FENE : 要 写 入 的 数据 长 度 

65  * Q(param - offt : 相对 于 文件 首 地 址 的 偏 移 

66  * Qreturn : 写 入 的 字 节 数 ， 如 果 为 负 值 ， 表 示 写 入 失败 

oy. y 

GS statie gize t beep uwieiue(struct iile viilip, Const char  — User Agut, 


Gime © Gmt, loti t VOTT) 





























69 f 

70 int retvalue; 

qal unsigned char databuf[1]; 

qe unsigned char beepstat; 

T3 struct beep deyv “ev = itilp->privace date; 

74 

75 retvalue = copy iron User (datelu, Dut, CAT)? 

76 if(retvalue « 0) ( 

TO printk("kernel write failed!\r\n"); 

78 return -EFAULT; 

78 ) 

80 

81 beepstat = databuf[0]; /* 获取 状态 值 */ 
82 

83 if(beepstat == BEEPON) ( 

84 gpio set value(dev-»beep gpio, 0); /* 打开 蜂 鸣 器 */ 
85 ) else if(beepstat == BEEPOFF) ( 

86 gpio set value(dev-»beep gpio, 1); /* 关闭 蜂 鸭 器 */ 
87 } 

88 return 0; 

Som) 

90 

DIE ES 


92  * Qdescription  : 关闭 /释放 设备 

93  * QGparam - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 

gA REE EUEN : 0 成 功 ;其 他 失败 

DONE 

9G. tetic int beep ieleese(stiuct inode no siciwwei Tile virilis) 
SL 

98 return 0; 

DIONESY 

100 


101 /* 设备 操作 函数 */ 
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10/2. statie struct tile operations besp Tops = d 
TOS Towner = THATS EMODULE, 

104 .open -2 beep open, 

TOS .write S beep write, 

106 Seokeesee = beep release, 

3077 3e 

108 

TOOR 

110 * @description : 驱动 出 口 函数 

ii1 è parem 3 JE 

1102 = (resnen s JE 

WS UA 

se iar ^ imit bego imie (volc) 

335; | 

116 int ret = 0; 

TEE 


118 /* 设置 BEEP 所 使 用 的 GPIO */ 
119 /* 1、 获取 设备 节点 : beep */ 











120 beep.nd = of find node by path("/beep"); 

T21 if(beep.nd == NULL) { 

122 printk("beep node not find! Nrin"); 

1:278) return -EINVAL; 

W24 } else { 

125 printk ("beep node find!\r\n"); 

126 } 

127 qi 

128 /* 2. 获取 设备 树 中 的 gpio 属性 ， 得 到 BEEP 所 使 用 的 GPIO 编号 */ 
129 beep.beep gpio SS of get named gpio(beep.nd, "beep-gpio", 0); 
3S0) "(lead eee puo < U) 

3 SEIL printk("can't get beep-gpio"); 

1:552 return -EINVAL; 

T3 } 

134 joxesbenelie (^ Jed ono num = ehe wm" Deep. beep opio)? 

T35 

136 /* 3. WRA GPIO5_I001 为 输出 ， 并 且 输 出 高 电 平 ， 默 认 关 闭 BEEP */ 
1519] pet = golo Cirection output (besp-besp geio, NO EP 

138 aea ieee «s (0) 4 

139 elm ere eo lo Nai) P 

140 } 

141 


142 /* 注册 字符 设备 驱动 */ 
143 /* 1、 创 建设 备 号 */ 
144 if (beep.major) ( /* 定义 了 设备 号 */ 
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145 beep.devid = MKDEV(beep.major, 0); 

146 register chrdev region(beep.devid, BEEP CNT, BEEP NAME); 

147 ) else ( /* aane pea */ 

148 alloc chrdev region(&beep.devid, 0, BEEP CNT, BEEP NAME); 

149 beep.major = MAJOR(beep.devid); /* 获取 分 配 号 的 主 设备 号 */ 

150 beep.minor = MINOR(beep.devid); /* 获取 分 配 号 的 次 设备 号 */ 

151 } 

T52 printk ("beep major=%d,minor=%d\r\n",beep.major, beep.minor); 

153 

154 /* 2. YIRE cdev */ 

355) beep.cdev.owner - THIS MODULE; 

156 cdev init(&beep.cdev, &beep fops); 

S 

158 /* 3. cae 

15/9 cdev add(&beep.cdev, beep.devid, BEEP CNT); 

160 

161 /* 4、 创 建 类 */ 

162 beep.class - class create(THIS MODULE, BEEP NAME); 

163 sus (16 ERR (be6p- Class) d 

164 return PTR ERR(beep.class); 

1S5 } 

166 

167 /* 5、 创建 设备 */ 

168 beep.device = device create(beep.class, NULL, beep.devid, NULL, 
BEEP NAME); 

169 if (IS ERR(beep.device)) (t 

IO return PTR ERR(beep.device); 

1373 ) 

dE 

LS return 0; 

1395 

S 

WE qos 

177 * @description : IK3) H O K% 

178 * @param NES 

179 * Qreturn 3 Jb 

JN). 98 

leil gtetic vorc ^^ exit beep esl (vorc 

182.1 

183 /* 注销 字符 设备 驱动 */ 

184 cdev del(&beep.cdev); /* ”删除 cdev */ 

185 uUaregister chrdev reglon(beep-devid, BEEP CNT);  /* 注销 设备 号 */ 

186 
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187 deyice gGlesxow(esep.elsss, beep. devia); 

188 class destroy (beep.class); 

1/5/98) 

190 


IOL moule init (sep imit); 
192 module exit (besp exit); 
193 MODULE LICENSE ("GPL"); 
194 MODULE AUTHOR("zuozhongkai"); 
beep.c 中 的 内 容 和 上 一 章 的 gpioled.c 中 的 内 容 基 本 一 样 ， 只 是 换 为 了 初始 化 
SNVS TAMPERI 这 个 PIN， 这 里 就 不 详细 的 讲解 了 。 























46.3.3 编写 测试 APP 


测试 APP 在 上 一 章 实 验 的 ledApp.c 文件 的 基础 上 完成 ， 新 建 名 为 beepApp.c 的 文件 ， 然 后 
输入 如 下 所 示 内 容 : 











示例 代码 46.3.3.1 beepApp.c 文件 















































1 #include "stdio.h" 

2 sdinclude "unistd.h" 

3 #include "sys/types.h" 

4 d*$include "sys/stat.h" 

3 el el el 

6 $include "stdlib.h" 

we /ener ne cm 

B SKERA K K KICK KK KICK K K K E A K E KICK K K K A K K KICK K K E K K K KK K A K K AIRE GRO 
IMC OPCIONET TOA ETENTEKR TCO Medr oem 2020AN reserved 
10 文件 名 : beepApp.c 

11 fed : Al 

12 版 本 0 

13 描述 : beep 测试 APP。 

14 其 他 pU 

15 使 用 方法 : ./beepApp /dev/beep 0 关闭 蜂 鸣 器 

16 ./beepApp /dev/beep 1 打开 蜂 鸣 器 

TILES : www.openedv.com 

TORE : 初版 V1.0 2019/7/15 左 忠 凯 创建 

19 KCKCKCKCkCKCk kCkCk k kk k kk Ck kCk Ck k kk k kk k kk Ck k Ck Ck kCkCk k kk k kk Ck kc k Ck kck ck kck ck ckck ck ckckck sk ck kk f 
20 

21 #define BEEPOFF 0 

22 #define BEEPON 1 

25 

Qui ge 

25 * Qdescription : main 主 程序 

26 * Qparam - argo : argv MARIAL 

27 * Q8param - argv  : RH 

28 * Qreturn : 0 成 功 ;其 他 失败 
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DIO A 

3/0) süewE waste (bot aege, Cher tieuesw [D 
ST 

9? iwe elo Seele 

BS char *filename; 

34 unsigned char databuf[1]; 

B5 

36 if (argc !- 3)( 

2] prone (CU aererene Uses Ve wa) e 
38 return -1; 

39 } 

40 

41 filename = argv[1]; 

42 

43 /* 打开 beep 驱动 */ 

44 fd = open(filename, O RDWR); 
45 if(fd < 0){ 

46 站 人 二 
47 return -1; 

48 } 

49 


50 databuf[0] = atoi(argv[2]); /* 要 执行 的 操作 : 打开 或 关闭 */ 
51 











52 /* 向 /dev/beep 文件 写 入 数据 */ 

58 retvalue = write(fd, databuf, sizeof(databuf)); 
54 if(retvalue « O0)( 

55 printf("BEEP Control Failed!NrNin"); 

56 close (fd); 

D return -1]; 

58 ) 

EI 

60 retvalue = close(fd); /* 关闭 文件 */ 

61 if(retvalue « 0)( 

62 printf("file ss close failed!NrNn", argv[1]):; 
63 return -1; 

64 } 

65 return 0; 

o6 n 


beepApp.c 的 文件 内 容 和 ledApp.c 文件 内 容 基 本 一 样 ， 要 是 对 文件 进行 打开 、 写 、 关 闭 等 
操作 。 
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46.4 运行 测试 


46.4.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱 动 程序 

编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 beep.o，Makefile 内 容 如 下 所 示 : 
示例 代码 46.4.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 


























rel imz 4.1.15 2,150 ga alisntek 


4 obj-m := beep.o 














12 d -C $(KERNELDIR) M=$ (CURRENT PATH) clean 
第 4 行 ， 设置 obj-m 变量 的 值 为 beep.o。 

输入 如 下 命令 编译 出 驱动 模块 文件 : 

make -j32 

编译 成 功 以 后 就 会 生成 一 个 名 为 “beep.ko” 的 驱动 模块 文件 。 

2、 编 译 测试 APP 

输入 如 下 命令 编译 测试 beepApp.c 这 个 测试 程序 : 

arm-linux-gnueabihf-gcc beepApp.c -o beepApp 

编译 成 功 以 后 就 会 生成 beepA pp 这 个 应 用 程序 。 




















46.4.2 运行 测试 


将 上 一 小 节 编 译 出 来 的 beep.ko 和 beepApp 这 两 个 文件 拷贝 到 rootfs/lib/modules/4.1.15 H 
录 中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 加 载 beep.ko 驱动 模块 : 

depmod /第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 

modprobe beep.ko /加 载 驱 动 

驱动 加 载 成 功 以 后 会 在 终端 中 输出 一 些 信息 ， 如 图 46.4.2.1 所 示 : 


/lib/modules/4.1.15 # modprobe beep.ko 
beep node find! 

led-gpio num = 129 

beep majorz2249,minorzO 


图 46.4.2.1 驱动 加 载 成 功 以 后 输出 的 信息 

从 图 46.4.2.1 可 以 看 出 ,beep 这 个 节点 找到 了 ,并 且 GPIOS. 1001 这 个 GPIO 的 编号 为 129。 
使 用 beepApp 软件 来 测试 驱动 是 否 工作 正常 ， 输 入 如 下 命令 打开 蜂 鸣 器 : 

./beepApp (ER 1 /打开 蜂 鸣 器 

输入 上 述 命令 , 查看 IMX6U-ALPHA 开发 板 上 的 蜂 鸣 器 是 否 有 鸣叫 , 如 果 鸣 叫 的 话说 明 驱 
动工 作 正常 。 在 输入 如 下 命令 关闭 蜂 鸣 器 : 

JbeepApp /dev/beep 0 /关闭 蜂 鸣 器 
输入 上 述 命令 以 后 观察 LMX6U-ALPHA 开发 板 上 的 蜂 鸣 器 是 否 停止 鸣叫 。 如 果 要 钊 载 引 
动 的 话 输入 如 下 命令 即 可 : 
















































































*I 
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rmmod beep.ko 


第 四 十 七 章 Linux 并 发 与 竞争 


Linux 是 一 个 多 任务 操作 系统 ,肯定 会 存在 多 个 任务 共同 操作 同一 段 内 存 或 者 设备 的 情况 ， 
多 个 任务 甚至 中 断 都 能 访问 的 资源 叫做 共享 资源 ， 就 和 共享 单车 一 样 。 在 驱动 开发 中 要 注意 对 
共享 资源 的 保护 ， 也 就 是 要 处 理 对 共享 资源 的 并 发 访问 。 比 如 共享 单车 ， 大 家 按照 谁 扫 谁 骑 走 
的 原则 来 共用 这 个 单车 ， 如 果 没 有 这 个 并 发 访问 共享 单车 的 原则 存在 ， 只 怕 到 时 候 为 了 一 辆 单 
车 要 打 起 来 了 。 在 Linux 驱动 编写 过 程 中 对 于 并 发 控制 的 管理 非常 重要 ， 本 章 我 们 就 来 学 习 一 
下 如 何在 Linux 驱动 中 处 理 并 发 。 
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47.1 并 发 与 竞争 


1、 并 发 与 竞争 简介 


并 发 就 是 多 个 “用 户 ” 同 时 访问 同一 个 共享 资源 ， 比 如 你 们 公司 有 一 台 打印 机 ， 你 们 公司 
的 所 有 人 都 可 以 使 用 。 现 在 小 李 和 人 小 王 要 同时 使 用 这 一 台 打 印 机 ， 都 要 打印 一 份 文件 。 小 李 要 











打印 的 文件 内 容 如 下 : 
示例 代码 47.1.1 小 李 要 打印 的 内 容 
我 叫 小 李 
电话 : 123456 
I5: 16 
小 王 要 打印 的 内 容 如 下 : 
示例 代码 47.1.2 小 王 要 打印 的 内 容 
我 叫 小 王 
电话 : 678910 
T5: 20 

















这 两 份 文档 肯定 是 各 自打 印 出 来 的 ， 不 能 相互 影响 。 当 两 个 人 同时 打印 的 话 如 果 打 印 机 不 做 处 

















Lim 

















了 ， 可 能 会 出 现 如 下 的 错误 文档 内 容 : 
示例 代码 47.1.3 小 王 打 印 出 来 的 错误 文档 
我 叫 小 王 
电话 : 123456 
Lss 20 
可 以 看 出 ， 小 王 打 印 出 来 的 文档 









































的 话 可 能 会 出 现 小 李 的 文档 打印 了 一 行 ， 然 后 开始 打印 小 王 的 文档 ， 这 样 打印 出 来 的 文档 就 错乱 


电话 号 码 错 误 了 ， 变 成 小 李 的 了 ， 这 是 绝对 不 允许 的 。 如 


果 有 多 人 同时 向 打印 机 发 送 了 多 份 文档 ， 打 印 机 必须 保证 一 次 只 能 打印 一 份 文 档 ， 只 有 打印 完成 以 





后 才能 打印 其 他 的 文档 。 
Linux 系统 是 个 多 任务 操作 系统 ， 会 存在 多 个 任务 同时 访问 同一 片 内 存 区 域 











， 这 些 任务 可 




















DH | RE 














会 相互 覆盖 这 段 内 存 中 的 数据 ， 造 成 内 存 数 据 混乱 。 针 对 这 个 问题 必须 要 做 处 理 
能 会 导致 系统 月 演 。 现 在 的 Linux 系统 并 发 产生 的 原因 很 复杂 ， 总 结 一 下 有 下 面 几 个 主要 原 


(D、 多 线程 并 发 访问 ，Linux 是 多 任务 (线程 ) 的 系统 ， 所 以 多 线程 访问 是 最 基本 的 原因 。 





严重 的 话 

















凶 、 抢 占 式 并 发 访问 ， 从 2.6 版 本 内 核 开 始 ，Linux 内 核 支持 抢占 ， 也 就 是 说 调度 程序 可 以 


在 任意 时 刻 抢占 正在 运行 的 线程 ， 从 而 运行 其 他 的 线程 。 
@@、 中 断 程序 并 发 访问 ， 这 个 无 需 多 说 ,学 过 STM32 的 同学 应 该 知道 , 硬件 
是 很 大 的 。 











(、SMP( 多 核 ) 核 间 并 发 访问 ,现在 ARM 架构 的 多 核 SOC 很 常见 ， 多 核 CPU 存在 核 间 并 


发 访问 。 
并 发 访问 带 来 的 问题 就 是 竞争 , 学 过 FreeRTOS 和 UCOS 的 同学 应 该 知道 临界 





中 断 的 权利 可 





区 这 个 概念 ， 





所 谓 的 临界 区 就 是 共享 数据 段 ， 对 于 临界 区 必须 保证 一 次 只 有 一 个 线程 访问 ， 也 就 是 要 保证 临 




















界 区 是 原子 访问 的 ,注意 这 里 的 “原子 ”不 是 正点 原子 的 “原子 ”。 我 们 都 知道 ， 




















原子 化 学 反应 





不 可 再 分 的 基本 微粒 ， 这 里 的 原子 访问 就 表示 这 一 个 访问 是 一 个 步骤 ， 不 能 再 进行 拆 分 。 如 果 
多 个 线程 同时 操作 临界 区 就 表示 存在 竞争 ， 我 们 在 编写 驱动 的 时 候 一 定 要 注意 避免 并 发 和 防止 








EPH. RE Linux 驱动 初学 者 往往 不 注意 这 一 点 ， 在 驱动 程序 中 卖 下 了 隐患 ， 这 类 问题 往 
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往 又 很 不 容易 查找 ， 导 致 驱动 调试 难度 加 大 、 费 时 费力 。 所 以 我 们 一 般 在 编写 驱动 的 时 候 就 要 
考虑 到 并 发 与 竞争 ， 而 不 是 驱动 都 编写 完了 然后 再 处 理 并 发 与 竞争 。 


























2、 保 护 内 容 是 什么 











前 面 一 直 说 要 防止 并 发 访问 共享 资源 , 换 句 话说 就 是 要 保护 共享 资源 , 防止 进行 并 发 访问 。 
那么 问题 来 了 ， 什 么 是 共享 资源 ? 现实 生活 中 的 公共 电话 、 共 享 单车 这 些 是 共享 资源 ， 我 们 都 
很 容易 理解 , 那么 在 程序 中 什么 是 共享 资源 ? 也 就 是 保护 的 内 容 是 什么 ? 我 们 保护 的 不 是 代码 ， 
而 是 数据 ! 数据 ! 数据 ! 某 个 线程 的 局 部 变量 不 需要 保护 ， 我 们 要 保护 的 是 多 个 线程 都 会 访问 
































的 共享 数据 。 一 个 整形 的 全 局 变量 a 是 数据 ， 一 份 要 打印 的 文档 也 是 数据 ， 虽 然 我 们 知道 了 要 




















对 共享 数据 进行 保护 ， 那 么 怎么 判断 哪些 共享 数据 要 保护 呢 ? 
这 个 也 是 难点 














~ 


























找到 要 保护 的 数据 才 是 重点 ， 而 





因为 驱动 程序 各 不 相同 ， 那 么 数据 也 千变万化 ， 一 般 像 全 局 变量 ， 设 备 机 构 体 











这 些 肯 定 是 要 保护 的 ， 至 于 其 他 的 数据 就 要 根据 实际 的 驱动 程序 而 定 了 。 











当 我 们 发 现 驱动 程序 中 存在 并 发 和 竞争 的 时 候 一 定 要 处 下 
Linux 内 核 提供 的 几 种 并 发 和 竞争 的 处 理 方法 。 


47.2 原子 操作 


47.2.1 原子 操作 简介 
首先 看 一 下 原子 操作 ， 原 子 操作 就 是 指 不 能 在 进一步 分 惫 
或 者 位 操作 。 假 如 现在 要 对 无 符号 整形 变量 a 赋值 ， 值 为 3， 
是 : 

a=3 









































E 掉 ， 接 下 来 我 们 依次 来 学 习 一 下 











上 的 指令 ， 一 般 原子 操作 用 于 变量 
对 于 C 语言 来 讲 很 简单 ， 直 接 就 








但 是 C 语言 要 先 编译 为 成 汇编 指令 ，ARM 架构 不 支持 直接 对 寄存 器 进行 读 写 操作 ， 比 如 



































要 借助 寄存 器 RO. RI 等 来 完成 赋值 操作 。 假 设 变 量 a 的 地 址 为 0X3000000,“a=3” 这 一 行 C 














语言 可 能 会 被 编译 为 如 下 所 示 的 汇编 代码 : 

















示例 代码 47.2.1.1 汇编 示例 代码 


1 ldr r0, =0X30000000 /* 变量 a 地 址 * 
2 ldr rl, 2 5 /* 要 写 入 的 值 * 
3 acr rl, [z0] /* 将 5 写 入 到 a 变量 中 $ 





/ 
/ 
/ 


示例 代码 47.2.1.1 只 是 一 个 简单 的 距离 说 明 ， 实 际 的 结果 要 比 示 例 代码 复杂 的 多 。 从 上 述 














代码 可 以 看 出 ，C 语言 里 面 简 简 单单 的 一 句 “a=3” 编译 成 汇编 文件 以 后 变 成 了 3 句 ， 那 么 程 
































序 在 执行 的 时 候 肯 定 是 按照 示例 代码 47.2.1.1 中 的 汇编 语句 





条 一 条 的 执行 。 假 设 现在 线程 A 








要 向 a 变量 写 入 10 这 个 值 ， 而 线程 B 也 要 向 a 变量 写 入 20 这 个 值 ， 我 们 理想 中 的 执行 顺序 如 








图 47.2.1.1 所 示 : 
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线程 A 线程 B 
ipie 


Ieke seil Eo I0 cm d 


= 
S 
oo 
一 一 


图 47.2.1.1 理想 的 执行 流程 
按照 图 47.2.1.1 所 示 的 流程 ， 确 实 可 以 实现 线程 A 将 a 变量 设置 为 10， 线 程 B 将 a 变量 设 
置 为 20。 但 是 实际 上 的 执行 流程 可 能 如 图 47.2.1.2 所 示 : 
线程 A 线程 B 
———— 


Juohe 3edb, E3 0 ldr r0, 20X30000000 


IE Tarer £3 220) 
sea ella fed PEE E. 


ee 

图 47.2.1.2 可 能 的 执行 流程 

按照 图 47.2.1.2 所 示 的 流程 ， 线 程 A 最 终 将 变量 a 设置 为 了 20， 而 并 不 是 要 求 的 10! 线程 

B 没有 问题 。 这 就 是 一 个 最 简单 的 设置 变量 值 的 并 发 与 竞争 的 例子 ， 要 解决 这 个 问题 就 要 保证 

示例 代码 47.2.1.1 中 的 三 行 汇编 指令 作为 一 个 整体 运行 , 也 就 是 作为 一 个 原子 存在 。Linux WE 

提供 了 一 组 原子 操作 API 函数 来 完成 此 功能 ，Linux 内 核 提 供 了 两 组 原子 操作 API 函数 ， 一 组 
是 对 整形 变量 进行 操作 的 ， 一 组 是 对 位 进行 操作 的 ， 我 们 接 下 来 看 一 下 这 些 API KA. 





























































































































47.2.2 原子 整形 操作 API 函数 


Linux 内 核定 义 了 叫做 atomic t 的 结构 体 来 完成 整形 数据 的 原子 操作 ， 在 使 用 中 用 原子 变 
量 来 代替 整形 变量 ， 此 结构 体 定义 在 include/linux/types.h 文件 中 ， 定 义 如 下 : 
示例 代码 47.2.2.1 atomic, t 结构 体 


























175 typedef struct ( 
IG int counter; 
LII p enomme ©? 
如 果 要 使 用 原子 操作 API 函数 ， 首 先 要 先 定 义 一 个 atomic t 的 变量 ， 如 下 所 示 : 
atomic t a; /定义 a 
也 可 以 在 定义 原子 变量 的 时 候 给 原子 变量 赋 初 值 ， 如 下 所 示 : 
atomic tb = ATOMIC INIT(0); /定义 原子 变量 b 并 赋 初 值 为 0 
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可 以 通过 宏 ATOMIC. INIT 向 原子 变量 赋 初 值 。 








原子 变量 有 了 ， 接 下 来 就 是 对 原子 变量 进行 操作 ， 比 如 读 、 写 、 增 加 、 减 少 等 等 ，Linux 内 
核 提 供 了 大 量 的 原子 操作 API 函数 ， 如 表 47.2.2.1 所 示 ; 










































































ATOMIC INIT(int i) 定义 原子 变量 的 时 候 对 其 初始 化 。 
int atomic read(atomic t *v) 读 取 v 的 值 ， 并 且 返 回 。 
void atomic set(atomic t *v, int i) IH] v 5A i fe 
void atomic add(int i, atomic t *v) 给 v 加 上 i 值 。 
void atomic sub(int i, atomic t *v) 从 v 减 去 i 值 。 
void atomic inc(atomic t *v) 给 v 加 1， 也 就 是 自 增 。 
void atomic dec(atomic t *v) 从 v 减 1， 也 就 是 自 减 
intatomic dec return(atomic t *v) 从 v 减 1， 并 且 返 回 v 的 值 。 
int atomic_inc_return(atomic_t *v) 给 v 加 1， 并 且 返 回 v 的 值 。 
intatomic sub and test(inti atomic t*v) | M v Ji, 如 果 结 果 为 0 就 返回 真 ， 否 则 返回 假 
intatomic dec and test(atomic t *v) 从 v 减 1， 如 果 结 果 为 0 就 返回 真 ， 否 则 返回 假 
intatomic inc and test(atomic t *v) 给 v 加 1， 如 果 结 果 为 0 就 返回 真 ， 否 则 返回 假 
intatomic add negative(inti, atomic t*v) | 给 v 加 i， 如 果 结 果 为 负 就 返回 真 ， 否 则 返回 假 
表 47.2.2.1 原子 整形 操作 API 函数 表 
如 果 使 用 64 位 的 SOC 的 话 ， 就 要 用 到 64 位 的 原子 变量 ，Linux 内 核 也 定义 了 64 位 原子 























结构 体 ， 如 下 所 示 : 
示例 代码 47.2.2.2 atomic64. t 结构 体 

typedef struct { 

long long counter; 
D atomics T? 

相应 的 也 提供 了 64 位 原子 变量 的 操作 API 函数 ， 这 里 我 们 就 不 详细 讲解 了 ， 和 表 47.2.1.1 
中 的 API 函数 有 用 法 一 样 ， 只 是 将 “atomic ”前缀 换 为 “atomic64 ”， 将 int 3&7J long long。 如 
果 使 用 的 是 64 位 的 SOC， 那 么 就 要 使 用 64 位 的 原子 操作 函数 。Cortex-A7 是 32 位 的 架构 ， 所 
以 本 书 中 只 使 用 表 47.2.2.1 中 的 32 位 原子 操作 函数 。 原子 变量 和 相应 的 API 函数 使 用 起 来 很 简 
单 ， 参 考 如 下 示例 : 












































示例 代码 47.2.2.2 原子 变量 和 API 函数 使 用 
atomic t v = ATOMIC INIT(0); /* 定义 并 初始 化 原子 变 零 v=0 */ 


atomic set(10); /* WE v-10 */ 
atomic read(&v); /* HU v 的 值 ， 肯 定 是 10 wy 
atomic inc(&v); /* v PME T. w= */ 


47.2.3 原子 位 操作 API 函数 


位 操作 也 是 很 常用 的 操作 ，Linux 内 核 也 提供 了 一 系列 的 原子 位 操作 API 函数 ， 只 不 过 原 
子 位 操作 不 像 原 子 整形 变量 那样 有 个 atomic t 的 数据 结构 , 原子 位 操作 是 直接 对 内 存 进 行 操 作 ， 
API 函数 如 表 47.2.3.1 所 示 : 




















void set bit(int nr, void *p) 将 p 地 址 的 第 nr 位 置 1。 
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void clear bit(int nr,void *p) 将 p 地 址 的 第 nr 位 清 零 。 
void change bit(int nr, void *p) 将 p 地 址 的 第 nr 位 进行 翻转 。 
int test. bit(int nr, void *p) 获取 p 地 址 的 第 nr 位 的 值 。 
inttest and set bit(int nr, void *p) 将 p 地 址 的 第 nr bz EL 1,. Jf Ha [el nr 位 原来 的 值 。 
inttest and clear bit(int nr, void *p) 将 p 地 址 的 第 nr 位 清 零 ， 并 且 返 回 nr 位 原来 的 值 。 
inttest and change bit(intnr, void *p) | 将 p 地 址 的 第 nr 位 翻转 ， 并 且 返 回 nr 位 原来 的 值 。 





























表 47.2.3.1 原子 位 操作 函数 表 
47.3 自 旋 锁 


47.3.1 自 旋 锁 简 介 


原子 操作 只 能 对 整形 变量 或 者 位 进行 保护 ， 但 是 ， 在 实际 的 使 用 环境 中 怎么 可 能 只 有 整形 
变量 或 位 这 么 简单 的 临界 区 。 举 个 最 简单 的 例子 ， 设 备 结构 体 变量 就 不 是 整 型 变量 ， 我 们 对 于 
结构 体 中 成 员 变 量 的 操作 也 要 保证 原子 性 ， 在 线程 A 对 结构 体 变 量 使 用 期 间 ， 应 该 禁止 其 他 的 
线程 来 访问 此 结构 体 变量 ， 这 些 工 作 原子 操作 都 不 能 胜任 ， 需 要 本 节 要 讲 的 锁 机 制 ， 在 Linux 
内 核 中 就 是 自 旋 锁 。 

当 一 个 线程 要 访问 某 个 共享 资源 的 时 候 首 先 要 先 获 取 相 应 的 锁 ， 锁 只 能 被 一 个 线程 持 有 ， 
只 要 此 线程 不 释放 持 有 的 锁 ， 那 么 其 他 的 线程 就 不 能 获取 此 锁 。 对 于 自 旋 锁 而 言 ， 如 果 自 旋 锁 
正在 被 线程 A 持 有 ， 线 程 B 想 要 获取 自 旋 锁 ， 那 么 线程 B 就 会 处 于 忙 循环 -旋转 -等 待 状态 ， 线 
f£ B 不 会 进入 休眠 状态 或 者 说 去 做 其 他 的 处 理 ， 而 是 会 一 直 傻 傻 的 在 那里 “转圈 圈 ” 的 等 待 锁 
可 用 。 比 如 现在 有 个 公用 电话 亭 ， 一 次 肯定 只 能 进去 一 个 人 打 电 话 ， 现 在 电话 亭 里 面 有 人 正在 
打 电 话 ， 相 当 于 获得 了 自 旋 锁 。 此 时 你 到 了 电话 亭 门 口 ， 因 为 里 面 有 人 ， 所 以 你 不 能 进去 打 电 
话 ， 相 当 于 没有 获取 自 旋 锁 ， 这 个 时 候 你 肯定 是 站 在 原 地 等 待 ， 你 可 能 因为 无 聊 的 等 待 而 转圈 
圈 消 遣 时 光 ， 反 正 就 是 那里 也 不 能 去 ， 要 一 直 等 到 里 面 的 人 打 完 电话 出 来 。 终 于 ， 里 面 的 人 打 
完 电 话 出 来 了 ， 相 当 于 释放 了 自 旋 锁 ， 这 个 时 候 你 就 可 以 使 用 电话 亭 打 电话 了 ， 相 当 于 获取 到 
Y Egi. 
自 旋 锁 的 “自选 ”也 就 是 “ 原 地 打转 ”的 意思 ,“ 原 地 打转 ”的 目的 是 为 了 等 待 自 旋 锁 可 以 
用 ， 可 以 访问 共享 资源 。 把 自 旋 锁 比 作 一 个 变量 a， 变 量 a=1 的 时 候 表示 共享 资源 可 用 ， 当 a=0 
的 时 候 表 示 共 享 资源 不 可 用 。 现 在 线程 A 要 访问 共享 资源 , 发 现 a=0( 自 旋 锁 被 其 他 线程 持 有 )， 
那么 线程 A 就 会 不 断 的 查询 a 的 值 ， 直 到 a=1。 从 这 里 我 们 可 以 看 到 自 旋 锁 的 一 个 缺点 : 那 就 
等 待 自 旋 锁 的 线程 会 一 直 处 于 自选 状态 ， 这 样 会 浪费 处 理 器 时 间 ， 降 低 系统 性 能 ， 所 以 自 旋 锁 
的 持 有 时 间 不 能 太 长 。 所 以 自 旋 锁 适用 于 短 时 期 的 轻 量 级 加 锁 ， 如 果 遇 到 需要 长 时 间 持 有 锁 的 
场景 那 就 需要 换 其 他 的 方法 了 ， 这 个 我 们 后 面 会 讲解 。 

Linux 内 核 使 用 结构 体 spinlock t 表示 自选 锁 ， 结 构 体 定义 如 下 所 示 : 
示例 代码 47.3.1.1 spinlock t 结构 体 
64 typedef struct spinlock ( 
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65 union ( 
66 SErUCE .Es Ee le 
67 


68 #ifdef CONFIG DEBUG LOCK ALLOC 

69 4$ define LOCK PADSIZE (offsetof(struct raw spinlock, dep map)) 
70 [SjigieIeE xi 
ptt u8 | padding[LOCK PADSIZE]; 
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T struct lockdep map dep map; 

73 }; 

74 #endif 

75 }; 


07$ OCR t? 

在 使 用 自 旋 锁 之 前 ， 肯 定 要 先 定义 一 个 自 旋 锁 变量 ， 定 义 方法 如 下 所 示 : 
spinlock t lock; /定义 自 旋 锁 

定义 好 自 旋 锁 变量 以 后 就 可 以 使 用 相应 的 API 函数 来 操作 自 旋 锁 。 

















47.3.2 Ej Jie i APT 函数 
最 基本 的 自 旋 锁 API 函数 如 表 47.3.2.1 所 示 : 


DEFINE SPINLOCK(spinlock tlock) | 定义 并 初始 化 一 个 自选 变量 。 














int spin lock init(spinlock t *lock) 初始 化 自 旋 锁 。 

void spin lock(spinlock t *lock) 获取 指定 的 自 旋 锁 ， 也 叫做 加 锁 。 

void spin unlock(spinlock t *lock) 释放 指定 的 自 旋 锁 。 

int spin trylock(spinlock t *lock) 尝试 获取 指定 的 自 旋 锁 ， 如 果 没 有 获取 到 就 返回 0 











检查 指定 的 自 旋 锁 是 否 被 获取 ， 如 果 没 有 被 获取 就 
返回 非 0， 否 则 返回 0。 
表 47.3.2.1 自 旋 锁 基本 API 函数 表 

表 47.3.2.1 中 的 自 旋 锁 API 函 数 适用 于 SMP 或 支持 抢占 的 单 CPU 下 线程 之 间 的 并 发 访问 ， 
也 就 是 用 于 线程 与 线程 之 间 ， 被 自 旋 锁 保护 的 临界 区 一 定 不 能 调用 任何 能 够 引起 睡眠 和 阻塞 的 
API 函数 ， 和 否则 的 话 会 可 能 会 导致 死 锁 现象 的 发 生 。 自 旋 锁 会 自动 禁止 抢占 ， 也 就 说 当 线 程 A 
得 到 锁 以 后 会 暂时 禁止 内 核 抢 占 。 如 果 线 程 A 在 持 有 锁 期 间 进 入 了 休眠 状态 , 那么 线程 A 会 自 
动 放弃 CPU 使 用 权 。 线 程 B 开始 运行 ， 线 程 B 也 想 要 获取 锁 ， 但 是 此 时 锁 被 A 线程 持 有 ， 而 
且 内 核 抢 占 还 被 禁止 了 ! 线程 B 无 法 被 调度 出 去 ， 那 么 线程 A 就 无 法 运行 ， 锁 也 就 无 法 释放 ， 
好 了 ， 死 锁 发 生 了 ! 

K 47.3.2.1 中 的 API 函数 用 于 线程 之 间 的 并 发 访问 ， 如 果 此 时 中 断 也 要 插 一 脚 ， 中 断 也 想 
访问 共享 资源 ， 那 该 怎么 办 呢 ? 首 先 可 以 肯定 的 是 ， 中 断 里 面 使 用 自 旋 锁 ， 但 是 在 中 断 里 面 使 
用 自 旋 锁 的 时 候 ， 在 获取 锁 之 前 一 定 要 先 禁止 本 地 中 断 ( 也 就 是 本 CPU HP, SET E SOC 来 
说 会 有 多 个 CPU 核 )， 否 则 可 能 导致 锁 死 现象 的 发 生 ， 如 图 47.3.2.1 所 示 : 


int spin is locked(spinlock t *lock) 

















































































































线程 A 


spin, lock (&1ock) 


中 断 


spin lock (&lock) 


functionB() 


被 中 断 打 断 


spin unlock (&lock) spin, unlock (&lock) 


图 47.3.2.1 中 断 打 断 线程 
在 图 47.3.2.1 F, ZIE A 先 运 行 ， 并 且 获 取 到 了 lock 这 个 锁 ， 当 线程 A 运行 functionA FÉ 
数 的 时 候 中 断 发 生 了 ， 中 断 抢 走 了 CPU 使 用 权 。 右 边 的 中 断 服 务 函 数 也 要 获取 lock 这 个 锁 ， 
但 是 这 个 锁 被 线程 A 占有 着 ， 中 断 就 会 一 直 自 选 ， 等 待 锁 有 效 。 但 是 在 中 断 服务 函数 执行 完 之 
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void spin lock irq(spinlock t *lock) 


论坛 :www.opendev.com 

前 , 线程 A 是 不 可 能 执行 的 , 线程 A 说 “你 先 放 手 ” 中 断 说 “你 先 放 手 ” Mali A Bc, 

死 锁 发 生 ! 
最 好 的 解决 方法 就 是 获取 锁 之 前 关闭 本 地 中 断 ，Linux 内 核 提 供 了 相应 的 API 函数 ， 如 表 

47.3.2.2 所 示 : 


禁止 本 地 中 断 ， 并 获取 自 旋 锁 。 





void spin unlock irq(spinlock t *lock) 





激活 本 地 中 断 ， 并 释放 自 旋 锁 。 





void spin lock irqsave(spinlock t *lock, 
unsigned long flags) 


保存 中 断 状 态 ， 禁 止 本 地 中 断 ， 并 获取 自 旋 锁 。 





void spin unlock irqrestore(spinlock t 





*]ock, unsigned long flags) 





将 中 断 状 态 恢 复 到 以 前 的 状态 ， 并 且 激 活 本 地 中 断 ， 
释放 自 旋 锁 。 








表 47.3.2.2 线程 与 中 断 并 发 访问 处 理 API 函数 


使 用 spin lock irq/spin_unlock irq 的 时 候 需 要 月 
上 内 核 很 庞大 ， 运行 也 是 “千变万化 ”， 我 们 是 很 难 确定 某 个 时 刻 的 中 断 状 态 ， 因 此 不 推荐 使 用 





























户 能 够 确定 加 锁 之 前 的 中 断 状态 ， 但 实际 





spin lock irq/spin_ unlock irq。 建 议 使 用 spin lock irqsave/spin unlock irqrestore， 因 为 这 一 组 函 

数 会 保存 中 断 状态 ， 在 释放 锁 的 时 候 会 恢复 中 断 状 态 。 一 般 在 线程 中 使 用 spin lock irqsave/ 

spin unlock irqrestore， 在 中 断 中 使 用 spin_lock/spin_unlock， 示 例 代 码 如 下 所 示 : 
示例 代码 47.3.2.1 自 旋 锁 使 用 示例 






































1 DEFINE SPINLOCK (lock) /* 定义 并 初始 化 一 个 锁 7 
2 

3 /* SEA */ 

4 void functionA ()( 

5 unsigned long flags; /* 中 断 状态 A 
6 spin lock irqsave(&lock, flags) /* 获取 锁 K 
7 /* RAK */ 

8 spin unlock irqrestore(&lock, flags)  /* 释放 锁 */ 
9 l 

10 

11 /* RERS RR */ 

Pivord mir 

IS spin lock(&lock) /* 获取 锁 my 
14 /* 临界 区 */ 

15 spin unlock(&lock) /* 释放 锁 iA 
TETY 





下 半 部 (BH) 也 会 竞争 共享 资源 ， 有 些 资料 也 会 将 下 半 部 叫做 底 半 部 。 关 于 下 半 部 后 面 的 
章节 会 讲解 ， 如 果 要 在 下 半 部 里 面 使 用 自 旋 锁 ， 可 以 使 用 表 47.3.2.3 中 的 API 函数 : 




















void spin lock bh(spinlock t *lock) 











void spin unlock bh(spinlock t *lock) 





关闭 下 半 部 ， 并 获取 自 旋 锁 。 
打开 下 半 部 ， 并 释放 自 旋 锁 。 











表 47.3.2.3 下 半 部 竞争 处 理 函 数 
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47.3.3 其 他 类 型 的 锁 


在 自 旋 锁 的 基础 上 还 衍生 出 了 其 他 特定 场合 使 用 的 锁 ， 这 些 锁 在 驱动 中 其 实用 的 不 多 ， 更 
多 的 是 在 Linux 内 核 中 使 用 ， 本 节 我 们 简单 来 了 解 一 下 这 些 衍 生出 来 的 锁 。 

1、 读 写 自 旋 锁 

现在 有 个 学 生 信息 表 ， 此 表 存 放 着 学 生 的 年 龄 、 家 庭 住址 、 班 级 等 信息 ， 此 表 可 以 随时 被 
修改 和 读 取 。 此 表 肯 定 是 数据 ， 那 么 必须 要 对 其 进行 保护 ， 如 果 我 们 现在 使 用 自 旋 锁 对 其 进行 
保护 。 每 次 只 能 一 个 读 操 作 或 者 写 操 作 ， 但 是 ， 实 际 上 此 表 是 可 以 并 发 读 取 的 。 只 需要 保证 在 
修改 此 表 的 时 候 没 人 读 取 ， 或 者 在 其 他 人 读 取 此 表 的 时 候 没 有 人 修改 此 表 就 行 了 。 也 就 是 此 表 
的 读 和 写 不 能 同时 进行 ， 但 是 可 以 多 人 并 发 的 读 取 此 表 。 像 这 样 ， 当 某 个 数据 结构 符合 读 / 写 或 
生产 者 /消费 者 模型 的 时 候 就 可 以 使 用 读 写 自 旋 锁 。 

读 写 自 旋 锁 为 读 和 写 操作 提供 了 不 同 的 锁 ， 一 次 只 能 允许 一 个 写 操作 ， 也 就 是 只 能 一 个 线 
程 持 有 写 锁 ， 而 且 不 能 进行 读 操 作 。 但 是 当 没 有 写 操作 的 时 候 允 许 一 个 或 多 个 线程 持 有 读 锁 ， 
可 以 进行 并 发 的 读 操 作 。Linux 内 核 使 用 rwlock t 结构 体 表示 读 写 锁 ， 结 构 体 定义 如 下 (删除 了 
条 件 编译 ): 































































































示例 代码 47.3.3.1 rwlock_t 结构 体 
typedef struct ( 
arch rwlock t raw lock; 
p ewlt tp 
读 写 锁 操 作 API 函数 分 为 两 部 分 ， 一 个 是 给 读 使 用 的 ， 一 个 是 给 写 使 用 的 ， 这 些 API 函数 
如 表 47.3.3.1 所 示 : 

















DEFINE RWLOCK(rwlock t lock) 定义 并 初始 化 读 写 锁 

void rwlock init(rwlock t *lock) 初始 化 读 写 锁 。 

void read lock(rwlock t *lock) 获取 读 锁 。 

void read unlock(rwlock t *lock) 释放 读 锁 。 

void read lock irq(rwlock t *lock) 禁止 本 地 中 断 ， 并 且 获 取 读 锁 。 
void read unlock irq(rwlock t *lock) 打开 本 地 中 断 ， 并 且 释 放 读 锁 。 








void read lock irqsave(rwlock t *lock, 


保存 中 断 状态 ， 禁 止 本 地 中 断 ， 并 获取 读 锁 。 
unsigned long flags) 


void read unlock irqrestore(rwlock t *lock, 将 中 断 状态 恢复 到 以 前 的 状态 , 并 且 激 活 本 地 
unsigned long flags) | 中 断 ， 释 放 读 锁 。 


























void read lock bh(rwlock t *lock) 关闭 下 半 部 ， 并 获取 读 锁 。 
void read unlock bh(rwlock t *lock) 打开 下 半 部 ， 并 释放 读 锁 。 
void write lock(rwlock t *lock) 获取 读 锁 。 

void write unlock(rwlock t *lock) 释放 读 锁 。 

void write lock irq(rwlock t *lock) 禁止 本 地 中 断 ， 并 且 获 取 读 锁 。 
void write unlock irq(rwlock t *lock) 打开 本 地 中 断 ， 并 且 释 放 读 锁 。 








void write lock irqsave(rwlock t *lock, 


保存 中 断 状 态 ， 禁 止 本 地 中 断 ， 并 获取 读 锁 。 











unsigned long flags) 
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void write unlock irqrestore(rwlock t*lock, | 将 中 断 状 态 恢复 到 以 前 的 状态 , 并 且 激 活 本 地 
unsigned long flags) | 中 断 ， 释 放 读 锁 。 











void write lock bh(rwlock t *lock) 关闭 下 半 部 ， 并 获取 读 锁 。 
void write unlock bh(rwlock t *lock) 打开 下 半 部 ， 并 释放 读 锁 。 














表 47.3.3.1 读 写 锁 API 函数 
2、 顺 序 锁 
顺序 锁 在 读 写 锁 的 基础 上 衍生 而 来 的 ， 使 用 读 写 锁 的 时 候 读 操 作 和 写 操作 不 能 同时 进行 。 
使 用 顺序 锁 的 话 可 以 允许 在 写 的 时 候 进 行 读 操作 ， 也 就 是 实现 同时 读 写 ， 但 是 不 允许 同时 进行 
并 发 的 写 操作 。 虽 然 顺 序 锁 的 读 和 写 操 作 可 以 同时 进行 ,但 是 如 果 在 读 的 过 程 中 发 生 了 写 操作 ， 
最 好 重新 进行 读 取 ， 保 证 数据 完整 性 。 顺 序 锁 保 护 的 资源 不 能 是 指针 ， 因 为 如 果 在 写 操 作 的 时 
候 可 能 会 导致 指针 无 效 ， 而 这 个 时 候 恰 巧 有 读 操 作 访问 指针 的 话 就 可 能 导致 意外 发 生 ， 比 如 读 
取 时 指针 导致 系统 骨 演 。Linux 内 核 使 用 seglock t 结构 体 表 示 顺 序 锁 ， 结 构 体 定义 如 下 : 
示例 代码 47.3.3.2 seglock. t 结构 体 





















































typedef struct ( 
SELUCE SeGeieOUuE Sesion ? 
spinlock t loecky 

p eeglogk t? 
关于 顺序 锁 的 API 函数 如 表 47.3.32 所 示 : 


























DEFINE SEQLOCK(seqlock t sl) 定义 并 初始 化 顺序 锁 

void seglock ini seglock t *sl) 初始 化 顺序 锁 。 

void write seglock(seglock t *sl) 获取 写 顺序 锁 。 

void write sequnlock(seglock t *sl) 释放 写 顺 序 锁 。 

void write seglock irq(seglock t *sl) 禁止 本 地 中 断 ， 并 且 获 取 写 顺序 锁 

void write sequnlock irq(seglock t *sl) 打开 本 地 中 断 ， 并 且 释 放 写 顺序 锁 。 

void write seglock irqsave(seglock t *sl, 保存 中 断 状态 ， 禁 止 本 地 中 断 ， 并 获取 写 顺 序 
unsigned long flags) 锁 。 





void write sequnlock irqrestore(seglock t*sl, | 将 中 断 状 态 恢复 到 以 前 的 状态 , 并 且 激 活 本 地 
unsigned long flags) 中 断 ， 释 放 写 顺序 锁 。 























void write seglock bh(seglock t *sl) 关闭 下 半 部 ， 并 获取 写 读 锁 。 
void write sequnlock bh(seglock t *sl) 打开 下 半 部 ， 并 释放 写 读 锁 。 


读 单 元 访问 共享 资源 的 时 候 调 用 此 函数 , EG PRI 
数 会 返回 顺序 锁 的 顺序 号 。 
unsigned read seqretry(const seglock t *sl, 读 结 束 以 后 调用 此 函数 检查 在 读 的 过 程 中 有 
unsigned start) 没有 对 资源 进行 写 操作 , 如 果 有 的 话 就 要 重读 
表 47.3.3.2 顺序 锁 API 函数 表 





unsigned read seqbegin(const seglock t *sl) 





























47.3.4. 自 旋 锁 使 用 注意 事项 
综合 前 面 关 于 自 旋 锁 的 信息 ， 我 们 需要 在 使 用 自 旋 锁 的 时 候 要 注意 一 下 几 点 : 
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中 、 因 为 在 等 待 自 旋 锁 的 时 候 处 于 “ 自 旋 ”状态 ， 因 此 锁 的 持 有 时 间 不 能 太 长 ， 一 定 要 











短 ， 和 否则 的 话 会 降低 系统 性 能 。 如 果 临 界 区 比较 大 ， 运 行 时 间 比 较 长 的 话 要 选择 其 他 的 并 发 处 
理 方式 ， 比 如 稍 后 要 讲 的 信号 量 和 互 斥 体 。 

包 、 自 旋 锁 保护 的 临界 区 内 不 能 调用 任何 可 能 导致 线程 休眠 的 API 函数 ， 否 则 的 话 可 能 
导致 死 锁 。 

(9、 不 能 递归 申请 自 旋 锁 ， 因 为 一 旦 通过 递归 的 方式 申请 一 个 你 正在 持 有 的 锁 ， 那 么 你 就 
必须 “ 自 旋 ”， 等 待 锁 被 释放 ， 然 而 你 正 处 于 “ 自 旋 ”状态 ， 根 本 没 法 释放 锁 。 结 果 就 是 自己 
把 自己 锁 死 了 ! 

二、 在 编写 驱动 程序 的 时 候 我 们 必须 考虑 到 驱动 的 可 移植 性 ， 因 此 不 管 你 用 的 是 单 核 的 还 
是 多 核 的 SOC， 都 将 其 当做 多 核 SOC 来 编写 驱动 程序 。 


47.4 信号 量 
47.4.1 信号 量 简 介 


大 家 如 果 有 学 习 过 FreeRTOS 或 者 UCOS 的 话 就 应 该 对 信和 号 量 很 熟悉 ， 因 为 信号 量 是 同步 
的 一 种 方式 。Linux 内 核 也 提供 了 信号 量 机 制 ,信号 量 常常 用 于 控制 对 共享 资源 的 访问 。 举 一 个 
很 常见 的 例子 ， 某 个 停车 场 有 100 个 停车 位 ， 这 100 个 停车 位 大 家 都 可 以 用 ， 对 于 大 家 来 说 这 
100 个 停车 位 就 是 共享 资源 。 假 设 现 在 这 个 停车 场 正常 运行 ， 你 要 把 车 停 到 这 个 这 个 停车 场 肯 
定 要 先 看 一 下 现在 停 了 多 少 车 了 ? 还 有 没有 停车 位 ? 当前 停车 数量 就 是 一 个 信号 量 ， 具 体 的 停 
车 数量 就 是 这 个 信号 量 值 ， 当 这 个 值 到 100 的 时 候 说 明 停 车 场 满 了 。 停 车 场 满 的 时 你 可 以 等 一 
会 看 看 有 没有 其 他 的 车 开 出 停车 场 ， 当 有 车 开 出 停车 场 的 时 候 停车 数量 就 会 减 一 ， 也 就 是 说 信 
号 量 减 一 ， 此 时 你 就 可 以 把 车 停 进 去 了 ， 你 把 车 停 进去 以 后 停车 数量 就 会 加 一 ， 也 就 是 信号 量 
加 一 。 这 就 是 一 个 典型 的 使 用 信号 量 进行 共享 资源 管理 的 案例 ， 在 这 个 案例 中 使 用 的 就 是 计数 
型 信号 量 。 

相 比 于 自 旋 锁 ， 信 和 号 量 可 以 使 线程 进入 休眠 状态， 比如 A 与 B、C 合租 了 一 套房 子 ， 这 个 
房子 只 有 一 个 厕所 ， 一 次 只 能 一 个 人 使 用 。 某 一 天 早上 A 去 上 厕所 了 ， 过 了 一 会 B 也 想 用 而 
所 ， 因 为 A 在 厕所 里 面 ， 所 以 B 只 能 等 到 A 用 来 了 才能 进去 。B 要 么 就 一 直 在 厕所 门口 等 着 ， 
等 A 出 来 ， 这 个 时 候 就 相当 于 自 旋 锁 。B 也 可 以 告诉 A， 让 A 出 来 以 后 通知 他 一 下 ,然后 B 继 
续 回 房间 睡觉 ， 这 个 时 候 相 当 于 信号 量 。 可 以 看 出 ， 使 用 信号 量 会 提高 处 理 器 的 使 用 效率 ， 毕 
况 不 用 一 直 傻 平平 的 在 那里 “自选 ”等 待 。 但 是 ， 信 号 量 的 开销 要 比 自 旋 锁 大 ， 因 为 信号 量 使 
线程 进入 休眠 状态 以 后 会 切换 线程 ， 切 换 线程 就 会 有 开销 。 总 结 一 下 信和 号 量 的 特点 : 

Q、 因 为 信号 量 可 以 使 等 待 资源 线程 进入 休眠 状态 ， 因 此 适用 于 那些 占用 资源 比较 久 的 场 
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包 、 因 此 信号 量 不 能 用 于 中 断 中 ， 因 为 信号 量 会 引起 休眠 ， 中 断 不 能 休眠 。 
昌 、 如 果 共 享 资源 的 持 有 时 间 比 较 短 ， 那 就 不 适合 使 用 信号 量 了 ， 因 为 频繁 的 休眠 、 切 换 
线程 引起 的 开销 要 远大 于 信号 量 带 来 的 那 点 优势 。 

信号 量 有 一 个 信号 量 值 ， 相 当 于 一 个 房子 有 10 把 钥匙 ， 这 10 把 钥匙 就 相当 于 信号 量 值 为 
10。 因 此 ， 可 以 通过 信号 量 来 控制 访问 共享 资源 的 访问 数量 ， 如 果 要 想 进 房间 ， 那 就 要 先 获取 
把 钥匙 ， 信 号 量 值 减 1， 直到 10 把 钥匙 都 被 拿 走 ， 信 号 量 值 为 0， 这 个 时 候 就 不 允许 任何 人 
进入 房间 了 ， 因 为 没 钥匙 了 。 如 果 有 人 从 房间 出 来 ， 那 他 要 归还 他 所 持 有 的 那 把 钥 是 ， 信 号 量 
值 加 1， 此 时 有 » 把 钥匙 了 ， 那 么 可 以 允许 进去 一 个 人 。 相 当 于 通过 信号 量 控 制 访问 资源 的 线 
程 数 ， 在 初始 化 的 时 候 将 信号 量 值 设置 的 大 于 1， 那 么 这 个 信号 量 就 是 计数 型 信号 量 ， 计 数 型 
信号 量 不 能 用 于 互 斥 访问 ， 因 为 它 允 许多 个 线程 同时 访问 共享 资源 。 如 果 要 互 斥 的 访问 共享 资 
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源 那 么 信号 量 的 值 就 不 能 大 于 1， 此 时 的 信号 量 就 是 一 个 二 值 信 号 量 。 








47.4.2 信号 量 API 函数 


Linux 内 核 使 用 semaphore 结构 体 表 示 信 和 号 量 ， 结 构 体 内 容 如 下 所 示 : 
示例 代码 47.4.2.1 semaphote 结构 体 











struct semaphore { 


raw spinlock t ek, 
unsigned int count; 
otruct list neac wait listy 


要 想 使 用 信号 量 就 得 先 定义 ， 然 后 初始 化 信号 量 。 有 关 信 和 号 量 的 API 函数 如 表 47.4.2.1 所 








ZN: 
DEFINE SEAMPHORE(name) 定义 一 个 信号 量 ， 并 且 设 置信 号 量 的 值 为 1。 





E sem, KAIA SEEN val. 
获取 因为 会 导致 休眠 ， 因 此 不 能 在 中 


void sema init(struct semaphore *sem, int val) | 初始 化 信和 号 














void down(struct semaphore *sem) 

















Wrrp 

尝试 获取 信号 量 ， 如 果 能 获取 到 信号 量 就 获 
int down trylock(struct semaphore *sem); 取 ， 并 且 返 回 0。 如 果 不 能 就 返回 非 0， 并 且 

不 会 进入 休眠。 











获取 信号 量 , 和 down 类 似 , 只 是 使 用 down XE 
int down_interruptible(struct semaphore *sem) | 入 休眠 状态 的 线程 不 能 被 信号 打 断 。 而 使 用 此 
函数 进入 休眠 以 后 是 可 以 被 信号 打 断 的 。 
void up(struct semaphore *sem) 释放 信号 量 

X 47.4.2.1 信号 量 API 函数 


























信号 量 的 使 用 如 下 所 示 : 
示例 代码 47.4.2.2 信号 量 使 用 示例 

struct semaphore sem; /* 定义 信号 量 in 

sema init(&sem, 1); /* 初始 化 信号 量 */ 

down (&sem) ; /* 申请 信号 量 2 

/* 临界 区 */ 

up (&sem) ; /* 释放 信号 量 20 

47.5 互 斥 体 

47.5.1 互 斥 体 简介 


在 FreeRTOS 和 UCOS 中 也 有 互 斥 体 ， 将 信号 量 的 值 设置 为 1 就 可 以 使 用 信号 量 进行 互 斥 
访问 了 ， 虽 然 可 以 通过 信号 量 实 现 互 斥 ， 但 是 Linux 提供 了 一 个 比 信号 量 更 专业 的 机 制 来 进行 
互 太 ， 它 就 是 互 斥 体 一 mutex。 互 斥 访问 表示 一 次 只 有 一 个 线程 可 以 访问 共享 资源 ， 不 能 递归 申 
请 互 斥 体 。 在 我 们 编写 Linux 驱动 的 时 候 遇 到 需要 互 斥 访问 的 地 方 建议 使 用 mutex。Linux 内 核 
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struct mutex ( 


/* 1: unlocked, 0: locked, negative: 
atomie & count; 
spinlock t wait lock; 








QD. mutex 可 以 导致 休眠 ， 


论坛 :Www.opendev.com 
使 用 mutex 结构 体 表示 互 斥 体 ， 定 义 如 下 (省 略 条 件 编译 部 分 ): 
示例 代码 47.5.1.1 mutex 结构 体 





locked, possible waiters */ 





在 使 用 mutex 之 前 要 先 定 义 一 个 mutes 变量 。 在 使 用 mutex 的 时 候 要 注意 如 下 几 点 : 
因此 不 能 在 中 断 中 使 用 mutex， 中 断 中 只 能 使 用 自 旋 锁 。 




















D, MAs, mutex 
O, 
H mutex 不 能 递归 上 锁 和 解锁 。 








47.5.2 互 斥 体 API 函数 
有 关 互 斥 体 的 API 函数 如 表 47.5.2.1 所 示 : 





保护 的 临界 区 可 以 调用 引起 阻塞 的 API 函数 。 
因为 一 次 只 有 一 个 线程 可 以 持 有 mutex， 因 此 ， 必 须 由 mutex 的 持 有 者 释放 mutex。 并 








DEFINE MUTEX(name) 


定义 并 初始 化 一 个 mutex 变量 。 








void mutex init(mutex *lock) 


初始 化 mutex.» 





void mutex lock(struct mutex *lock) 





获取 mutex， 也 就 是 给 mutex 上 锁 。 如 果 获 
取 不 到 就 进 休眠 。 








void mutex unlock(struct mutex *lock) 


释放 mutex， 也 就 给 mutex 解锁 。 








int mutex trylock(struct mutex *lock) 


尝试 获取 mutex， 如 果 成 功 就 返回 1， 如果 失 
败 就 返回 0。 








int mutex is locked(struct mutex *lock) 


判断 mutex 是 否 被 获取 ， 如 果 是 的 话 就 返回 
1， 否 则 返回 0。 








int mutex lock interruptible(struct mutex *lock) 











使 用 此 函数 获取 信和 号 量 失败 进入 休眠 以 
以 被 信号 打 断 。 


可 


ul 











表 47.52.1 互 斥 体 API 函数 








互 斥 体 的 使 用 如 下 所 示 : 
示例 代码 47.5.2.1 互 斥 体 使 用 示例 

1 struct mutex lock; /* EX —^7 BJRME ud 

2 mutex init(&lock); /* 初始 化 互 斥 体 8 

S 

4 mutex lock(&lock); /* 上 锁 e 

5 /* IRAE */ 

6 mutex unlock(&lock) /* 解锁 Sy 





关于 Linux 中 的 并 发 和 竞争 就 讲解 到 这 里 ，Linux 内 核 还 有 很 多 其 他 的 处 理 并 发 和 竞争 的 





机 制 ， 本 章 我 们 主要 讲解 了 常用 的 原子 操作 、 自 旋 锁 、 




















言 号 量 和 互 斥 体 。 以 后 我 们 在 编写 Linux 


驱动 的 时 候 就 会 频繁 的 使 用 到 这 几 种 机 制 ， 希 望 大 家 能 够 深入 理解 这 几 个 常用 的 机 制 。 
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第 四 十 八 章 Linux 并 发 与 竞争 实验 


在 上 一 章 中 我 们 学 习 了 Linux 下 的 并 发 与 竞争 ， 并 且 学 习 了 四 种 常用 的 处 理 并 发 和 竞争 的 
机 制 :原子 操作 、 自 旋 锁 、 信 号 量 和 互 斥 体 。 本 章 我 们 就 通过 四 个 实验 来 学 习 如 何在 驱动 中 使 
用 这 四 种 机 制 。 
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48.1 原子 操作 实验 
本 实验 对 应 的 例 程 路 径 为 ， 开发 板 光盘 -> 2、Linux 驱动 例 程 -> 7 atomic. 


论坛 :www.opendev.com 









































本 例 程 我 们 在 第 四 十 五 章 的 gpioled.c 文件 基础 上 完成 。 在 本 节 使 用 中 我 们 使 用 原子 操作 来 
实现 对 LED 这 个 设备 的 互 斥 访问 ， 也 就 是 一 次 只 允许 一 个 应 用 程序 可 以 使 用 LED AT 


48.1.1 实验 程序 编写 


1、 修 改 设备 树 文件 
因为 本 章 实验 是 在 第 四 十 五 章 实 验 的 基础 上 完成 的 ， 因 此 不 需要 对 设备 树 做 任何 的 修改 。 


2. LED 驱动 修改 











本 节 实 验 在 第 四 十 五 章 实验 驱动 文件 gpioled.c 的 基础 上 修改 而 来 。 新 建 名 为 “7_atomic” 
的 文件 夹 ,然后 在 7_atomic 文件 夹 里 面 创建 vscode 工程 , 工作 区 命名 为 “atomic”。 将 5 gpioled 





实验 中 的 gpioled.c 复制 到 7 atomic 文件 夹 中 ， 并 且 重 命名 为 atomic.c。 本 节 实 验 重 点 就 是 使 用 




















atomic 来 实现 一 次 只 能 允许 一 个 应 用 访问 LED， 所 以 我 们 只 需要 在 atomic.c 文件 源码 的 基础 上 
加 上 添加 atomic 相关 代码 即 可 ， 完 成 以 后 的 atomic.c 文件 内 容 如 下 所 示 : 


fincl 
fincl 
fincl 
fincl 
#incl 
#incl 


#incl 


CON ES ON CN CG S E 


#incl 


tO 


#incl 


E 
(e 


#incl 


Er 
j= 


#incl 


m 
N 


#incl 


[en 
Ww 


#incl 


p 
心 


#incl 


E 
[91] 


dincl 


m 
OY 


#incl 


|Bm| 
co -1 


文件 名 
作者 
版 本 
i 述 
其 他 
论坛 


日 志 


NO N BS 
[— O 10 








N 
N 











Y O VS 
Oo) G 4 C 














de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 





示例 代码 48.1.1.1 atomic.c 文件 代码 段 
<linux/types.h> 
<linux/kernel.h> 
<linux/delay.h> 
«linux/ide.h» 
«linux/init.h» 
<linux/module.h> 
<linux/errno.h> 
«linux/gpio.h» 
«linux/cdev.h» 








«linux/device.h» 
«linux/of.h» 
«linux/of address.h» 
«linux/of gpio.h» 
«asm/mach/map.h» 
X«asm/uaccess.h» 


«asm/io.h» 


/大 大 大 大 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 火炎 炎炎 大 火炎 大 大 大 大大 大 大 炎炎 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 





Copyright O6 ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 


: atomic.c 


e 左 忠 凯 

g Wis 

: 原子 操作 实验 ， 使 用 原子 变量 来 实现 对 实现 设备 的 互 斥 访问 
STE 


: wwwW.Oopenedv.com 


: 初版 V1.0 2019/7/18 左 忠 凯 创建 


大 类 火炎 大 大火 类 大 类 火炎 大 类 火炎 大 炎炎 类 大 类 类 类 大 类 类 类 大 类 类 类 大 类 大大 大 类 类 大 大 类 类 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 大 类/ 
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27 #define GPIOLED CNT 1 /* 设备 号 个 数量 */ 

28 4define GPIOLED NAME "gpioled" /* 4 s 

29 define LEDOFF 0 Ma DT ira 

30 4define LEDON 1 /* ARNT x 

Bal 


32 /* gpioled 设备 结构 体 */ 
DESEE cevi 





34 dev_t devid; /* 设备 号 5 
25 struct eolew edev? /* cdev on 
36 Su Clase velass; /* 3& xy 
Sh) struct device *device; /* 设备 d 
38 ioe major? /* 主 设备 号 27 
39 iar minore /* 次 设备 号 DÀ 
40 struct device node *nd; /* WA B nu 
sal int led goio; /* led 所 使 用 的 GPIO 编号 uu 
42 atomic t lock; /* 原子 变量 Sy 
3 

44 

45 struct gpioled dev gpioled; / led ita a 
46 

ay qne 

48  * Qdescription  : 打开 设备 


49  * Qparam - inode : 传递 给 驱动 的 inode 
50 * QGparam - filp : 设备 文件 ， file 结构 体 有 个 叫做 private data 的 成 员 变 量 





it 


51 x 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
局 2 : 0 成 功 ;其 他 失败 
5S e 


5 å ratie int led gpen(struct inode vinode, struct iile wiilp) 
Sg 
56 /* 通过 判断 原子 变量 的 值 来 检查 LED 有 没有 被 别 的 应 用 使 用 / 

















57 if (l'atomic dec and test(&gpioled.lock)) ( 

58 atomic inc(&gpioled.lock);/* 小 于 0 的 话 就 加 1 使 其 原子 变量 等 于 0 */ 
59 return -EBUSY; /* LED 被 使 用 ， 返 回 忙 */ 

60 } 

cil 

62 filp-»private data = &gpioled; /* 设置 私有 数据 */ 

63 return 0; 

64 } 

65 

em fS 


67  * Qdescription : 从 设备 读 取 数据 
68 * @param - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 
69 * @param - buf  : 返回 给 用 户 空间 的 数据 缓冲 区 
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70 ** (Sieegeemn — (cu : 要 读 取 的 数据 长 度 

71  * Qparam - offt : 相对 于 文件 首 地 址 的 偏 移 

72  * Qreturn : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 

DRE 

72 SEatle size t led reac (struct iile siilj, Char VvSer Aout, 
Size E Cnt, lui E VOLTE) 


TORI 

76 return 0; 
zy 5 

78 

TE pe 


80  * QGdescription : 向 设备 写 数 据 

81 * Qparam - filp : 设备 文件 ， 表 示 打 开 的 文件 描述 符 

82  * @param - buf  : 要 写 给 设备 写 入 的 数据 

83  * Qparam - ent  : X€'SAQSUEKE 

84  * Q(param - offt : 相对 于 文件 首 地 址 的 偏 移 

85  * Qreturn : 写 入 的 字 节 数 ， 如 果 为 负 值 ， 表 示 写 入 失败 

9G wf 

97 starie size t lec wite(suruct Tile viilp, conski Char Vser out, 
Size č Cmt, lori 1E vorrt)) 














88 { 

89 int retvalue; 

90 unsigned char databuf[1]; 

S unsigned char ledstat; 

92 struct goioled dev vev = fll->~orivate Qeta? 

9E 

94 retvalue = copy from user(databuf, buf, cnt); 

95 if(retvalue « 0) ( 

96 printk("kernel write failed!NrWXn"); 

97 return -EFAULT; 

98 ) 

99 

100 ledstat eu /* 获取 状态 值  */ 
TON! 

102 if(ledstat == LEDON) ( 

103 gpia set value(dev->led guo, 0); /* a LEDAT */ 
104 ) else if(ledstat == LEDOFF) ( 

105 gpio set value(dev-»led gpio, 1);  /* XH|LEDAT */ 
106 ) 

TOF return 0; 

108 ] 

109 

(0 
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111 * @description  : 关闭 /释放 设备 

112 * Qparam - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 

SITES SEM molem : 0 成 功 ;其 他 失败 

A E 

iS statie inct led releaselstructi Imnoce vinode, struct Tile wila) 
LLG d] 





IL struct gololed dey “ev = tilp->privarcs cate, 
118 

119 /* 关闭 驱动 文件 的 时 候 释 放 原 子 变 量 */ 

120 atomic inc(&dev->lock); 

JE return 0; 

2229 

39255) 


124 /* 设备 操作 函数 */ 


125 statie gtruct tile Gperetions Gololed tops = d 





126 .owner = THIS MODULE, 

LAN .open = led open, 

128 oead acce 

129 owrite = 二 人 write, 

130 sueledgscex-uiccdEmeltesser 
JH: Mg 

192 

NSS e 

134 * @description : IK3) H O K% 
135 * @paran B JE 

136 * Qreturn 2 JE 

ST 
EGG 
JUST) N 

140 int ret = 0; 

141 


142 /* 初始 化 原子 变量 */ 
143 atomic set(&gpioled.lock, 1);  /* 原子 变量 初始 值 为 1 */ 
144 


145 /* 设置 LED 所 使 用 的 GPIO */ 








146 VI B: gpioled */ 

147 gpioled.nd = of find node by path("/gpioled"); 
148 if(gpioled.nd == NULL) ( 

149 printk("gpioled node not find!NrMn"); 

150 return -EINVAL; 

dl ) else ( 

T52 printk("gpioled node find!Nrin"); 

153 } 
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154 

155 /* 2. 获取 设备 树 中 的 gpio 属性 ， 得 到 LED 所 使 用 的 LED 编号 */ 

3l 5j gpioled.led gpio = of get named gpio(gpioled.nd, "led-gpio", 0); 
TS: if(gpioled.led gpio < 0) ( 

158 printk("can't get led-gpio"); 

1855/9 return -EINVAL; 

160 } 

161 printk("led-gpio num = sd\rin", gpioled. led gpio); 

162 

163 /* 3. WA GPIOl 1003 为 输出 ， 并 且 输 出 高 电 平 ， 默 认 关 闭 LED */ 
164 ret = golo cirection OUESUEUOSLOLE led epo, 1»5 

165 ela (Geene. <0) Jl 

166 eramtlk (ean te: set regonton Ne wan) E 

167 } 

168 


169 /* 注册 字符 设备 驱动 */ 
170 /* 1、 创 建设 备 号 */ 




































































LaL if (gpioled.major) { /* 定义 了 设备 号 */ 

JE 712 gpioled.devid = MKDEV(gpioled.major, 0); 

13 register chrdev region(gpioled.devid, GPIOLED CNT, 
GPIOLED NAME); 

174 ) else ( /* We S */ 

JE Hs; alloc chrdev region(&gpioled.devid, 0, GPIOLED CNT, 
GPIOLED NAME); /* 申请 设备 号 */ 

176 gpioled.major = MAJOR(gpioled.devid);/* 获取 分 配 号 的 主 设备 号 */ 

Ia gpioled.minor = MINOR(gpioled.devid);/* 获取 分 配 号 的 次 设备 号 */ 

1S } 

179 printk("gpioled major=%d,minor=%d\r\n",gpioled.major, 

gpioled.minor); 

180 

121 /* 2、 初 始 化 cdev */ 

182 gpioled.cdev.owner - THIS MODULE; 

183 cdev init(&gpioled.cdev, &gpioled fops); 

184 

185 /* 3. Mh NN cdev */ 

186 cdev add(&gpioled.cdev, gpioled.devid, GPIOLED CNT); 

eT 

188 /* 4、 创 建 类 */ 

MESES] gpioled.class = class create(THIS MODULE, GPIOLED NAME); 

190 if (IS ERR(gpioled.class)) d 

ISO NIE return PTR ERR(gpioled.class); 

192 } 


19 
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194 /* 5. 创建 设备 */ 

1.95 gpioled.device - device create(gpioled.class, NULL, 
gpioled.devid, NULL, GPIOLED NAME); 

196 if (IS ERR(gpioled.device)) ( 

T97. return PTR ERR(gpioled.device); 

198 } 

1199) 

200 return 0; 

200 

202 

QUOS) uf 

204 * Qdescription : JkzJ reu 

205 * Gparam B Zi 

206 * Greturn 3 JE 

207. wy 

20/8 a voici —— exit led ext (voici) 

209 ( 

210 /* 注销 字符 设备 驱动 */ 

al cdev del(&gpioled.cdev);/* 删除 cdev */ 

A unregister chrdev region(gpioled.devid, GPIOLED CNT); 

DIIS 

214 device destroy(gpioled.class, gpioled.devid); 

25 Elass destroy (gpololed elass) 7 

AE 

2/187, 


21/8 module init (lec! imit); 
219 module exire (lec! exit) 
220 MODULE LICENSE ("GPL"); 
221 MODULE AUTHOR ("zuozhongkai"); 























第 42 行 ， 原 子 变 量 lock， 用 来 实现 一 次 只 能 允许 一 个 应 用 访问 LED KT, led init 驱动 入 口 


函数 会 将 lock 的 值 设置 为 1。 








第 57~60 4T. 每 次 调用 open 函数 打开 驱动 设备 的 时 候 先 申请 lock, 如 果 申 请 成 功 的 话 就 表 


























示 LED 灯 还 没有 被 其 他 的 应 用 使 用 ,如 果 申 请 失败 就 表示 LED 灯 正 在 被 其 他 的 应 ) 





程序 使 用 。 

















每 次 打开 驱动 设备 的 时 候 先 使 用 atomic. dec and test 函数 将 lock 减 1, 如 果 atomic dec and test 
























































K Bu Imp E 








变 为 0。 








数 返 回 值 为 真 就 表示 lock 当前 值 为 0， 说 明 设 备 可 以 使 用 。 如 果 atomic dec and test 函数 返 
值 为 假 ， 就 表示 lock 当前 值 为 负数 (lock 值 默 认 是 1), lock 值 为 负数 的 可 能 性 只 有 一 个 ， 那 就 
其 他 设备 正在 使 用 LED。 其 他 设备 正在 使 用 LED 灯 ， 那 么 就 只 能 退出 了 ， 在 退 
数 atomic inc 将 lock 加 1， 因 为 此 时 lock 的 值 被 减 成 了 负数 ， 必 须要 对 其 加 1， 将 lock 的 值 


出 之 前 调用 





第 120 fT, LED 灯 使 用 完毕 , 应 用 程序 调用 close 函数 关闭 的 驱动 文件 ，led_release 函数 执 





行 ， 调 用 atomic_inc 释放 lcok， 也 就 是 将 lock 加 1。 

















第 143 行 ， 初 始 化 原子 变量 lock， 和 初始 值 设置 为 1， 这 样 每 次 就 只 允许 一 个 应 用 使 用 LED 





灯 。 
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3、 编 写 测试 APP 


新 建 名 为 atomicApp.c 的 测试 APP， 在 里 面 输 入 如 下 所 示 内 容 : 
示例 代码 48.1.1.2 atomicApp.c 文件 代码 












































1 #include "stdio.h" 

2 4include "unistd.h" 

3 #include "sys/types.h" 

4 d$include "sys/stat.h" 

S te el "iex m 

6 $include "stdlib.h" 

T aeva Menee IN a 

3 /*kkkkkkkkkkkkěkkkkkkkkkkkkěkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk* 
5) ekeyswneakewane (Or LE Ce Imole 1L9909—20)9 O JMILIL seskedsE! reserved. 
10 文件 名 : atomicApp.c 

11 fEXe : Ael 

12 版 本 3 VIO 

13 描述 : 原子 变量 测试 APP， 测 试 原子 变量 能 不 能 实现 一 次 
dd 只 人 允许 一 个 应 用 程序 使 用 LED. 

15 其 他 : 5 

16 使 用 方法 : ./atomicApp /dev/gpioled 0 关闭 IED 灯 
i7 ./atomicApp /dev/gpioled 1 1[Jf LED AJ 
18 i&dx : www.openedv.com 

19 Hx : 初版 V1.0 2019/1/30 左 忠 凯 创建 

2 0 KC kc kk kk ek kk ek kk ke Re KK e KK ke KICK Re KC de KK ok KK KK d KK R KO Kok / 
2 

22 #define LEDOFF 

23 $define LEDON i 

24 

25 f 

26 * Qdescription : main 主 程序 

27 * Qparam - arge : argv ACHICAR MAL 

28 * @param - argv :具体 参数 

20) o (Bree : 0 成 功 ;其 他 失败 

307 

31 int main(int argc, char *argv[]l) 

DT 

E int fd, retvalue; 

34 char *filename; 

D unsigned char cnt = 0; 

36 unsigned char databuf[1]; 

B 

38 if(argc !- 3)( 

39 primet (0 En on Usage NENS) 

40 return -1; 
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41 } 

42 

43 filename = argv[!]; 

44 

45 /* 打开 beep 驱动 */ 

46 fd 2 open(filename, O RDWR); 

47] if(fd « O)( 

48 printf("file ss open failed!NrWin", argv[1]); 
49 return -1|; 

50 } 

Sal 

52 databuf[0] = atoi(argv[2]); /* 要 执行 的 操作 : 打开 或 关闭 */ 
58 

54 /* 向 /dev/gpioled 文件 写 入 数据 */ 

55 retvalue = write(fd, databuf, sizeof (databuf)); 
56 if(retvalue < 0){ 

57 prame (QUAITISIB) le Wie wie p 

58 elose (ie z 

59 return lp 

60 j 

61 

62 /* 模拟 占用 25S LED */ 

63 while(1) ( 

64 sleep(5); 

65 enttt; 

66 printf("App running times:%d\r\n", cnt); 

67 if (cnt >= 5) break; 

68 } 

69 

70 printf("App running finished!"); 

qal retvalue = close(fd); /* 关闭 文件 */ 

72 if(retvalue « 0){ 

T printf("file $s close failed!NrNn", argv[1]): 
74 return -i|; 

75 } 

76 return 0; 

VAS 








atomicApp.c 中 的 内 容 就 是 在 第 四 十 五 章 的 ledAPPc 的 基础 上 修改 而 来 的 ， 重 点 是 加 入 了 





第 63~68 行 的 模拟 占用 25 秒 LED 的 代码 。 测 试 APP 在 获取 到 LED 灯 驱 动 的 使 月 








日 权 以 后 会 使 


用 25S$， 在 使 用 的 这 段 时 间 如 果 有 其 他 的 应 用 也 去 获取 LED. 灯 使 用 权 的 话 肯定 会 失败 ! 





48.1.2 运行 测试 


1、 编 译 驱动 程序 
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编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 atomic.o，Makefile 内 容 如 下 所 示 : 
示例 代码 48.1.2.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
Tel ims 4515159 25.1.0 ga alientelk 

















4 obj-m := atomic.o 
He leam: 
12 $(MAKE) -C $(KERNELDIR) M=$ (CURRENT_PATH) clean 

















第 4 行 ， 设 置 obj-m 变量 的 值 为 atomic.o。 

输入 如 下 命令 编译 出 驱动 模块 文件 : 

make -j32 

编译 成 功 以 后 就 会 生成 一 个 名 为 “atomic.ko” 的 驱动 模块 文件 。 
、 编 译 测试 APP 

输入 如 下 命令 编译 测试 atomicApp.c 这 个 测试 程序 : 


arm-linux-gnueabihf-gcc atomicApp.c -o MEE 
编译 成 功 以 后 就 会 生成 atomicA pp 这 个 应 用 程序 。 

3、 运 行 测试 

将 上 一 小 节 编 译 出 来 的 atomic.ko 和 atomicApp 这 两 个 文件 拷贝 到 rootfs/lib/modules/4.1.15 
目录 中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 加 载 atomic.ko 驱动 模 
块 : 

depmod /第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 

modprobe atomic.ko /加 载 驱动 

驱动 加 载 成 功 以 后 就 可 以 使 用 atomicApp 软件 来 测试 驱动 是 否 工作 正常 ， 输 入 如 下 命令 以 
后 台 运 行 模式 打开 LED 灯 ,“ 人 此” 表示 在 后 台 运 行 atomicApp 这 个 软件 : 

/atomicApp /dev/gpioled 1& /打开 LED 4T 

输入 上 述 命令 以 后 观察 开发 板 上 的 红色 LED 灯 是 否 点 亮 ,然后 每 隔 5 秒 都 会 输出 一 行 “App 
running t times ”， 如 图 48.1.2.1 所 示 : 


"iib /modules/4. 1.15 £ 

/lib/modules/4.1.15 £ ./atomicApp /dev/gpioled 1& 
/lib/modules/4.1.15 # App running times:1 

App running times:2 





N 



































WS 





















































图 48.1.2.1 打开 LED 4T 

从 图 48.1.2.1 可 以 看 出 , atomicApp 运行 正常 , 输出 了 “App running times:1 " fil ^ App running 
times:2”， 这 就 是 模拟 25S 占用 ， 说 明 atomicApp 这 个 软件 正在 使 用 LED 灯 。 此 时 再 输入 如 下 
命令 关闭 LED 4T: 














.atomicApp  /dev/gpioled 0 /关闭 LED 灯 
输入 上 述 命令 以 后 会 发 现 如 图 48.1.2.2 所 示 输 入 信息 : 


/lib/modules/4.1.15 # ./atomicApp /dev/gpioled 0 
file /dev/gpioled open failed! 
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图 48.1.2.2 关闭 LED 灯 
从 图 48.1.2.2 可 以 看 出 ， 打 开 /dev/gpioled 失败 ! 原因 是 在 图 48.1.2.1 中 运行 的 atomicAPP 





























软件 正在 占用 /dev/gpioled， 如 果 再 次 运行 atomicApp 软件 去 操作 /dev/gpioled 肯定 会 失败 。 必 须 
等 待 图 48.1.2.1 中 的 atomicApp 运行 结 束 ,也 就 是 25S 结束 以 后 其 他 软件 才能 去 操作 /dev/gpioled。 
这 个 就 是 采用 原子 变量 实现 一 次 只 能 有 一 个 应 用 程序 访问 LED 灯 。 

如 果 要 和 卯 载 驱 动 的 话 输入 如 下 命令 即 可 : 


rmmod atomic.ko 


48.2 自 旋 锁 实验 


上 一 节 我 们 使 用 原子 变量 实现 了 一 次 只 能 有 一 个 应 用 程序 访问 LED 灯 , 本 节 我 们 使 用 自 旋 
锁 来 实现 此 功能 。 在 使 用 自 旋 锁 之 前 ， 先 回顾 一 下 自 旋 锁 的 使 用 注意 事项 : 

QD、 自 旋 锁 保护 的 临界 区 要 尽 可 能 的 短 , 因此 在 open 函数 中 申请 自 旋 锁 , 然后 在 release K 
数 中 释放 自 旋 锁 的 方法 就 不 可 取 。 我 们 可 以 使 用 一 个 变量 来 表示 设备 的 使 用 情况 ， 如 果 设 备 被 
使 用 了 那么 变量 就 加 一 ， 设 备 被 释放 以 后 变量 就 减 1， 我 们 只 需要 使 用 自 旋 锁 保护 这 个 变量 即 
可 。 

包 、 考 虑 驱动 的 兼容 性 ， 合 理 的 选择 API 函数 。 

综 上 所 述 , 在 本 节 例 程 中 , 我 们 通过 定义 一 个 变量 dev stats 表示 设备 的 使 用 情况 , dev_stats 
为 0 的 时 候 表示 设备 没有 被 使 用 ，dev_stats 大 于 0 的 时 候 表 示 设 备 被 使 用 。 驱 动 open 函数 中 先 
判断 dev_stats 是 否 为 0, 也 就 是 判断 设备 是 否 可 用 , 如 果 为 0 的 话 就 使 用 设备 , 并 且 将 dev stats 
加 1， 表 示 设 备 被 使 用 了 。 使 用 完 以 后 在 release 函数 中 将 dev stats 减 1， 表 示 设 备 没 有 被 使 用 
了 。 因 此 真正 实现 设备 互 斥 访问 的 是 变量 dev_stats， 但 是 我 们 要 使 用 自 旋 锁 对 dev. stats 来 做 保 
护 。 





























































































































































































































































































































48.2.1 实验 程序 编写 


1、 修 改 设备 树 文件 
本 章 实验 是 在 上 一 节 实 验 的 基础 上 完成 的 ， 同 样 不 需要 对 设备 树 做 任何 的 修改 。 
2. LED 驱动 修改 


本 节 实 验 在 第 上 一 节 实 验 驱动 文件 atomic.c 的 基础 上 修改 而 来 。 新 建 名 为 “8_spinlock” 的 
文件 夹 , 然后 在 8_spinlock 文件 夹 里 面 创建 vscode 工程 , 工作 区 命名 为 “spinlock”。 将 7. atomic 
实验 中 的 atomic.c 复制 到 8_spinlock 文件 夹 中 ,并 且 重 命名 为 spinlock.c。 将 原来 使 用 atomic 的 
地 方 换 为 spinlock 即 可 ， 其 他 代码 不 需要 修改 ， 完 成 以 后 的 spinlock.c 文件 内 容 如 下 所 示 ( 有 省 












































c— 












































示例 代码 48.2.1.1 spinlock.c 文件 代码 
1  £include <linux/types.h> 
2  d$include Xlinux/kernel.h» 
3  £$include «linux/delay.h» 
4  $include Xlinux/ide.h» 
5  $include Xlinux/init.h» 


TE /大 大 大 大 炎炎 大火 炎 大 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 大火 大 大 大 火炎 炎炎 火炎 大 大 火炎 大 大 大 大 大 大 大大 大大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 
18 Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
19 文件 名 TO 
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20 ME : 左 忠 凯 

21 版 本 e VLO 

22 描述 : 自 旋 锁 实验 ， 使 用 自 旋 锁 来 实现 对 实现 设备 的 互 斥 访问 

23 其 他 TE 

DAE UOS : www.openedv.com 

25 BS : 初版 V1.0 2019/7/18 左 忠 凯 创 建 

26 Kk ck ckckckckckckckckck ck kckk ck kc kk kk kk kk kck ckckckck ckck ck ck ck ck ck ck ckck ck ck ck ck ck ck ckck ck ck ckck ck ck kck kk kk f 
27 4define GPIOLED CNT 1 /* WS */ 

28 4define GPIOLED NAME "gpioled" /* 4 ct 

29 4define LEDOFF 0 M= RIT d 

30 #define LEDON 1 M AT a 

3 

312 


33 /* gpioled 设备 结构 体 */ 
3S4 erruct gguelee! cevi 





B5 dev t devid; /* 设备 号 rA 
36 struct eolew colew /* cdev n 
33 gecuct Class velass; [ame uni 
38 struct device *device; /* 设备 S 
39 int major; /* 主 设备 号 x, 
40 iau minore /* 次 设备 号 nA 
41 struct device node *nd; /* RADM i 
42 int led gpio; /* led 所 使 用 的 GPIO 编号 r4 
43 int dev stats; /* 设备 状态 ，0， 设 备 未 使 用 :>0 ,设备 已 经 被 使 用 */ 
44 spinlock t lock; /* 自 旋 锁 e 
8m yg 

46 

47 struct gpioled dev gpioled; /* led 设备 A 
48 

o MAE 

50  * Qdescription : 打开 设备 


E * QGparam - inode : 传递 给 驱动 的 inode 
52  * Qparam - filp : 设备 文件 ，file 结构 体 有 个 叫做 private data 的 成 员 变 


li 








53 * 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
54 * (ireturn : 0 成 功 ;其 他 失败 
55 z 


5 Statie int led openlstruct inode "ned, struci Tile wiil) 
mer 


58 unsigned long flags; 

59 filp-»private data = &gpioled; /* 设置 私有 数据 */ 

60 p 

61 spin lock irqsave(&gpioled.lock, flags); /* 上 锁 */ 
62 if (gpioled.dev stats) ( /* 如 果 设 备 被 使 用 了 */ 
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63 Spin unlock irqrestore(&gpioled.lock, flags); /* 解锁 */ 

64 return -EBUSY; 

65 } 

66 gpioled.dev_stats++; /* 如 果 设 备 没 有 打开 ， 那 么 就 标记 已 经 打开 了 */ 
67 spin unlock irqrestore(&gpioled.lock, flags);/* 解锁 */ 

68 

69 return 0; 

30. 

iie fS 


117 * Qdescription  : 关闭 /释放 设备 

118 * param - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 

119 * Qreturn : 0 成 功 ;其 他 失败 

TAO sy 

iL statie int leë releaselstruct nol vinode, struct tile srili) 
122 { 


JS unsigned long flags; 

124 struct gpioled dev *dev = filp-»private data; 

125 

126 /* 关闭 驱动 文件 的 时 候 将 dev stats WE1 */ 

127 Spin lock irqsave(&dev-»lock, flags);  /* 上 锁 */ 
128 if (dev-»dev stats) ( 

129 dev-»dev stats--; 

130 } 

131 spin_unlock_irqrestore (&dev->lock, flags) ;/* 解锁 */ 
d 

15/5] return 0; 

134 ) 

LS 


136 /* 设备 操作 函数 */ 
137] statie gtruct tile operetions opuoleo tops — i 











138 .owner — THIS MODULE, 
P39 .open - led open, 

140 oead = led reacl, 

TAT owrite = leg write, 

142 ozelease = lec! release, 
LASE qr 

144 

IST 

146 * @description  : IK3) H O K ži 
147 * @param 8 JE 

148 * Qreturn 8 E 
TAST 
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I50 statie ime _ imit lec LaLe (oic) 

JT 

152 int ret = 0; 

153 

154 /* ”初始 化 自 旋 锁 */ 

T55 Spin lock init(&gpioled.lock); 

Z4liz return 0; 

gilsy- m 

214 

Ze ye 

216 * Qdescription : JkzJt H2 

217 * Gparam B Zi 

218 * Qreturn 3 JE 

2g. e 

22/0 pratic voie  — exit led exit (weus 

DAN N 

222 /* 注销 字符 设备 驱动 */ 

£29 cdev del(&gpioled.cdev);/* 删除 cdev */ 

224 unregister chrdev region(gpioled.devid, GPIOLED CNT); 
PIDE 

226 device destroy(gpioled.class, gpioled.devid); 
220 Class destroy (roaoeol. elass) 7 

22m n 

2 


2500 module sbeobe (bel imit) p 
Z5 module exit (lee! exit) 
232 MODULE LICENSE ("GPL"); 
233 MODULE AUTHOR ("zuozhongkai"); 

第 43 ÍT, dev stats 表示 设备 状态 ， 如 果 为 0 的 话 表 示 设 备 还 没有 被 使 用 ， 如 果 大 于 0 的 
话 就 表示 设备 已 经 被 使 用 了 。 

第 44 行 ， 定 义 自 旋 锁 变量 lock。 

第 61-67 行 ， 使 用 自 旋 锁 实 现 对 设备 的 互 斥 访问 ， 第 61 行 调用 spin lock irqsave 函数 获 
取 锁 ， 为 了 考虑 到 驱动 兼容 性 ， 这 里 并 没有 使 用 spin lock 函数 来 获取 锁 。 第 62 行 判断 
dev stats 是 否 大 于 0， 如 果 是 的 话 表示 设备 已 经 被 使 用 了 ， 那 么 就 调用 spin. unlock irqrestore 
函数 释放 锁 ， 并 且 返 回 -EBUSY。 如 果 设 备 没 有 被 使 用 的 话 就 在 第 66 行将 dev stats 加 1， 表 
示 设 备 要 被 使 用 了 ， 然 后 调用 spin unlock irqrestore 函数 释放 锁 。 自 旋 锁 的 工作 就 是 保护 
dev stats 变量 ， 真 正 实 现 对 设备 互 斥 访问 的 是 dev stats. 

第 126-131 fT, Æ release 函数 中 将 dev_stats 减 1， 表 示 设 备 被 释放 了 ， 可 以 被 其 他 的 应 月 
程序 使 用 。 将 dev stats 减 1 的 时 候 需 要 自 旋 锁 对 其 进行 保护 。 

第 155 行 ， 在 驱动 入 口 函数 led init 中 调用 spin lock init 函数 初始 化 自 旋 锁 。 


3、 编 写 测试 APP 
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测试 APP 使 用 48.1.1 小 节 中 的 atomicApp.c 即 可 ， 将 7 atomic 中 的 atomicApp.c 文件 到 本 




















例 程 中 ， 并 将 atomicApp.c 重 命名 为 spinlockApp.c 即 可 。 











48.2.2 运行 测试 


1、 编 译 驱动 程序 

编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m AE 
量 的 值 改 为 spinlock.o，Makefile 内 容 如 下 所 示 : 
示例 代码 48.2.2.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 






































iel imz 4515159 2-1-0 mee alientelk 

4 obj-m := spinlock.o 
11 clean: 
12 $(MAKE) -C S$(KERNELDIR) M=$ (CURRENT PATH) clean 

第 4 行 ， 设 置 obj-m 变量 的 值 为 spinlock.o。 
输入 如 下 命令 编译 出 驱动 模块 文件 : 
make -j32 
编译 成 功 以 后 就 会 生成 一 个 名 为 “spinlock.ko” 的 驱动 模块 文件 。 
、 编 译 测试 APP 
输入 如 下 命令 编译 测试 spinlockApp.c 这 个 测试 程序 : 
arm-linux-gnueabihf-gcc spinlockApp.c -o spinlockApp 
编译 成 功 以 后 就 会 生成 spinlockApp 这 个 应 用 程序 。 

3、 运 行 测试 

将 上 一 小 节 编 译 出 来 的 spinlock.ko 和 spinlockApp 这 两 个 文件 拷贝 到 
rootfs/lib/modules/4.1.15 目录 中 ， 重 启 开 发 板 , 进入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 
加 载 spinlock.ko 驱动 模块 : 

depmod // 第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 

modprobe spinlock.ko /加 载 驱动 

驱动 加 载 成 功 以 后 就 可 以 使 用 spinlockApp 软件 测试 驱动 是 否 工作 正常 , 测试 方法 和 48.1.2 
小 节 中 一 样 ， 先 输入 如 下 命令 让 spinlockAPP 软件 模拟 占用 25S 的 LED 灯 : 

./atomicApp /dev/gpioled 1& /打开 LED XT 

紧 接 着 再 输入 如 下 命令 关闭 LED 灯 : 

JatomicApp /dev/gpioled 0 /关闭 LED 灯 

看 一 下 能 不 能 关闭 LED 灯 ， 驱 动 正常 工作 的 话 并 不 会 马上 关闭 LED 灯 ， 会 提示 你 “fle 
/dev/gpioled open failed!”， 必 须 等 待 第 一 个 atomicApp 软件 运行 完成 (25S 计时 结束 ) 才 可 以 再 次 
操作 LED AJ. 

如 果 要 伸 载 驱动 的 话 输入 如 下 命令 即 可 : 


rmmod spinlock.ko 
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48.3 信号 量 实验 








本 节 我 们 来 使 用 信号 量 实现 了 一 次 只 能 有 一 个 应 用 程序 访问 LED 灯 ， 信 号 量 可 以 导致 休 
卢 ， 因 此 信号 量 保护 的 临界 区 没有 运行 时 间 限 制 ， 可 以 在 驱动 的 open 函数 申请 信号 量 , 然后 在 
release 函数 中 释放 信号 量 。 但 是 信号 量 不 能 用 在 中 断 中 ， 本 节 实 验 我 们 不 会 在 中 断 中 使 用 信和 号 


o 
































48.3.1 实验 程序 编写 


1、 修 改 设备 树 文件 

本 章 实验 是 在 上 一 节 实 验 的 基础 上 完成 的 ， 同 样 不 需要 对 设备 树 做 任何 的 修改 。 

2. LED 驱动 修改 

本 节 实 验 在 第 上 一 节 实 验 驱 动 文件 spinlock.c 的 基础 上 修改 而 来 .新建 名 为 “9_semaphore” 
的 文件 夹 ， 然 后 在 9_semaphore 文件 夹 里 面 创建 vscode 工程 ， 工 作 区 命名 为 “semaphore” 将 
8 spinlock 实验 中 的 spinlock.c 复制 到 9_semaphore XRF, 并且 重 命名 为 semaphore.c。 将 原 
来 使 用 到 自 旋 锁 的 地 方 换 为 信号 量 即 可 , 其 他 的 内 容 基 本 不 变 , 完成 以 后 的 semaphore.c 文件 内 
容 如 下 所 示 ( 有 省 略 ): 





















































示例 代码 48.3.1.1 semaphore.c 文件 代码 
1 #include <linux/types.h> 
14 ginclude «linux/semaphore.h»? 
15 4 include «asm/mach/map.h» 
16 d£include «Xasm/uaccess.h» 
17 d$include «asm/io.h» 


18 J[ KCKCKCKCKCKCkCk kCkCk kCkCk kCKCkCkCKCkCk KCkCk IC KC kCKCKCkCKCKCk KC KC kCKCK kCKCKCkCKCk kc kCk ck ck k ck kck ck ck kck ck kck 


19 Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 



































20 文件 名 : semaphore.c 

21 Pa : 左 忠 凯 

22 版 本 s WO 

23 描述 : 信号 量 实验 ， 使 用 信号 量 来 实现 对 实现 设备 的 互 斥 访问 
24 其 他 

25 iex : www.openedv.com 

2. BE : 初版 V1.0 2019/7/18 左 忠 凯 创建 

m. KOKCKCKCKCkCKCkCk kCkCk kCk Ck Ck kc k Ck kCk Ck k kc k k kk k kc k Ck kCk Ck k kc k k kc k k kc k kckck ck kck ck ckck ck ckck ck kck ck ke ke f 
28 define GPIOLED CNT 1 设备 号 个 数量 */ 
29 #define GPIOLED NAME "gpioled" /* AS Bu 
30 4define LEDOFF 0 uS si 
31 #define LEDON il A AET 2 
32 


33 /* gpioled 设备 结构 体 */ 
3 erruet Gguelee! devi 
35 dev t devid; /* 设备 号 5 


36 struct cdev cdev; /* cdev */ 
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ET struct class *class; Ja ZR ra 

38 struct device *device; /* 设备 ara 

39 ime mejor /* 主 设备 号 A] 

40 int minor; /* 次 设备 号 Ay 

41 struct device node *nd; /* 设备 节点 n 

42 int led gpio; /* led 所 使 用 的 GPIO 编号 i 

43 struct semaphore sem; /* 信号 量 */ 
全 

45 

46 struct gpioled dev gpioled; /* led 设备 */ 

47 

48 /* 

49  * Qdescription  : 打开 设备 

50  * @param - inode : 传递 给 驱动 的 inode 

51  * @param - filp : 设备 文件 ，file 结构 体 有 个 叫做 private data 的 成 员 变 量 
So & 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
SS : 0 成 功 ;其 他 失败 

54 */ 

25 Static int lec! opxew(suuct inode "imeele, siue Tile virili) 
SIGUE 

E filp-»private data = &gpioled; /* 设置 私有 数据 */ 

58 

59 /* 获取 信号 量 , 进 入 休眠 状态 的 进程 可 以 被 信号 打 断 */ 

60 if (down interruptible(&gpioled.sem)) ( 

61 return -ERESTARTSYS; 

62 ) 

63 #1f O0 

64 down (&gpioled.sem); /* 不 能 被 信号 打 断 */ 

65 #endif 

66 

67 return 0; 

us 

Ta AR 

115 * Qdescription  : 关闭 /释放 设备 

116 * Qparam - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 

MT REESEN : 0 成 功 ;其 他 失败 

le 

11.9) statie imt led releaselstruct imods inode, struct iile virila) 
TZOS 

IZ struct gpioled dev *dev = filp-»private data; 

11227 

123 up (&dev-»sem) ; /* 释放 信号 量 ， 信 号 量 值 加 1 */ 
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124 

12/5 return 0; 

125 。 )} 

127 

128 /* 设备 操作 函数 */ 

1/2) tetic struct tile operationes gGyestolkec! tops > ii 











130 .owner = THIS MODULE, 

Poil .open = led open, 

11512 .read = led read, 

133 .write S led write, 

134 macies = lec! release, 

i95 »g 

136 

TIY e 

138 * QGdescription : 驱动 入 口 函数 
139 * (iparam 3 JE 

140 * Greturn 3 JE 

JLAHL a 

JLAUZ starcie ime _ imit lee siib (viste, 
143 { 

144 int ret = 0; 

145 

146 /* 初始 化 信号 量 */ 

147 sema init(&gpioled.sem, 1); 
204 return 0; 

2IDISEN) 

206 

20g f 

208 * G8description : 驱动 出 口 函 数 

209 * Gparam 8 JE 

210 * Greturn 3 JE 

gib y 

21.2. Starcie voici exit led exte (veu 
gus N 

214 /* 注销 字符 设备 驱动 */ 

gil cdev del(&gpioled.cdev);/* 删除 cdev */ 
ZING unregister chrdev region(gpioled.devid, GPIOLED CNT); 
Zl) 

218 device destroy(gpioled.class, gpioled.devid); 
249 Class destroy (oe eels 
2200) 

ZI 
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222 module imit (lexl init)? 
22,5 moule ezit (leel exit); 





224 MODU 
225 MODU 


i£ LICENS 





E ("GPL") E 

















EK AUTHOR ("zuozhongkai"); 
第 14 行 ， 要 使 用 信号 量 必须 添加 <linux/semaphore.h> 头 文件 。 








第 43 行 ， 在 设备 结构 体 中 添加 








个 信号 量 成 员 变 量 semo 





论坛 :www.opendev.com 








第 60—65 ÍT, Æ open 函数 中 申请 信号 量 , 可 以 使 用 
函数 。 如 果 信 和 号 1 就 表示 可 用 ， 那么 应 用 程序 














0 就 表示 应 用 程序 不 能 使 用 LED 4T, 
ud ir 申请 信和 号 量 











第 123 行 ， 在 release 函数 中 调用 up 函数 释放 信和 号 量 ， 


入 休眠 状态 的 应 用 程序 就 会 唤醒 ， 获 























就 会 开 
此 时 应 用 程序 就 会 
量 ， 获 取 LED 灯 使 用 权 。 









































取信 号 量 。 

















第 147 行 ， 在 驱动 入 口 函数 中 调 
人 
总 结 下 24 


“© 一 口 


LED 灯 ， 





























函数 初始 化 信和 号 


J sema init P. 


Ht sem 为 1 的 时 候 表示 LED 灯 还 没有 被 使 用 ， 如 果 应 
先 调用 open 函数 打开 /dev/gpioled，, i 








值 减 1 变 为 0。 如 果 此 时 


应 用 程序 B 也 要 使 用 LED 灯 ， 调 用 


down 函数 ,也 可 以 使 用 
始 使 用 LED 灯 。 如 果 信 号 量 值 为 
进入 到 休眠 状态 。 

















down interruptible 








等 到 信号 量 值 大 于 1 





这 样 其 他 因为 没有 得 到 信号 量 而 进 


4 


sem 的 值 为 1， 相 当 于 sem 





Titi 











这 个 时 候 会 获取 信号 量 














用 程序 A 要 使 用 
sem， 获 取 成 功 以 后 sem 的 



































为 信号 量 无 效 ( 值 为 0) 而 进入 休眠 状态 , 当 应 用 程序 A 运行 完毕 
的 时 候 就 会 释放 信号 量 sem， 此 时 信号 量 sem 的 值 就 会 加 1， 变 为 1。 信 和 号 量 sem 











示 其 他 应 用 程序 可 以 使 用 LED 灯 了 ， 
获取 成 功 以 后 就 开始 使 用 LED 灯 。 
3、 编 写 测试 APP 











open 函数 打开 /devwgpioled 就 会 因 

















,调用 





close 函数 关闭 /dev/gpioled 
再 次 有 效 ， 表 











此 时 在 休眠 状态 的 应 用 程序 A 就 会 获取 到 信号 量 sem, 





测试 APP 使 用 48.1.1 小 节 中 的 atomicApp.c 即 可 ， 将 7 atomic 中 的 atomicApp.c 文件 到 本 
例 程 中 ， 并 将 atomicApp.c 重 命名 为 semaApp.c 即 可 。 








48.3.2 运行 测试 


























Makefile 文件 和 第 四 十 章 实验 基本 


1、 编 译 驱 动 程序 
编写 Makefile 文件 ， 本 章 实 验 的 
量 的 值 改 为 semaphore.o，Makefile 内 容 如 下 所 示 : 














代码 48.3.2.1 Makefile 文件 


rel imz ne 





示例 
1 KERNELDIR :- 
4 obj-m :-semaphore.o 
11 clean: 
12 $(MAKE) -C S$(KERNELDIR) 

















第 4 行 ， 设 置 obj-m 变量 的 值 为 


M=$ (CURRENT PATH) 





semaphore.o. 


输入 如 下 命令 编译 出 驱动 模块 文件 : 


make -j32 


只 是 将 obj-m 变 


/home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 


clean 


编译 成 功 以 后 就 会 生成 一 个 名 为 “semaphore.ko” 的 驱动 模块 文件 。 


2、 编 译 测 试 APP 
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输入 如 下 命令 编译 测试 semaApp.c 这 个 测试 程序 : 


arm-linux-gnueabihf-gcc semaApp.c -0 ene 


编译 成 功 以 后 就 会 生成 sema A pp 这 个 应 用 程序 。 
3、 运 行 测试 











将 上 一 小 节 编 译 出 来 的 semaphoreko 和 semaApp 这 两 个 文件 拷贝 到 
rootfs/lib/modules/4.1.15 目录 中 ,重启 开 发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 
加 载 semaphore.ko 驱动 模块 : 

depmod /第 一 次 加 载 驱动 的 时 候 需 要 运行 此 命令 

modprobe semaphore.ko/ 加 载 驱动 

驱动 加 载 成 功 以 后 就 可 以 使 用 semaA pp. 软件 测试 驱动 是 否 工作 正常, 测试 方法 和 48.1.2 小 
节 中 一 样 ， 先 输入 如 下 命令 让 semaApp 软件 模拟 占用 25S 的 LED 灯 : 

/ semaApp /dev/gpioled 1& /打开 LED 4T 

紧 接 着 再 输入 如 下 命令 关闭 LED 47: 

./ semaApp /dev/gpioled 0& /关闭 LED 4T 

注意 两 个 命令 都 是 运行 在 后 台 ， 第 一 条 命令 先 获 取 到 信号 量 ， 因 此 可 以 操作 LED XT, 将 
Pe 并 且 占 有 25S。 第 二 条 命令 因为 获取 信号 量 失败 而 进入 休眠 状态 ， 等 待 第 一 条 命 
令 运行 完毕 并 释放 信号 量 以 后 才 拥 有 LED 灯 使 用 权 , 将 LED 灯 关 闭 , 运行 结果 如 图 48.3.2.1 所 






















































































































/1ib/modules/4. 1.15 


./semaApp /dev/gpioled 1& 
lib udi 4. 1.15 


semaApp /dev/gpioled 0& 
j App running times: 










App running times:2 
App running times:3 
App running times:4 
i running times:5 



















running times: 
App running times: 
App running times: 
A running Ken 
running 





Un Js uo Po E: [p 


times: 
"Hari id 









图 48.3.2.1 命令 运行 过 程 
如 果 要 卸载 驱动 的 话 输 入 如 下 命令 即 可 : 




















rmmod semaphore.ko 


48.4 互 斥 体 实验 


前 面 我 们 使 用 原子 操作 、 自 旋 锁 和 信号 量 实现 了 对 LED 灯 的 互 斥 访问 , 但 是 最 适合 互 斥 的 
就 是 互 斥 体 mutex 了 。 本 节 我 们 来 学 习 一 下 如 何 使 用 mutex 实现 对 LED 灯 的 互 斥 访问 。 
































48.4.1 实验 程序 编写 


1、 修 改 设备 树 文件 
本 章 实验 是 在 上 一 节 实 验 的 基础 上 完成 的 ， 同 样 不 需要 对 设备 树 做 任何 的 修改 。 
2. LED 驱动 修改 
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本 节 实 验 在 第 上 一 节 实 验 驱 动 文件 semaphore.c 的 基础 上 修改 而 来 。 新 建 名 为 “10_mutex?” 
的 文件 夹 ,然后 在 10_mutex 文件 夹 里 面 创建 vscode 工程 ,工作 区 命名 为 "mutex”. 将 9_semaphore 

















实验 中 的 semaphore.c 复制 到 10_mutex 文件 夹 中 , 并 且 重 命名 为 mutex.c。 将 原来 使 用 到 信和 号 量 

的 地 方 换 为 mutex 即 可 ,其 他 的 内 容 基 本 不 变 ,完成 以 后 的 mutex.c 文 件 内 容 如 下 所 示 ( 有 省 略 ): 
示例 代码 48.4.1.1 mutex.c 文件 代码 

1  £include <linux/types.h> 











17 4include «asm/io.h» 


18 /玉米 类 火炎 类 类 类 炎炎 类 大 大 类 类 大 大 炎炎 大 大火 大 大 类 类 大 大 类 类 大 大 大 类 大 类 大 类 大 大 大 大大 大大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 





19 Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
20 文件 名 : mutex.c 























2 ED : 左 忠 凯 

22 版 本 3 Vi 0 

23 描述 : 互 斥 体 实 验 ， 使 用 互 斥 体 来 实现 对 实现 设备 的 互 斥 访问 
24 其 他 ET 

Q5. WEE : www.openedv.com 

23 BE : 初版 V1.0 2019/7/18 左 忠 凯 创建 

emi KOKCKCKCKCkCKCkCk kCkCk kCkCk Ck kCk Ck kCk ck k kc k k kk Ck kc k Ck kk k k kc k k k Ck k kc kckckck ck kck ck ckck ck ckckck kock ck ke ke kx f 
28 4define GPIOLED CNT il /* 设备 号 个 数 */ 
29 #define GPIOLED NAME note lee f E z 
30 #define LEDOFF 0 人 
31 d4define LEDON il KE De x 
32 


33 /* gpioled 设备 结构 体 */ 
3 etruet goiolee chew 





35 dev t devid; /* 设备 号 s 
36 struct eey edev? /* cdev wy 
37 struct class *class; /* 3E A, 
38 struct device *device;  /* 设备 uu 
39 digne major; /* 主 设备 号 x 
40 ime morg /* 次 设备 号 E 
41 struct device node *nd; /* WA B a 
42 int led gpio; /* led 所 使 用 的 GPIO 编号 */ 
43 struct mutex lock; /* 互 斥 体 *f 
Xa > 

45 

46 struct gpioled dev gpioled; /* led K* */ 

47 

48 /* 

49  * Qdescription  : 打开 设备 


50  * Qparam - inode : 传递 给 驱动 的 inode 
51  * Qparam - filp : 设备 文件 ， file 结构 体 有 个 叫做 private data 的 成 员 变 量 
52 * 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 





fiti 
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SE * Qreturn : 0 成 功 ;其 他 失败 
54 */ 


25 Sexe int lec! opxew(sutruct inode "wimeele, situe able virili) 
XE 


57 filp-»private data = &gpioled; /* 设置 私有 数据 */ 
58 

59 /* 获取 互 斥 体 , 可 以 被 信号 打 断 */ 

60 if (mutex lock interruptible(&gpioled.lock)) ( 
61 return -ERESTARTSYS; 

62 ) 

63 dif 0 

64 mutex lock(&gpioled.lock); /* 不 能 被 信号 打 断 */ 
65 #endif 

66 

67 return 0; 

ex I) 

alal yf 


115 * @description : 关闭 /释放 设备 

116 * @param - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 

deg e (etes Die : 0 成 功 ;其 他 失败 

118 E 

11,9 statie imt lel selesse(struct imods vinode, Suwet iile virila) 
120 ( 


JE struct gololed dey *olew; = tilp- privare dates 
122 

12S /* EESE */ 

124 mutex_unlock (&dev->lock) ; 

TAS 

126 return 0; 

LAT i 

128 


129 /* 设备 操作 函数 */ 
130 tacie struct tile operatione goiloled tops MET 








dl Srt .owner = THIS MODULE, 
152) .open = led open, 

133 .read = led read, 

134 .write = led write, 

135 o elease = leel release, 
136 DE 

SN 

LIBE e 


139 * @description  : 驱动 入 口 函 数 
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140 * @param 3 JE 

141 aan 8 25 

JEANS ey 

14:5, gretie me _ targe dleel imit (veste 
144 ( 

145 int ret = 0; 

146 

147 /* 初始 化 互 斥 体 */ 

148 mutex init(&gpioled.lock); 
205 return 0; 

2 


275 moule sbeobe (bel imit); 

224 module exited exit)? 

225 MODULE LICENSE ("GPL"); 

226 MODULE AUTHOR ("zuozhongkai"); 
第 43 行 ， 定 义 互 斥 体 lock。 























第 60~65 行 ， 在 open 函数 中 调用 mutex lock interruptible 或 者 mutex lock 获取 mutex， 成 




















功 的 话 就 表示 可 以 使 用 LED 灯 ， 失 败 的 话 就 会 进入 休眠 状态 ， 和 信和 号 量 一 样 。 


























第 124 fT. TE release 函数 中 调用 mutex_unlock 函数 释放 mutex， 这 样 其 他 应 用 程序 就 可 以 











获取 mutex 了 。 
第 148 行 ， 在 驱动 入 口 函数 中 调用 mutex init 初始 化 mutex。 
互 斥 体 和 二 值 信号 量 类 似 ， 只 不 过 互 斥 体 是 专门 用 于 互 斥 访问 的 。 
3、 编 写 测试 APP 























测试 APP 使 用 48.1.1 小 节 中 的 atomicApp.c 即 可 ， 将 7 atomic 中 的 atomicApp.c 文件 到 本 


例 程 中 ， 并 将 atomicApp.c 重 命名 为 mutexApp.c 即 可 。 





48.4.2 运行 测试 


1、 编 译 驱 动 程序 























编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m AE 


量 的 值 改 为 mutex.o，Makefile 内 容 如 下 所 示 : 
示例 代码 48.4.2.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 














rel ime 451515 2-1-0 Ga alientelk 
4 obj-m := mutex.0 
11 clean: 
12 S$(MAKE) -C S(KERNELDIR) Mz$ (CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 mutex.o。 
输入 如 下 命令 编译 出 驱动 模块 文件 : 
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make -j32 
编译 成 功 以 后 就 会 生成 一 个 名 为 “mnutex.ko” 的 驱动 模块 文件 。 
2、 编 译 测 试 APP 


输入 如 下 命令 编译 测试 mutexApp.c 这 个 测试 程序 : 
arm-linux-gnueabihf-gcc mutexApp.c -o mutexApp 
编译 成 功 以 后 就 会 生成 mutex App 这 个 应 用 程序 。 
3、 运 行 测试 
将 上 一 小 节 编 译 出 来 的 mutex.ko 和 mutexApp 这 两 个 文件 找 贝 到 rootfs/lib/modules/4.1.15 
目录 中 , 重启 开发 板 , 进入 到 目录 lib/modules/4.1.15 中 , 输入 如 下 命令 加 载 mutex.ko 驱动 模块 : 
depmod /第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 
modprobe mutex.ko /加 载 驱动 
驱动 加 载 成 功 以 后 就 可 以 使 用 mutexApp 软件 测试 驱动 是 否 工 作 正 常 ， 测 试 方法 和 48.32 
中 测试 信号 量 的 方法 一 样 。 
如 果 要 和 独 载 驱动 的 话 输入 如 下 命令 即 可 : 


rmmod mutex.ko 
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第 四 十 九 章 Linux 按键 输入 实验 








在 前 几 章 我 们 都 是 使 用 的 GPIO 输出 功能 ， 还 没有 用 过 GPIO 输入 功能 ， 本 章 我 们 就 来 学 
习 一 下 如 果 在 Linux 下 编写 GPIO 输入 驱动 程序 。I.MX6U-ALPHA 开发 板 上 有 一 个 按键 ， 我 们 
就 使 用 此 按键 来 完成 GPIO 输入 驱动 程序 ， 同 时 利用 第 四 十 七 章 讲 的 原子 操作 来 对 按键 值 进 行 
保护 。 
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49.1 Linux 下 按键 驱动 原理 
按键 驱动 和 LED 驱动 原理 上 来 讲 基 本 都 是 一 样 的， 都 是 操作 GPIO， 只 不 过 一 个 是 读 取 


























GPIO 的 高 低 电 平 ,一 个 是 从 GPIO 输出 高 低 电 平 。 本 章 实 现 我 们 实现 按键 输入 ， 在 驱动 程序 中 
使 用 一 个 整形 变量 来 表示 按键 值 ,应 用 程序 通过 read 函数 来 读 取 按键 值 ,判断 按键 有 没有 按 下 。 
在 这 里 ， 这 个 保存 按键 值 的 变量 就 是 个 共享 资源 ， 驱 动 程序 要 向 其 写 入 按键 值 ， 应 用 程序 要 读 
取 按 键 值 。 所 以 我 们 要 对 其 进行 保护 ， 对 于 整形 变量 而 言 我 们 首选 的 就 是 原子 操作 ， 使 用 原子 
操作 对 变量 进行 赋值 以 及 读 取 。Linux 下 的 按键 驱动 原理 很 简单 ， 接 下 来 开始 编写 驱动 。 

注意 ， 本 章 例 程 只 是 为 了 演示 Linux 下 GPIO 输入 驱动 的 编写 ， 实 际 中 的 按键 驱动 并 不 会 
采用 本 章 中 所 讲解 的 方法 ，Linux 下 的 input 子 系统 专门 用 于 输入 设备 ! 


49.2 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 15.2 小 节 即 可 。 


49.3 实验 程序 编写 
本 实验 对 应 的 例 程 路 径 为 : 开发 板 光 盘 -> 2、Linux 驱动 例 程 -> 11_key。 









































































































































49.3.1 修改 设备 树 文 件 


1、 添 加 pinctrl 节点 

LMX6U-ALPHA 开发 板 上 的 KEY fH] f UARTI. CTS B 这 个 PIN， 打开 imx6ull-alientek- 
emmc.dts， 在 iomuxc 节点 的 imx6ul-evk 子 节 点 下 创建 一 个 名 为 “pinctrl key” 的 子 节点 ， 节 点 
内 容 如 下 所 示 : 





示例 代码 49.3.1.1 按键 pincttl 节点 
qaum: key: lweweso i 
2 fsl,pins - « 
3 MX6UL PAD UART1 CTS B GPIO1 IO18 OxF080 /* KRYO */ 
4 
5 








}; 
第 3 行 ， 将 GPIO_1018 这 个 PIN 复 用 为 GPIO1 IO18。 
2、 添 加 KEY 设备 节点 


在 根 节 点 “/” 下 创建 KEY 节点 ， 节 点 名 为 “key” 节点 内 容 如 下 : 
示例 代码 49.3.1.2 创建 KEY 节点 














1 key ( 

2 faddress-cells = «1»; 

5 #size-cells = <1>; 

4 compatible = "atkalpha-key"; 

5 pinctrl-names — "default"; 

6 pinctrl-0 2 «&pinctrl key»; 

7 key-gpio = «&gpiol 18 GPIO ACTIVE LOW»; [5 guo eH 
8 status - "okay"; 

Suy 
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第 6 行 ，pinctrl-0 属性 设置 KEY 所 使 用 的 PIN 对 应 的 pinctrl 节点 。 
第 7 行 ，key-gpio 属性 指定 了 KEY 所 使 用 的 GPIO. 























3、 检 查 PIN 是 否 被 其 他 外 设 使 用 


在 本 章 实验 中 蜂 鸣 器 使 用 的 PIN 为 UARTI. CTS B. 因此 先 检 查 PIN 为 UARTI CTS B 这 
个 PIN 有 没有 被 其 他 的 pinctrl 节点 使 用 , 如 果 有 使 用 的 话 就 要 屏蔽 掉 , 然后 再 检查 GPIO1 IO18 
这 个 GPIO 有 没有 被 其 他 外 设 使 用 ， 如 果 有 的 话 也 要 屏蔽 掉 。 

设备 树 编 写 完成 以 后 使 用 “make dtbs” 命 令 重 新 编译 设备 树 ， 然 后 使 用 新 编译 出 来 的 
imx6ull-alientek-emmc.dtb 文件 启动 Linux 系统 。 局 动 成 功 以 后 进入 “/proc/device-tree” 目 录 中 
查看 “key” 节 点 是 否 存在 ， 如 果 存 在 的 话 就 说 明 设 备 树 基本 修改 成 功 (具体 还 要 驱动 验证 )， 结 
果 如 图 49.3.1.1 所 示 : 


/sys/firmware/devicetree/base # 1s 


Zaddress-cells inte ot-controller&$00a01000 
ésize-cells 
aliases memory 




























































































alphaled model key 子 节点 
back1ight name 

beep pxp_v412 

chosen regulators 

clocks reserved-memory 

compatible soc 

cpus sound 

gpioled spi4 





图 46.3.1.1 key 子 节点 


49.3.2 按键 驱动 程序 编写 


设备 树 准 备 好 以 后 就 可 以 编写 驱动 程序 了 ， 新 建 名 为 “11_key” 的 文件 夹 ， 然 后 在 11_key 
文件 夹 里 面 创建 vscode 工程 ， 工 作 区 命名 为 “key”。 工 程 创 建 好 以 后 新 建 key.c 文件 ， 在 key.c 
里 面 输入 如 下 内 容 : 


















































示例 代码 49.3.2.1 key.c 文件 代码 
finclude <linux/types.h> 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include <linux/device.h> 
#include <linux/of.h> 
*include «linux/of address.h» 


Linu kernel, nz 


linux/delay.h> 


linux/ide.h» 


JL inte sc faac te. «nie 


linux/module.h» 


linux/errno.h» 


linux/gpio.h» 


KONG EE Om OI ESCONDE ES 

















< 
< 
< 
< 
< 
< 
< 
< 


linux/cdev.h» 


=E HEBE 
w N HB o 


#include «linux/of gpio.h» 


p 
心 


finclude «linux/semaphore.h» 


E 
Cn 


finclude «asm/mach/map.h» 








E 
Oo 


include Xasm/uaccess.h» 
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17 d$include «asm/io.h» 


18 /汪汪 炎炎 炎炎 炎炎 类 火炎 火炎 火炎 类 类 火炎 火炎 火炎 类 类 类 类 炎炎 类 类 类 类 类 类 类 大 类 类 类 类 类 类 类 大 类 类 类 类 类 类 类 类 类 大 类 大 类 大 类 类 大 大 


19 Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
200 S d Rey 
2i E : 左 忠 凯 
22 版 本 s V0 



































23 描述 : Linux 按键 输入 驱动 实验 

24 Rh —: X 

25 WESS : www.openedv.com 

26 ES : WIR v1.0 2019/7/18 左 忠 凯 创建 

kam 炎炎 火炎 类 大 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 类 大 类 大 类 大 火炎 类 大 类 大 类 大 大大 大 大 类 大 类 大 大 大 类 大 大 大 大/ 
2 1 /* VES MR */ 
29 4define KEY NAME "ey" "cc cn 
30 

31 /* SEXES */ 

32 #define KEYOVALUE OXFO /* 按键 值 mo 
33 #define INVAKEY 0x00 /* 无 效 的 按键 值 */ 
34 

35 /* key 设备 结构 体 */ 

J preruct key cevi 

37 dev t devid; /* WES i 

38 struct cdev cdev; /* cdev iA 

39 SEE 二 二 < [> 2R 2 

40 struct device *device;  /* 设备 */ 

41 int major; /* 主 设备 号 wf 

42 int minor; /* 次 设备 号 E 

43 struct device node *nd; /* Wd B S 

44 int key gpio; /* key 所 使 用 的 GPIO 编号 
45 atomic t keyvalue; /* 按键 值 e 

46 ); 

47] 

48 struct key dev keydev; /* key 设备 */ 

49 

SOR 

51  * @description : 初始 化 按键 To，open 函数 打开 驱动 的 时 候 
与 2 初始 化 按键 所 使 用 的 GPIO 引 脚 。 

53  * Qparam 3 E 

54  * Qreturn 3 JE 

55 i, 

SG eTtaTIE int kəyio init (weil) 

ISI 

58 keydev.nd = of find node by path("/key"); 

59 if (keydev.nd-- NULL) ( 
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60 return -EINVAL; 

1l } 

62 

63 keydev.key gpio = of get named gpio(keydev.nd ,"key-gpio", 0); 
64 if (keydev.key gpio < 0) ( 

65 printk("can't get keyONrWn"); 

66 return -EINVAL; 

67 } 

68 printk("key gpilo=sdirin", keydev.key gpio); 

69 

70 /* 初始 化 key 所 使 用 的 IO */ 

gal gpio request(keydev.key gpio, "key0"); WR E 
p gpio direction input(keydev.key gpio); /* 设置 为 输入 wy 
JS return 0; 

74 } 

3/5; 

3m pe 

7] * Qdescription : 打开 设备 

78  * Qparam - inode : 传递 给 驱动 的 inode 

79  * Qparam - filp : 设备 文件 ，file 结构 体 有 个 叫做 private data 的 成 员 变 量 
80 * 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
8 em : 0 成 功 ;其 他 失败 

a E 

$3 tatic int kay open(otruct inode taimoele, struct Tile cuu 
84 { 

85 aliat. ret = 07 

86 filp-»private data = &keydev; /* 设置 私有 数据 A, 

87 

88 ret = keyio init(); /* 初始 化 按键 IO on 

89 IE (rece sx 10) 

90 return ret; 

gil } 

92 

93 return 0; 

94 ) 

95 

eG. As 

97  * edescription  : 从 设备 读 取 数据 

98  * Qparam - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 

99  * Qparam - buf  : 返回 给 用 户 空间 的 数据 缓冲 区 

100 * @param - cnt  : 要 读 取 的 数据 长 度 

101 * @param - offt : 相对 于 文件 首 地 址 的 偏 移 

102 * @return : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 
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JS. 7 

1/04. statie ssize t key reac(otruct tile inl, Char _ user our, 
size © Emt, lort TE Vou) 















































TOS 

106 int ret = 0; 

107 unsigned char value; 

108 struct key dey vdey = tilp->privarce date, 

109 

110 if (gpio get value(dev-»-key gpio) == 0) ( /* keyO 按 下 yy 
Tal while(!gpio get value (dev->key gpio)); /* 等 待 按 键 释 放 */ 
BITES atomic set(&dev-»-keyvalue, KEYOVALUE); 

TiS } else { /* 无 效 的 按键 值 */ 
114 atomic set(&dev-»5keyvalue, INVAKEY); 

11305 ) 

116 

Jy value = atomic read(&dev-»keyvalue); /* 保存 按键 值  */ 
aale ret —- copy to user(buf, &value, sizeof(value)); 

119. return ret; 

120 } 

T2 

1222 

123 /* 设备 操作 函数 */ 

124 Statie gtruct tile operations key tops < i 

125 .owner = THIS MODULE, 

3025 .open = key open, 

112: T) .read = key read, 

2S) Ug 

T29 

T30 /2 

131 * @description : 驱动 入 口 函 数 

132 * Qparam 8 JE 

133 * Qreturn 3 JE 

le 

135 SEaELe ime _ imirt mykey mit (rore 

LSA N 

15 /* Wie TAE */ 

IBe atomic set(&keydev.keyvalue, INVAKEY); 

TAS 

140 /* 注册 字符 设备 驱动 */ 

141 /* 1、 创 建设 备 号 */ 

1412 if (keydev.major) ( JR RESCUE AERE */ 

143 keydev.devid = MKDEV(keydev.major, 0); 

144 register chrdev region(keydev.devid, KEY CNT, KEY NAME); 
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145 ) eise ( /* 没有 定义 设备 号 */ 

146 alloc chrdev region(&keydev.devid, 0, KEY CNT, KEY NAME); 

147 keydev.major = MAJOR(keydev.devid); /* 获取 分 配 号 的 主 设备 号 */ 

148 keydev.minor = MINOR(keydev.devid); /* 获取 分 配 号 的 次 设备 号 */ 

149 ) 

150 

IS /* 2. 初始 化 Easy */ 

S2 keydev.cdev.owner = THIS MODULE; 

155 cdev init(&keydev.cdev, &key fops); 

154 

155 /* 3. Mh cdev */ 

ISI cdev add(&keydev.cdev, keydev.devid, KEY CNT); 

S 

158 /* 4、 创 建 类 */ 

5) keydev.class = class create(THIS MODULE, KEY NAME); 

160 if (IS ERR(keydev.class)) 1 

JE GE return PTR ERR(keydev.class); 

T62 } 

163 

164 /* 5. BE */ 

165 keydev.device - device create(keydev.class, NULL, keydev.devid, 
NULL, KEY NAME); 

166 eus (I5 ERR(keydev teviee)) d 

167 return PTR ERR(keydev.device); 

168 ) 

169 

dE TRO) return 0; 

ipsa n 

JE 152 

Jg Sr gres 

174 * Qdescription : 驱动 出 口 函 数 

175 二 3 村 8 JE 

176 * Qreturn 3 JE 

db Sed 

WS starcie voie — exit myke (oe 

AS 

180 /* 注销 字符 设备 驱动 */ 

1151 cdev del(&keydev.cdev); /* 删除 caev */ 

182 unregister chrdev region(keydev.devid, KEY CNT); /* 注销 设备 号 */ 

FS 

184 device destroy(keydev.class, keydev.devid); 

185 class destroy(keydev.class); 

TN) 
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187 


188 module init(mykey init); 
189 module exit(mykey exit); 
190 MODULE LICENSE ("GPL"); 
191 MODULE AUTHOR ("zuozhongkai"); 

第 36-46 行 ， 结 构 体 key dev 为 按键 的 设备 结构 体 ， 第 45 行 的 原子 变量 keyvalue 用 于 记 
录 按 键 值 。 

第 56~74 行 ， 函 数 keyio_init 用 于 初始 化 按键 ， 从 设备 树 中 获取 按键 的 gpio 信息 ， 然 后 设 
置 为 输入 。 将 按键 的 初始 化 代码 提取 出 来 ， 将 其 作为 独立 的 一 个 函数 有 利于 提高 程序 的 模块 化 
air. 

第 83-94 ÍT, key open 函数 通过 调用 keyio init 函数 来 始 化 按键 所 使 用 的 IO， 应 用 程序 
每 次 打开 按键 驱动 文件 的 时 候 都 会 初始 化 一 次 按键 IO。 

第 104-120 ÍF, key read 函数 ， 应 用 程序 通过 read. 函数 读 取 按键 值 的 时 候 此 函数 就 会 执 
行 。 第 110 行 读 取 按 键 IO 的 电 平 ， 如 果 为 0 的 话 就 表示 按键 按 下 了 ， 如 果 按 键 按 下 的 话 第 
111 行 就 等 待 按键 释放 。 按 键 释放 以 后 标记 按键 值 为 

第 135~171 行 ， 驱 动 入 口 函数 ， 第 138 行 调 用 atomic. set 函数 初始 化 原子 变量 默认 为 无 效 

























































































值 。 





第 178~186 行 ， 驱 动 出 口 函 数 。 
key.c 文件 代码 很 简单 ， 重 点 就 是 key read 函数 读 取 按 键 值 ， 要 对 keyvalue 进行 保护 。 














49.3.3 编写 测试 APP 


新 建 名 为 keyApp.c 的 文件 ， 然 后 输入 如 下 所 示 内 容 : 
示例 代码 49.3.2.2 keyApp.c 文件 代码 








finclude "stdio.h" 
dinclude "unistd.h" 
finclude "sys/types.h" 
finclude "sys/stat.h" 
finclude "fcntl.h" 
finclude "stdlib.h" 








finclude "string.h" 


OO MY ES CHIETI E CO TS ES 


J[ KKCKCKCKCKCkCk KCkCk kCkCk kk KC KCkCk kCkCk kCkCK kk kCKCkCk KCkCk kCkCk k kc k Ck kc k Ck k kc k kck k kck ck kckck ck kok 


O 





Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
文件 名 : keyApp.c 

: 左 忠 凯 

2 VO 

: 按键 输入 测试 应 用 程序 

E 

HE : ./keyApp /dev/key 

: www.openedv.com 


: 初版 V1.0 2019/1/30 左 忠 凯 创建 


KCKCKCKCKCkCkCkCkCk Ck k Ck k Ck kCk Ck Ck kCk Ck k Ck kCkCkCkCk Ck Ck kCk kCk Ck k Ck k ck k Ck k k k ck k ck k ck k ckck kokckok kok X ke x k f 





Ex qe qs (EA ges 
w 0 PN nP o 
TER 
= S p k 








E 
UI 








=. eH re 
Rol ker enl ar 
<- 

G> 

Hu 

BEN 


/* REX */ 


N 
(e) 
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21 $define KEYOVALUE OXFO 

22 4define INVAKEY 0x00 

25 

2A 

25 * @description : main 主 程序 
DO 人 

27 * Qparam - argv  : 具体 参数 

28 * Qreturn : 0 成 功 ;其 他 失败 

2O 

SO stewE waste (bet. arge, Chec ol) 

EET 

22 sione G ESLA 

33 char *filename; 

34 unsigned char keyvalue; 

E 

36 if (arge !- 2)( 

5) printe (Enon Usage i ve wm) e 

38 return -1; 

29 } 

40 

41 filename = argv[!]; 

42 

43 /* 打开 key 驱动 */ 

44 fd 2 open(filename, O RDWR); 

45 if(fd « O)( 

46 printf("file $s open failed!NrNMn", argv[1]); 
47 return 1, 

48 } 

49 

50 /* 循环 读 取 按 键 值 数据 ! */ 

5d while(1) { 

52 read(fd, &keyvalue, sizeof(keyvalue)); 

53 if (keyvalue == KEYOVALUE) ( [^s REXO wy 
54 printf("KEYO Press, value = $4XWXrWXn", keyvalue);/* iF */ 
55 } 

56 } 

57 

58 rete close(td): o A WI e 

59 if(ret < O)[( 

60 printf("file $s close failed!NrMn", argv[1]); 
61 return -1; 

62 } 

63 return 0; 
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64 ) 











第 51-56 行 ， 循 环 读 取 /dewkey 文件 ， 也 就 是 循环 读 取 按 键 值 ， 并 且 将 按键 值 打印 出 来 。 
49.4 运行 测试 
49.4.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 

编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m AE 
量 的 值 改 为 key.o，Makefile 内 容 如 下 所 示 ; 
示例 代码 49.4.1.1 Makefile 文件 
1 KERNELDIR :- /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 























ixl ime 451515 2,150 Ga alientelk 
4 obj-m := key.o 





12 $(MAKE) -C S$(KERNELDIR) M=$ (CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 key.o。 

输入 如 下 命令 编译 出 驱动 模块 文件 : 

make -j32 

编译 成 功 以 后 就 会 生成 一 个 名 为 “key.ko” 的 驱动 模块 文件 。 

、 编 译 测试 APP 

输入 如 下 命令 编译 测试 keyApp.c 这 个 测试 程序 : 


arm-linux-gnueabihf-gcc keyApp.c -o NIE 
编译 成 功 以 后 就 会 生成 keyA pp 这 个 应 用 程序 。 























N 











—A— 


49.4.2 运行 测试 
将 上 一 小 节 编 译 出 来 的 keyko 和 keyApp 这 两 个 文件 拷贝 到 rootfs/lib/modules/4.1.15 目录 





中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， AAT 令 加 载 keyko 驱动 模块 : 
depmod /第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 
modprobe key.ko /加 载 驱动 


驱动 加 载 成 功 以 后 如 下 命令 来 测试 : 
JkeyApp /dev/key 
输入 上 述 命令 以 后 终端 显示 如 图 49.4.2.1 所 示 : 


/lib/modules/4.1.15 # ./keyApp /dev/key 
key. gpio-18 

















图 49.4.2.1 测试 APP 运行 界面 
按 下 开发 板 上 的 KEY0 按键 ，keyApp 就 会 获取 并 且 输 出 按键 信息 ， 如 图 49.4.2.2 所 示 : 
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/lib/modules/4.1.15 # ./keyApp /dev/key 

key. gpio-18 

KEYO Press, value = OXFO 

KEYO Press, value = OXFO 

KEYO Press, value = OXFO 

KEYO Press, value = OXFO 

KEYO Press, value = OXFO 








图 49.4.22 按键 运行 结果 
从 图 49.4.2.2 可 以 看 出 ， 当 我 们 按 下 KEY0 以 后 就 会 打印 出 “KEY0 Press, value = 0XF0”， 
表示 按键 按 下 。 但 是 大 家 可 能 会 发 现 ， 有 时 候 按 下 一 次 KEY0 但 是 会 输出 好 几 行 “KEY0 Press, 
value = 0XF0”， 这 是 因为 我 们 的 代码 没有 做 按键 消 拌 处 理 。 
如 果 要 卸载 驱动 的 话 输入 如 下 命令 即 可 : 


rmmod key.ko 
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第 五 十 章 Linux 内 核定 时 器 实验 


定时 器 是 我 们 最 常用 到 的 功能 ， 一 般 用 来 完成 定时 功能 ， 本 章 我 们 就 来 学 习 一 下 Linux 内 
核 提 供 的 定时 器 API 函数 , 通过 这 些 定时 器 API 函数 我 们 可 以 完成 很 多 要 求 定 时 的 应 用 。Linux 
内 核 也 提供 了 短 延 时 函数 ， 比 如 微 秒 、 纳 秒 、 毫 秒 延 时 函数 ， 本 章 我 们 就 来 学 习 一 下 这 些 和 时 
间 有 关 的 功能 。 
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50.1 Linux 时 间 管 理 和 内 核定 时 器 简介 
50.1.1. 内 核 时 间 管 理 简 介 


学 习 过 UCOS 或 FreeRTOS 的 同学 应 该 知道 ，UCOS 或 FreeRTOS 是 需要 一 个 硬件 定时 器 
提供 系统 时 钟 ， 一 般 使 用 Systick 作为 系统 时 钟 源 。 同 理 ，Linux 要 运行 ， 也 是 需要 一 个 系统 时 
钟 的 , 至 于 这 个 系统 时 钟 是 由 哪个 定时 器 提供 的 , 笔者 没有 去 研究 过 Linux 内 核 , 但 是 在 Cortex- 
A7 内 核 中 有 个 通用 定时 器 , 在 《Cortex-A7 Technical ReferenceManua.pdf》 的 “9:Generic Timer" 
章节 有 简单 的 讲解 ， 关 于 这 个 通用 定时 器 的 详细 内 容 ， 可 以 参考 《ARM ArchitectureReference 
Manual ARMv7-A and ARMv7-R edition.pdf》 的 “chapterB8 The Generic Timer” 章 节 。 这 个 通用 
定时 器 是 可 选 的 ， 按 照 笔 者 学 习 FreeRTOS 和 STM32 的 经 验 ， 猜 测 Linux 会 将 这 个 通用 定时 器 
作为 Linux 系统 时 钟 源 (前 提 是 SOC 得 选 配 这 个 通用 定时 器 )。 具 体 是 怎么 做 的 笔者 没有 深入 研 
究 过 ， 这 里 仅仅 是 猜测 ! 不 过 对 于 我 们 Linux 驱动 编写 者 来 说 ， 不 需要 深入 研究 这 些 具体 的 实 
现 ， 只 需要 掌握 相应 的 API 函数 即 可 ， 除 非 你 是 内 核 编 写 者 或 者 内 核 爱 好 者 。 

Linux 内 核 中 有 大 量 的 函数 需要 时 间 管 理 ， 比 如 周期 性 的 调度 程序 、 延 时 程序 、 对 于 我 们 驱 
动 编写 者 来 说 最 常用 的 定时 器 。 硬件 定时 器 提供 时 钟 源 ， 时钟 源 的 频率 可 以 设置 ， 设置 好 以 后 
就 周期 性 的 产生 定时 中 断 ， 系 统 使 用 定时 中 断 来 计时 。 中 断 周期 性 产生 的 频率 就 是 系统 频率 ， 
也 叫做 节拍 率 (tick rate)( 有 的 资料 也 叫 系 统 频率 )， 比 如 1000Hz，100Hz 等 等 说 的 就 是 系统 节拍 
率 。 系 统 节拍 率 是 可 以 设置 的 ， 单 位 是 Hz， 我 们 在 编译 Linux 内 核 的 时 候 可 以 通过 图 形 化 界面 
设置 系统 节拍 率 ， 按 照 如 下 路 径 打 开 配 置 界面 : 

-> Kernel Features 

-> Timer frequency (<choice> [=y]) 
选中 “Timer frequency”, 打开 以 后 如 图 50.1.1.1 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 















































Timer frequency 
Use the arrow keys to navigate this window or press the 
hotkey of the item you wish to select followed by the <SPACE 
BAR>. Press <?> for additional information about this 


[£3] CEE 
( ) 200 Hz 
250 Hz 


500 Hz 


) 
) 300 Hz 
) 
) 1000 Hz 


< Help > 





50.1.11 系统 节拍 率 设置 
从 图 50.1.1.1 可 以 看 出 ， 可 选 的 系统 节拍 率 为 100Hz、200Hz、250Hz、300Hz、500Hz 和 
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1000Hz， 默 认 情况 下 选择 100Hz。 设 置 好 以 后 打开 Linux 内 核 源 码 根 目录 下 的 .config 文件 ， 在 
此 文件 中 有 如 图 50.1.1.2 所 示 定 义 : 


zuozhongkai@ubuntu: -/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 


CONFIG PREEMBT COUNT-y 
CONFIG HZ FIXED-O 
CONFIG HZ 100-y 











CONFIG HZ-100 


CONFIG SCHED HRTICK-y 
CONFIG AEABI-y 





图 50.1.1.2 系统 节拍 率 
图 50.1.1.2 中 的 CONFIG. HZ 73 100, Linux 内 核 会 使 用 CONFIG_HZ 来 设置 自己 的 系统 时 
钟 。 打 开 文 件 include/asm-generic/param.h， 有 如 下 内 容 : 
示例 代码 50.1.1.1 include/asm-generic/param.h 文件 代码 段 























6 # undef HZ 

7 4 define HZ CONFIG HZ 
8 4 define USER HZ 100 

9 # define CLOCKS PER SEC (USER HZ) 

第 7 行 定义 了 一 个 宏 HZ， 宏 HZ 就 是 CONFIG HZ， 因 此 HZ=100， 我 们 后 面 编写 Linux 
驱动 的 时 候 会 常常 用 到 HZ， 因 为 HZ 表示 一 秒 的 节拍 数 ， 也 就 是 频率 。 

大 多 数 初学 者 看 到 系统 节拍 率 默 认为 100Hz 的 时 候 都 会 有 疑问 ， 怎 么 这 么 小 ? 100Hz 是 可 
选 的 节拍 率 里 面 最 小 的 。 为 什么 不 选择 大 一 点 的 呢 ? 这 里 就 引出 了 一 个 问题 : 高 节拍 率 和 低 节 
拍 率 的 优 缺 点 : 

QD、 高 节拍 率 会 提高 系统 时 间 精 度 ， 如 果 采 用 100Hz 的 节拍 率 ， 时 间 精 度 就 是 10ms， 采 用 
1000Hz 的 话 时 间 精 度 就 是 lms， 精 度 提 高 了 10 倍 。 高 精度 时 钟 的 好 处 有 很 多 ， 对 于 那些 对 时 
间 要 求 严 格 的 函数 来 说 ， 能 够 以 更 高 的 精度 运行 ， 时 间 测 量 也 更 加 准确 。 

包 、 高 节拍 率 会 带 导 致 中 断 的 产生 更 加 频繁 ， 频 繁 的 中 断 会 加 剧 系统 的 负担 ，1000Hz 的 
100Hz 的 系统 节拍 率 相 比 ， 系 统 要 花费 10 倍 的 “精力 ”去 处 理 中 断 。 中 断 服务 函数 占用 处 理 器 
的 时 间 增 加 ， 但 是 现在 的 处 理 器 性 能 都 很 强大 ， 所 以 采用 1000Hz 的 系统 节拍 率 并 不 会 增加 大 
大 的 负载 压力 。 根 据 自 己 的 实际 情况 ， 选 择 合适 的 系统 节拍 率 ， 本 教程 我 们 全 部 采用 默认 的 
100Hz 系统 节拍 率 。 

Linux 内 核 使 用 全 局 变量 jiffies 来 记录 系统 从 启动 以 来 的 系统 节拍 数 ， 系 统 启动 的 时 候 会 
将 jiffies 初始 化 为 0，jiffies 定义 在 文件 include/linux/jiffies.h 中 ， 定 义 如 下 : 

示例 代码 50.1.1.2 include/jiffies.h 文件 代码 段 
J extera u4 ^ Jitiy deta Jiiiiss 647 






















































































































































































































































































I extern unsignel! Long volatiles _ Jitiy deta Jiitties, 

第 76 行 ， 定 义 了 一 个 64 位 的 jiffies_64。 

第 TI 行 ， 定 义 了 一 个 unsigned long 类 型 的 32 位 的 jiffies。 

jiffies 64 和 jiffies 其 实 是 同一 个 东西 , jiffies 64 用 于 64 位 系统 , 而 jiffies 用 于 32 位 系统 。 
为 了 兼容 不 同 的 硬件 ，jiffies 其 实 就 是 jiffies 64 的 低 32 位 ，jiffies 64 和 jiffies 的 结构 如 图 
50.1.1.3 所 示 : 
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64 32 0 
| J 
" jiffieg( 低 32 位 ) 





- 
jiffies_64 
图 50.1.1.3 jiffies 64 和 jiffies 结构 图 


当 我 们 访问 jiffies 的 时 候 其 实 访问 的 是 jiffies 64 的 低 32 位 ， 使 用 get jiffies 64 这 个 函数 
可 以 获取 jiffies 64 的 值 ,在 32 位 的 系统 上 读 取 jiffies 的 值 , 在 64 位 的 系统 上 jiffes 和 jiffies_64 























表示 同一 个 变量 ， 因 此 也 可 以 直接 读 取 jiffies 的 值 。 所 以 不 管 是 32 位 的 系统 还 是 64 位 系统 ， 
都 可 以 使 用 jiffies。 


前 面 说 了 HZ 表示 每 秒 的 节拍 数 ，jiffies 表示 系统 运行 的 jiffies 节拍 数 ， 所 以 jiffies/HZ 就 





是 系统 运行 时 间 ， 单 位 为 秒 。 不管 是 32 位 还 是 64 位 的 jiffies， 都 有 溢出 的 风险 ,， 洲 出 以 后 会 


nz 





新 从 0 开始 计数 ， 相 当 于 绕 回 来 了 ， 因 此 有 些 资料 也 将 这 个 现象 也 叫做 绕 回 。 假 如 HZ 为 最 大 
值 1000 的 时 候 ，32 位 的 jiffies 只 需要 49.7 天 就 发 生 了 绕 回 ， 对 于 64 为 的 jiffies 来 说 大 概 需要 




















5.8 亿 年 才能 绕 回 ， 因 此 jiffies 64 的 绕 回 忽略 不 计 。 处 理 32 位 jiffies 的 绕 回 显得 尤为 重要 ， 
Linux 内 核 提 供 了 如 表 50.1.1.1 所 示 的 几 个 API 函数 来 处 理 绕 回 。 

















time after(unkown, known) 





time before(unkown, known) 











unkown 通常 为 jiffies, known 通常 是 需要 对 比 的 值 。 








time after eq(unkown, known) 





time before eq(unkown, known) 














表 50.1.1.1 处 理 绕 回 的 API ER 














如 果 unkown 超过 known 的 话 ，time_after 函数 返回 真 ， 否 则 返回 假 。 如 果 unkown 没有 起 





过 known 的 话 time before 函数 返回 真 , 否则 返回 假 ,time_after_eq 函数 和 time. after 函数 类 似 ， 


只 是 多 了 判断 等 于 这 个 条 件 。 同 理 ，time_before eq 函数 和 time before 函数 也 类 似 。 比 如 我 们 








要 判断 某 段 代码 执行 时 间 有 没有 超时 ， 此 时 就 可 以 使 用 如 下 所 示 代 码 : 
示例 代码 50.1.1.3 使 用 jiffies 判断 超时 
unsigned long timeout; 


timeout < jiffies * (2 * HZ); /* 超时 的 时 间 点 */ 











/玉米 业 大火 大火 大 炎炎 类 大 类 类 火炎 类 大 类 类 类 大 大大 大大 类 大 类 大 类 大 大大 类 大 大 


1 
2 
3 
4 
5 ”具体 的 代码 
6 
7 
8 
9 





类 大大 类 火炎 大大 类 大 大大 大 大 大大 大 大 类 大 类 大 大 类 大 大 类 大 大 大 大 大 大 大 大 大 


/* 判断 有 没有 超时 */ 
EE (me betore(jitiies, nol 
10 /* 超时 发 生 */ 
11 ) else { 
12 /* ENRE */ 
131} 








timeout 就 是 超时 时 间 点 ， 比 如 我 们 要 判断 代码 执行 时 间 是 不 是 超过 了 2 秒 ,那么 超时 时 间 
点 就 是 jiffies+(2*HZ)， 如 果 jiffies KF timeout 那 就 表示 超时 了 ， 和 否则 就 是 没有 超时 。 第 4-6 行 
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就 是 具体 的 代码 段 。 第 9 行 通过 函数 time. before 来 判断 jiffies 是 否 小 于 timeout， 如 果 小 于 的 话 
就 表示 没有 超时 。 

为 了 方便 开发 ，Linux 内 核 提供 了 几 个 jifties 和 ms、us、ns 之 间 的 转换 函数 ， 如 表 50.1.1.2 
所 示 : 


int jiffies to msecs(const unsigned long j) 将 jiffies 类 型 的 参数 j 分 别 转换 为 对 应 的 毫秒 、 
微 秒 、 纳 秒 。 




















intjiffies to usecs(const unsigned long j) 





u64 jiffies to nsecs(const unsigned long j) 





long msecs to jiffies(const unsigned int m) 
long usecs to jiffies(const unsigned int u) 将 毫秒 、 微 秒 、 纳 秒 转换 为 jiffies 类 型 。 
unsigned long nsecs to jiffies(u64 n) 

表 50.1.1.2 jiffies FU ms, us. ns 之 间 的 转换 函数 




















50.1.2. 内 核定 时 器 简介 


定时 器 是 一 个 很 常用 的 功能 ， 需 要 周期 性 处 理 的 工作 都 要 用 到 定时 器 。Linux 内 核定 时 器 
采用 系统 时 钟 来 实现 ， 并 不 是 我 们 在 裸 机 篇 中 讲解 的 PIT 等 硬件 定时 器 。Linux 内 核定 时 器 使 
用 很 简单 ， 只 需要 提供 超时 时 间 ( 相 当 于 定时 值 ) 和 定时 处 理 函 数 即 可 ， 当 超时 时 间 到 了 以 后 设 
置 的 定时 处 理 函 数 就 会 执行 ， 和 我 们 使 用 硬件 定时 器 的 套路 一 样 ， 只 是 使 用 内 核定 时 器 不 需要 
做 一 大 扒 的 寄存 器 初始 化 工作 。 在 使 用 内 核定 时 器 的 时 候 要 注意 一 点 ， 内 核定 时 器 并 不 是 周期 
性 运行 的 ， 超 时 以 后 就 会 自动 关闭 ， 因 此 如 果 想 要 实现 周期 性 定时 ， 那 么 就 需要 在 定时 处 理 函 
数 中 重新 开启 定时 器 。Linux 内 核 使 用 timer list 结构 体 表 示 内 核定 时 器 ，timer list 定义 在 文件 
include/linux/timer.h 中 ， 定 义 如 下 (省 略 掉 条 件 编译 ): 

示例 代码 50.1.2.1 timer. list 结构 体 



















































































struct timer ligt i 
otruct list head entry? 
unsigned long expires; /* 定时 器 超时 时 间 ， 单 位 是 节拍 数 */ 


struct EVSG base a 























void (*function) (unsigned long); /* 定时 处 理 函 数 eg 
unsigned long data; /* 要 传递 给 function 函数 的 参数 */ 


EEC 








要 使 用 内 核定 时 器 首先 要 先 定义 一 个 timer list 变量 ， 表 示 定 时 器 ，tiemr list 结构 体 的 
expires 成 员 变 量 表示 超时 时 间 ， 单 位 为 节拍 数 。 比 如 我 们 现在 需要 定义 一 个 周期 为 2 秒 的 定时 
器 ， 那 么 这 个 定时 器 的 超时 时 间 就 是 jiffies+(2*HZ)， 因 此 expires=jiffies+(2*HZ)。function 就 是 
定时 器 超时 以 后 的 定时 处 理 函 数 ， 我 们 要 做 的 工作 就 放 到 这 个 函数 里 面 ， 需 要 我 们 编写 这 个 定 
时 处 理 函 数 。 

定义 好 定时 器 以 后 还 需要 通过 一 系列 的 API 函数 来 初始 化 此 定时 器 ， 这 些 函数 如 下 : 

1, init timer 函数 

init timer 函数 负责 初始 化 timer list 类 型 变量 ， 当 我 们 定义 了 一 个 timer list 变量 以 后 一 定 
要 先 用 init timer 初始 化 一 下 。init_ timer 函数 原型 如 下 : 
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void init timer(struct timer list *timer) 
函数 参数 和 返回 值 含 义 如 下 : 
timer: 要 初始 化 定时 器 。 
返回 值 : 没有 返回 值 。 
2. add timer 函数 


add timer 函数 用 于 向 Linux 内 核 注 册 定时 器 ,使 用 add. timer 函数 向 内 核 注 册 定 时 器 以 后 ， 











定时 器 就 会 开始 运行 ， 函 数 原型 如 下 : 

void add timer(struct timer list *timer) 

函数 参数 和 返回 值 含义 如 下 : 

timer: 要 注册 的 定时 器 。 

返回 值 ， 没有 返回 值 。 

3. del timer 函数 

del timer. 函数 用 于 删除 一 个 定时 器 ， 不 管 定时 器 有 没有 被 激活 ， 都 可 以 使 用 此 函数 删除 。 
在 多 处 理 器 系统 上 ， 定 时 器 可 能 会 在 其 他 的 处 理 器 上 运行 ， 因 此 在 调用 del timer 函数 删除 定时 
器 之 前 要 先 等 待 其 他 处 理 器 的 定时 处 理 器 函数 退出 。del timer 函数 原型 如 下 ; 

int del timer(struct timer list * timer) 

函数 参数 和 返回 值 含义 如 下 : 

timer: 要 删除 的 定时 器 。 

返回 值 ，0， 定 时 器 还 没 被 激活 ; 1， 定 时 器 已 经 激活 。 

4、del_timer_sync 函数 


del timer sync 函数 是 del timer 函数 的 同步 版 ， 会 等 待 其 他 处 理 器 使 用 完 定 时 器 再 删除 ， 
del timer sync 不 能 使 用 在 中 断 上 下 文中 。del timer. sync 函数 原型 如 下 所 示 : 
int del timer sync(struct timer list *timer) 
函数 参数 和 返回 值 含 义 如 下 : 
timer: 要 删除 的 定时 器 。 
返回 值 ，0， 定 时 器 还 没 被 激活 ; 1， 定 时 器 已 经 激活 。 
5. mod timer 函数 


mod timer 函数 用 于 修改 定时 值 ， 如 果 定 时 器 还 没有 激活 的 话 ，mod timer 函数 会 激活 定时 
函数 原型 如 下 : 
int mod timer(struct timer list *timer, unsigned long expires) 
函数 参数 和 返回 值 含义 如 下 : 
timer: 要 修改 超时 时 间 ( 定 时 值 ) 的 定时 器 。 
expires: 修改 后 的 超时 时 间 。 
返回 值 : 0， 调 用 mod timer 函数 前 定时 器 未 被 激活 ; 1， 调 用 mod timer 函数 前 定时 器 已 
被 激活 。 
关于 内 核定 时 器 常用 的 API 函数 就 讲 这 些 ， 内 核定 时 器 一 般 的 使 用 流程 如 下 所 示 : 
TURE 50.1.2.2 内 核定 时 器 使 用 方法 演示 
ee me en 
2 
3 /* 定时 器 回调 函数 */ 


4 void function(unsigned long arg) 
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5 { 

6 Jp 

7 * 定时 器 处 理 代 码 

8 a 

9 

10 /* 如 果 需 要 定时 器 周期 性 运行 的 话 就 使 用 mod_ timer 

13 * 函数 重新 设置 超时 值 并 且 启 动 定 时 器 。 

12 wy 

iiS moe timer (ccdev->timertest, Jiitiies 3» mesecs to jiiies(^)»)5 
14 ] 

iG 


16 /* 初始 化 函数 */ 


L7 yonel abb (woe) 





18 ( 

19 init timer(&timer); /* 初始 化 定时 器 e 
20 

Pul timer.function = function; /* 设置 定时 处 理 函 数 
2 timer.expires-jffies + msecs to jiffies(2);/* 超时 时 间 2 秒 */ 
23 timer.data = (unsigned long)&dev;  /* 将 设备 结构 体 作 为 参数 */ 
24 

25 add timer(&timer); /* 启动 定时 器 B 
25 

2) 


28 /* 退出 函数 */ 


29) wee exe (won) 

















SO 

aul del timer(&timer); /* 删除 定时 器 */ 
32 /* 或 者 使 用 */ 

SYS del timer sync(&timer); 

34 ) 

50.1.3 Linux 内 核 短 延 时 函数 





有 时 候 我 们 需要 在 内 核 中 实现 短 延 时 ， 尤 其 是 在 Linux 驱动 中 。Linux AHE T E in 





秒 和 纳 秒 延 时 函数 ， 这 三 个 函数 如 表 50.1.3.1 所 示 : 





void ndelay(unsigned long nsecs) 
void udelay(unsigned long usecs) 纳 秒 、 微 秒 和 毫秒 延 时 函数 。 
void mdelay(unsigned long mseces) 


表 50.1.3.1. 内 核 短 延 时 函数 

















50.2 硬件 原理 图 分 析 
本 章 使 用 通过 设置 一 个 定时 器 来 实现 周期 性 的 闪烁 LED 灯 , 因此 本 章 例 程 就 使 用 到 了 一 个 
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LED H, XF LED 灯 的 硬 伯 


论坛 :www.opendev.com 





原理 图 参考 参考 8.3 小 节 即 可 。 


50.3 实验 程序 编写 

本 实验 对 应 的 例 程 路 径 为 : 开发 板 光 盘 -> 2. Linux 驱动 例 程 -> 12_timer。 

本 章 实验 我 们 使 用 内 核定 时 器 周期 性 的 点 亮 和 熄灭 开发 板 上 的 LED T, LED 灯 的 内 烁 周 
期 由 内 核定 时 器 来 设置 ， 测 试 应 用 程序 可 以 控制 内 核定 时 器 周期 。 

















50.3.1 修改 设备 树 文件 
本 章 实验 使 用 到 了 LED 灯 ，LED 灯 的 设备 树 节点 信息 使 用 45.4.1 小 节 创 建 的 即 可 。 








50.3.2. 定时 器 驱动 程序 编写 


新 建 名 为 “12_timer” 的 文件 夹 ， 然 后 在 12 timer 文件 夹 里 面 创建 vscode 工程 ， 工 作 
名 为 “timer”。 工 程 创建 好 以 后 新 建 timer.c 文件 ， 在 timere 里 面 输入 如 下 内 容 : 
示例 代码 50.3.2.1 timer.c 文件 代码 段 
x/types.h» 
x/kernel.h» 
x/delay.h» 
x/ide.h» 
x/init.h» 
x/module.h» 


x 
8 








Tt 














~ 


de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de 
de «asm/uaccess.h» 
de «asm/io.h» 


六 大 kk kk kk kk kk kk kk kk kk kk kk kk kc kk kk kk kck ckck kck kck kck ckck ckck ck ck ck ck ck ck ck ck ck ck koc 


ea 
«lin 
«lin 
< 
«lin 
«lin 
«lin 
«lin 
«lin 
«lin 
«lin 
«lin 
Ken 
«lin 
«lin 


dinclu U 


#inclu U 


#inclu U 


#inclu U 


#+inclu U 


#inclu U 


dinclu ux/errno.h» 


OON OY CU OO SOS 


fincl x/gpio.h» 
x/cdev.h» 
x/device.h» 
x/of.h» 


x/of address.h» 














tO 


dinclu U 


rp 
(e 


#inclu U 


ri 
jai 


#inclu U 


m 
N 


#inclu U 


[n 
Ww 


#inclu U 


x/of gpio.h» 


p 
心 


dincl x/semaphore.h» 


x/timer.h» 








ES 
Cn 


dinclu U 


m 
OY 


#inclu <asm/mach/map.h> 


Ea 
~] 


#incl 
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29 4define TIMER CNT 1 /* 设备 号 个 数 a 

30 #define TIMER NAME Mimers /* ZF i 

31 #define CLOSE CMD ( IO(0XEF, 0x1)) /* 关闭 定时 器 */ 

32 4define OPEN CMD ( IO(OXEF, 0x2)) J* E */ 

33 4$define SETPERIOD CMD ( IO(0XEF, 0x3)) /* 设置 定时 器 周期 命令 */ 
34 #define LEDON 1 VOS aT un 

35 4define LEDOFF 0 A= ROT ui 

36 


37 /* timer 设备 结构 体 */ 


BES ue ne 














39 dev t devid; [* 设备 号 ii 

40 struct cdev cdev; /* cdev A 

41 struct class *class; /* 3E DA 

42 struct device *device;  /* 设备 x 

43 int major; /* 主 设备 号 A 

44 int minor; /* 次 设备 号 ur 

45 struct device node *nd; /* We ur 

46 int leed gpio; /* key 所 使 用 的 GPIO 编号 

47 int timeperiod; /* 定时 周期 ,单位 为 ms my 

48 struct timer list timer; /* X PENs */ 

49 spinlock t lock; /* 定义 自 旋 锁 n 

50 y; 

sd 

52 struct timer dev timerdev; /* timer A n 

59 

54 /* 

55 * @description : 初始 化 LED 灯 I0O，open 函数 打开 驱动 的 时 候 

56 * 初始 化 LED 灯 所 使 用 的 Gero 引 脚 。 

57  * Qparam TS 

58  * Qreturn 8 2B 

59 x 

S0 tatie ime diexol imit (vonc) 

61 { 

62 int ret 2 0; 

63 

64 timerdev.nd = of find node by path("/gpioled"); 

65 if (timerdev.nd-- NULL) ( 

66 return -EINVAL; 

67 } 

68 

69 timerdev.led gpio = of get named gpio(timerdev.nd ,"led-gpio", 
0); 

70 if (timerdev.led gpio « 0) ( 
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gal ER oan de, (rene. Meo ee 

72 return -EINVAL; 

73 ) 

74 

75 /* II lea 所 使 用 的 IO */ 

76 gpio request (timerdev.led gpio, "deo p /* iik IO EA 
TE ret = epulo direction output (timsroer. led golo, 195 

78 if(ret « O) ( 

79 printk (canit set peu) Wie wa) e 

80 } 

81 return 0; 

8200 

9E 

84 /* 

85  * Qdescription : 打开 设备 


86  * (param - inode : 传递 给 驱动 的 inode 
87  * @param - filp : 设备 文件 file 结构 体 有 个 叫做 private_data 的 成 员 变量 





it 


88 S 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
89  * Qreturn : 0 成 功 ;其 他 失败 

9 — wp 

Zl Statie imt timer Open l(otruct inode usce, struct Tile wil) 
S| 

95 int ret = 0; 

94 filp-»private data = &timerdev; /* 设置 私有 数据 2 
95 

96 timerdev.timeperiod = 1000; /* 默认 周期 为 1s iA 
97 ret = led init(); /* 初始 化 IED IO ir 
98 if (ret <0) f 

29 return ret; 

100 } 

ORN return 0; 

102 ] 

IOS 

104 /* 

105 * QGdescription  : ioctl HL, 


106 * @param - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 
107 * Qparam - cmd  : 应 用 程序 发 送 过 来 的 命令 





108 * (Qparam - arg : 参数 
109 * QGreturn : 0 成 功 ;其 他 失败 
ibi) s 


I1 statie long timer unlocked ioctl (estruci tile wiil, 
unsigned int cmd, unsigned long arg) 


JE. 1] 
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ale; struct timer dey vdev = (otruct timer dev t5) ixdp--1xuibwenwe data, 
114 int timerperiod; 
d) unsigned long flags; 
116 
arg switch (cmd) ( 
118 case CLOSE CMD: /* 关闭 定时 器 i 
TAS) del timer sync(&dev-»timer); 
120 break; 
"at case OPEN CMD: /* 打开 定时 器 =f 
12727 Spin lock irqsave(&dev-»lock, flags); 
IZS timerperiod = dev->timeperiod; 
124 spin unlock irqrestore(&dev-»2lock, flags); 
1225) mod timer(&dev-»timer, jiffies * 
meets to Jitiies(tinerperiroch))) y 
T26 break; 
127 case SETPERIOD CMD: /* 设置 定时 器 周期 ” */ 
3728 spin lock irqsave(&dev-»lock, flags); 
129 dev->timeperiod = arg; 
30 spin unlock irqrestore(&dev-»lock, flags); 
T31 moc! timer (cdey->timer, jitiies i- meecs to jJitiies(arg)) 7 
dL SIS break; 
1,519) default: 
134 break; 
1/95] ) 
1S6 return 0; 
le 
138 
139 /* 设备 操作 函数 */ 
140 statie struct Tile operations timer = 
141 .Owner = THIS MODULE, 
142 .open - timer open, 
143 Unlocked Loctl = timer unlocked Ne 
144 ); 
145 


146 /* 定时 器 回调 函数 */ 


147 void timer function(unsigned long arg) 


148 ( 

149 gtruct timer Cey wey C3 (struct timer dev wharo; 
T50 statie me ta =mi 

T5 int timerperiod; 

Ho unsigned long flags; 

1155/3) 

154 sta = letag /* 每 次 都 取 反 ， 实 现 LED 灯 反 转 */ 
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TS] gelo set welwue(cew--lesc golo, sua); 
156 
157 /* 重启 定时 器 */ 
158 spin lock irqsave(&dev-»lock, flags); 
1559 timerperiod = dev-»timeperiod; 
160 spin unlock irqrestore(&dev-»lock, flags); 
ilk lt mod timer ele rs tebe Jaiiogles v 
msecs to jiffies(dev-»timeperiod)); 
dH 
163 
IL s 
165 * Qdescription  : 驱动 入 口 函 数 
166 * Qparam B zb 
167 * Qreturn e JE 
JG. t 
1(95) gracie ime _ init cimer imit (Toch 
170 ( 
Hd /* 初始 化 自 旋 锁 */ 
db 712 spin lock init(&timerdev.lock); 
I3 


i74 /* 注册 字符 设备 驱动 */ 
175 /* 1. Gs S */ 


























176 if (timerdev.major) ( J* ENTRES */ 

iPy m timerdev.devid = MKDEV(timerdev.major, 0); 

1578 register chrdev region(timerdev.devid, TIMER CNT, 
TIMER NAME); 

179 ) eise ( /* 没有 定义 设备 号 */ 

180 alloc chrdev region(&timerdev.devid, 0, TIMER CNT, 














TIMER NAME); 





























181 timerdev.major 2 MAJOR(timerdev.devid); /* 获取 主 设备 号 */ 
182 timerdev.minor = MINOR (timerdev.devid); /* 获取 次 设备 号 */ 
183 } 

184 

185 /* 2. 初始化 Cedev */ 

186 timerdev.cdev.owner = THIS MODULE; 

187 cdev init(&timerdev.cdev, &timer fops); 

188 

189 /* 3. WSn—^h cdev */ 

90 cdev add(&timerdev.cdev, timerdev.devid, TIMER CNT); 

191 

192 /* 4、 创建 类 */ 

193 timerdev.class © class create(THIS MODULE, TIMER NAME); 

194 a ta (ess PERR (meneer as 
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i95 return PTR ERR(timerdev.class); 

196 ) 

239) gj 

198 /* 5. BEER */ 

199 timerdev.device - device create(timerdev.class, NULL, 
timerdev.devid, NULL, TIMER NAME); 

200 eus (I5 ERR (timsrdey lr ie) 

A0 return PTR ERR(timerdev.device); 

202 ) 

203 


204 /* 6、 初 始 化 timer， 设 置 定 时 器 处 理 函 数 , 还 未 设置 周期 ， 所 有 不 会 激活 定时 器 */ 


205 init timer(&timerdev.timer); 











206 timerdev.timer.function = timer function; 

AOT timerdev.timer.data = (unsigned long)&timerdev; 

208 return 0; 

209) 

210 

ZdL. fe 

212 * Qdescription : 驱动 出 口 函 数 

213 è G8param 8 JE 

214 * Qreturn 8 3E 

Qus. E 

Zl Starcie volc ^ exit timer (xb (voici) 

ZA. d 

2/18 

219 gpio set value(timerdev.led gpio, 1); /* SIEXUKZJBJNHAOSBHILED */ 
220 del timer syne (Crtrimerdev, tiner) g /* MR timer */ 
221 fif 0 

222! del timer(&timerdev.tiemr); 

223 #endif 

224 

PES /* 注销 字符 设备 驱动 */ 

226 cdev del(&timerdev.cdev); /* 删除 caev */ 
AI unregister chrdev region(timerdev.devid, TIMER CNT); 
229 

229 device destroy (timerdey Class, Cimerdev le 

230 ellas cessio (me nl ves) 

Z9 

292 


25:3 module init (timer init)? 

25/4 module exit (timer exit) p 

235 MODULE LICENSE ("GPL"); 

236 MODULE AUTHOR ("zuozhongkai"); 
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第 38-50 行 ， 定 时 器 设备 结构 体 ， 在 48 行 定 义 了 一 个 定时 器 成 员 变 量 timer. 
第 60-82 fT, LED 灯 初 始 化 函数 ， 从 设备 树 中 获取 LED 灯 信 息 ， 然 后 初始 化 相应 的 IO。 


























第 91~102 行 ， 函 数 timer_open， 对 应 应 用 程序 的 open 函数 ， 应 用 程序 调用 open 函数 打开 

/dev/timer 驱动 文件 的 时 候 此 函数 就 会 执行 。 此 函数 设置 文件 私有 数据 为 tmerdev， 并 且 初 始 化 
定时 周期 默认 为 1 秒 ， 最 后 调用 led init 函数 初始 化 LED 所 使 用 的 IO。 
第 111-137 行 ， 函 数 timer unlocked ioctl， 对 应 应 用 程序 的 ioctl 函数 ， 应 用 程序 调用 ioctl 
函数 向 驱动 发 送 控制 信息 ， 此 函数 响应 并 执行 。 Sen Mn filp, cmd 和 arg， 其 中 filp 
是 对 应 的 设备 文件 ，cmd 是 应 用 程序 发 送 过 来 的 命令 信息 ，arg 是 应 用 程序 发 送 过 来 的 参数 ,在 
本 章 例 程 中 arg 参数 表示 定时 周期 。 

一 共有 三 种 命令 CLOSE CMD, OPEN CMD 和 SETPERIOD_CMD， 这 三 个 命令 分 别 为 关 
闭 定时 器 、 打 开 定 时 器 、 设 置 定 时 周期 。 这 三 个 命令 的 左右 如 下 : 

CLOSE CMD: 关闭 定时 器 命令 ， 调 用 del timer sync 函数 关闭 定时 器 。 

OPEN CMD: 打开 定时 器 命令 , 调用 mod timer 函数 打开 定时 器 ,定时 周期 为 timerdev 的 
timeperiod 成 员 变量 ， 定 时 周期 默认 是 1 秒 。 

SETPERIOD CMD: 设置 定时 器 周期 命令 ， 参 数 arg 就 是 新 的 定时 周期 ， 设 置 timerdev 的 
timeperiod 成 员 变 量 为 arg 所 表示 定时 周期 指 。 并 且 使 用 mod. timer 重新 打开 定时 器 ， 使 定时 器 
以 新 的 周期 运行 。 

第 140-144 行 ， 定 时 器 驱动 操作 函数 集 timer. fops. 

第 147-162 ÍT, PAŽI timer function， 定 时 器 服务 函数 ， 此 函 有 一 个 参数 arg， 在 本 例 程 中 
arg 参数 就 是 timerdev 的 地 址 ， 这 样 通过 arg 参数 就 可 以 访问 到 设备 结构 体 。 当 定时 周期 到 了 以 
后 此 函数 就 会 被 调用 。 在 此 函数 中 将 LED 灯 的 状态 取 反 ， 实 现 LED 灯 闪 烁 的 效果 。 因 为 内 核 
定时 器 不 是 循环 的 定时 器 ， 执 行 一 次 以 后 就 结束 了 ， 因 此 在 161 行 又 调用 了 mod timer 函数 重 
新 开启 定时 器 。 

第 169-209 行 ， 函 数 timer_init， 驱 动 入 口 函 数 。 在 第 205~207 行 初 始 化 定时 器 ， 设 置 定时 
器 的 定时 处 理 函 数 为 timer_function， 另 外 设置 要 传递 给 timer function 函数 的 参数 为 timerdev。 
在 此 函数 中 并 没有 调用 timer. add 函数 来 开启 定时 器 , 因此 定时 器 默认 是 关闭 的 , 除非 应 用 程序 
发 送 打开 命令 。 

第 216~231 ÍT, IZH LIBE, E 219 行 关闭 LED， 也 就 是 邱 载 驱动 以 后 LED Ab T4587 
状态 。 第 220 行 调用 del timer sync 函数 删除 定时 器 ， 也 可 以 使 用 del timer 函数 。 
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50.3.3 编写 测试 APP 


测试 APP 我 们 要 实现 的 内 容 如 下 : 
QD). 3&fr APP 以 后 提示 我 们 输入 要 测试 的 命令 , 输入 1 表示 关闭 定时 器 、 输 入 2 表示 打开 
定时 器 ， 输 入 3 设置 定时 器 周期 。 
、 如 果 要 设置 定时 器 周期 的 话 ， 需 要 让 用 户 输 入 要 设置 的 周期 值 ， 单 位 为 毫秒 。 
新 建 名 为 timerApp.c 的 文件 ， 然 后 输入 如 下 所 示 内 容 : 
示例 代码 50.3.2.2 timerApp.c 文件 代码 段 


ame ele "seio mV 



































finclude "unistd.h" 
lude "sys/types.h" 
finclude "sys/stat.h" 
finclude "fcntl.h" 


tee sto 





op Ele et 
- 
H 
je) 
Q 
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7 $include "string.h" 


5. neue "Jes oe IL z Im" 


9 J[ KCKCKCKCk kk kk kk kk kk ck Ck ckCkckCkckckckckckckck ckck ck k ckckckckckckckckckck ckck ck ck ckck ck ck ckck ck ck ck ck ck ck ck ck ko 





0 ootenme CONS SIRISRINDPISEU SI c Meee le 20295 A omnes reseed 


















































11 文件 名 : timerApp.c 

12 fea : cL 

13 版 本 TO 

14 描述 : 定时 器 测试 应 用 程序 

15 其 他 $207 

16 使 用 方法 : ./timertest /dev/timer PTAA App 

TIBIAS : www.openedv.com 

18 Ea : 初版 V1.0 2019/7/24 左 忠 凯 创建 

19 KCKCKCKCKCKCkCkCkCk k kk k kk Ck kCk Ck k kk k kc k k kc k Ck k Ck Ck kCk Ck k kk k kk k kc k Ck kck ck kck ck ckck ck ckckck kk kk f 
20 

a EE 

22 #define CLOSE CMD ( IO(0XEF, 0x1)) /* 关闭 定时 器 
23 #define OPEN CMD (_IO(0XEF, 0x2)) /* 打开 定时 器 e 
24 #define SETPERIOD CMD (_IO(0XEF, 0x3)) /* 设置 定时 器 周期 命令 */ 
25 

QUO EE 

27 * Qdescription : main 主 程序 

28 * Qparam - argo  : A A 

29 * Qparam - argv : 有 具体 参数 

30 * Qreturn : 0 成 功 ;其 他 失败 

Se 

Sn (en hi 

SES 

34 ne Eolo ESLA 

ES char *filename; 

36 unsigned int cmd; 

Si unsigned int arg; 

38 unsigned char str[100]; 

n9 

40 if (arge "= 2) ( 

41 [rer (0 non sae 

42 return -1; 

43 } 

44 

45 filename = argv[!]; 

46 

47 fd = open(filename, O RDWR); 

48 aiz (mel «s Od 

49 printf("Can't open file %s\r\n", filename); 
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50 return -1; 

Sa } 

52 

53 while (1) { 

54 人 下 全 人) 

55 ret = scanf("$d", &cmd); 

56 an (eet T /* 参数 输入 错误 2 
57 gets (str); /* 防止 卡 死 /A 
58 } 

S 

60 serenus == d /* KH] LED JT a 
61 cmd > CLOSE CMD; 

62 else if(cmd == 2) ya qi iu 
8B cmd — OPEN CMD; 

64 else if(cmd == 3) ( 

65 cmd = SETPERIOD CMD; /* 设置 周期 值 “y 
66 printf("Input Timer Period:"); 

67 ret = scanf("$d", &arg); 

68 az (ret ls 1) 4 /* 参数 输入 错误 a 
69 gets (str); /* 防止 卡 死 Wy 
70 ) 

qat } 

"a ioctl(fd, cmd, arg); /* 控制 定时 器 的 打开 和 关闭 */ 
7/5) ) 

74 close(fd); 

qi ) 


第 22-24 fT, dip MH. 

第 53-73 行 ，while(1) 循 环 ， 让 用 户 输入 要 测试 的 命令 ， 然 后 通过 第 72 行 的 ioctl 函数 发 送 
给 驱动 程序 。 如果 是 设置 定时 器 周期 命令 SETPERIOD CMD, 那么 ioctl 函数 的 arg 参数 就 是 用 
户 输入 的 周期 值 。 


























50.4 运行 测试 
50.4.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱 动 程序 

编写 Makefile 文件 ， 本 章 实 验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 timer.o，Makefile 内 容 如 下 所 示 : 
示例 代码 50.4.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 


























rel imz 4.1.15 2,150 ga alisntek 
4 obj-m := timer.o 
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Te] elle any 
12 S$(MAKE) -C $ (KERNELDIR) M=$ (CURRENT PATH) clean 




















第 4 行 ， 设 置 obj-m 变量 的 值 为 ttmero。 

输入 如 下 命令 编译 出 驱动 模块 文件 : 

make -j32 

编译 成 功 以 后 就 会 生成 一 个 名 为 “timer.ko” 的 驱动 模块 文件 。 
2、 编 译 测试 APP 

输入 如 下 命令 编译 测试 timerApp.c 这 个 测试 程序 : 


arm-linux-gnueabihf-gcc timerApp.c -0 timerApp 


编译 成 功 以 后 就 会 生成 timerApp 这 个 应 用 程序 。 











50.4.2 运行 测试 


将 上 一 小 节 编 译 出 来 的 timer.ko 和 timerApp 这 两 个 文件 拷贝 到 rootfs/lib/modules/4.1.15 H 
录 中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 加 载 timer.ko 驱动 模块 : 

depmod // 第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 

modprobe timer.ko // 加 载 驱 动 

驱动 加 载 成 功 以 后 如 下 命令 来 测试 : 

.timerApp  /dev/timer 

输入 上 述 命 令 以 后 终端 提示 输入 命令 ， 如 图 50.4.2.1 所 示 : 


/lib/modules/4.1.15 # ./timerApp /dev/timer 
Input CMD: 














图 50.4.2.1 输入 命令 
输入 “2” 打开 定时 器 ， 此 时 LED 灯 就 会 以 默认 的 1 秒 周 期 开始 闪烁 。 在 输入 “3” 来 设 
置 定 时 周期 ， 根 据 提示 输入 要 设置 的 周期 值 ， 如 图 50.4.2.2 所 示 : 
Input CMD:3 
Input Timer Period: 
图 50.4.2.2 设置 周期 值 
输入 “500”， 表示 设置 定时 器 周期 值 为 500ms， 设 置 好 以 后 LED 灯 就 会 以 500ms 为 间隔 ， 
开始 闪烁 。 最 后 可 以 通过 输入 “1?” 来 关闭 定时 器 ， 如 果 要 御 载 驱动 的 话 输入 如 下 命令 即 可 : 


rmmod timer.ko 



































1227 


LMX6U AR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


第 五 十 一 章 Linux 中 断 实 验 


不 管 是 裸 机 实验 还 是 Linux 下 的 驱动 实验 ， 中 断 都 是 频繁 使 用 的 功能 ， 关 于 LMX6U 的 中 
断 原理 已 经 在 第 十 七 章 做 了 详细 的 讲解 ， 在 裸 机 中 使 用 中 断 我 们 需要 做 一 大 堆 的 工作 ， 比 如 配 
置 寄存 器 ， 使 能 IRQ 等 等 。Linux 内 核 提 供 了 完善 的 中 断 框架 ， 我 们 只 需要 申请 中 断 ， 然 后 注 
册 中 断 处 理 函 数 即 可 ， 使 用 非常 方便 ， 不 需要 一 系列 复杂 的 寄存 器 配置 。 本 章 我 们 就 来 学 习 一 
下 如 何在 Linux 下 使 用 中 断 。 
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51.1 Linux 中 断 简 介 


51.1.1 Linux 中 断 API 函数 


先 来 回顾 一 下 裸 机 实验 里 面 中 断 的 处 理 方法 : 

QD、 使 能 中 断 ， 初 始 化 相应 的 寄存 器 。 

@、 注 册 中 断 服 务 函数 ， 也 就 是 向 irqTable 数组 的 指定 标号 处 写 入 中 断 服务 函数 

@、 中 断 发 生 以 后 进入 IRQ 中 断 服 务 函 数 , 在 IRQ 中 断 服务 函数 在 数组 irqTable 里 面 查找 
具体 的 中 断 处 理 函 数 ， 找 到 以 后 执行 相应 的 中 断 处 理 函 数 。 
fr Linux 内 核 中 也 提供 了 大 量 的 中 断 相 关 的 API 函数 ， 我 们 来 看 一 下 这 些 跟 中 断 有 关 的 
API 函数 : 

1、 中 断 号 

每 个 中 断 都 有 一 个 中 断 号 ， 通 过 中 断 号 即 可 区 分 不 同 的 中 断 ， 有 的 资料 也 把 中 断 号 叫做 中 
断 线 。 在 Linux 内 核 中 使 用 一 个 int 变量 表示 中 断 号 ， 关 于 中 断 号 我 们 已 经 在 第 十 七 章 讲 解 过 
T: 

2. request irq 函数 
在 Linux 内 核 中 要 想 使 用 某 个 中 断 是 需要 申请 的 ,request_irq 函数 用 于 申请 中 断 , request_irq 
函数 可 能 会 导致 睡眠 ， 因 此 不 能 在 中 断 上 下 文 或 者 其 他 禁止 睡眠 的 代码 段 中 使 用 request. irq K 
Zi. request irq 函数 会 激活 (使 能 ) 中 断 ， 所 以 不 需要 我 们 手动 去 使 能 中 断 ，request_ irq 函数 原型 
如 下 : 


int request irq(unsigned int irq, 



















































































irq handler t handler, 


unsigned long flags, 

const char *name, 

void *dev) 
函数 参数 和 返回 值 含 义 如 下 : 


irq: 要 申请 中 断 的 中 断 号 。 

handler: 中 断 处理 函 数 ， 当 中 断 发 生 以 后 就 会 执行 此 中 断 处 理 函 数 。 

flags: 中 断 标 志 ， 可 以 在 文件 include/linux/interrupt.h 里 面 查看 所 有 的 中 断 标 志 ， 这 里 我 们 
介绍 几 个 常用 的 中 断 标志 ， 如 表 51.1.1.1 所 示 : 





























多 个 设备 共享 一 个 中 断 线 , 共享 的 所 有 中 断 都 必须 指定 此 标志 。 











IRQF SHARED 如 果 使 用 共享 中 断 的 话 ，request_irq 函数 的 dev 参数 就 是 唯一 
区 分 他 们 的 标志 
IRQF ONESHOT 单 次 中 断 ， PA OE: 





IRQF TRIGGER NONE 无 触发 。 
IRQF TRIGGER RISING | 上 升 沿 触发 。 
IRQF TRIGGER FALLING | 下 降 沿 触发 。 
IRQF TRIGGER HIGH 高 电 平 触发 
IRQF TRIGGER LOW 低 电 平 触发 。 

表 51.1.1.1 常用 的 中 断 标志 
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比如 I.MX6U-ALPHA 开发 板 上 的 KEY0 使 用 GPIO1 IO03， 按 下 KEY0 以 后 为 低 电 平 ， 
此 可 以 设置 为 下 降 沿 触发 ， 也 就 是 将 flags 设置 为 了 QF _ TRIGGER FALLING。 表 51.1.1.1 中 的 
这 些 标志 可 以 通过 “|” 来 实现 多 种 组 合 。 

















name: 中 断 名 字 ， 设 置 要 以 后 可 以 在 /proc/interrupts 文件 中 看 到 对 应 的 中 断 名 字 。 

dev: 如 果 将 flags 设置 为 耻 QF_ SHARED 的话 ，dev 用 来 区 分 不 同 的 中 断 ， 一 般 情况 下 将 
dev 设置 为 设备 结构 体 ，dev 会 传递 给 中 断 处 理 函 数 irq_handler t 的 第 二 个 参数 。 

返回 值 : 0 中 断 申 请 成 功 ， 其 他 负 值 中 断 申 请 失败 ， 如 果 返 回 -EBUSY 的 话 表 示 中 断 已 经 
被 申请 了 。 

3. free irq 函数 

使 用 中 断 的 时 候 需 要 通过 request irq 函数 申请 ， 使 用 完成 以 后 就 要 通过 free irq 函数 释放 
掉 相 应 的 中 断 。 如 果 中 断 不 是 共享 的 , 那么 free_irq 会 删除 中 断 处 理 函 数 并 且 禁 止 中 断 。free_irq 
函数 原型 如 下 所 示 : 

void free irq(unsigned int irq, 

void *dev) 

函数 参数 和 返回 值 含义 如 下 : 

irq: ERI HP Br 

dev: 如 果 中 断 设置 为 共享 IRQF_SHARED) 的 话 ， 此 参数 用 来 区 分 具体 的 中 断 。 共 享 中 断 
只 有 在 释放 最 后 中 断 处 理 函 数 的 时 候 才 会 被 禁止 掉 。 

返回 值 : 无 。 

4、 中 断 处 理 函 数 


使 用 request_irq 函数 申请 中 断 的 时 候 需 要 设置 中 断 处 理 函 数 , 中断 处 理 函 数 格式 如 下 所 示 : 

irqreturn t (*irq handler t) (int, void *) 

第 一 个 参数 是 要 中 断 处 理 函 数 要 相应 的 中 断 号 。 第 二 个 参数 是 一 个 指向 void 的 指针 ， 也 就 
是 个 通用 指针 ， 需 要 与 request irq 函数 的 dev 参数 保持 一 致 。 用 于 区 分 共享 中 断 的 不 同 设备 ， 
dev 也 可 以 指向 设备 数据 结构 。 中 断 处 理 函 数 的 返回 值 为 irqreturn_t 类 型 ，irqreturn t 类 型 定义 
如 下 所 示 : 














































































































































































































示例 代码 51.1.1.1 irgreturn t 4t 

















10 enum irqreturn ( 

ii IRQ NONE = (0 << 0), 
212 IRO HANDLED = (1 << 0), 
13 IRQ WAKE THREAD = (1 << 1), 
14 } 

15 


16 typedef enum irqreturn irqgreturn t; 

可 以 看 出 irqreturn. t 是 个 枚 举 类 型 ， 一 共有 三 种 返回 值 。 一 般 中 断 服务 函数 返回 值 使 用 如 
下 形式 : 

return IRQ RETVAL(IRQ HANDLED) 

S、 中 断 使 能 与 禁止 函数 
常用 的 中 断 使 用 和 禁止 函数 如 下 所 示 : 


void enable irq(unsigned int irq) 





























void disable irq(unsigned int irq) 
enable irq 和 disable irq 用 于 使 能 和 禁止 指定 的 中 断 ，irq 就 是 要 禁止 的 中 断 号 。disable_irq 
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函数 要 等 到 当前 正在 执行 的 中 断 处 理 函 数 执行 完 才 返回 ， 因 此 使 用 者 需要 保证 不 会 产生 新 的 中 
断 ， 并 且 确 保 所 有 已 经 开始 执行 的 中 断 处 理 程序 已 经 全 部 退出 。 在 这 种 情况 下 ， 可 以 使 用 另外 
一 个 中 断 禁 止 函 数 : 
void disable irq nosync(unsigned int irq) 
disable irq nosync 函数 调用 以 后 立即 返回 ， 不 会 等 待 当前 中 断 处 理 程序 执行 完毕 。 上 面 三 
个 函数 都 是 使 能 或 者 禁止 某 一 个 中 断 ， 有 时 候 我 们 需要 关闭 当前 处 理 器 的 整个 中 断 系统 ， 也 就 
是 在 学 习 STM32 的 时 候 常 说 的 关闭 全 局 中 断 ， 这 个 时 候 可 以 使 用 如 下 两 个 函数 : 
local irq enable() 
























































local irq disable() 

local irq enable 用 于 使 能 当前 处 理 器 中 断 系 统 ，local irq disable 用 于 禁止 当前 处 理 器 中 断 
系统 。 假 如 A 任务 调用 local irq disable 关闭 全 局 中 断 10S， 当 关闭 了 2S 的 时 候 B 任务 开始 运 
fr, B 任务 也 调用 local irq disable 关闭 全 局 中 断 3S, 3 秒 以 后 B 任务 调用 local irq enable PR 
数 将 全 局 中 断 打 开 了 。 此 时 才 过 去 243-5 秒 的 时 间 ， 然 后 全 局 中 断 就 被 打开 了 ， 此 时 A 任务 要 
关闭 10S 全 局 中 断 的 愿望 就 破灭 了 ， 然 后 A 任务 就 “生气 了 ” 结果 很 严重 ， 可 能 系统 都 要 被 
A 任务 整 朋 溃 。 为 了 解决 这 个 问题 ，B 任务 不 能 直接 简单 粗暴 的 通过 local irq enable 函数 来 打 
开 全 局 中 断 ， 而 是 将 中 断 状态 恢复 到 以 前 的 状态 ， 要 考虑 到 别 的 任务 的 感受 ， 此 时 就 要 用 到 下 
面 两 个 函数 : 

local irq save(flags) 








































































































local irq restore(flags) 
这 两 个 函数 是 一 对 ，local irq save 函数 用 于 禁止 中 断 ， 并 且 将 中 断 状态 保存 在 flags 中 。 
local irq restore 用 于 恢复 中 断 ， 将 中 断 到 flags 状态 。 





51.1.2 上 半 部 与 下 半 部 


在 有 些 资 料 中 也 将 上 半 部 和 下 半 部 称 为 顶 半 部 和 底 半 部 ， 都 是 一 个 意思 。 我 们 在 使 用 
request_irq 申请 中 断 的 时 候 注册 的 中 断 服务 函数 属于 中 断 处 理 的 上 半 部 ， 只 要 中 断 触发 ， 那 么 
中 断 处 理 函 数 就 会 执行 。 我 们 都 知道 中 断 处 理 函 数 一 定 要 快 点 执行 完毕 ， 越 短 越 好 ， 但 是 现实 
往往 是 残酷 的 ， 有 些 中 断 处 理 过 程 就 是 比较 费时 间 ， 我 们 必须 要 对 其 进行 处 理 ， 缩 小 中 断 处 理 
函数 的 执行 时 间 。 比 如 电容 触摸 屏 通过 中 断 通知 SOC 有 触摸 事件 发 生 ，SOC 响应 中 断 ， 然 后 
通过 IIC 接口 读 取 触摸 坐标 值 并 将 其 上 报 给 系统 。 但 是 我 们 都 知道 IC 的 速度 最 高 也 只 有 
400KbitS， 所 以 在 中 断 中 通过 IC 读 取 数据 就 会 浪费 时 间 。 我 们 可 以 将 通过 IC 读 取 触摸 数据 
的 操作 暂 后 执行 ， 中 断 处 理 函 数 仅仅 相应 中 断 ， 然 后 清除 中 断 标志 位 即 可 。 这 个 时 候 中 断 处 理 
过 程 就 分 为 了 两 部 分 : 

上 半 部 : 上 半 部 就 是 中 断 处 理 函 数 ， 那 些 处 理 过 程 比较 快 ， 不 会 占用 很 长 时 间 的 处 理 就 可 
以 放 在 上 半 部 完成 。 

下 半 部 : 如 果 中 断 处 理 过 程 比较 耗 时 ， 那 么 就 将 这 些 比 较 耗 时 的 代码 提出 来 ， 交 给 下 半 部 
去 执行 ， 这 样 中 断 处 理 函 数 就 会 快 进 快 出 。 

因此 ，Linux 内 核 将 中 断 分 为 上 半 部 和 下 半 部 的 主要 目的 就 是 实现 中 断 处 理 函 数 的 快 进 快 
出 ， 那 些 对 时 间 敏 感 、 执 行 速度 块 的 操作 可 以 放 到 中 断 处 理 函 数 中 ， 也 就 是 上 半 部 。 剩 下 的 所 
有 工作 都 可 以 放 到 下 半 部 去 执行 ， 比 如 在 上 半 部 将 数据 拷贝 到 内 存 中 ， 关 于 数据 的 具体 处 理 就 
可 以 放 到 下 半 部 去 执行 。 至 于 哪些 代码 属于 上 半 部 ， 哪 些 代码 属于 下 半 部 并 没有 明确 的 规定 ， 
一 切 根 据 实际 使 用 情况 去 判断 ， 这 个 就 很 考研 驱动 编写 人 员 的 功底 了 。 这 里 有 一 些 可 以 借鉴 的 










































































































































































































































































CD、 如 果 要 处 理 的 内 容 不 希望 被 其 他 中 断 打 断 ， 那 么 可 以 放 到 上 半 部 。 
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的 任务 对 时 间 敏 感 ， 
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的 任务 与 硬件 有 关 ， 
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可 以 放 到 上 半 部 。 
可 以 放 到 上 半 部 








nu 


、 除 了 上 述 三 点 以 外 的 其 他 任务 ， 优 先 考虑 放 到 下 半 部 。 




















上 上 半 部 处 理 很 简单 ， 直 接 编 
核 提供 了 多 种 下 半 部 机 制 ， 接 下 来 我 们 来 学 习 一 下 这 些 下 半 部 机 制 。 


1、 软 中 断 


一 开始 Linux 内 核 提供 了 “bootom half” 机 制 来 实现 下 半 部 ， 简 称 “BH”。 后 
央 ， 完 全 可 以 使 用 软 中 断 和 taskled RER BH, M 2.5 版 本 的 Linux 
内 核 开始 BH 已 经 被 抛弃 了 。Linux 内 核 使 用 结构 体 softirq_action 表示 软 中 断 ， 


ETAN tasklet RË “BH” HLH 
































写 中 断 处 理 函 数 就 行 了 ， 关 键 是 下 半 部 该 怎么 做 昵 ? Linux 内 








KE 





再 引 入 了 软 中 
































softirq_action 


结构 体 定义 在 文件 include/linux/interrupt.h 中 ， 内 容 如 下 : 
示例 代码 51.1.2.1 softirq_action 结构 体 


433 
434 ( 
435 void 
436 ); 
在 kernel/softirq 





statie struct sortire GE 


ShEGBIGNE gõirtira cCriom 














.c 文件 中 一 





(Cecrion) (Struct sottira action whe 


定义 了 10 个 软 中 断 ， 如 下 所 示 : 
示例 代码 51.1.2.2 softirq_vec 数组 
Pone OnE CNRS OERO S 








NR SOFTIRQS 是 枚 举 类 型 ， 定 义 在 文件 include/linux/interrupt.h 中 ， 定 义 如 下 : 
示例 代码 51.1.2.3 softirq_vec 数组 




















enum 

{ 
HI SOFTIRQ-0, (s 
TIMER SOFTIRQ, n 
NET TX SOFTIRG, Lil 
NET RX SOFTIRQ, ps 
BLOCK SOFTIRQ, 
BLOCK IOPOLL SOFTIRQ, 
TASKLET SOFTIRQ, 205 
SCHED SOFTIRQ, pe 
HRTIMER SOFTIRQ, os 
RCU SOFTIRQ, [5 


NR SOFTIROS 








高 优先 级 软 中 断 a 
定时 器 软 中 断 x 
KRE REE ” */ 
网 络 数据 接收 软 中 断 ” */ 
tasklet $P Wr AU 
调度 软 中 断 */ 
高 精度 定时 器 软 中 断 ” */ 
RCU 软 中 断 


可 以 看 出 ， 一 共有 10 个 软 中 断 ， 因 此 NR_SOFTIRQS 为 10， 因 此 数组 softirq vec 有 10 个 
元 素 。softirq_action 结构 体 中 的 action 成 员 变 量 就 是 软 中 断 的 服务 函数 ， 数 组 softirq_vec 是 个 


全 局 数组 ， 
控制 机 制 |， 并 且 




















只 执行 自 











因此 所 有 的 CPU( 对 于 SMP 系统 而 言 ) 都 可 以 访问 到 ， 每 个 CPU 都 有 自己 的 触发 和 
己 所 触发 的 软 中 断 。 但 是 各 个 CPU 所 执行 的 软 中 断 服 务 函数 确 是 相同 








的 ， 都 是 数组 softirq_vec 中 定义 的 action 函数 。 要 使 用 软 中 断 ， 必 须 先 使 用 open softirq 函数 注 


册 对 应 的 软 中 断 处 理 





函数 ，open_softirq 函数 原型 如 下 : 


void open softirq(int nr, void (*action)(struct softirq action *)) 


函数 参数 和 返回 值 含 义 如 下 : 
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nr: 要 开启 的 软 中 断 ， 在 示例 代码 51.1.2.3 中 选择 一 个 。 

action: 软 中 断 对 应 的 处 理 函 数 。 

返回 值 : 没有 返回 值 。 

注册 好 软 中 断 以 后 需要 通过 raise softirq 函数 触发 ，raise_softirq 函数 原型 如 下 : 

void raise softirq(unsigned int nr) 

函数 参数 和 返回 值 含 义 如 下 : 

nr: 要 触发 的 软 中 断 ， 在 示例 代码 51.1.2.3 中 选择 一 个 。 

返回 值 : 没有 返回 值 。 

软 中 断 必 须 在 编译 的 时 候 静 态 注 册 ! Linux 内 核 使 用 softirq init. 函数 初始 化 软 中 断 ， 
softirq init 函数 定义 在 kernel/softirq.c 文件 里 面 ， 函 数 内 容 如 下 : 

示例 代码 51.1.2.4 softirq_init 函数 内 容 

SBSa yonel  — oe (vonc 


























635i 

636 dai CUS 

637 

638 for each possible cpu(cpu) i 

639 per cpultasklet vec, Cp) -tail = 

640 &per cpu(tasklet vec, cpu).head; 

641 per Gpu(ltesklet hi sexe, Cpu) -teil 三 

642 Gper cpu(tasklet hi vee, Cpu) -neac 
643 } 

644 

645 open softirq(TASKLET SOFTIRQ, tasklet action); 
646 open softirq(HI SOFTIRQ, tasklet hi action); 
647 ) 





从 示例 代码 51.1.24 可 以 看 出 ，softirq init. 函数 默认 会 打开 TASKLET SOFTIRQ 和 
HI SOFTIRQ. 


2. tasklet 


tasklet 是 利用 软 中 断 来 实现 的 另外 一 种 下 半 部 机 制 ， 在 软 中 断 和 tasklet 之 间 ， 建 议 大 家 使 
用 tasklet. Linux 内 核 使 用 结构 体 
示例 代码 51.1.2.5 tasklet struct 结构 体 
Se he ve 

















485 { 

486 SiO ole et ict roc We n 

487 unsigned long state; /* tasklet 状态 a 

488 atomie t count, /* 计数 器 ， 记 录 对 tasklet 的 引用 数 */ 
489 void (*func) (unsigned long); /* tasklet 执行 的 函数 */ 

490 unsigned long data; /* E func 的 参数 i 

491 ); 














第 488 行 的 func 函数 就 是 tasklet 要 执行 的 处 理 函 数 , 用 户 定 义 函 数 内 容 ， 相 当 于 中 断 处 理 
函数 。 如 果 要 使 用 tasklet， 必 须 先 定义 一 个 tasklet， 然 后 使 用 tasklet init 函数 初始 化 tasklet， 
taskled init 函数 原型 如 下 ; 
void tasklet init(struct tasklet struct ^ *t, 
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void (*func)(unsigned long), 


unsigned long data); 

函数 参数 和 返回 值 含义 如 下 : 

t: 要 初始 化 的 tasklet 

func: tasklet 的 处 理 函 数 。 

data: 要 传递 给 func 函数 的 参数 

返回 值 ， 没有 返回 值 。 

也 可 以 使 用 宏 DECLARE TASKLET 来 一 次 性 完成 tasklet 的 定义 和 初始 化 ， 
DECLARE TASKLET 定义 在 include/linux/interrupt.h 文件 中 ， 定 义 如 下 : 

DECLARE TASKLET(name, func, data) 

其 中 name 为 要 定义 的 tasklet 名 字 ， 这 个 名 字 就 是 一 个 tasklet struct 类 型 的 时 候 变量 ，func 
就 是 tasklet 的 处 理 函 数 ，data 是 传递 给 func 函数 的 参数 。 
在 上 半 部 ， 也 就 是 中 断 处 理 函 数 中 调用 tasklet schedule 函数 就 能 使 tasklet 在 合适 的 时 间 运 
行 ，tasklet schedule 函数 原型 如 下 : 
void tasklet schedule(struct tasklet struct *t) 

函数 参数 和 返回 值 含义 如 下 : 

t: 要 调度 的 tasklet， 也 就 是 DECLARE TASKLET 宏 里 面 的 name. 

返回 值 ， 没有 返回 值 。 

关于 tasklet 的 参考 使 用 示例 如 下 所 示 : 

示例 代码 51.1.2.7 tasklet 使 用 示例 

/* 5E X. taselet */ 
struct tasklet struct ee 



































/* tasklet 处 理 函 数 i 
void testtasklet func(unsigned long data) 
( 


/* tasklet 具体 处 理 内 容 */ 


/* 中 断 处 理 函 数 */ 


ee ele el Gunsac vord wdey iel) 





/* 调度 tasklet */ 
tasklet schedule (ess) 





/* 驱动 入 口 函数 2 


ptarite ime _— imit erz imit (vonc) 


/* 初始 化 tasklet */ 
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tasklet inii (Gtesttasklet, testtasklet iune, caua); 


/* 注册 中 断 处 理 函 数 */ 


reduest ralz 1r; test handler, (0, "xe", Ceux CEV)? 


2、 工 作 队 列 


工作 队列 是 另外 一 种 下 半 部 执行 方式 ， 工 作 队 列 在 进程 上 下 文 执行 ， 工 作 队 列 将 要 推 后 的 
工作 交 给 一 个 内 核 线程 去 执行 ， 因 为 工作 队列 工作 在 进程 上 下 文 ， 因 此 工作 队列 允许 睡眠 或 如 
新 调度 。 因 此 如 果 你 要 推 后 的 工作 可 以 睡眠 那么 就 可 以 选择 工作 队列 ， 否 则 的 话 就 只 能 选择 软 
中 断 或 tasklet。 

Linux 内 核 使 用 work struct 结构 体 表示 一 个 工作 ， 内 容 如 下 (省 略 掉 条 件 编译 ): 

示例 代码 51.1.2.8 work. struct 结构 体 























pa 












































Sse ee work struck i 

atomie long t datar 

struct list head entry? 

work fune © Tune; /* 工作 队列 处 理 函 数 */ 
e 

这 些 工作 组 织 成 工作 队列 ， 工 作 队 列 使 用 workqueue struct 结构 体 表示 ， 内 容 如 下 (省 略 掉 
条 件 编译 ): 








T | 














示例 代码 51.1.2.9 workqueue. struct 结构 体 
struct workqueue struct ( 
struct liest neac pwqs; 
SEEUGE List neac lists 


EE 加 QE NES: mutex; 

ation. work color; 

het irlbwisym Colore 

atomie it mur jesse tO Flush 


struct wa Tlusner -filrst flusners 
struct list neac flusher queue; 
struct list neac flusher overflow; 


SEEUGE list neac maydays; 


struct worker *rescuer; 
Ne me drainer; 
int saved max active; 


struct workqueue attrs *unbound attrs; 


struct pool workqueue  *dfl pwq; 














char name [WO NAME LEN]; 
SECUCE FEU Near TUP 
unsigned int flags cacheline aligned; 


struct pool workqueue . percpu *cpu pwqs; 


struct pool workqueue . rcu *numa pwq tbl[]l; 
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Linux 内 核 使 用 工作 者 线程 (worker thred) 来 处 理工 作 队 列 中 的 各 个 工作 ，Linux 内 核 使 用 
worker 结构 体 表 示 工 作者 线程 ，worker 结构 体内 容 如 下 : 
示例 代码 51.1.2.10 worker 结构 体 

















struct worker { 
union ( 
struct list neac entry; 


struct hlist node hentry; 


Exe rons er Ue evn Wonky 
work func t Current UnC} 

struct pool workqueue  *current pwq; 
bool dese suis 

struct list head scheduled; 

GnEwwICIE CASk SELCE eask, 


Save VOrker POOL on 








SEruece list heag node; 

unsigned long lege SueiEuwS 
unsigned int lages 

TAE Lely 

(lgieue desc[WORKER DESC LEN]; 














struct workqueue struct *rescue wq; 














从 示例 代码 51.1.2.10 可 以 看 出 ， 每 个 worker 都 有 一 个 工作 队列 ， 工 作者 线程 处 理 自己 工 
作 队 列 中 的 所 有 工作 。 在 实际 的 驱动 开发 中 , 我们 只 需要 定义 工作 (work strucb 即 可 ， 关 于 工作 
队列 和 工作 者 线程 我 们 基本 不 用 去 管 。 简 单 创建 工作 很 简单 ， 直 接 定义 一 个 work struct 结构 体 
变量 即 可 ， 然 后 使 用 INIT WORK 宏 来 初始 化 工作 ，INIT_WORK 宏 定义 如 下 : 

#define INIT WORK( work, func) 

work 表示 要 初始 化 的 工作 ，_func 是 工作 对 应 的 处 理 函 数 。 

也 可 以 使 用 DECLARE WORK 宏一 次 性 完成 工作 的 创建 和 初始 化 ， 宏 定义 如 下 : 

#define DECLARE WORK(n, f) 

n 表示 定义 的 工作 (work strucD，f 表 示 工 作对 应 的 处 理 函 数 。 

和 tasklet 一 样 ， 工 作 也 是 需要 调度 才能 运行 的 ， 工 作 的 调度 函数 为 schedule _ work， 函 数 原 
型 如 下 所 示 : 

bool schedule work(struct work struct *work) 

函数 参数 和 返回 值 含义 如 下 : 

work: 要 调度 的 工作 。 

返回 值 : 0 成 功 ， 其 他 值 失败 。 

关于 工作 队列 的 参考 使 用 示例 如 下 所 示 : 

示例 代码 51.1.2.11 工作 队列 使 用 示例 

Me EEE oz) 3 


struct work struct testwork; 






















































































/* work 处 理 函 数 & 
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void testwork func t(struct work struct *work); 


{ 


/* work 具体 处 理 内 容 


/* 中 断 处 理 函 数 
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3 


E 


ee lee © test handiler(iat irg, vord wdey iel) 


{ 
/* 调度 work */ 
schedule work(&testwork); 
} 
/* 驱动 入 口 函数 */ 
GuESHe3LO ime ^^ imit (eel) 
{ 
/* 初始 化 work m 
INIT WORK(&testwork, testwork func t); 
/* 注册 中 断 处 理 函 数 */ 
ieces ilex iro, test handler, Op "cox" Cxxx dev)? 
} 


51.1.3 设备 树 中 断 信 息 节 点 


如 果 使 用 设备 树 的 话 就 需要 在 设备 树 中 设置 好 中 断 属 性 信息 ，Linux 内 核 通过 读 取 设备 树 








中 的 中 断 属性 信息 来 配置 中 断 。 对 于 中 断 控制 器 而 言 ， 





设备 树 绑 定 信息 参考 文档 


Documentation/devicetree/bindings/arm/gic.txt。 打 开 imx6ull.dtsi 文件 ， 其 中 的 inte 节点 就 是 


I.MX6ULL 的 中 断 控 制 器 节点 ， 节 点 内 容 如 下 所 示 : 
示例 代码 51.1.3.1 中 断 控制 器 inte 节点 





1 intc: interrupt-controller800a01000 ( 
2 compatible = "arm,cortex-a7-gic"; 
3 #interrupt-cells = «43»; 

4 interrupt-controller; 

5 reg = «0x00a801000 0x1000», 

6 «0x00a02000 0x100»; 

7 ps 


第 2 1T, compatible 属性 值 为 “arm,cortex-a7-gic” 在 Linux 内 核 源码 中 搜索 “arm,cortex-a7- 


gic” 即 可 找到 GIC 中 断 控 制 器 驱动 文件 。 











第 3 ÍT, tüinterrupt-cells flladdress-cells. Zsize-cells 一 样 。 表 示 此 中 断 控制 器 下 设备 的 cells 























大 小 ， 对 于 设备 而 言 ， 会 使 用 interrupts 属性 描述 中 断 信 息 ，##interrupt-cells 描述 了 interrupts 
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性 的 cells 大 小 ， 也 就 是 一 条 信息 有 几 个 cells。 每 个 cells 都 是 32 位 整形 值 ， 对 于 ARM 处 理 的 
GIC 来 说 ， 一 共有 3 个 cells， 这 三 个 cells 的 含义 如 下 : 

第 一 个 cells: 中 断 类 型 ，0 表示 SPI 中 断 ，1 表示 PPI 中 断 。 

第 二 个 cells: 中 断 号 ， 对 于 SPI 中 断 来 说 中 断 号 的 范围 为 0~987， 对 于 PPI 中 断 来 说 中 断 



































号 的 范围 为 0~15。 

第 三 个 cells: 标志 ，bit[3:0] 表 示 中 断 触发 类 型 ， 为 1 的 时 候 表示 上 升 沿 触 发 ， 为 2 的 时 候 
表示 下 降 沿 触 发 , 为 4 的 时 候 表 示 高 电 平 触发 ,为 8 的 时 候 表示 低 电 平 触发 。bit[15:8] 为 PPI 中 
断 的 CPU 掩 码 。 

第 4 行 ，interrupt-controller 节点 为 空 ， 表 示 当 前 节点 是 中 断 控制 器 。 

对 于 gpio 来 说 ，gpio 节点 也 可 以 作为 中 断 控制 器 ， 比 如 imx6ull.dtsi 文件 中 的 gpio5 节点 内 
容 如 下 所 示 : 


























示例 代码 51.1.3.2 gpio5 设备 节点 
1 gpio5: gpio8020ac000 ( 
2 compaitiio le m= Ene stiaes tib repertor. — Meister tiles Se (ot) P 
3 reg = «0x020ac000 0x4000»; 
4 interrupts - «GIC SPI 74 IRQ TYPE LEVEL HIGH», 
5 «GIC SPI 75 IRQ TYPE LEVEL HIGH»; 
6 Gio. - Cioxane roller; 
7 #gpio-cells = <2>; 
8 interrupt-controller; 
9 
1 


Kinterrupt-cells = «2»; 








Q. Jg 
第 4 行 ,interrupts 描述 中 断 源 信息 ， 对 于 gpio5 来 说 一 共有 两 条 信息 ,中断 类 pex SPI, 
MR EFA IRQ TYPE LEVEL HIGH. REIZ ute TPRI, 个 是 74， Æ 75, HF 

















可 以 打开 《IMX6ULL 参考 手册 》 的 “Chapter 3 Interrupts and DMA Events” s 找到 表 3-1, 
全 50.1.3.1 所 示 的 内 容 : 


Interrupt Source Interrupt Description 
gpio5 dE interrupt indication for GPIOS signal 0 throughout 








EE. interrupt indication for GPIO5 signal 16 throughout 











图 50.1.3.1 rp 
从 图 50.1.3.1 可 以 看 出 ，GPIO5 一 共用 了 2 个 中 断 号 ， 一 个 是 74， 一 个 是 75。 其 中 74 对 
应 GPO: _IO00~GPIO5S IO15 这 低 16 ^ IO, 75 对 应 GPIOS IO16~GPIOIS IO31 这 高 16 位 IO。 
第 8 ÍT, interrupt-controller 表明 了 gpio5 节点 也 是 个 中 断 控制 器 ， 用 于 控制 gpio5 所 有 IO 
的 中 断 。 
第 9 行 ， 将 #interrupt-cells 修改 为 2。 
打开 imx6ull-alientek-emmc.dts 文件 ， 找 到 如 下 所 示 内 容 : 
示例 代码 51.1.3.3 fxls8471 设备 节点 
































1 fxls8471801e ( 

2 compatible = "fsl,fx1s8471"; 
B reg = <0xle>; 

4 position = «0»; 

5 interrupt-parent = «&gpio5»; 
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6 interrupts = «0 8»; 
7i dg 


fxls8471 是 NXP 官方 的 6ULL 开发 板 上 的 一 个 磁力 计 蕊 片 ， 仪 ls8471 有 一 个 中 断 引 脚 链 接 
到 了 LMX6ULL 的 SNVS TAMPERO 因 脚 上 ， 这 个 引 脚 可 以 复 用 为 GPIOS IO00。 

第 5 1T, interrupt-parent 属性 设置 中 断 控制 器 ， 这 里 使 用 gpio5 作为 中 断 控 制 器 。 

第 6 行 ，interrupts 设置 中 断 信 息 ，0 表示 GPIOS IO00，8 表示 低 电 平 触发 。 

简单 总 结 一 下 与 中 断 有 关 的 设备 树 属性 信息 : 

QD)、#interrupt-cells， 指 定 中 断 源 的 信息 cells 个 数 。 

包 、interrupt-controller， 表 示 当 前 节点 为 中 断 控制 器 。 

(3)、interrupts， 指 定 中 断 号 ， 触 发 方式 等 。 

由 、interrupt-parent， 指 定 父 中 断 ， 也 就 是 中 断 控制 器 。 





















































51.1.4. 获取 中 断 号 


编写 驱动 的 时 候 需 要 用 到 中 断 号 ， 我 们 用 到 中 断 号 ， 中 断 信息 已 经 写 到 了 设备 树 里 面 ， 因 
此 可 以 通过 irq_of parse and. map 函数 从 interupts 属性 中 提取 到 对 应 的 设备 号 , 函数 原型 如 下 : 


unsigned intirq of parse and map(struct device node *dev, 














int index) 
函数 参数 和 返回 值 含 义 如 下 : 
dev: 设备 节点 。 
index: 索引 号 ，interrupts 属性 可 能 包含 多 条 中 断 信息 ， 通 过 index 指定 要 获取 的 信息 。 
返回 值 : 中 断 号 。 
如 果 使 用 GPIO 的 话 ， 可 以 使 用 gpio to irq 函数 来 获取 gpio 对 应 的 中 断 号 ， 函 数 原型 如 


























int gplo to irq(unsigned int gpio) 

函数 参数 和 返回 值 含 义 如 下 : 

gpio: 要 获取 的 GPIO 编号 。 

BEHE: GPIO 对 应 的 中 断 号 中 断 号 。 


51.2. 硬件 原理 图 分 析 
本 章 实 验 硬 件 原 理 图 参考 15.2 小 节 即 可 。 


51.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 2、Linux 驱动 例 程 -> 13_irq。 

本 章 实验 我 们 驱动 LMX6U-ALPHA 开发 板 上 的 KEYO 按键 ， 不 过 我 们 采用 中 断 的 方式 ， 
并 且 采 用 定时 器 来 实现 按键 消 拌 ， 应 用 程序 读 取 按 键 值 并 且 通 过 终端 打印 出 来 。 通 过 本 章 我 们 
可 以 学 习 到 Linux 内 核 中 断 的 使 用 方法 ， 以 及 对 Linux 内 核定 时 器 的 回顾 。 


































































































51.3.1 修改 设备 树 文件 


本 章 实 验 使 用 到 了 按键 KEY0， 按 键 KEY0 使 用 中 断 模式 ， 因 此 需要 在 “key” 节 点 下 添加 
断 相 关 属 性 ， 添 加 完成 以 后 的 “key” 节 点 内 容 如 下 所 示 : 
示例 代码 51.3.1.1 key 节点 信息 












































1 key { 
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«1»; 
#size-cells = «1»; 


daddress-cells 


compatible "atkalpha-key"; 


Eee TE; 


pinctrl-names 


pinctrl-0 - «&pinctrl key»; 








key-gpio 
interrupt-parent - «&gpiol»; 
«18 IRQ TYPE EDGE BOTH»; 


interrupts 


0 
1 m 


SIE SHETDIGI Mec 


LU UD) ION ES 人 ES 
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«&gpiol 18 GPIO ACTIVE LOW»; /* KEYO */ 


/* FALLING RISING */ 











第 817, WE interrupt-parent 属性 值 为 “gpio1”， 因 为 KEY0 所 使 | 








的 GPIO 为 





GPIOI IO18， 也 就 是 设置 KEY0 的 GPIO 中 断 控制 器 为 gpio1。 
第 9 行 ， 设 置 interrupts 属性 ， 也 就 是 设置 中 断 源 ， 第 一 个 cells 的 

















18 表示 GPIOI 组 的 18 


*5 IO. IRQ TYPE EDGE BOTH 定义 在 文件 include/linux/irq.h 中 ， 定 义 如 下 : 


示例 代码 51.3.1.2 中 断 线 状态 


76 enum ( 




























































































77 IRQ TYPE NONE = 0x00000000, 

78 IRQ TYPE EDGE RISING z 0x00000001, 

79 IRQ TYPE EDGE FALLING = 0x00000002, 

80 IRQ TYPE EDGE BOTH = (IRQ TYPE EDGE FALLING | 
IRQ TYPE EDGE RISING), 

81 IRQ TYPE LEVEL HIGH z 0x00000004, 

82 IRQ TYPE LEVEL LOW = 0x00000008, 

83 IRQ TYPE LEVEL MASK = (IRQ TYPE LEVEL LOW | 
IRO TYPE LEVEL HIGH), 

TOORE 





从 示例 代码 51.3.1.2 中 可 以 看 出 ,IRQ_TYPE EDGE BOTH 表示 上 升 沿 和 下 降 沿 同时 有 效 ， 





相当 于 KEY0 按 下 和 释放 都 会 触发 中 断 。 
设备 树 编写 完成 以 后 使 用 
imx6ull-alientek-emmc.dtb 文件 启动 Linux 系统 。 











51.3.2 按键 中 断 驱 动 程序 编写 
































“make dtbs ”命令 重新 编译 设备 树 ， 然 后 使 / 


新 建 名 为 “13_irq” 的 文件 来， 然后 在 13_irq 文件 夹 里 面 创建 vscode 工程 ， 











新 编译 出 来 的 











工作 区 命名 为 








“imx6uirq”。 工程 创建 好 以 后 新 建 imx6uirq.c 文件 ， 在 imx6uirq.c 里 面 输入 如 下 内 容 : 











示例 代码 51.3.2.1 imx6uirq.c 文件 代码 





1  £include Xlinux/types.h» 
2  d$4include Xlinux/kernel.h» 
3  £dinclude Xlinux/delay.h» 
4  $include Xlinux/ide.h» 

5  $include Xlinux/init.h» 

6 #include <linux/module.h> 
7 | $include «linux/errno.h» 

















1240 


LMX6U BEAR Linux 驱动 开发 指南 





原子 哥 在 线 教 学 ，www.yuanzige.com 


finclude «linux/gpio.h» 
$include «linux/cdev.h» 


49 
50 


dinclude «linux/device.h» 


$include «linux/of.h» 


*include «linux/of address.h» 


finclude <linux/of gpio.h» 


finclude «linux/semaphore.h» 


$include «linux/timer.h» 





*include «linux/of irq.h» 


dinclude «linux/irq.h» 


finclude «asm/mach/map.h» 


#include «asm/uaccess.h» 


dinclude Xasm/io.h» 
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Copyright O ALIENTEK Co., Ltd. 1998-2029. AII rights reserved. 
文件 名 : imx6uirq.c 
Iza : 左 忠 凯 
版 本 & NL 
DS : Linux 中 断 驱 动 实验 
其 他 EE 
论坛 : www.openedv .com 
Hx : 初版 V1.0 2019/7/26 左 忠 凯 创建 
"Kk ck ckckckckck kk kk ck kc k ck kk k ck kk kk kckckck ckck ckck ckck ckck ckck ck ck ckck ck ck ck ck ck ck ckck ck ck ckck ck ck kck kk kk f 
#define IMX6UIRQ CNT 1 /* 设备 号 个 数 */ 
#define IMX6UIRQ NAME "imx6uirq" /* 名 字 7 
#define KEYOVALUE 0X01 /* KEYO 按键 值 ud 
define INVAKEY OXFF /* 无 效 的 按键 值 = 
#define KEY NUM 1 /* 按键 数量 xf 
/* 中 断 ro 描述 结构 体 */ 
struct irg kaydese i 

iae golog /* gpio "i 

int irqgnum; /* 中 断 号 iA 


unsigned char value; 


char name[10]; 


/* 按键 对 应 的 键 值  */ 


/* 名 字 


irgreturmn t (hanciler) (Lat, vorc =) p 


bg 


/* imx6uird 设 备 结构 体 */ 
struct imx6uirq devi 
dev t devid; 


struct cdev cdev; 


Sese Clase else 


/* 
/ * 
/ * 


m 
/* 中 断 服务 函数 */ 


e 
y 
"p 
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Sil struct device *device; /* 设备 */ 

52 sone major, /* 主 设备 号 */ 

53 ime morg /* 次 设备 号 ^ 

54 struct device node *nd; /* 设备 节操 ui 

55 atomic t keyvalue; /* 有 效 的 按键 键 值 nu 

56 atomic t releasekey; /* 标记 是 否 完成 一 次 完成 的 按键 */ 

53 struct timer list timer; /* jE X — AEN / 

58 struct irq keydesc irqkeydesc[KEY NUM]; /* 按键 描述 数组 */ 
59 unsigned char curkeynum; /* 当前 的 按键 号 */ 
60 p; 

61 

62 struct imxóuirq dev imx6uirgq; /* iYg 设备 */ 

63 

64 /* Qdescription : 中 断 服务 函数 ， 开 启 定 时 器 ， 延 时 10ms, 

65 * 定时 占用 于 按键 消 拌 。 

66  * Qparam - irq : 中 断 号 

67  * Qparam - dev id : 设备 结构 。 

68  * Qreturn : 中 断 执 行 结 

Ge 

10 ertatie irgreturn t keyO handler (int ira; vore dew 1e 

ga A 

72 struct imx6uirq dev *dev = (struct imx6uirq dev *)dev id; 
T7 3j 

74 dev-»curkeynum = 0; 

E dev-»timer.data - (volatile long)dev id; 

76 moc timer (Cdey->tiner, Jiiities T mesecs to Jitiirss (ioh)? 
p return IRQ RETVAL (IRQ HANDLED); 

VINE 

78) 

80 /* Q(description  : 定时 器 服务 函数 ， 用 于 按键 消 拌 ， 定 时 器 到 了 以 后 

81 * 再 次 读 取 按 键 值 ， 如 果 按 键 还 是 处 于 按 下 状态 就 表示 按键 有 效 。 
B2 SS : 设备 结构 变量 

83  * Qreturn 3 JE 

84  */ 

S5 void timer dibbeotuhloje M (ns Ro jor o long aze) 

SET 

87 unsigned char value; 

88 unsigned char num; 

89 struct irg keydese vkeydese? 

90 struct imx6uirq dev *dev = (struct imx6uirq dev *)arg; 

Or 

92 num = dev-»curkeynum; 

33 keydesc = &dev->irqkeydesc [num]; 
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94 

95 value = gpio get value (keydesc-»gpio); /* HX ro 值 n 

96 is (valus = 0) /* 按 下 按键 i 

97 atomic set(&dev-»keyvalue, keydesc-»value); 

98 ) 

99 else( /* 按键 松 开 */ 

100 atomic set(&dev-»2keyvalue, 0x80 | keydesc-»value); 

EIN atomic set(&dev-»releasekey, 1); /* 标记 松 开 按键 */ 

102 ) 

10S. T 

104 

OS ues 

106 * Qdescription  : 按键 Io 初始 化 

107 * param S 

108 * Greturn 3 JE 

409. cy 

1.1H0) statie ime kayilo atate (voch) 

iin A 

303122 unsigned char i = 0; 

ILS char name[10]; 

114 int ret = 0; 

Talis 

116 imx6uirq.nd = of find node by path("/key"); 

dE if (imx6uirq.nd-- NULL)( 

118 printk("key node not find!NrMin"); 

119 return -EINVAL; 

120 ) 

162l 

122 /* 提取 GPIO */ 

i23 for (i = 0; i < KEY NUM; i++) ( 

124 imx6uirq.irqkeydesc[il]l.gpio = of get named gpio(imxó6uirq.nd, 
"key-gpio", i); 

i25, if (imx6uirq.irgkeydesc[i].gpio « 0) ( 

126 printk("can't get key$dNrWMn", i); 

L27 } 

128 } 

T29 

130 /* 初始 化 key 所 使 用 的 ITZo， 并 且 设 置 成 中 断 模 式 */ 

LS for (i = 0; i < KEY NUM; i++) { 

T32 memset(imx6uirq.irqkeydesc[i].name, 0, sizeof(name)); 

HESS sprintf(imx6uirq.irgkeydesc[i].name, "KEYZ2d", i); 

134 gpio request(imx6uirq.irqkeydesc[i].gpio, name); 

135 gpio direction input(imx6uirq.irqkeydesc[i].gpio); 
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136 imx6uirq.irqkeydesc[i].irqnum = ira of parse and map( 


IMEUT EGAM) 























NSP petes. QU 
138 imx6uirq.irqkeydesc[i].irqnum = golo to irq( 
imx6uirq.irqkeydesc[i]l.gpio); 
139 #endif 
140 printk("key$d:gpio-$d, irgnum-$d'NrMn",i, 
imx6uirq.irqkeydesc[i].gpio, 

141 imx6uirq.irgkeydesc[i]l.irgnum); 

142 } 

143 /* Hu */ 

144 imx6uirq.irqkeydesc[0].handler = keyO handler; 

145 imx6uirq.irgkeydesc[0].value = KEYOVALUE; 

146 

147 for (i = 0; i < KEY NUM; i++) ( 

148 ret S request irq(imx6uirq.irqkeydesc[i].irqnum, 
imx6uirq.irgkeydesc[i].handler, 
IRQF TRIGGER FALLING|IRQOF TRIGGER RISING, 
imx6uirq.irqkeydesc[i].name, &imxó6uirg); 

149 if(ret < Ot 

150 printk("irq $d request failed!Nr*n", 

imx6uirq.irqkeydesc[i].irgnum); 

JUS return -EFAULT; 

1592 } 

LSS } 

154 

155 /* 创建 定时 器 */ 

156 init timer(&imx6uirq.timer); 

10517 imx6uirq.timer.function = timer function; 

158 return 0; 

i59 

160 

Ib. yrs 


162 = Qdescription s ova 
163 * Qparam - inode: 传递 给 驱动 的 inode 
164 * @param - filp : 设备 文件 ，file 结构 体 有 个 叫做 Private data 的 成 员 变 量 





165 ~ 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
166 * (return : 0 成 功 ;其 他 失败 
JH e) 


lch gtatic ine Imzouirg opeex((siciwrei inode vinode, struct Eile wiil) 
169 ( 

170 filp-»private data = &imx6uirq; /* 设置 私有 数据 */ 

dL HIE return 0; 
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mm 

1579 

A cus 

1353 * (description : 从 设备 读 取 数据 

176  * 8param - filp: 要 打开 的 设备 文件 (文件 描述 符 ) 











177  * Qparam - buf : 返回 给 用 户 空间 的 数据 缓冲 区 

3E 7/8) saparani ehe 8 要 读 取 的 数据 长 度 

179  * Qparam - offt : 相对 于 文件 首 地 址 的 偏 移 

180  * QGreturn : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 

181 "y 

132 statie gsize t abücxOwleoy iemel(siiwel tile wiilp, Chear  —— User Duit, 
gize t GE, loti iE SORTE) 




















ES N 

184 int ret = 0; 

185 unsigned char keyvalue = 0; 

186 unsigned char releasekey = 0; 

187 struct imx6uirq dev *dev = (struct imxó6uirq dev *) 
filp-»private data; 

188 

189 keyvalue = atomic read(&dev-»keyvalue); 

190 releasekey = atomic read(&dev-»releasekey); 

Ioa 

192 if (releasekey) ( /* 有 按键 按 下 2 

193 if (keyvalue & 0x80) ( 

194 keyvalue &= «40x80; 

1:95 ret = copy to user(buf, &keyvalue, sizeof(keyvalue)); 

196 ) else ( 

JL) goto data error; 

19g } 

199 atomic set(&dev-»releasekey, 0); /* 按 下 标志 清 零 */ 

200 } else { 

ZAO goto data_error; 

202 } 

203 return 0; 

204 

205 daeta errTors 

206 return -EINVAL; 

ZU) 

208 

209 /* 设备 操作 函数 */ 

Z0 tatie struct tile operarlons nouee rops = wi 

2HLIE .Owner = THIS MODULE, 

LZ .open - imx6uirq open, 
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25) .read = imx6uirq read, 

Z0 

215 

ZEE 

217 * Qdescription : 驱动 入 口 函数 

218 * QGparam e JE 

219 * Qreturn s JE 

Z2) . Su 

2A ee dmt — imit anbsewuiree] aba (voL) 

ZI N 

225 /* l1. FJEEWE ER S */ 

224 if (imx6uirq.major) ( 

225 imx6uirq.devid = MKDEV(imxó6uirq.major, 0); 

226 register chrdev region(imx6uirq.devid, IMX6UIRQ CNT, 
IMX6UIRQ NAME) R 

2217 ) else ( 

228 alloc chrdev region(&imx6uirq.devid, 0, IMX6UIRQ CNT, 
IMX6UIRQ NAME) > 

2 imx6uirq.major = MAJOR(imx6uirq.devid); 

2:5) imx6uirq.minor = MINOR(imx6uirq.devid); 

2i } 

232 

233 /* 2. EFT E */ 

234 cdev init(&imxóuirq.cdev, &imx6óuirq fops); 

255 cdev add(&imx6uirq.cdev, imx6uirq.devid, IMX6UIRQ CNT); 

236 

237 /* 3、 创 建 类 27 

268 imx6uirq.class = class create(THIS MODULE, IMX6UIRQ NAME); 

259 E(B (ee llss d 

240 return PTR ERR(imxó6uirq.class); 

241 } 

242 

243 /* 4、 创 建设 备 un 

244 imx6uirq.device = device create(imx6uirq.class, NULL, 

imx6uirq.devid, NULL, IMX6UIRQ NAME); 

245 if (IS ERR(imx6uirq.device)) d 

246 return PTR ERR(imxó6uirq.device); 

247 } 

248 

249 /* 5、 始 化 按键 =y 

250 atomic set(&imx6uirq.keyvalue, INVAKEY); 

Zi atomic set(&imxó6uirq.releasekey, 0); 

AIA keyio init)? 
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250 return 0; 
254 } 
255 
QUU 
257 * Qdescription : 驱动 出 口 函 数 
258 * Qparam 3 JE 
259 * Qreturn = JE 
AGO SU 
Aal eratcie saeculo!  — exit abnubxSubLiegy exit (Voci) 
262 Ti 
263 unsigned i = 0; 
264 /* 删除 定时 器 */ 
265 del timer sync(&imxóuirq.timer); 
266 
267 [* TERCBI 5/ 
268 for (i = 0; i < KEY NUM; i++) ( 
269 free irq(imx6uirq.irqkeydesc[i].irgnum, &imxóuirqg); 
210 ) 
2m cdev del(&imx6uirq.cdev); 
232) unregister chrdev region(imx6uirq.devid, IMX6UIRQ CNT); 
218) device destroy(imx6uirq.class, imxó6uirq.devid); 
274 class destroy(imx6uirq.class); 
275 
216 
277] module init(imxóuirq init); 
278 module exit(imxó6uirq exit); 
279 MODULE LICENSE ("GPL"); 
280 MODULE AUTHOR ("zuozhongkai"); 
第 38-43 ÍT, 结构 体 irq_keydesc 为 按键 的 中 断 描 述 结构 体 , gpio 为 按键 GPIO 编号 , irqnum 
为 按键 IO 对 应 的 中 断 号 ，value 为 按键 对 应 的 键 值 ，name 为 按键 名 字 ，handler 为 按键 中 断 服 
ZKA EH irq_ keydesc 结构 体 即 可 描述 一 个 按键 中 断 。 























第 47~60 行 , 结构 体 imx6uirq dev 为 本 例 程 设备 结构 体 , 第 55 行 的 keyvalue 保存 按键 值 ， 
第 56 行 的 releasekey 表示 按键 是 否 被 释放 ， 如 果 按 键 被 释放 表示 发 生 了 一 次 完整 的 按键 过 程 。 
第 57 行 的 timer 为 按键 消 拌 定时 器 ， 使 用 定时 器 进行 按键 消 拌 的 原理 已 经 在 19.1 小 节 讲 解 过 
。 第 58 行 的 数组 irqkeydesc 为 按键 信息 数组 ， 数 组 元 素 个 数 就 是 开发 板 上 的 按键 个 数 ， 



































LMX6U-ALIPHA 开发 板 上 只 有 一 个 按键 ， 因 此 irqkeydesc 数组 只 有 一 个 元 素 。 第 59 行 的 
curkeynum 表示 当前 按键 。 








第 62 行 ， 定 义 设备 结构 体 变 量 imx6uirq。 
第 70—78 行 ，key0_handler 函数 ， 按 键 KEY0 中 断 处 理 函 数 ， 参 数 dev id 为 设备 结构 体 ， 











也 就 是 imx6uirq. $ 74 行 设置 curkeynum=0， 表 示 当 前 按键 为 KEY0， 第 76 行使 用 mod timer 


函数 启动 定时 器 ， 定 时 器 周期 为 10ms。 
第 85-103, timer function 函数 ， 定 时 器 定时 处 理 函 数 ， 参 数 arg 是 设备 结构 体 ， 也 就 是 














imx6uirq， 在 此 函数 中 读 取 按键 值 。 第 95 行 通过 gpio_get value 函数 读 取 按 键 值 。 如 果 为 0 的 
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话 就 表示 按键 被 按 下 去 了 , 按 下 去 的 话 就 设置 imx6uirq 结构 体 的 keyvalue 成 员 变 量 为 按键 的 键 
值 ,比如 KEY0 按键 的 话 按键 值 就 是 KEY0VALUE=0。 如 果 按 键 值 为 1 的 话 表示 按键 被 释放 了 ， 
按键 释放 了 的 话 就 将 imx6uirq 结构 体 的 keyvalue 成 员 变 量 的 最 高 位 置 1， 表 示 按 键 值 有 效 ， 也 
就 是 将 keyvalue 与 0x80 进行 或 运算 ， 表示 按键 松 开 了 ， 并 且 设 置 imx6uirq 结构 体 的 releasekey 
成 员 变 量 为 1， 表 示 按 键 释 放 ， 一 次 有 效 的 按键 过 程 发 生 。 

第 110~159 行 , keyio_init 函数 , 按键 IO 初始 化 函数 , 在 驱动 入 口 函 数 里 面 会 调用 keyio init 
来 初始 化 按键 JO。 第 131~142 行 轮流 初始 化 所 有 的 按键 ， 包 括 申请 IO、 设 置 IO 为 输入 模式 、 
从 设备 树 中 获取 IO 的 中 断 号 等 等 。 第 136 行 通 过 irq_ of parse and. map 函数 从 设备 树 中 获取 按 
BE IO 对 应 的 中 断 号 。 也 可 以 使 用 gpio to irg 函数 将 某 个 IO 设置 为 中 断 状态 ， 并 且 返 回 其 中 断 
号 。 第 144 和 145 行 设 置 KEYO 按键 对 应 的 按键 中 断 处 理 函 数 为 key0_handler、KEY0 的 按键 
值 为 KEYOVALUE。 第 147-153 行 轮流 调用 request irq 函数 申请 中 断 号 ， 设 置 中 断 触发 模式 为 
IRQF TRIGGER FALLING fll IRQF TRIGGER RISING, 也 就 是 上 升 沿 和 下 降 沿 都 可 以 触发 中 
断 。 最 后 ， 第 156 行 初始 化 定时 器 ， 并 且 设 置 定 时 器 的 定时 处 理 函 数 。 

第 168~172 行 ，imx6uirq open 函数 ， 对 应 应 用 程序 的 open 函数 。 

第 182-207 ÍT, imx6uirq_read 函数 ， 对 应 应 用 程序 的 read 函数 。 此 函数 向 应 用 程序 返回 按 
键 值 。 首 先 判断 imx6uirq 结构 体 的 releasekey 成 员 变 量 值 是 否 为 1， 如 果 为 1 的 话 表 示 又 一 次 
有 效 按键 发 生 ， 和 否则 的 话 就 直接 返回 -EINVAL。 当 有 按键 事件 发 生 的 话 就 要 向 应 用 程序 发 送 按 
键 值 ， 首 先 判断 按键 值 的 最 高 位 是 否 为 1， 如 果 为 1 的 话 就 表示 按键 值 有 效 。 如 果 按 键 值 有 效 
的 话 就 将 最 高 位 清除 ， 得 到 真实 的 按键 值 ， 然 后 通过 copy to user 函数 返回 给 应 用 程序 。 向 应 
用 程序 发 送 按键 值 完 成 以 后 就 将 imx6uirq 结构 体 的 releasekey 成 员 变 量 清 零 ， 准 备 下 一 次 按键 
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*8 210-214 行 ， 按 键 中 断 驱 动 操作 函数 集 imx6uirq_fops。 

第 221-253 行 ， 驱 动 入 口 函 数 ， 第 250 和 251 行 分 别 初始 化 imx6uirq 结构 体 中 的 原子 变量 
keyvalue 和 releasekey， 第 252 行 调 用 init 函数 初始 化 按键 所 使 用 的 IO。 

第 261-275 ÍT, IEH OK $E 265 行 调用 del timer sync 函数 删除 定时 器 ， 第 268-070 
行 轮流 释放 申请 的 所 有 按键 中 断 。 



































51.3.3 编写 测试 APP 


测试 APP 要 实现 的 内 容 很 简单 ， 通 过 不 断 的 读 取 /dewimx6uirq 文件 来 获取 按键 值 ， 当 按键 
按 下 以 后 束 会 将 获取 到 的 按键 值 输出 在 终端 上 , 新 建 名 为 imx6uirqApp.c 的 文件 , 然后 输入 如 下 
所 示 内 容 : 




















示例 代码 51.3.3.1 imx6uirqApp.c 文件 代码 
linclude "stdio.h" 
finclude "unistd.h" 
include "sys/types.h" 
finclude "sys/stat.h" 
Fe el Mr emea 


tinclade Ystdlib- n? 








pime lude "string.h' 











tine huder vinnu oee IL a Im 





Keo o E c C a TS E 


/玉米 类 炎炎 火炎 大 炎炎 类 大 炎炎 火炎 大火 类 类 类 类 类 大 类 大大 大大 大大 大大 大大 大大 类 大 大 类 类 大 类 类 类 大 类 类 类 大 类 类 类 大 类 大 大 大 类 大大 大 
dO C opas no AN COn, MEd 9 20200 A ome neser os 
11 文件 名  : imx6uirgApp.c 
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12 fEXé : 左 忠 凯 

13 版 本 eu 

14 描述 : 定时 器 测试 应 用 程序 

15 其 他 3 

16 使 用 方法 : ./imx6uirgApp /dev/imx6uirq 打开 测试 App 
E Ours www.openedv.com 

18 Ex 初版 V1.0 2019/7/26 左 忠 凯 创建 

19 XO Ok ck kk kk kk koe KK ek KK ke kk e KK eR KK ok KCKOK e ACIER KK Rok Ok ook Kok kei / 
20 

Zn ghe 

22 * Qdescription : main 主 程序 

23 * (param = argc argv 数组 元 素 个 数 

24 * Qparam - argv  : RAA 

2L cw et 0 成 功 ;其 他 失败 

26e 

27 int main(int argc, char *argv[]) 

ZONE 

2 sume EEE 

30 Ine ret = 0; 

Sal char *filename; 

7 

9S if (arge "S 2) ( 

34 站 

35, return -i|; 

36 } 

2) 

38 filename = argv[!]: 

29 fd = open(filename, O RDWR); 

40 IERES «S (00) wi 

41 printf("Can't open file $sNrWn", filename); 
42 return -1; 

43 } 

44 

45 while (1) { 

46 ret = read(fd, &data, sizeof(data)); 

47 if (ret < 0) {  /* 数据 读 取 错误 或 者 无 效 */ 
48 

49 } else ( /* 数据 读 取 正 确 ri 
50 if (data) /* 读 取 到 数据 n 
il printf("key value = %#X\r\n", data); 
52 } 

S30 

54 close(fd); 
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55 return ret; 
SI 

第 45-53 行 的 while 循环 用 于 不 断 的 读 取 按键 值 ， 如 果 读 取 到 有 效 的 按键 值 就 将 其 输出 到 
终端 上 。 



































51.4 运行 测试 
51.4.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 
编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 imx6uirq.o，Makefile 内 容 如 下 所 示 : 
示例 代码 51.4.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
Tel ime 4515115 2,150 Ga alientelk 



































4 obj-m := imxóuirq.o 
11 clean 
12 $(MAKE) -C S$(KERNELDIR) M=$ (CURRENT PATH) clean 




















第 4 行 ， 设 置 obj-m 变量 的 值 为 imx6uirq.o。 

输入 如 下 命令 编译 出 驱动 模块 文件 : 

make -j32 

编译 成 功 以 后 就 会 生成 一 个 名 为 “imx6uirq.ko” 的 驱动 模块 文件 。 
2、 编 译 测试 APP 

输入 如 下 命令 编译 测试 imx6uirqApp.c 这 个 测试 程序 : 


arm-linux-gnueabihf-gcc imx6uirqApp.c -o imx6uirqApp 


编译 成 功 以 后 就 会 生成 imx6uirqA pp 这 个 应 用 程序 。 











51.4.2 运行 测试 


将 上 一 小 节 编 译 出 来 imx6uirqko 和 imx6uirqApp 这 两 个 文件 拷贝 到 
rootfs/lib/modules/4.1.15 目录 中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 
加 载 imx6uirq.ko 驱动 模块 : 

depmod /第 一 次 加 载 驱动 的 时 候 需 要 运行 此 命令 

modprobe imx6uirq.ko // 加 载 驱动 

驱动 加 载 成 功 以 后 可 以 通过 查看 /proc/interrupts 文件 来 检查 一 下 对 应 的 中 断 有 没有 被 注册 
上 ， 输 入 如 下 命令 : 
cat /proc/interrupts 


结果 如 图 51.4.2.1 所 示 : 
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站 # cat /proc/interrupts 
CPU 






16: 44744 GPC 55 Level i.MX Timer Tick 
18: 405 GPC 26 Level 2020000. serial 
19: : GPC ze Leve] sai KEY0 中 断 


171: 0 gpio- E 4 Edge anar he detect 
图 51.4.2.1 proc/interrupts 文件 内 容 
从 图 51.4.2.1 可 以 看 出 imx6uirq.c 驱动 文件 里 面 的 KEY0 中 断 已 经 存在 了 ， 触 发 方式 为 跳 
边沿 (Edge)， 中 断 号 为 49. 
接 下 来 使 用 如 下 命令 来 测试 中 断 : 
.imxouirqApp /dev/imx6uirq 
按 下 开发 板 上 的 KEY0 键 ， 终 端 就 会 输出 按键 值 ， 如 图 51.4.2.2 所 示 : 




















1.15 # ./imx6uirqApp /dev/imx6uirq 
key value 


key value = Ox 
key value = 0X1 
key value = 0X1 
key value = OX1 
key value = OX1 
key value = 0X1 





图 51.4.2.2 读 取 到 的 按键 值 
从 图 51.4.2.2 可 以 看 出 ， 按 键 值 获取 成 功 ， 并 且 不 会 有 按键 抖动 导致 的 误 判 发 生 ， 说 明 按 
键 消 抖 工作 正常 。 如 果 要 利 载 驱动 的 话 输入 如 下 命令 即 可 : 


rmmod imx6uirq.ko 
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第 五 十 二 章 Linux 阻塞 和 非 阻塞 IO 实验 





阻塞 和 非 阻塞 IO 是 Linux 驱动 开发 里 面 很 常见 的 两 种 设备 访问 模式 ， 在 编写 驱动 的 时 候 
一 定 要 考虑 到 阻塞 和 非 阻塞 。 本 章 我 们 就 来 学 习 一 下 阻塞 和 非 阻 塞 IJO， 以 及 如 何在 驱动 程序 中 
处 理 阻塞 与 非 阻 塞 ， 如 何在 驱动 程序 使 用 等 待 队 列 和 poll 机 制 。 
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52.1 阻塞 和 非 阻 塞 IO 


52.1.1. 阻塞 和 非 阻塞 简介 


这 里 的 “IO” 并 不 是 我 们 学 习 STM32 或 者 其 他 单片机 的 时 候 所 说 的 “GPIO”( 也 就 是 引 脚 )。 
这 里 的 IO 指 的 是 Input/Output, 也 就 是 输入 /输出 ， 是 应 用 程序 对 驱动 设备 的 输入 /输出 操作 。 当 
应 用 程序 对 设备 驱动 进行 操作 的 时 候 , 如 果 不 能 获取 到 设备 资源 , 那么 阻塞 式 IO 就 会 将 应 用 程 
序 对 应 的 线程 挂 起 ， 直 到 设备 资源 可 以 才 做 为 止 。 对 于 非 阻 塞 IO， 应 用 程序 对 应 的 线程 不 会 挂 
起 ， 它 要 么 一 直 轮 询 等 待 ， 直 到 设备 资源 可 以 使 用 ， 要 么 就 直接 放弃 。 阻 塞 式 IO 如 图 52.1.1.1 
所 示 : 

























































































用 户 态 | | AH 
厂 read() ~ 
函数 从 驱动 读 取 数据 -------- » 设备 不 可 用 
1 I T 
u NE 
D || B pus 
| (dh 
| A 
MIRZE- ------- | 设备 可 用 
~ i ' P 























图 52.1.1.1. 阻塞 IO 访问 示意 图 。 

图 52.1.1.1 中 应 用 程序 调用 read. 函数 从 设备 中 读 取 数据 ， 当 设备 不 可 用 或 数据 未 准备 好 的 
时 候 就 会 进入 到 休 眼 态 。 等 设备 可 用 的 时 候 就 会 从 休眠 态 唤醒 ， 然 后 从 设备 中 读 取 数据 返回 给 
应 用 程序 。 非 阻塞 IO 如 图 52.1.2 所 示 : 





































































































用 户 态 ET 
P read () ' ' S 
函数 从 驱动 读 取 数 据 -------- 区 ,设备 不 本 
BIWIE «4 ----L---------E----Y 
Y ! 
继续 重新 读 取 数据 "------- 其， 设备 不 可 用 
应 用 程序 < 错误 码 丰 ----+---------J---- 刺 > 设备 
aco oot !-------- 其 ”设备 不 可 用 
从 驱动 中 恋 取 到 的 数据 -+--+ 设备 可 用 





图 52.1.1.2 非 阻 塞 IO 访问 示意 图 
从 图 52.1.1.2 可 以 看 出 ， 应 用 程序 使 用 非 阻塞 访问 方式 从 设备 读 取 数据 ， 当 设备 不 可 用 或 
数据 未 准备 好 的 时 候 会 立即 向 内 核 返回 一 个 错误 码 ， 表 示 数 据 读 取 失败 。 应 用 程序 会 再 次 重新 
读 取 数 据 ， 这 样 一 直 往 复 循环 ， 直 到 数据 读 取 成 功 。 
应 用 程序 可 以 使 用 如 下 所 示 示 例 代码 来 实现 阻塞 访问 : 
示例 代码 52.1.1.1 应 用 程序 阻塞 读 取 数 据 



































nn el 

2 int data = 0; 

B 

4 fd = open("/dev/xxx dev", O RDWR); /* 阻塞 方式 打开 */ 
5 ret = read(fd, &data, sizeof(data)); /* 读 取 数据 */ 
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从 示例 代码 52.1.1.1 可 以 看 出 ， 对 于 设备 驱动 文件 的 默认 读 取 方 式 就 是 阻塞 式 的 ， 所 以 我 
们 前 面 所 有 的 例 程 测试 APP 都 是 采用 阻塞 IO。 
如 果 应 用 程序 要 采用 非 阻 塞 的 方式 来 访问 驱动 设备 文件 ， 可 以 使 用 如 下 所 示 代 码 ; 
示例 代码 52.1.1.2 应 用 程序 非 阻塞 读 取 数 据 
































shae Op 
int data = 0; 


fd = open("/dev/xxx dev", O RDWR | O NONBLOCK); VM e */ 
ret = read(fd, &data, sizeof(data)); /* 读 取 数据 */ 

第 4 行使 用 open 函数 打开 “/dev/xxx_dev ”设备 文件 的 时 候 添 加 了 参数 “O_NONBLOCK”， 
表示 以 非 阻 塞 方式 打开 设备 ， 这 样 从 设备 中 读 取 数 据 的 时 候 就 是 非 阻塞 方式 的 了 。 


CECI CO TS NER ES 

















52.1.2 等 待 队列 


1、 等 待 队列 头 

阻塞 访问 最 大 的 好 处 就 是 当 设 备 文 件 不 可 操作 的 时 候 进 程 可 以 进入 休眠 态 ， 这 样 可 以 将 
CPU 资源 让 出 来 。 但 是 ， 当 设备 文件 可 以 操作 的 时 候 就 必须 唤醒 进程 ， 一 般 在 中 断 函 数 里 面 完 
成 唤醒 工作 。Linux 内 核 提 供 了 等 待 队 列 (wait queue) 来 实现 阻塞 进程 的 唤醒 工作 ， 如 果 我 们 要 
在 驱动 中 使 用 等 待 队 列 ， 必 须 创 建 并 初始 化 一 个 等 待 队列 头 ， 等 待 队列 头 使 用 结构 体 
wait queue head ft 表 示 ,，wait queue head t 结构 体 定义 在 文件 include/linux/wait.h 中 , 结构 体内 
容 如 下 所 示 : 

































































示例 代码 52.1.2.1 wait queue head t 结构 体 


29 struct _ walt GUeve ne 


ZEE eel 
4i Struct liet neac task liste 
42 }; 


43 typedef struct Ee e head wait queue head t; 

定义 好 等 待 队列 头 以 后 需要 初始 化 ， 使 数 init waitqueue head 函数 初始 化 等 待 队列 头 ， 函 
数 原型 如 下 : 

void init waitqueue head(wait queue head t *q) 

参数 q 就 是 要 初始 化 的 等 待 队列 头 。 

也 可 以 使 用 宏 DECLARE WAIT QUEUE HEAD 来 一 次 性 完成 等 待 队列 头 的 定义 的 初始 
化 。 

2、 等 待 队 列 项 

等 待 队 列 头 就 是 一 个 等 待 队列 的 头 部 ， 每 个 访问 设备 的 进程 都 是 一 个 队列 项 ， 当 设备 不 可 
用 的 时 候 就 要 将 这 些 进程 对 应 的 等 待 队列 项 添加 到 等 待 队列 里 面 。 结 构 体 wait queue t 表示 等 
竺 队列 项 ， 结 构 体 内 容 如 下 : 
























































示例 代码 52.1.2.2 wait queue t 结构 体 


SEEUGE —— wait eueue 1 


unsigned int flags; 
void *private; 
wait queue func t ne 
struct list neac task listy 
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b; 

typedef struct ^ wait queue wait queue t; 
使 用 宏 DECLARE WAITQUEUE 定义 并 初始 化 一 个 等 待 队列 项 ， 宏 的 内 容 如 下 : 
DECLARE WAITQUEUE(name, tsk) 
name 就 是 等 待 队 列 项 的 名 字 ，tsk 表示 这 个 等 待 队列 项 属于 哪个 任务 (进程 )， 一 般 设置 为 











current ， 在 Linux 内 核 中 current 相当 于 一 个 全 局 变量 ， 表 示 当 前 进程 。 因 此 安 
DECLARE WAITQUEUE 就 是 给 当前 正在 运行 的 进程 创建 并 初始 化 了 一 个 等 待 队列 项 。 

3、 将 队列 项 添加 / 移 除 等 待 队列 头 

当 设 备 不 可 访问 的 时 候 就 需要 将 进程 对 应 的 等 待 队列 项 添加 到 前 面 创建 的 等 待 队 列 头 中 ， 
只 有 添加 到 等 待 队列 头 中 以 后 进程 才能 进入 休 眼 态 。 当 设备 可 以 访问 以 后 再 将 进程 对 应 的 等 待 
队列 项 从 等 待 队列 头 中 移 除 即 可 ， 等 待 队列 项 添加 API 函数 如 下 : 


void add wait queue(wait queue head t *q, 
































wait queue t *wait) 
函数 参数 和 返回 值 含义 如 下 : 
q: 等 待 队列 项 要 加 入 的 等 待 队列 头 。 
wait: 要 加 入 的 等 待 队列 项 。 
返回 值 : 无 。 
等 待 队列 项 移 除 API 函数 如 下 : 
void remove wait queue(wait queue head t ^ *q, 
wait queue t *wait) 
函数 参数 和 返回 值 含义 如 下 : 
q: 要 删除 的 等 待 队列 项 所 处 的 等 待 队 列 头 。 
wait: 要 删除 的 等 待 队 列 项 。 
返回 值 : 无 。 
4、 等 待 唤醒 
当 设 备 可 以 使 用 的 时 候 就 要 唤醒 进入 休眠 态 的 进程 ， 唤 醒 可 以 使 用 如 下 两 个 函数 : 


void wake up(wait queue head t *q) 




















void wake up interruptible(wait queue head t *q) 

参数 q 就 是 要 唤醒 的 等 待 队列 头 ， 这 两 个 函数 会 将 这 个 等 待 队列 头 中 的 所 有 进程 都 唤醒 。 
wake up 函数 可 以 唤醒 处 于 TASK INTERRUPTIBLE 和 TASK UNINTERRUPTIBLE 状态 的 进 
程 ， 而 wake up interruptible 函数 只 能 唤醒 处 于 TASK _INTERRUPTIBLE 状态 的 进程 。 

5、 等 待 事件 

除了 主动 唤醒 以 外 ， 也 可 以 设置 等 竺 队列 等 待 某 个 事件 ， 当 这 个 事件 满足 以 后 就 自动 唤醒 
等 待 队列 中 的 进程 ， 和 等 待 事件 有 关 的 API 函数 如 表 52.1.2.1 所 示 : 






































等 待 以 wd 为 等 待 队列 头 的 等 待 队列 被 唤醒 ， 前 
» 提 是 condition 条 件 必须 满足 (为 真 )， 否 则 一 直 阻 
wait event(wq, condition) m 


塞 。 此 函数 会 将 进程 设置 为 
TASK UNINTERRUPTIBLE 状态 

功能 和 wait event 类 似 ， 但 是 此 函数 可 以 添加 超 
时 时 间 ， 以 jiffies 为 单位 。 此 函数 有 返回 值 ， 如 


























wait event timeout(wq, condition, timeout) 
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果 返 回 0 的 话 表示 超时 时 间 到 ， 而 且 condition 
为 假 。 为 1 的 话 表 示 condition 为 真 ， 也 就 是 条 





















































件 满足 了 。 
与 wait event 函数 类 似 ， 但 是 此 函数 将 进程 设置 
wait event interruptible(wq, condition) 为 TASK INTERRUPTIBLE， 就 是 可 以 被 信号 打 





Lj wait event timeout 函数 类 似 ， 此 函数 也 将 进 
程 设置 为 TASK INTERRUPTIBLE， 可 以 被 信号 
打 断 。 

表 52.1.2.1 等 待 事件 API 函数 


wait event interruptible timeout(wq, 





condition, timeout) 














52.1.3. $e f] 


如 果 用 户 应 用 程序 以 非 阻塞 的 方式 访问 设备 ， 设 备 驱 动 程序 就 要 提供 非 阻塞 的 处 理 方式 ， 
也 就 是 轮 询 。poll、epoll 和 select 可 以 用 于 处 理 轮 询 ， 应 用 程序 通过 select、epoll 或 poll 函数 来 
查询 设备 是 否 可 以 操作 ， 如 果 可 以 操作 的 话 就 从 设备 读 取 或 者 向 设备 写 入 数据 。 当 应 用 程序 调 
用 select、epoll 或 poll 函数 的 时 候 设备 驱动 程序 中 的 poll 函数 就 会 执行 ， 因 此 需要 在 设备 驱动 
程序 中 编写 poll 函数 。 我 们 先 来 看 一 下 应 用 程序 中 使 用 的 select, poll 和 epoll 这 三 个 函数 。 


1、select 函数 
































































































































select 函数 原型 如 下 : 

int select(int nfds, 
fd set *readfds, 
fd set *writefds, 
fd set *exceptfds, 
struct timeval *timeout) 

函数 参数 和 返回 值 含义 如 下 : 








nfds: 要 操作 的 文件 描述 符 个 数 。 

readfds、writefds 和 exceptfds: 这 三 个 指针 指向 描述 符 集合 ， 这 三 个 参数 指明 了 关心 哪些 
描述 符 、 需 要 满足 哪些 条 件 等 等 ， 这 三 个 参数 都 是 fd set XHAI, fd set 类 型 变量 的 每 一 个 位 
都 代表 了 一 个 文件 描述 符 。readfds 用 于 监视 指定 描述 符 集 的 读 变化 ， 也 就 是 监视 这 些 文件 是 否 
可 以 读 取 ， 只 要 这 些 集合 里 面 有 一 个 文件 可 以 读 取 那 么 seclect 就 会 返回 一 个 大 于 0 的 值 表 示 文 
件 可 以 读 取 。 如 果 没 有 文件 可 以 读 取 , 那么 就 会 根据 timeout 参数 来 判断 是 否 超时 。 可 以 将 readfs 
设置 为 NULL， 表 示 不 关心 任何 文件 的 读 变 化 。writefds 和 readfs 类 似 ， 只 是 writefs 用 于 监视 
这 些 文件 是 否 可 以 进行 写 操 作 。exceptfds 用 于 监视 这 些 文件 的 异常 。 

比如 我 们 现在 要 从 一 个 设备 文件 中 读 取 数据 ， 那 么 就 可 以 定义 一 个 fd_set 变量 ， 这 个 变量 
要 传递 给 参数 readfds。 当 我 们 定义 好 一 个 fd_set 变量 以 后 可 以 使 用 如 下 所 示 几 个 宏 进行 操作 ; 

void FD ZERO(fd set *set) 

void FD SET(int fd, fd set *set) 

void FD CLR(int fd, fd set *set) 

int FD ISSET(int fd, fd set *set) 

FD ZERO 用 于 将 fd_set 变量 的 所 有 位 都 清 零 ，FD_SET 用 于 将 fd set 变量 的 某 个 位 置 1， 
也 就 是 向 fd set 添加 一 个 文件 描述 符 , 参数 fd 就 是 要 加 入 的 文件 描述 符 .FD_CLR 用 户 将 fd . 
变量 的 某 个 位 清 零 ， 也 就 是 将 一 个 文件 描述 符 从 fd. set 中 删除 ， 参数 fd 就 是 要 删除 的 文件 
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fj. FD ISSET 用 于 测试 fd_set 的 某 个 位 是 否 置 1， 也 就 是 判断 某 个 文件 是 否 可 以 进行 操作 ， 参 























数 fd 就 是 要 判断 的 文件 描述 符 。 
timeout: 超 时 时 间 ， 当 我 们 调用 select 函数 等 待 某 些 文件 描述 符 可 以 设置 超时 时 间 ， 超 时 时 
间 使 用 结构 体 timeval 表示 ， 结 构 体 定义 如 下 所 示 : 


struct timeval { 






































long tv sec; /* 秒 wp 
long tv usec; Fb */ 


à 
当 timeout 为 NULL 的 时 候 就 表示 无 限期 的 等 待 。 
返回 值 : 0， 表 示 的 话 就 表示 超时 发 生 ， 但 是 没有 任何 文件 描述 符 可 以 进行 操作 ; -1， 发 生 
错误 ; 其 他 值 ， 可 以 进行 操作 的 文件 描述 符 个 数 。 
使 用 select 函数 对 某 个 设备 驱动 文件 进行 读 非 阻塞 访问 的 操作 示例 如 下 所 示 ; 
示例 代码 52.1.3.1 select 函数 非 阻 塞 读 访问 示例 



















































































1 void main(void) 

2 1 

B Sae Lely EO /* 要 监视 的 文件 描述 符 */ 
4 fd set readfds; /* 读 操作 文件 描述 符 集 a 
5 struct timeval timeout; /* 超时 结构 体 */ 
6 

7 fd = open("dev xxx", O RDWR | O NONBLOCK); /* 非 阻塞 式 访问 */ 
8 

9 FD ZERO(&readfds); /* 清除 readfqds e 
10 FD SET(fd, &readfds); /* 将 fq 添加 到 readfqs 里 面 */ 
11 

12 /* 构造 超时 时 间 */ 

IBS timeout.tv sec - 0; 

14 timeout.tv usec = 500000; M SOs — f 

T5 

16 ret = select(fd + 1, &readfds, NULL, NULL, &timeout); 
Jg switch (ret) ( 

18 case 0: /* 超时 E 

19 peme fe (Ce en Nae Vas Vp 

20 break; 

2T case -1: /* 错误 sul 

22 ee (ee re Saa) p 

29 break; 

24 default: /* 可 以 读 取 数据 */ 

25 if(FD ISSET(fd, &readfds)) ( /* 判断 是 否 为 fa 文件 描述 符 */ 
26 /* 使 用 read 函数 读 取 数据 */ 

AN } 

28 break; 

29 } 

2300) 
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2. poll 函数 
在 单个 线程 中 ，select 函数 能 够 监视 的 文件 描述 符 数量 有 最 大 的 限制 ， 一 般 为 1024， 可 以 
修改 内 核 将 监视 的 文件 描述 符 数 量 改 大 ,但 是 这 样 会 降低 效率 ! 这 个 时 候 就 可 以 使 用 poll 函数 ， 
poll 函数 本 质 上 和 select 没有 太 大 的 差别 , 但 是 poll 函数 没有 最 大 文件 描述 符 限 制 ，Linux 应 用 
程序 中 poll 函数 原型 如 下 所 示 : 
int poll(struct pollfd *fds, 
nfds t nfds, 
int timeout) 
函数 参数 和 返回 值 含义 如 下 : 
fds: 要 监视 的 文件 描述 符 集 合 以 及 要 监视 的 事件 ,为 一 个 数组 ， 数 组 元 素 都 是 结构 体 pollfd 
类 型 的 ，pollfd 结构 体 如 下 所 示 : 
struct pollfd ( 
int fd; P 文件 描述 符  */ 
short events; /x 请 求 的 事 价 E 
short revents; /* 返回 的 事 价 en 

































































E 
fd 是 要 监视 的 文件 描述 符 ， 如 果 fd 无 效 的 话 那 么 events 监视 事件 也 就 无 效 ， 并 且 revents 






















































































返回 0。events 是 要 监视 的 事件 ， 可 监视 的 事件 类 型 如 下 所 示 : 
POLLIN 有 数据 可 以 读 取 。 
POLLPRI 有 紧急 的 数据 需要 读 取 。 
POLLOUT 可 以 写 数据 。 
POLLERR 指定 的 文件 描述 符 发 生 错误 。 
POLLHUP 指定 的 文件 描述 符 挂 起 。 
POLLNVAL 无 效 的 请 求 。 


POLLRDNORM 等同 于 POLLIN 

revents 是 返回 参数 ， 也 就 是 返回 的 事件 ， 有 Linux 内 核 设置 具体 的 返回 事件 。 

nfds: poll 函数 要 监视 的 文件 描述 符 数量 。 

timeout: 超时 时 间 ， 单 位 为 ms。 

返回 值 : 返回 revents 域 中 不 为 0 的 pollfd 结构 体 个 数 ， 也 就 是 发 生 事件 或 错误 的 文件 
符 数 量 ; 0， 超 时 ，-1， 发 生 错误 ， 并 且 设 置 erno 为 错误 类 型 。 

使 用 poll 函数 对 某 个 设备 驱动 文件 进行 读 非 阻塞 访问 的 操作 示例 如 下 所 示 : 

示例 代码 52.1.3.2 poll 函数 读 非 阻塞 访问 示例 
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1 void main (void) 

e x 

3 Loe SEA 

4 ime fd /* 要 监视 的 文件 描述 符 */ 
5 strut Toxolllbotel tde: 

6 

7 fd = open(filename, O RDWR | O NONBLOCK); /* 非 阻塞 式 访问 */ 
8 

9 /* 构造 结构 体 */ 

10 fds.fd Cm fd; 

11 fds events = POLLING? /* 监视 数据 是 否 可 以 读 取 */ 
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12 


13 ret = poll(&fds, 1, 500); /* 轮 询 文件 是 否 可 操作 ， 超 时 500ms */ 


14 i leath i /* 数据 有 效 *f 
1 ren 

16 /* 读 取 数 据 */ 

| 

18 )'eise if (ret = 0) 4 /* 超时 A 
po EM 

20 ) eise if (ret « 0) t /* 错误 */ 





3. epoll 函数 

传统 的 selcet 和 poll 函数 都 会 随 着 所 监听 的 fd 数量 的 增加 ， 出 现 效率 低下 的 问题 ， 而 且 
poll 函数 每 次 必须 遍历 所 有 的 描述 符 来 检查 就 绪 的 描述 符 ， 这 个 过 程 很 浪费 时 间 。 为 此 ，epol 
因 运 而 生 ，epoll 就 是 为 处 理 大 并 发 而 准备 的 ， 一 般 常 常 在 网 络 编程 中 使 用 epoll 函数 。 应 用 程 
序 需 要 先 使 用 epoll create 函数 创建 一 个 epoll 句柄 ，epoll_create 函数 原型 如 下 : 

int epoll create(int size) 

函数 参数 和 返回 值 含义 如 下 : 

size: 从 Linux2.6.8 开始 此 参数 已 经 没有 意义 了 ， 随 便 填写 一 个 大 于 0 的 值 就 可 以 。 

返回 值 : epoll 句柄 ， 如 果 为 -1 的 话 表 示 创 建 失败 。 

epoll 句柄 创建 成 功 以 后 使 用 epoll_ctl 函数 向 其 中 添加 要 监视 的 文件 描述 符 以 及 监视 的 事 
TF, epoll ctl 函数 原型 如 下 所 示 : 
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int epoll ctl(int epfd, 
int Op, 
int fd, 


struct epoll event *event) 

函数 参数 和 返回 值 含 义 如 下 : 

epfd: 要 操作 的 epoll 句柄 ， 也 就 是 使 用 epoll create 函数 创建 的 epoll 句柄 。 

op: 表示 要 对 epfd(epoll 句柄 ) 进 行 的 操作 ， 可 以 设置 为 ; 

EPOLL CTL ADD 问 epfd 添加 文件 参数 fd 表示 的 描述 符 。 

EPOLL CTL MOD ”修改 参数 fd 的 event 事件 。 

EPOLL CTL DEL ”从 epfd 中 删除 fd 描述 符 。 

fd: 要 监视 的 文件 描述 符 。 

event: 要 监视 的 事件 类 型 ,为 epoll event 结构 体 类 型 指针 ，epoll_ event 结构 体 类 型 如 下 所 
ZR: 

struct epoll event { 


















































uint32 t events; /* epoll 事件 i 
epoll data t data; /* 用 户 数据 Ey 
hs * 
Zi TA epoll event 的 events 成 员 变 量 表 示 要 监视 的 事件 ， 可 选 的 事件 如 下 所 示 : 





EPOLLIN 有 数据 可 以 读 取 。 
EPOLLOUT 可 以 写 数据 。 
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EPOLLPRI 有 紧急 的 数据 需要 读 取 。 

EPOLLERR 指定 的 文件 描述 符 发 生 错误 。 

EPOLLHUP 指定 的 文件 描述 符 挂 起 。 

EPOLLET ”设置 epoll 为 边沿 触发 ， 默 认 触 发 模式 为 水 平 触 

EPOLLONESHOT 一 次 性 的 监视 ， 当 监视 完成 以 后 还 需要 再 
fd 重新 添加 到 epoll 里 面 。 

上 面 这 些 事件 可 以 进行 “或 ”操作 ， 也 就 是 说 可 以 设置 监视 多 个 事件 。 

返回 值 : 0， 成 功 ;， -1， 失 败 ， vm errno 的 值 为 相应 的 错误 码 

一 切 都 设置 好 以 后 应 用 程序 就 可 以 通过 epoll_wait 函数 来 等 待 事件 的 发 生 ， 类 似 select PR 
数 。epoll_wait 函数 原型 如 下 所 示 : 


发 。 
次 监视 某 个 码 ， 那 么 就 需要 将 
































int epoll wait(int epfd, 
struct epoll event *events, 
int maxevents, 
int timeout) 


EUER HUE 义 如 下 : 

epfd: 要 等 待 的 epoll。 

events: 指向 epoll event 结构 体 的 数组 ， 当 有 事件 发 生 的 时 候 Linux. 内 核 会 填写 events， 调 
用 者 可 以 根据 events 判断 发 生 了 哪些 事件 。 

maxevents: events 数组 大 小 ， 必 须 大 于 0。 

timeout: 超时 时 间 ， 单 位 为 ms。 

返回 值 ，0， 超 时 ; -1， 错 误 ; 其 他 值 ， 准 备 就 绪 的 文件 描述 符 数量 。 

epoll E eae 因为 在 这 种 场合 下 select 和 poll 并 不 适合 。 当 
设计 到 的 文件 描述 符 (fq) 比较 少 的 时 候 就 适合 用 selcet 和 poll， 本 章 我 们 就 使 用 sellect 和 poll 这 
两 个 函数 。 



















































































52.1.4 Linux 驱动 下 的 poll 操作 函数 


当 应 用 程序 调用 select 或 poll 函数 来 对 驱动 程序 进行 非 阻 塞 访问 的 时 候 ， 驱 动 程序 
file operations 操作 集中 的 poll 函数 就 会 执行 。 所 以 驱动 程序 的 编写 者 需要 提供 驱 对 应 的 poll RKI 
数 ，poll 函数 原型 如 下 所 示 : 

unsigned int (*poll) (struct file *filp, struct poll table struct *wait) 

函数 参数 和 返回 值 含义 如 下 : 

fip: 要 打开 的 设备 文件 (文件 描述 符 )。 

wait: 结构 体 poll table struct 类 型 指针 ， 又 应 用 程序 传递 进来 的 。 一 般 将 此 参数 传递 给 
poll wait 函数 。 

返回 值 :向 应 用 程序 返回 设备 或 者 资源 状态 ， 可 以 返回 的 资源 状态 如 下 : 

POLLIN 有 数据 可 以 读 取 。 






































































































































POLLPRI 有 紧急 的 数据 需要 读 取 。 
POLLOUT 可 以 写 数据 。 

POLLERR 指定 的 文件 描述 符 发 生 错 误 
POLLHUP 间 定 的 文件 描述 符 挂 起 。 
POLLNVAL 无 效 的 请 求 。 


POLLRDNORM 等 同 于 POLLIN， 普 通 数据 可 读 
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我 们 需要 在 驱动 程序 的 poll 函数 中 调用 poll wait KÆ, poll wait 函数 不 会 引起 阻塞 ， 只 是 
将 应 用 程序 添加 到 poll table 中 ，poll_wait 函数 原型 如 下 : 

void poll wait(struct file * filp, wait queue head t * wait address, poll table *p) 

参数 wait address 是 要 添加 到 poll table 中 的 等 待 队列 头 ， 参 数 p Wæ poll table, Wiz 
file operations 中 poll 函数 的 wait 参数 。 


52.2 阻塞 IO 实验 


在 上 一 章 Linux 中 断 实 验 中 ， 我 们 直接 在 应 用 程序 中 通过 read. 函数 不 断 的 读 取 按 键 状态 ， 
当 按 键 有 效 的 时 候 就 打印 出 按键 值 。 这 种 方法 有 个 缺点 ， 那 就 是 imx6uirqApp 这 个 测试 应 用 程 
序 拥 有 很 高 的 CPU 占用 率 ， 大 家 可 以 在 开发 板 中 加 载 上 一 章 的 驱动 程序 模块 imx6uirq.ko, ZA 
后 以 后 台 运 行 模式 打开 imx6uirqApp 这 个 测试 软件 ， 命 令 如 下 : 

.imxouirqApp /dev/imx6uirq & 

测试 驱动 是 否 正常 工作 ， 如 果 驱 动工 作 正常 的 话 输入 “top” 命 令 查看 imx6uirqApp 这 个 应 
用 程序 的 CPU 使 用 率 ， 结 果 如 图 522.1 所 示 : 


Load average: 0.99 0.63 0.28 2/37 74 
PID_PPTND USFR STAT . VSZ %VSZ CPU %CPL COMMAND 


















































































































7 61 0 R 1224 0.2 0 99.6 ./1imx6uirgApp /dev/imx6uirc 
- D U R 030 D. U U. Oo = 
61 10 S 2636 0.5 0 0.0 -/bin/sh CPU 使 用 率 高 
1 0 0 S 2632 0.5 0 0.0 init 达 99.6% 
54 20 SW 0 0.0 0 0.0 [kworker/0:3] ` 
55 2 0 SW< 0 0.0 0 0.0 [kworker/0:1H] 
图 52.2.1 CPU 使 用 率 














从 图 52.2.1 可 以 看 出 ，imx6uirqApp 这 个 应 用 程序 的 CPU 使 用 率 竟然 高 达 99.6%， 这 仅仅 
是 一 个 读 取 按键 值 的 应 用 程序 ,这 么 高 的 CPU 使 用 率 显然 是 有 问题 的 ! 原因 就 在 于 我 们 是 直接 
在 while 循环 中 通过 read 函数 读 取 按 键 值 ， 因 此 imx6uirqApp 这 个 软件 会 一 直 运 行 ， 一 直 读 取 
按键 值 ，CPU 使 用 率 肯 定 就 会 很 高 。 最 好 的 方法 就 是 在 没有 有 效 的 按键 事件 发 生 的 时 候 ， 
imx6uirqApp 这 个 应 用 程序 应 该 处 于 休 眼 状态 ， 当 有 按键 事件 发 生 以 后 imx6uirqApp 这 个 应 用 
程序 才 运行 ， 打 印 出 按键 值 ， 这 样 就 会 降低 CPU 使 用 率 ， 本 小 节 我 们 就 使 用 阻塞 IO 来 实现 此 
功能 。 


























































































































522.1 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 15.2 小 节 即 可 。 





5222 实验 程序 编写 


1、 豫 动 程序 编写 

本 实验 对 应 的 例 程 路 径 为 ， 开 发 板 光盘 -> 2. Linux 驱动 例 程 -> 14_blockio。 

本 章 实验 我 们 在 上 一 章 的 “13_irqg” 实 验 的 基础 上 完成 , 主要 是 对 其 添加 阻塞 访问 相关 的 代 
码 。 新 建 名 为 “14_blockio” 的 文件 来， 然后 在 14_blockio 文件 夹 里 面 创 建 vscode 工程 ， 工 作 
区 命名 为 “blockio” 将 “13 irq” 实 验 中 的 imx6uirq.c 复制 到 14_blockio 文件 夹 中 ， 并 重 命 名 
为 blockio.c。 接 下 来 我 们 就 修改 blockio.c 这 个 文件 ， 在 其 中 添加 阻塞 相关 的 代码 ， 完 成 以 后 的 
blockio.c 内 容 如 下 所 示 ( 因 为 是 在 上 一 章 实 验 的 imx6uirq.c 文件 的 基础 上 修改 的 ， 因 为 了 减少 篇 
幅 ， 下 面 的 代码 有 省 略 ): 

















































































































示例 代码 52.2.2.1 blockio.c 文件 代码 (有 省 略 ) 
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1  £dinclude Xlinux/types.h» 
2  $include «linux/kernel.h» 


18 4include «asm/mach/map.h» 
19 4$include «asm/uaccess.h» 
20 $£include «asm/io.h» 


ul J[KCKCKCKCKCKCKCk KCkCk kCkCkCkCKCKCkCKCkCk KCKCk KOC KC KOC Ck KCkCk kCkCk kCk ck Ck kCk Ck kCk ck k kc k k kc k kck ck ck kck kc kok k 


220 Copy © ATU SNIBERNECOT EINE 1998-20297 ALL ghtsecesctivecl 




















23 文件 名 : block.c 

24 作答 | : 左 忠 凯 

25 版 本 ERA 

26 描述 : 阻塞 IO 访问 

2 人 E 

28 论坛 : Www.openedv.com 

29 B% : 初版 V1.0 2019/7/26 左 忠 凯 创 建 

E KECKCKCKCKCKCkCkCkCk k kk k kk k kc k Ck kk k k kk k k Ck Ck kCk Ck k kc k k kc k k kCk k kc k ck kck ck kck ck kck ck ckckck kk ke k 
31 #define IMX6UIRQ CNT i /* 设备 号 个 数 说 
32 #define IMX6UIRQ NAME "blockio" /* 名 字 */ 
33 #define KEYOVALUE 0X01 /* KEYO 按键 值 a 
34 #define INVAKEY OXFF /* 无 效 的 按键 值 */ 
35 #define KEY NUM i /* 按键 数量 a 
36 


37 /* 中 断 IO 描述 结构 体 */ 
Je SEEUCE ireo keycese i 


39 iur. golo; le gpio i 
40 int irqnum; /* 中 断 号 n 
41 unsigned char value; /* 按键 对 应 的 键 值 容光 
42 char name[10]; /* 名 字 A 
43 irqreturn t (*handler) (int, void *); /* 中 断 服 务 函 数 */ 
44 p); 

45 


46 /* imx6uird 设 备 结构 体 */ 
47 struct imx6uirq devi 





48 dev t devid; /* 设备 号 ui 
49 struct eey edev? /* cdev rA 
50 struct class *class; /* 3& iA 
sl struct device *device;  /* 设备 DA 
32 iat major? /* 主 设备 号 
53 ime morg /* 次 设备 号 A, 
54 struct device node *nd; /* X4 A S 
55 atomic_t keyvalue; /* 有 效 的 按键 键 值 
56 atomic t releasekey; /* 标记 是 否 完成 一 次 完成 的 按键 on 
57 struct timer list timer; /* N Pena / 
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58 struct irq keydesc irqkeydesc[KEY NUM]; /* 按键 init 述 数组 */ 
59 unsigned char curkeynum; /* 当前 init 按键 号 */ 
60 

61 wait queue head t r wait; /* 读 等 待 队列 头 */ 

62 ); 

63 

64 struct imx6uirq dev imx6uirq;  /* irq bea */ 

65 

66 /* Qdescription : 中 断 服务 函数 ， 开 启 定时 器 

67 * 定时 器 用 于 按键 消 抖 。 

68  * @param - irq 中 断 号 

69  * eparam - dev id — : 设备 结构 。 

70 * Qreturn : 中 断 执行 结果 





gal */ 
T2 SütenExG irogreturm t keyO hancler(int irg, vore dey 1e) 
ee 

















74 struct imx6uirq dev *dev = (struct imx6uirq dev*)dev id; 
75 

76 dev-»curkeynum = 0; 

FN dev-»timer.data - (volatile long)dev id; 

78 moc timer ((Cwolewy-2icibwweir, Jifiies 7 mesecs to Jiirtiss (0) 

V9 return IRQ RETVAL (IRQ HANDLED) ; 

SO) 

81 

82 /* QGdescription  : 定时 器 服务 函数 ， 用 于 按键 消 拌 ， 定 时 器 到 了 以 后 

83 * 再 次 读 取 按键 值 ， 如 果 按 键 还 是 处 于 按 下 状态 就 表示 按键 有 效 。 
84  * Qparam - arg  : 设备 结构 变量 

85  * Qreturn 8 JE 

e wu 

87 void timer function(unsigned long arg) 

88 ( 

89 unsigned char value; 

90 unsigned char num; 

S dl Struct irg keydese vkeydesc, 

92 struct imzévirg Cev vdey = (Struct me Aew w) ergy 

9S 

94 num = dev-»curkeynum; 

35 keydesc = &dev->irqkeydesc [num]; 

96 

97 value = gpio get value (keydesc->gpio); /* iXHX ro fü */ 
98 if(value = 0) /* 按 下 按键 e 
99 atomic set(&dev-»keyvalue, keydesc-»value); 

100 ) 
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1O else{ /* 按键 松 开 ^ 
102 atomic set(&dev-»2keyvalue, 0x80 | keydesc-»value); 

IOS; atomic set(&dev-»releasekey, 1); 

104 } 

1105 


106 /* 唤醒 进程 */ 
107 if(atomic read(&dev->releasekey)) { /* 完成 一 次 按键 过 程 */ 


108 /* wake up(&dev-»r wait); */ 
109 wake up interruptible(&dev-»r wait); 
110 ) 

MaLa y 

112 

MS ses 

114 * @description : 按键 ro 初始 化 

115 * Gparam 8 XB 

116 * Gremm 3 JE 

Ma cx 

lile tecie ime keyio imie (voici 

MSN 

120 unsigned char i - 0; 

Qut char name[10]; 

122 int ret = 0; 


163 /* 创建 定时 器 */ 


164 init timer(&imxóuirq.timer); 

1:65 imx6uirq.timer.function = timer function; 
166 

167 /* 初始 化 等 待 队列 头 */ 

168 init waitqueue head(&imx6uirq.r wait); 
169 return 0; 

1.358) 3] 

1U 7/4 

iA 人 


173 = Qdescription s Ava 
174 * @param - inode: 传递 给 驱动 的 inode 
175 * @param - filp : 设备 文件 ，file 结构 体 有 个 叫做 private data 的 成 员 变 量 





176 * 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
7 : 0 成 功 ;其 他 失败 
S ey 


179) tatic int aae wb] opeex((siciwrei inode -inode, struct Tile wiil) 
180 { 

181 filp-»private data = &imx6uirq; /* 设置 私有 数据 */ 

182 return 0; 
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8s 

184 

Ta wq 

186  * @description : 从 设备 读 取 数 据 

187  * - :CEHTOTRIVE eo h (CE 

188  * - : 返回 给 用 户 空间 的 数据 缓冲 区 
189  * - : 要 读 取 的 数据 长 度 

190 * - : 相对 于 文件 首 地 址 的 偏 移 

ISl 5 

192 57 

19,5; Statie gsize t imxGuLlre iemel(siiwel tile wiillo, Chear  —— User buit, 
194 

135; int ret = 0; 

196 unsigned char keyvalue = 0; 

do unsigned char releasekey = 0; 

198 struct imx6uirq dev *dev = (struct imx6uirq dev *) 
dL 

200 #if 0 

201 /* 加 入 等 待 队列 ， 等 待 被 唤醒 ,也 就 是 有 按键 按 下 */ 
202 ret = wait event interruptible(dev-»r wait, 
203 if (ret) { 

204 goto wait_error; 

205 

206 #endif 

207 

208 DECLARE WAITQUEUE (wait, current); 

209 if(atomic read(&dev-»releasekey) == 0) ( 
210 add wait queue(&dev-»r wait, &wait); 
211 . Set current state(TASK INTERRUPTIBLE);/* 设置 任务 状态 */ 
2:12 schedule(); 

213 if(signal pending (current)) { 

214 ret = -ERESTARTSYS; 

215 goto wait_error; 

216 

217 

218 

Z9 

220 keyvalue atomic read(&dev-»keyvalue); 

20271 releasekey 











: 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 


gize t Gmt; loti © SORET) 


tilp private data; 


atomic_read (&dev->releasekey)) ; 


remove_wait_queue (&dev->r_wait, &wait);/* 唤醒 以 后 将 等 待 队列 移 除 */ 





e31E SIT 


论坛 :www.opendev.com 

















/* 定义 一 个 等 待 队列 */ 
/* 没有 按键 按 下 */ 
/* 添加 到 等 待 队列 头 */ 


/* XtfT VES */ 
/* 判断 是 否 为 信号 引起 的 唤醒 */ 





atomic read(&dev-»releasekey); 
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234 
225 


return 0; 


wait error: 


set current state(TASK RUNNING); 


return ret; 


data error: 


return -EINVAL; 





/* 设备 操作 函数 */ 


statie struct tile operertione meio = d 























.owner — THIS MODULE, 
.open = imx6uirq open, 
.read - imx6uirq read, 
}; 
/ * 
* QGdescription  : 驱动 入 口 函 数 
* Qparam H 3B 
* Qreturn S 
zy 
ptatie int — imit mzonirg imit (voke) 
{ 
/* 1、 构 建设 备 号 */ 
if (nn eo maon) 
imx6uirq.devid - MKDEV(imx6uirq.major, 0); 
register chrdev region(imx6uirq.devid, IMX6UIRQ CNT, 
IMX6UIRQ NAME) E 
) else ( 
alloc chrdev region(&imx6uirq.devid, 0, IMX6UIRQ CNT, 
IMX6UIRQ NAME) E 
imx6uirq.major = MAJOR(imxóuirq.devid); 
imx6uirg.minor - MINOR(imx6uirq.devid); 
) 
/* oN 从 化 按键 = 
atomic set(&imx6uirq.keyvalue, INVAKEY); 
atomic set(&imx6uirq.releasekey, 0); 
keyio imit)? 
return 0; 
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/* 设置 任务 为 运行 态 */ 
remove wait queue(&dev-»r wait, &wait); /* 将 等 待 队列 移 除 


*/ 
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Z9 

Z9] 

N 

293 * @description : 驱动 出 口 函 数 

294 * Qparam BH 3E 

295 * Qreturn NES 

296 

297 müeeuEiLe void exit imxOUirE exit (VOLC) 

298 ( 

2:09 unsigned i = 0; 

300 /* 删除 定时 器 */ 

ENT del timer sync(&imxóuirq.timer); /* 删除 定时 器 */ 
SN class destroy(imx6uirq.class); 

ets 1 

Sg 


Slo mocule greed (ertmos aera emer) 


314 module exit(imx6uirq exit); 
Sul MODULE LICENSE ("GPL"); 


出 现 一 个 名 为 “/dewblockio” 的 文件 。 

















第 32 行 ， 修 改 设备 文件 名 字 为 “blockio”， 当 驱动 程序 加 载 成 功 以 后 就 会 在 根 文件 系统 中 

















第 61 行 ， 在 设备 结构 体 中 添加 一 个 等 待 队列 头 r_wait， 因 为 在 Linux 驱动 中 处理 阻塞 IO 








需要 用 到 等 待 队列 。 











第 107~110 行 ， 定 时 器 中 断 处 理 函 数 执行 ， 表 示 有 按键 按 下 ， 先 在 107 行 判断 一 下 是 否 是 

















一 次 有 效 的 按键 ， 如 果 是 的 话 就 通过 wake up 或 者 wake up interruptible 函数 来 唤醒 等 待 队列 


r wait. 


releasekey 有 效 ， 也 就 是 有 按键 按 下 。 如 果 按 键 没 有 按 下 的 话 进程 就 会 进入 休眠 状态 ， 因 为 采用 





第 168 行 ， 调 用 init waitqueue head 函数 初始 化 等 待 队列 头 T_wait。 
第 200-206 行 ， 采 用 等 待 事件 来 处 理 read 的 阻塞 访问 ，wait_event_interruptible 函数 等 待 

































































了 wait event interruptible 函数 ， 因 此 进入 休 眼 态 的 进程 可 以 被 信号 打上 断 。 





第 208-218 行 ， 首 先 使 用 DECLARE WAITQUEUE 宏 定义 一 个 等 待 队 列 ， 如 果 没 有 按键 








按 下 的 话 就 使 用 add wait queue 函数 将 当前 任务 的 等 待 队列 添加 到 等 待 队列 头 r_wait 中 。 随 后 
调用 _set_current_state 函数 设置 当前 进程 的 状态 为 TASK_INTERRUPTIBLE， 也 就 是 可 以 被 信 
号 打 断 。 接 下 来 调用 schedule 函数 进行 一 次 任务 切换 ， 当 前 进程 就 会 进入 到 休眠 态 。 如 果 有 按 
键 按 下 , 那么 进入 休 眼 态 的 进程 就 会 唤醒 , 然后 接着 从 休 眼 点 开始 运行 。 在 这 里 也 就 是 从 第 213 
























































83 


开始 运行 ， 首 先 通过 signal pending 函数 判断 一 下 进程 是 不 是 由 信号 唤醒 的 ， 如 果 是 由 信号 




















唤醒 的 话 就 直接 返回 -ERESTARTSYS 这 个 错误 码 。 如 果 不 是 由 信号 唤醒 的 (也 就 是 被 按键 唤醒 


的 ) 









































那么 就 在 218 行 调 用 remove wait queue 函数 将 进程 从 等 待 队 列 中 删除 。 
使 用 等 待 队列 实现 阻塞 访问 重点 注意 两 点 : 

GD、 将 任务 或 者 进程 加 入 到 等 待 队列 头 ， 

多、 在 合适 的 点 唤醒 等 待 队 列 ， 一 般 都 是 中 断 处 理 函 数 里 


2、 编 写 测试 APP 



























































时 
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本 节 实 验 的 测试 APP 直接 使 用 第 51.3.3 小 节 所 编写 的 imx6uirqApp.c, 将 imx6uirqApp.c 复 
制 到 本 节 实 验 文件 夹 下 ， 并 且 重 命名 为 blockioApp.c， 不 需要 修改 任何 内 容 。 








52.2.3 运行 测试 


1、 编 译 驱动 程序 和 测试 APP 


了 由、 编译 驱动 程序 
编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 blockio.o，Makefile 内 容 如 下 所 示 : 
示例 代码 52.2.3.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
rel img 4515159 2,150 ee alientelk 






































4 obj-m := blockio.o 








12 $(MAKE) -C S$(KERNELDIR) Me$(CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 blockio.o。 

输入 如 下 命令 编译 出 驱动 模块 文件 : 

make -j32 

编译 成 功 以 后 就 会 生成 一 个 名 为 “blockio.ko” 的 驱动 模块 文件 。 

D, MENA APP 

输入 如 下 命令 编译 测试 noblockioApp.c 这 个 测试 程序 : 


arm-linux-gnueabihf-gcc blockioApp.c -o blockioApp 
编译 成 功 以 后 就 会 生成 blcokioApp 这 个 应 用 程序 。 


2、 运 行 测试 
将 上 一 小 节 编 译 出 来 blockio.ko 和 blockioApp 这 两 个 文件 找 贝 到 rootfs/lib/modules/4.1.15 


目录 中 ， 重 局 开 发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 加 载 blockio.ko 驱动 模 
块 : 



























































depmod /第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 

modprobe blockio.ko /加 载 驱动 

驱动 加 载 成 功 以 后 使 用 如 下 命令 打开 blockioApp 这 个 测试 APP， 并 且 以 后 台 模 式 运 行 : 
.blockioApp /dev/blockio & 

按 下 开发 板 上 的 KEY0 按键 ， 结 果 如 图 52.2.3.1 Bros: 


/lib/modules/4. 1.15 # dsl ies ioni frutos & 
pd 1.15 £ key value = 


SS 


























key value = 

key value = OX 
key value = 0X1 
key value = 0X1 
key value = 0X1 
key value = 0X1 
key value = 0X1 


图 52.2.3.1 测试 APP 运行 测试 
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当 按 下 KEY0 按键 以 后 blockioApp 这 个 测试 APP 就 会 打印 出 按键 值 。 输 入 “top” 命 令 ， 
查看 blockioAPP 这 个 应 用 APP 的 CPU 使 用 率 ， 如 图 52.2.3.2 所 示 : 


Mem: 51212K used, 457716K free, OK shrd, OK buff, 5784K cached 
CPU: 8.3% usr 8.3% sys 0.0% nic 83.3% idle 0.0% io 0.0% irq 0.0% sirq 
Load average: 0.00 0.01 0.02 1/38 89 



































PPID USER STAT VSZ %VSZ CPU %CPU COMMAND 
61 10 S 2636 0.5 0 0.0 -bin/sh CPU 0.0% 
1 00 S 2632 0.5 0 -0.0_ jin di 
84 61 0 S 1224 0.2 © .0 M Er /dev/blockio 
7 20 SW 0 0.0 0 0.0 [rcu preemp 


图 52.2.3.2 应 用 程序 CPU 使 用 率 

从 图 52.2.3.2 可 以 看 出 ， 当 我 们 在 按键 驱动 程序 里 面 加 入 阻塞 访问 以 后 ，blockioApp 这 个 
应 用 程序 的 CPU 使 用 率 从 图 52.2.1 中 的 99.6% 降 低 到 了 0.0%。 大 家 注意 ， 这 里 的 0.0% 并 不 是 
说 blockioApp 这 个 应 用 程序 不 使 用 CPU 了 ， 只 是 因为 使 用 率 太 小 了 ，CPU 使 用 率 可 能 为 
0.00001%， 但 是 图 52.2.3.2 只 能 显示 出 小 数 点 后 一 位 ， 因 此 就 显示 成 了 0.0%。 

我 们 可 以 使 用 “kill” 命令 关闭 后 台 运行 的 应 用 程序 ， 比 如 我 们 关闭 掉 blockioApp 这 个 后 台 
运行 的 应 用 程序 。 首 先 输出 “Ctrl+HC” 关 闭 top 命令 界面 ， 进 入 到 命令 行 模式 。 然 后 使 用 “ps” 
命令 查看 一 下 blockioApp 这 个 应 用 程序 的 PID, WE 52.2.3.3 所 示 : 


/lib/modules/4.1.15 # ps 
PID USER TIME COMMAND 
10 0:01 init blockioApp 这 个 


Wk 应 用 程序 的 PID 为 

























































































图 52.2.3.3 当前 系统 所 有 进程 的 ID 
从 图 图 52.2.3.3 可 以 看 出 ，blockioApp 这 个 应 用 程序 的 PID 为 149， 使 用 “kill -9 PID” B] 
可 “ 杀 死 ”指定 PID 的 进程 ， 比 如 我 们 现在 要 “ 杀 死 ”PID 为 149 的 blockioApp 应 用 程序 ， 可 
是 使 用 如 下 命令 : 























kill -9 149 
输入 上 述 命令 以 后 终端 显示 如 图 52.2.3.4 所 示 : 
/lib/modules/4.1.15 # kill -9 149 
[1] killed ./blockioApp /dev/blockio 
/lib/modules/4.1.15 £ 
图 52.2.3.4 kill 命令 输出 结果 
从 图 52.2.3.4 可 以 看 出 ,“./blockioApp /dev/blockio” 这 个 应 用 程序 已 经 被 “ 杀 掉 ”了 ， 在 此 
输入 “ps” 命 令 查看 当前 系统 运行 的 进程 ， 会 发 现 blockioApp 已 经 不 见 了 。 这 个 就 是 使 用 Kill 
命令 “ 杀 掉 ”指定 进程 的 方法 。 


52.3 非 阻 塞 IO 实验 


52.3.1 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 15.2 小 节 即 可 。 
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52.3.2 实验 程序 编写 











1、 了 驱动 程序 编写 
本 实验 对 应 的 例 程 路 径 为 : 开发 板 光 盘 -> 2. Linux 驱动 例 程 -> 15_noblockio。 
本 章 实验 我 们 在 52.2 小 节 中 的 “14 blockio” 实 验 的 基础 上 完成 ， 上 一 小 节 实 验 我 们 已 经 

















在 驱动 中 添加 了 阻塞 IO 的 代码 ， 本 小 节 我 们 继续 完善 驱动 ， 加 入 非 阻塞 IO 驱动 代码 。 新 建 名 
为 “15_noblockio” 的 文件 夹 ， 然 后 在 15_noblockio 文件 夹 里 面 创建 vscode 工程 ， 工 作 区 命名 
为 “noblockio”。 将 “14 blockio” 实 验 中 的 blockio.c 复制 到 15 noblockio 文件 夹 中 ， 并 重 命名 
为 noblockio.c。 接 下 来 我 们 就 修改 noblockio.c 这 个 文件 ， 在 其 中 添加 非 阻塞 相关 的 代码 ， 完 成 
以 后 的 noblockio.c 内 容 如 下 所 示 ( 因 为 是 在 上 一 小 节 实 验 的 blockio.c 文件 的 基础 上 修改 的 ， 因 
为 了 减少 篇 幅 ， 下 面 的 代码 有 省 略 ): 

示例 代码 52.3.3.1 noblockio.c 文件 (有 省 略 ) 

1  £$include <linux/types.h> 

2  $include «linux/kernel.h» 






































18 #include Xlinux/wait.h» 
19 4$include «linux/poll.h» 
20 #include «asm/mach/map.h» 
21 #include «asm/uaccess.h» 
22 #include «asm/io.h» 


228] M KCRCKCK kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kck kck kck ckck ckck 大。 大 ckck ckck kck ck ck ck ck ck ck koc 











24 Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
25 文件 名 Sole ee 











AG ET : 左 忠 凯 

27 版 本 5 VIO 

28 描述 : 非 阻 塞 ro 访问 

29 其 他 8 JE 

30 iex : www.openedv.com 

Sm ES : 初版 V1.0 2019/7/26 左 忠 凯 创 建 

no OKCKCKCKCKCKCkCk kCkCk k kk Ck kCkCk k kk k kk k kk Ck k Ck Ck kCkCk k kc k k kc k Ck kc k Ck kck ck kck ck ckck ck ckck ck kck ck ke kk f 
31 #define IMX6UIRQ CNT 1 /* 设备 号 个 数 3 
32 $define IMX6UIRQ NAME "noblockio" /* 45x */ 
Ay nm 

188  * Qdescription : 从 设备 读 取 数 据 

189  * @param - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 

190 * GQGparam - buf : 返回 给 用 户 空间 的 数据 缓冲 区 

Sl wenam — (Cu : 要 读 取 的 数据 长 度 

19/2. ** peran ~ OLTE : 相对 于 文件 首 地 址 的 偏 移 

193  * Qreturn : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 

194 z 


195 statie gsize t imura reacdletruct tile wiilp, cinese _ User voui, 


gize t Gmt, loti i wort) 


1270 


I.MX6U HX Linux 驱动 开发 指南 e» 1E za [m T 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
EGET 

3L 97) int ret = 0; 

198 unsigned char keyvalue = 0; 

199 unsigned char releasekey = 0; 

200 struct imx6uirq dev *dev = (struct imx6uirq dev *) 


filp-»private data; 














201 
202 if (filp-»f flags & O NONBLOCK) ( /* 非 阻 塞 访问 — */ 
203 if(atomic read(&dev->releasekey) == 0) /* 没有 按键 按 下 */ 
204 return -EAGAIN; 
205 ) else ( /* 阻塞 访问 E 
206 /* 加 入 等 待 队列 ， 等 待 被 唤醒 , 也 就 是 有 按键 按 下 */ 
207 ret = wait event interruptible(dev-»r wait, 

atomic read(&dev-»releasekey)); 
208 if (ret) ( 
209 goto wait error; 
210 ) 
ZU } 


22/9 yalt errors 
230 return ret; 


253i deta errors 























292 return -EINVAL; 

ZONE 

234 

29 E 

236  * GQdescription : poll 函数 ， 用 于 处 理 非 阻塞 访问 
237  * 8param - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 
238  * G8param - wait : SERIA (poll table) 

299 * return : 设备 或 者 资源 状态 ， 

240 v] 


241 unsigned int imx6uirq poll(struct file *filp, 
struct poll table struct *wait) 


242 ( 

243 unsigned int mask - 0; 

244 struct imx6uirq dev *dev = (struct imx6uirq dev *) 
filp-»private data; 

245 

246 poll wait(filp, &dev-»r wait, wait); 

247 

248 if(atomic read(&dev-»releasekey)) ( /* 按键 按 下 */ 

249 mask = POLLIN | POLLRDNORM; /* 返回 PLLIN */ 

250 } 
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251 return mask; 

252 ] 

253 

254 /* 设备 操作 函数 */ 

255 ratie struct iile gperarions no rops = wi 
256 .owner — THIS MODULE, 

225 .open = imxó6uirq open, 

258 .read - imx6uirq read, 

259 .poll = imx6uirq poll, 

2510) vg 

261 

UNS 

263 * Q8description : 驱动 入 口 函 数 

264 * @param 8 JE 

265 * Qreturn 3 JE 

Ze ww 

ASil gracie ne aba (volc) 
268 { 

298 keyio init)? 

299 return 0; 

300 ) 

301 

SOA fs 

303 * Qdescription : 驱动 出 口 函数 

304 * (QGparam 3 JE 

305 = Qreturn 8 JE 

306 7 

SOT stratie voici mn xe (voc) 
308 ( 

309 unsigned i = 0; 

310 /* 删除 定时 器 */ 

S del timer sync(&imx6uirg.timer); /* 删除 定时 器 */ 
320 Elass destroy (Chm ire Glass)? 
323 

222 

025 moule (Gn me imit) 

324 module exit(imx6uirq exit); 

325 MODULE LICENSE ("GPL"); 


第 32 行 ， 修 改 设 备 文 件 名 字 为 “noblockio”， 当 驱动 程序 加 载 成 功 以 
中 出 现 一 个 名 为 “/dev/noblockio” 的 文件 。 
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第 202-204 行 ， 判 断 是 否 为 非 阻塞 式 读 取 访 问 ， 如 果 是 的 话 就 判断 按键 是 否 有 效 ， 也 就 是 
判断 一 下 有 没有 按键 按 下 ， 如 果 没 有 的 话 就 返回 -EAGAIN。 


第 241-252 行 ，imx6uirq poll 函数 就 是 fle_operations 驱动 操作 和 集中 的 poll 函数 ， 当 应 用 














程序 调用 select 或 者 poll 函数 的 时 候 imx6uirq poll 函数 就 会 执行 。 第 246 行 调用 poll wait 函数 
将 等 待 队列 头 添加 到 poll table F, 第 248-250 行 判断 按键 是 否 有 效 , 如 果 按 键 有 效 的 话 就 向 应 
用 程序 返回 POLLIN 这 个 事件 ， 表 示 有 数据 可 以 读 取 。 

第 259 行 ， 设 置 file operations 的 poll 成 员 变 量 为 imx6uirq poll. 

2、 编 写 测试 APP 

新 建 名 为 noblockioApp.c 测试 APP 文件 ， 然 后 在 其 中 输入 如 下 所 示 内 容 : 












































示例 代码 52.3.3.2 noblockioApp.c 文件 代码 








il finclude "stdio.h" 

2 finclude "unistd.h" 

3  dinclude "sys/types.h" 

4  d$include "sys/stat.h" 

5  d4include "fcntl.h" 

6 dinclude "stdlib.h" 

mel ee te 

8  f$include "poll.h" 

9  £$include "sys/select.h" 

10 #include "sys/time.h" 

I nee Iba OCE c dni 

31522 J[KCKCKCKCKCKCkCk KCkCk kCkCk kCKCKCkCKCkCk KCKCk KC KC kCKCKCkCKCkCk KCkCk kCk Ck Ck kCk Ck kCk Ck k kk k kc k kck ck ck kck ck ck ck k 
13 Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
14 文件 名 : noblockApp.c 

1e TEE : AD 

16 版 本 3 wmm 

17. 描述 : 非 阻塞 访问 测试 APP 

18 其 他 2 JE 

19 使 用 方法 ./blockApp /dev/blockio 打开 测试 App 
20 ieiz : www.openedv.com 

2i Elas : 初版 V1.0 2019/9/8 左 忠 凯 创建 

DD 类 类 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 类 类 火炎 火炎 火炎 火炎 火炎 类 大 火炎 大 大 类 大 类 大 类 大 类 大 大大 类 大 类 大 大 大 类/ 
29 

DUAE 

25  * Qdescription : main 主 程序 

26  * Qparam - argc : argv 数组 元 素 个 数 

2 = Goercemi = SIS GINA : 具体 参数 

28  * QGreturn : 0 成 功 ;其 他 失败 

2 

3/0). dne Te arge, Char ss 内 

ail h 

B2 ime TEQUE 

ES int ret 2 0; 
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34 char *filename; 

35 SEE pxole esp 

36 iol eet seexevelirolsr 

ay struct timeval timeout; 

38 unsigned char data; 

29 

40 if (argc !2 2) ( 

41 printf("Error Usage! re 

42 return -i|; 

43 ) 

44 

45 filename = argv[!]; 

46 fd = open(filename, O RDWR | O NONBLOCK);  /* 非 阻塞 访问 */ 
47 if (fd « O) ( 

48 printf("Can't open file %s\r\n", filename); 
49 return -i|; 

50 ) 

5l 

S2 pets. (0 

53 /* 构造 结构 体 */ 

54 fds.fd = fd; 

55 fds.events = POLLIN; 

56 

55) while (!) ( 

58 ret = XUI Sfc TONS 

59 if (ret) ( /* 数据 有 效 */ 

60 ret = read(fd, &data, sizeof(data)); 
61 if(ret < 0) ( 

62 /* 读 取 错误 */ 

63 ) else ( 

64 if (data) 

65 printf("key value = $d \r\n", data); 
66 ) 

67 ) else if (ret == 0) ( /* 超时 */ 

68 /* 用 户 自 定义 超时 处 理 */ 

69 ) else if (ret < 0) ( pE Bar M 

70 /* 用 户 自 定义 错误 处 理 */ 

qal } 

72 } 

73 #endif 

74 

T5 while (1) { 

76 FD ZERO(&readfds); 
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p ED SETE, Creaciiela) MP 

78 /* 构造 超时 时 间 */ 

po timeout. ty SEC = (0p 

80 timeout. tr psec = 500000; /* 500ms ™/ 

9l ret = select(fd + 1, &readfds, NULL, NULL, &timeout); 
82 switch (ret) ( 

83 case 0: /* 超时 */ 

84 /* 用 户 自 定义 超时 处 理 */ 

85 break; 

86 case -1: /* i */ 

87 /* 用 户 自 定义 错误 处 理 */ 

88 break; 

89 default: /* 可 以 读 取 数据 */ 

90 if(FD ISSET(fd, &readfds)) (t 

91 ret = read(fd, &data, sizeof(data)); 

92 if (ret <0) { 

93 /* ei */ 

94 ) else { 

95 if (data) 

96 printf("key value=%d\r\n", data); 
9m } 

98 } 

99 break; 

100 } 

Kon } 

102 

WOS close(fd); 

104 return ret; 

its Iy 








第 52-73 行 ， 这 段 代码 使 用 poll 函数 来 实现 非 阻 塞 访问 ， 在 while 循环 中 使 用 



































poll 函数 不 


断 的 轮 询 ， 检 查 驱 动 程序 是 否 有 数据 可 以 读 取 ， 如 果 可 以 读 取 的 话 就 调用 read. 函数 读 取 按 键 


数据 。 
第 75-101 行 ， 这 段 代码 使 用 select 函数 来 实现 非 阻塞 访问 。 








52.3.3 运行 测试 
1、 编 译 驱 动 程序 和 测试 APP 
Q、 编 译 驱 动 程序 














编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 


ir 
cz 


值 改 为 noblockio.o，Makefile 内 容 如 下 所 示 : 
示例 代码 52.3.3.1 Makefile 文件 














1 KERNELDIR :- /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 


rel imz 4.1.15 2.150 ga alisntek 
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4 obj-m := noblockio.o 
11 clean: 
12 S$(MAKE) =C S$(KERNELDIR) M=$ (CURRENT _ PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 noblockio.o。 
输入 如 下 命令 编译 出 驱动 模块 文件 : 
make -j32 
编译 成 功 以 后 就 会 生成 一 个 名 为 “noblockio.ko” 的 驱动 模块 文件 。 
© AENA APP 
输入 如 下 命令 编译 测试 noblockioApp.c 这 个 测试 程序 : 


arm-linux-gnueabihf-gcc noblockioApp.c -o noblockioApp 
编译 成 功 以 后 就 会 生成 noblcokioA pp 这 个 应 用 程序 。 

2、 运 行 测试 

将 上 一 小 节 编 译 出 来 noblockioko 和 noblockioApp 这 两 个 文件 拷贝 到 
rootfs/lib/modules/4.1.15 目录 中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 
加 载 blockio.ko 驱动 模块 : 

depmod /第 一 次 加 载 驱动 的 时 候 需 要 运行 此 命令 

modprobe noblockio.ko /加 载 驱动 

驱动 加 载 成 功 以 后 使 用 如 下 命令 打开 noblockioApp 这 个 测试 APP， 并 且 以 后 台 模 式 运行 : 

.noblockioApp /dev/noblockio & 

按 下 开发 板 上 的 KEY0 按键 ， 结 果 如 图 52.3.3.1 Bros: 
/lib/modules/4.1.15 £ V eA rie /dev/noblockio & 
Mole os ii i 1.15 # key] value = 1 
key value = 
key value 
key value 
key value 


key value 
key value 




































































"unm 
PPPPPP 


图 52.3.3.1 测试 APP 运行 测试 
当 按 下 KEY0 按键 以 后 noblockioApp 这 个 测试 APP 就 会 打印 出 按键 值 。 输入 “top” 命 令 ， 
查看 noblockioAPP 这 个 应 用 APP 的 CPU 使 用 率 ， 如 图 52.3.3.2 所 示 : 





























Mem: 58080K used, 450848K free, OK shrd, OK buff, 5816K cached 
CPU: 9.0% usr 0.0% sys 0.0% nic 90.9% idle 0.0% io 0.0% irq 0.0% sirq 
Load average: 0.00 0.01 0.05 1/38 135 








PPID USER STAT VSZ %VSZ CPU %CPU COMMAND 
61 10 S 2636 0.5 0 0.0 -/bin/sh 
1 0 0 S 2632 0.5 0 0.0 init CPU 使 用 率 0.0% 
135 61 0 R 2632 0.5 0 0.0 top 
134 61 0 S 1224 0.2 0[0.0 ./noblock10oApp /dev/noblock10o 








图 52.3.3.[2 应 用 程序 CPU 使 用 率 

从 图 52.3.3.2 可 以 看 出 ， 采 用 非 阻 塞 方式 读 处 理 以 后 ，noblockioApp 的 CPU 占用 率 也 低 至 
0.0%， 和 图 52.2.3.2 中 的 blockioApp 一 样 ， 这 里 的 0.0% 并 不 是 说 noblockioApp 这 个 应 用 程序 
不 使 用 CPU 了 ， 只 是 因为 使 用 率 太 小 了 ， 而 图 中 只 能 显示 出 小 数 点 后 一 位 ， 因 此 就 显示 成 了 
0.096. 
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如 果 要 “ 杀 掉 ”处 于 后 台 运 行 模式 的 noblockioApp 这 个 应 用 程序 ， 可 以 参考 52.2.3 小 节 
讲解 的 方法 。 
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第 五 十 三 章 异步 通知 实验 


在 前 面 使 用 阻塞 或 者 非 阻塞 的 方式 来 读 取 驱动 中 按键 值 都 是 应 用 程序 主动 读 取 的 ， 对 于 非 


























阻塞 方式 来 说 还 需要 应 用 程序 通过 poll 函数 不 断 的 轮 询 。 最 好 的 方式 就 是 驱动 程序 能 主动 向 应 
用 程序 发 出 通知 ， 报 告 自己 可 以 访问 ， 然 后 应 用 程序 在 从 驱动 程序 中 读 取 或 写 入 数据 ， 类 似 于 
我 们 在 裸 机 例 程 中 讲解 的 中 断 。Linux 提供 了 异步 通知 这 个 机 制 来 完成 此 功能 ， 本 章 我 们 就 来 
学 习 一 下 异步 通知 以 及 如 何在 驱动 中 添加 异步 通知 相关 处 理 代码 。 
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53.1 异步 通知 


53.1.1 异步 通知 简介 





我 们 首先 来 回顾 一 下 “中 断 ” 中 断 是 处 理 器 提供 的 一 种 异步 机 制 , 我 们 配置 好 中 断 以 后 就 
可 以 让 处 理 器 去 处 理 其 他 的 事情 了 ， 当 中 断 发 生 以 后 会 触发 我 们 事先 设置 好 的 中 断 服务 函数 ， 
在 中 断 服 务 函数 中 做 具体 的 处 理 。 比 如 我 们 在 裸 机 篇 里 面 编写 的 GPIO 按键 中 断 实 验 ， 我 们 通 
过 按键 去 开关 蜂 鸣 器 ， 采 用 中 断 以 后 处 理 器 就 不 需要 时 刻 的 去 查看 按键 有 没有 被 按 下 ， 因 为 按 
键 按 下 以 后 会 自动 触发 中 断 。 同 样 的 ，Linux a ee UR 
访问 驱动 设备 ， 通 过 阻塞 方式 访问 的 话 应 用 程序 会 处 于 休眠 态 ， 等 竺 驱动 设 备 可 以 使 用 ， 非 阻 
塞 方式 的 话 会 通过 poll 函数 来 不 断 的 轮 询 ， 碍 看 驱动 设备 文件 是 否 可 以 使 用 。 这 两 种 方式 都 需 
要 应 用 程序 主动 的 去 查询 设备 的 使 用 情况 ， 如 果 能 提供 一 种 类 似 中 断 的 机 制 ， 当 驱动 程序 可 以 
访问 的 时 候 主动 告诉 应 用 程序 那 就 最 好 了 。 

“信号 ”为 此 应 运 而 生 ， 信 和 号 类 似 于 我 们 硬件 上 使 用 的 “中 断 ” 只 不 过 信号 是 软件 层次 上 
的 。 算 是 在 软件 层次 上 对 中 断 的 一 种 模拟 ， 驱 动 可 以 通过 主动 向 应 用 程序 发 送信 号 的 方式 来 报 
告 自己 可 以 访问 了 ， 应 用 程序 获取 到 信号 以 后 就 可 以 从 驱动 设备 中 读 取 或 者 写 入 数据 了 。 整 个 
过 程 就 相当 于 应 用 程序 收 到 了 驱动 发 送 过 来 了 的 一 个 中 断 ， 然 后 应 用 程序 去 响应 这 个 中 断 ， 在 
整个 处 理 过程 中 应 用 程序 并 没有 去 查询 驱动 设备 是 否 可 以 访问 ,一 切 都 是 由 驱动 设备 自己 告诉 
给 应 用 程序 的 。 

阻塞 、 非 阻塞 、 异 步 通知 ， 这 三 种 是 针对 不 同 的 场合 提出 来 的 不 同 的 解决 方法 ， 没 有 优 劣 
之 分 ， 在 实际 的 工作 和 学 习 中 ， 根 据 自己 的 实际 需求 选择 合适 的 处 理 方法 即 可 。 

异步 通知 的 核心 就 是 信号 , 在 arch/xtensa/include/uapi/asm/signal.h 文件 中 定义 了 Linux 所 支 
持 的 所 有 信和 号， 这 些 信号 如 下 所 示 : 

示例 代码 53.1.1.1 Linux 信号 













































































































































































































































































34 #define SIGHUP 1 /* 终端 挂 起 或 控制 进程 终止 */ 
35 4define SIGINT 2 /* 终端 中 断 (Ctrl+tc 组 合 键 ) f 
36 #define SIGQUIT 3 /* 终端 退出 (ctr1l+\ 组 合 键 ) */ 
27 Tete ea eese STEILE 4 /* dEXkdH > E 
38 #define SIGTRAP 5 /* debug 使 用 有 断 点 指令 产生 */ 
39 #define SIGABRT 6 /* Hi abort (3) 发 出 的 退出 指令 in 
40 4$define SIGIOT 6 /* IOT 指令 af 
41 #define SIGBUS 7 /* 总 线 错误 = 
42 #define SIGFPE 8 /* 浮 点 运算 错误 */ 
43 #define SIGKILL 9 /* 杀 死 、 终 止 进程 */ 
44 #define SIGUSRI 10 /* 用 户 自 定义 信号 1 no 
45 #define SIGSEGV 11 /* 段 违 例 (无 效 的 内 存 段 ) E 
46 $define SIGUSR2 32 /* 用 户 自 定义 信号 2 e 
47 #define SIGPIPE 19 /* 回 非 读 管 道 写 入 数据 ur 
48 4$define SIGALRM 14 /* fep */ 
49 $define SIGTERM 15 /* 软件 终止 */ 
50 4define SIGSTKFLT 16 /* 栈 异 常 n 
51 4define SIGCHLD die /* 子 进程 结束 uid 
52 4define SIGCONT 18 /* 进程 继续 */ 
53 $define SIGSTOP 19 /* 停止 进程 的 执行 ， 只 是 暂停 */ 
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54 $define SIGTSTP 20 /* 停止 进程 的 运行 (Ctz1+2 组 合 键 ) */ 
55 #define SIGTTIN 2 /* 后 台 进 程 需要 从 终端 读 取 数 据 ef 
56 #define SIGTTOU 22 /* 后 台 进 程 需要 向 终端 号 数据 */ 

57 &define SIGURG 23 /* 有 "紧急 "数据 */ 

58 #define SIGXCPU 24 /* 超过 CPU 资源 限制 */ 

59 $define SIGXFSZ 25 /* 文件 大 小 超额 x 

60 $define SIGVTALRM 26 /* 虚拟 时 钟 信号 */ 

61 4define SIGPROF 2 /* 时 钟 信 号 描述 */ 

62 $define SIGWINCH 28 /* 窗 回 大 小 改变 */ 

63 &define SIGIO 29 /* 可 以 进行 输入 /输出 操作 

64 $define SIGPOLL SIEIO 

65 /* #define SIGLOS 26 

66 #define SIGPWR 30 /* 断 点 重启 */ 

67 #define SIGSYS S /* 非法 的 系统 调用 y 

68 4$define SIGUNUSED zi /* 未 使 用 信号 * 














在 示例 代码 53.1.1.1 中 的 这 些 信 号 中 ， 除 了 SIGKILL(9) 和 SIGSTOP(19) 这 两 个 信号 不 能 被 
忽略 外 , 其 他 的 信号 都 可 以 忽略 。 这 些 信 Kee AN 不 同 的 中 断 号 代表 了 不 同 的 中 断 ， 
不 同 的 中 断 所 做 的 处 理 不 同 ， 因 此 ， 了 驱动 程序 可 以 通过 向 应 用 程序 发 送 不 同 的 信号 来 实现 不 同 
的 功能 。 

我 们 使 用 中 断 的 时 候 需 要 设置 中 断 处 理 函 数 ， 同 样 的 ， 如 果 要 在 应 用 程序 中 使 用 信号 ， 那 
么 就 必须 设置 信号 所 使 用 的 信号 处 理 函数 ， 在 应 用 程序 中 使 用 signal 函数 来 设置 指定 信号 的 处 
理 函 数 ，signal 函数 原型 如 下 所 示 : 

sighandler t signal(int signum, sighandler t handler) 

函数 参数 和 返回 值 含义 如 下 : 

signum: 要 设置 处 理 函 数 的 信和 号。 

handler: 信号 的 处 理 函 数 。 

返回 值 ， 设置 成 功 的话 返 回信 号 的 前 一 个 处 理 函 数 ， 设 置 失 败 的 话 返回 SIG_ERR。 

信号 处 理 函数 原型 如 下 所 示 : 

typedef void (*sighandler t)(int) 

我 们 前 面 讲解 的 使 用 “kill -9 PID ” 杀 死 指定 进程 的 方法 就 是 向 指定 的 进程 (PID) 发 送 
SIGKILL 这 个 信号 。 当 按 下 键盘 上 的 CTRL+C 组 合 键 以 后 会 向 当前 正在 占用 终端 的 应 用 程序 发 
出 SIGINT 信号 ，SIGINT 信号 默认 的 动作 是 关闭 当前 应 用 程序 。 这 里 我 们 修改 一 下 SIGINT 信 
号 的 默认 处 理 函 数 ， 当 按 下 CTRL+C 组 合 键 以 后 先 在 终端 上 打印 出 “SIGINT signal!” 这 行 字 
符 串 ， 然 后 再 关闭 当前 应 用 程序 。 新 建 signaltest.c 文件 ， 然 后 输入 如 下 所 示 内 容 : 

示例 代码 53.1.1.2 信号 测试 


















































































































































dinclude "stdlib.h" 
dinclude "stdio.h" 


finclude "signal.h" 


void sigint handler(int num) 

( 
Prime E (UNEN GENS iona NENA) 
exit (0); 


(e e I CST S CN 
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2 

10 

Il ne retailel)) 

w i 

ES signal (SIGINT, sigint handler); 

14 while(!); 

JUS return 0; 

wen 


在 示例 代码 53.1.1.2 中 我 们 设置 SIGINT 信号 的 处 理 函 数 为 sigint_handler, 当 按 下 CTRL+C 
向 signaltest 发 送 SIGINT 信号 以 后 sigint handler 函数 就 会 执行 ， 此 函数 先 输出 一 行 “SIGINT 
signal!" FFE, AAH exit 函数 关闭 signaltest 应 用 程序 。 

使 用 如 下 命令 编译 signaltest.c: 

gcc signaltest.c -o signaltest 

然后 输入 “./signaltest” 命 令 打开 signaltest 这 个 应 用 程序 ， 然 后 按 下 键盘 上 的 CTRL+C 组 
合 键 ， 结 果 如 图 53.1.1.1 所 示 : 



































$ ./signaltest 
yn t 


SIGINT signal! 








图 53.1.1.1 signaltest 软件 运行 结 
从 图 53.1.1.1 可 以 看 出 ， 当 按 下 CTRL+C 组 合 键 以 后 sigint handler 这 个 SIGINT 信号 处 理 
函数 执行 了 ， 并 且 输 出 了 “SIGINT signal!” 这 行 字符 串 。 














53.1.2 驱动 中 的 信号 处 理 


1. fasync struct 结构 体 


首先 我 们 需要 在 驱动 程序 中 定义 一 个 fasync. struct 结构 体 指针 变量 , fasync. struct 结构 体内 
容 如 下 : 






































示例 代码 53.1.2.1 fasync struct 发 结构 体 


ceeueeerasyaes ee Ue 


spinlock t ie loek; 
AAE magic; 
TNE ig cel 
Seructe Tasya SEEUGCD via Qe 
SEE iNe wta dalle 
grruet reu head ae 


Dg 





一 般 将 fasync struct 结构 体 指针 变量 定义 到 设备 结构 体 中 , 比如 在 上 一 章节 的 imx6uirq dev 
结构 体 中 添加 一 个 fasync_struct 结构 体 指针 变量 ， 结 果 如 下 所 示 : 
示例 代码 53.1.2.2 在 设备 结构 体 中 添加 fasync_struct 类 型 变量 指针 


1L SEU Tnzoulise Gew i 





2 struct device *dev; 


3 struct eese welse 
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4 struct cdev cdev; 

14 struct fasync struct *async queue; /* 异步 相关 结构 体 */ 

LS 35 





第 14 行 就 是 在 imx6uirq. dev 中 添加 了 一 个 fasync. struct 结构 体 指针 变量 。 
2. fasync 函数 














如 果 要 使 用 异步 通知 ， 需 要 在 设备 驱动 中 实现 file operations 操作 集中 的 fasync 函数 ， 此 








函数 格式 如 下 所 示 : 
int (*fasync) (int fd, struct file *filp, int on) 











fasync 函数 里 面 一 般 通 过 调用 fasyne helper 函数 来 初始 化 前 面 定 义 的 fasync struct 结构 体 




















指针 ，fasync_helper 函数 原型 如 下 : 
int fasync_helper(int fd, struct file * filp, int on, struct fasync struct **fapp) 





fasync helper 函数 的 前 三 个 参数 就 是 fasync 函数 的 那 三 个 参数 ， 第 四 个 参数 就 是 要 初始 化 
的 fasync struct 结构 体 指针 变量 。 当 应 用 程序 通过 “fentl(fd, F SETFL, flags | FASYNC)” 改 变 














fasync 标记 的 时 候 ， 驱 动 程序 file_operations 操作 集中 的 fasync 函数 就 会 执行 。 
驱动 程序 中 的 fasyne 函数 参考 示例 如 下 : 
示例 代码 53.1.2.3 驱动 中 fasync 函数 参考 示例 

















下 

2 Ec eu 

3 struct fasync struct *async queue; /* 异步 相关 结构 体 */ 
Hp 

5 

a tatie int xx Tasyne(ine fe, Struct tile wiilp;, ime om) 
7 4 

8 struct xxx dev *dev - (xxx dev)filp-»private data; 

9 

10 if (fasync helper(fd, filp, on, &dev-»async queue) < 0) 
dE return -EIO; 

12 return 0; 

IS 

14 

lg gtatiet struct iile Gosratlons 2e Ops = 4 

M E Boer 

db) .fasync - xxx fasync, 

joo M cu 

AS bg 


在 关闭 驱动 文件 的 时 候 需 要 在 file operations 操作 集中 的 release 函数 中 释放 fasync. struct, 
fasync struct 的 释放 函数 同样 为 fasync helper. release 函数 参数 参考 实例 如 下 : 

示例 代码 53.1.2.4 释放 fasync struct 参考 示例 
l statice imie xz :selesse(stiuest imogle vinode, struct iile wil 
2 N 
3 return xxx fasync(-1, filp, 0); /* 删除 异步 通知 */ 
2 y 
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5 
6 statie ue iile operations <2 OS = d 
ret 
8 .release = xxx release, 
pp 
第 3 行 通 过 调用 示例 代码 53.1.2.3 中 的 xxx. fasyne 函数 来 完成 fasynce. struct 的 释放 工作 ， 
但 是 ， 其 最 终 还 是 通过 fasync_helper 函数 完成 释放 工作 。 





1, kill fasync 函数 


当 设 备 可 以 访问 的 时 候 , 驱动 程序 需要 向 应 用 程序 发 出 信号 , 相当 于 产生 “ 中断 ”.kill_ fasync 
函数 负责 发 送 指定 的 信号 ，Kill_fasync 函数 原型 如 下 所 示 : 

void kill fasync(struct fasync struct **fp, int sig, int band) 

函数 参数 和 返回 值 含义 如 下 : 

fp: 要 操作 的 fasync struct. 

sig: 要 发 送 的 信和 号。 

band: 可 读 时 设置 为 POLL IN， 可 写 时 设置 为 POLL OUT. 

返回 值 : 无 。 














53.1.3. 应 用 程序 对 异步 通知 的 处 理 

应 用 程序 对 异步 通知 的 处 理 包 括 以 下 三 部 : 

1、 注 册 信 号 处 理 函 数 

应 用 程序 根据 驱动 程序 所 使 用 的 信号 来 设置 信号 的 处 理 函 数 ， 应 用 程序 使 用 signal 函数 来 
设置 信号 的 处 理 函 数 。 前 面 已 经 详细 的 讲 过 了 ， 这 里 就 不 细 讲 了 。 

2、 将 本 应 用 程序 的 进程 号 告诉 给 内 核 

使 用 fentl(fd,F SETOWN, getpidO) 将 本 应 用 程序 的 进程 号 告诉 给 内 核 。 

3、 开 启 异步 通知 


使 用 如 下 两 行程 序 开启 异步 通知 : 

flags = fentl(fd, F GETFL); /* 获取 当前 的 进程 状态 */ 

fcntl(fd, F SETFL, flags | FASYNC); /* 开启 当前 进程 异步 通知 功能 */ 

重点 就 是 通过 fentl 函数 设置 进程 状态 为 FASYNC， 经 过 这 一 步 ， 驱 动 程序 中 的 fasync A 
数 就 会 执行 。 


53.2 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 15.2 小 节 即 可 。 


53.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 2、Linux 驱动 例 程 -> 16_asyncnoti。 

本 章 实验 我 们 在 上 一 章 实验 “15_noblockio” 的 基础 上 完成 ,在 其 中 加 入 异步 通知 相关 内 容 
即 可 ， 当 按键 按 下 以 后 驱动 程序 向 应 用 程序 发 送 SIGIO 信和 号， 应 用 程序 获取 到 SIGIO 信和 号 以 后 
读 取 并 且 打 印 出 按键 值 。 
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53.3.1 修改 设备 树 文件 
因为 是 在 实验 “15_noblockio” 的 基础 上 完成 的 ， 因 此 ， 不 需要 修改 设备 树 。 





53.3.2 程序 编写 











新 建 名 为 “16_asyncnoti” 的 文件 夹 ， 然 后 在 16 asyncnoti 文件 夹 里 面 创 建 vscode 工程 ， 工 





作 区 命名 为 “asyncnoti” 将 “15_noblockio” 实 验 中 的 noblockio.c 复制 到 16 asyncnoti 文件 夹 


中 ， 





并 重 命 名 为 asyncnoti.c。 接 下 来 我 们 就 修改 asyncnoti.c 这 个 文件 ， 在 其 中 添加 异步 通知 关 








的 代码 ， 完 成 以 后 的 asyncnoti.c 内 容 如 下 所 示 ( 因 为 是 在 上 一 章 实验 的 noblockio.c 文件 的 基础 
上 修改 的 ， 因 为 了 减少 篇 幅 ， 下 面 的 代码 有 省 略 ): 

















示例 代码 53.3.2.1 asyncnoti.c 文件 代码 段 
finclude <linux/types.h> 


#include «linux/fcntl.h» 

finclude «asm/mach/map.h» 

finclude «asm/uaccess.h» 

finclude «asm/io.h» 

[Ck kk kk k kk ke ke kk Kk kk koh KK KK kk ok K KK KK ok Rok KICK koc kk k k oko kk k k k k k k k k 
Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
文件 名 : asyncnoti.c 



































作者 : ZEB 
版 本 eo Was 

pus : 非 阻 塞 ro 访问 
其 他 3 JE 
论坛 : www.openedv.com 

nh : 初版 V1.0 2019/8/13 左 忠 凯 创建 
炎炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 类 大 类 大火 大火 类 火炎 类 火炎 大火 大 类 大 类 大 火炎 火炎 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 大/ 
#define IMX6UIRQ CNT 1 /* 设备 号 个 数 2) 
#define IMX6UIRQ NAME "asyncnoti" /* 名 字 uf 
#define KEYOVALUE 0X01 /* KEYO 按键 值 a 
#define INVAKEY OXFF /* 无 效 的 按键 值 ui 
&define KEY NUM 1 /* 按键 数量 */ 








/* imx6uirq 设备 结构 体 */ 


struct imx6óuirq dewi 


struct fasync struct *async queue; /* 异步 相关 结构 体 */ 
}; 


struct imx6uirq dev imx6uirq;  /* irqW& */ 
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85 /* edqescription  : 定时 器 服务 函数 ， 用 于 按键 消 拌 ， 定 时 器 到 了 以 后 

86 * 再 次 读 取 按 键 值 ， 如 果 按 键 还 是 处 于 按 下 状态 就 表示 按键 有 效 。 

87 * @param - arg  : 设备 结构 变量 

88  * Qreturn 8 2B 

OO 

90 void timer function(unsigned long arg) 

SHE 

92 unsigned char value; 

93 unsigned char num; 

94 struct irg keydese vVisewelesc 

95 struct imzévuirg Glew vdey = (Struct mzsuirg Glew; v5) 83589? 

109 if (atomic_read (&dev->releasekey)) { /* 一 次 完整 的 按键 过 程 */ 

110 if (dev->async_queue) 

alabab kill fasync(&dev-»async queue, SIGIO, POLL IN); 

112 } 

IIS 

114 #if 0 

115 /* 唤醒 进程 */ 

116 if (atomic read(&dev->releasekey)) { /* 完成 一 次 按键 过 程 */ 

115157 /* wake up(&dev-»r wait); */ 

118 wake up interruptible(&dev-»r wait); 

119 ) 

120 #endif 

Jd. 3 

262 /* 

263 * @description  : fasync 图 数 ， 用 于 处 理 异 步 通 知 

264 * Qparam - fd : 文件 描述 符 

265 * Qparam - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 

266 * Qparam - on : 模式 

267 * Qreturn : 负数 表示 函数 执行 失败 

268m7 

269 static int imx6uirq_fasync (int fd, struct file *filp, int on) 

270 { 

271 struct imx6uirq dev *dev = (struct imx6uirq dev *) 
filp-»private data; 

272 return fasync helper(fd, filp, on, &dev-^async queue); 

273 ) 

274 

29S gf 

276 * Qdescription : release 函数 ， 应 用 程序 调用 close 关闭 驱动 文件 的 时 候 会 执行 

271] > Qparam - inode: inode WA 
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278 * @param - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 
区 : 负数 表示 函数 执行 失败 
9M", 

281 static int imx6uirq release(struct inode *inode, struct file *filp) 
282 ( 

283 return imx6uirq fasync(-i, filp, 0); 
284 } 

285 

286 /* 设备 操作 函数 */ 

201 etetic struct tile operations imzouirg tops = i 
288 .owner — THIS MODULE, 

289 .open = imx6uirq open, 

290 .read - imx6uirq read, 

ZO .poll = imx6uirq poll, 

292 .Easync = imx6uirq fasync, 

293 .release = imx6uirq release, 

294 ); 

25 

DIDI AS 

297 * Qdescription : 驱动 入 口 函 数 

2199 ME paran 3 JE 

299 * Qreturn IS 

EXON 

SOl pracie ime ——— imirt le eat (voke) 

SMA N 

328 

329 /* 5. 始 化 按键 */ 

330 atomic set(&imx6uirq.keyvalue, INVAKEY); 
o atomic set(&imx6uirq.releasekey, 0); 
Sis keyio init(); 

939g return 0; 

334 ) 

S35 

DON AX 

337 * Qdescription : 驱动 出 口 函 数 

338 * @param 8 JE 

339 * Qreturn 3 Jb 

340 */ 

SLE etacie voie neo) 

342 ( 

343 unsigned i - 0; 
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354 elass destroy (emo Ue ee 

goce 

356 


$517 module stone (im:Güire imit) p 
Eumesimilte exit (mn 
359 MODULE LICENSE ("GPL"); 
第 20 行 ， 添 加 fentl.h 头 文件 ， 因 为 要 用 到 相关 的 API 函数 。 
第 64 行 ， 在 设备 结构 体 imx6uirq dev 中 添加 fasync_struct 指针 变量 。 
第 109~112 行 ， 如 果 是 一 次 完整 的 按键 过 程 ， 那 么 就 通过 kill fasync 函数 发 送 SIGIO 信 




















第 114~120 行 ， 屏 项 掉 以 前 的 唤醒 进程 相关 程序 。 

第 269~273 行 ，imx6uirq fasync 函数 ， 为 file operations 操作 集中 的 fasync 函数 ， 此 函数 
内 容 很 简单 ， 就 是 调用 一 下 fasync_helper。 

第 281-284 行 ，release 函数 ， 应 用 程序 调用 close 函数 关闭 驱动 设备 文件 的 时 候 此 函数 就 
会 执行 ， 在 此 函数 中 释放 掉 fasync_struct 指针 变量 。 

第 292~293 行 ， 设 置 file_operations 操作 和 集中 的 fasync 和 release 这 两 个 成 员 变 量 。 






































53.3.3 编写 测试 APP 


测试 APP 要 实现 的 内 容 很 简单 ， 设 置 SIGIO 信和 号 的 处 理 函 数 为 sigio_ signal func， 当 驱动 
程序 向 应 用 程序 发 送 SIGIO 信号 以 后 sigio signal func 函数 就 会 执行 。sigio_signal func 函数 内 
容 很 简单 ， 就 是 通过 read 函数 读 取 按 键 值 。 新 建 名 为 asyncnotiApp.c 的 文件 ， 然 后 输入 如 下 所 
WAX: 
































示例 代码 53.3.3.2 asyncnotiApp.c 文件 代码 段 























o eele Werohia Ini 

Ze lade me 

3 4sinclude "sys/types.h" 

4 d*$include "sys/stat.h" 

Smee "usen dl c dare 

6 4include "stdlib.h" 

Wael ele st dme 

8 include "poll.h" 

9 #include "sys/select.h" 

10 #include "sys/time.h" 

a ee aorene e dan 

d uccisi e se 

9 JO KK e I E e A Ae ok KK KK ok RR KICK ok RC e E E E A A ok KK E A A e oko e A K K K E A k K K k k OK 
14 Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
15 文件 名 : asyncnotiApp.c 

16 fEX- : AD 

17 版 本 dou 

18 描述 : 异步 通知 测试 APP 

19 其 他 = 万 

20 使 用 方法 : ./asyncnotiApp /dev/asyncnoti 打开 测试 App 
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21 iex : www.openedv.com 

22 E : WIR v1.0 2019/8/13 左 忠 凯 创建 
2A 大 大大 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 类 火炎 大 火炎 类 类 火炎 大大 大大 类 类 类 类 类 大 类 大 类 大 类 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 类/ 
24 

2 

26 

2 

28 * SIGIO 信号 处 理 函 数 

29 * (param - signum : 信号 值 

30 * Qreturn B 

Sd cy 

32 Seaele vold GO siomnal Tune(int Sionu 
EE 

34 int err = 0; 

325 unsigned int keyvalue = 0; 

36 

2] err = read(fd, &keyvalue, sizeof(keyvalue)); 
38 if(err « 0) ( 

39 /* WEBB */ 

40 ) else { 

41 printf("sigio signal! key value-$dNrNn", keyvalue); 
42 } 

43 } 

44 

TO 

46 * @description : main 主 程序 

47 * Qparam - arge  : argy 数组 元 素 个 数 

48 * Qparam - argv  : 具体 参数 

49 * Qreturn : 0 成 功 ;其 他 失败 

ONES 

Si dme meane Arge, dna wenen M D) 

52i 

58 int flags - 0; 

54 char *filename; 

55 

56 if (arge !2 2) ( 

59 printf("Error Usage! NrNMn"); 

58 return -1; 

59 } 

60 

61 filename = argv[1]; 

62 fd 2 open(filename, O RDWR); 

63 eid (GECI «s (09 i 
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64 printf("Can't open file $sWNrMn", filename); 

65 return -1; 

66 } 

67 

68 /* 设置 信号 SIGIO 的 处 理 函 数 */ 

69 signal(SIGIO, sigio signal func); 

70 

Fa fcntl (fd, F SETOWN, getpid()); /* 将 当前 进程 的 进程 号 告诉 给 内 核 */ 
7g flags = fcntl(fd, F GETFD); /* 获取 当前 的 进程 状态 */ 
73 fcntl(fd, F SETFL, flags | FASYNC);/* 设置 进程 启用 异步 通知 功能 */ 
74 

715) while(!) ( 

76 sleep(2); 

qol } 

78 

79 close (fd); 

80 return 0; 

81 ] 














第 32-43 ÍT, sigio signal func 函数 ，SIGIO 信和 号 的 处 理 函 数 ， 当 驱动 程序 有 效 按键 按 下 
以 后 就 会 发 送 SIGIO 信号 ， 此 函数 就 会 执行 。 此 函数 通过 read 函数 读 取 按 键 值 ， 然 后 通过 
printf 函数 打印 在 终端 上 。 

第 69 行 ， 通 过 signal 函数 设置 SIGIO 信和 号 的 处 理 函 数 为 sigio signal func. 

第 71~73 行 ， 设 置 当 前 进程 的 状态 ， 开 启 异 步 通 知 的 功能 。 

第 75~77 行 ，while 循环 ， 等 待 信号 产生 。 





















































53.4 运行 测试 
53.4.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 

编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m AE 
量 的 值 改 为 asyncnoti.o，Makefile 内 容 如 下 所 示 : 
示例 代码 53.4.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 



































rel ims 451515 2-1-0 ee alientelk 
4 obj-m := asyncnoti.o 




















12 S$(MAKE) -C S(KERNELDIR) M=$ (CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 asyncnoti.o。 
输入 如 下 命令 编译 出 驱动 模块 文件 : 
make -j32 
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编译 成 功 以 后 就 会 生成 一 个 名 为 “asyncnoti.ko” 的 驱动 模块 文件 。 
2、 编 译 测试 APP 





输入 如 下 命令 编译 测试 asyncnotiApp.c 这 个 测试 程序 : 
arm-linux-gnueabihf-gcc asyncnotiApp.c -o asyncnotiApp 
编译 成 功 以 后 就 会 生成 asyncnotiApp 这 个 应 用 程序 。 





53.4.2. 运行 测试 


将 上 一 小 节 编 译 出 来 asyncnotiko 和 asyncnotiApp iX W ^ X fF $5 Ul $j 
rootfs/lib/modules/4.1.15 目录 中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 
加 载 asyncnoti.ko 驱动 模块 : 

depmod /第 一 次 加 载 驱动 的 时 候 需 要 运行 此 命令 

modprobe asyncnoti.ko /加 载 驱动 

驱动 加 载 成 功 以 后 使 用 如 下 命令 来 测试 中 断 : 

JasyncnotiA pp /dev/asyncnoti 

按 下 开发 板 上 的 KEY0 键 ， 终 端 就 会 输出 按键 值 ， 如 图 53.42.1 所 示 : 

/lib/modules/4.1.15 # ./asyncnotiApp /dev/asyncnoti 

















sigio signal! key value-1 
sigio signal! key value=1 
sigio signal! key value-1 
sigio signal! key value=1 
sigio signal! key value-1 
sigio signal! key value=1 
sigio signal! key value=1 


图 53.4.2.1 读 取 到 的 按键 值 

从 图 53.4.2.1 可 以 看 出 ， 捕 获 到 SIGIO 信号 ， 并 且 按 键 值 获取 成 功 ， 大 家 可 以 自行 以 后 台 

模式 运行 asyncnotiApp， 查 看 一 下 这 个 应 用 程序 的 CPU 使 用 率 。 如 果 要 外 载 驱动 的 话 输入 如 下 
命令 即 可 : 


rmmod asyncnoti.ko 
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第 五 十 四 章 platform 设备 驱动 实验 




















我 们 在 前 面 几 章 编写 的 设备 驱动 都 非常 的 简单 ,都 是 对 IO 进行 最 简单 的 读 写 操作 。 像 DC、 
SPI. LCD 等 这 些 复杂 外 设 的 驱动 就 不 能 这 么 去 写 了 ，Linux 系统 要 考虑 到 驱动 的 可 重用 性 ， 因 
此 提出 了 驱动 的 分 离 与 分 层 这 样 的 软件 思路 ， 在 这 个 思路 下 诞生 了 我 们 将 来 最 常 打交道 的 
platform 设备 驱动 , 也 叫做 平台 设备 驱动 。 本 章 我 们 就 来 学 习 一 下 Linux 下 的 驱动 分 离 与 分 层 ， 
以 及 plartorm 框架 下 的 设备 驱动 该 如 何不 编写 。 
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54.1 Linux 驱动 的 分 离 与 分 层 


54.1.1 驱动 的 分 隔 与 分 离 
对 于 Linux 这 样 一 个 成 熟 、 庞 大 、 复 杂 的 操作 系统 ， 代 码 的 重用 性 非常 重要 ， 否 则 的 话 就 











会 在 Linux 内 核 中 存在 大 量 无 意义 的 重复 代码 。 尤 其 是 驱动 程序 ， 因 为 驱动 程序 占用 了 Linux 
内 核 代 码 量 的 大 头 ， 如 果 不 对 驱动 程序 加 以 管理 ， 任 由 重复 的 代码 肆意 增加 ， 那 么 用 不 了 多 久 
Linux 内 核 的 文件 数量 就 庞大 到 无 法 接受 的 地 步 。 

假如 现在 有 三 个 平台 A、B 和 C,， 这 三 个 平台 (这 里 的 平台 说 的 是 SOC) 上 都 有 MPU6050 这 
个 DC 接口 的 六 轴 传 感 器 , 按照 我 们 写 裸 机 I2C 驱动 的 时 候 的 思路 , 每 个 平台 都 有 一 个 MPU6050 
的 驱动 ， 因 此 编写 出 来 的 最 简单 的 驱动 框架 如 图 54.1.1 所 示 : 
































主机 了 驱动 设备 驱动 





图 54.1.1 传统 的 PC 设备 驱动 

从 图 54.1.1 可 以 看 出 ， 每 种 平台 下 都 有 一 个 主机 了 驱动 和 设备 驱动 ， 主 机 驱动 肯定 是 必须 要 
的 ， 毕 竞 不同 的 平台 其 2C 控制 器 不 同 。 但 是 右 侧 的 设备 驱动 就 没 必要 每 个 平台 都 写 一 个 ， 因 
为 不 管 对 于 那个 SOC 来 说 ，MPU6050 都 是 一 样 ， 通 过 I2C 接口 读 取 数据 就 行 了 ， 只 需要 一 个 
MPU6050 的 驱动 程序 即 可 。 如 果 在 来 几 个 PC 设备 ， 比 如 AT24C02、FT5206( 电 容 触摸 屏 ) 等 ， 
如 果 按 照 图 54.1.1 中 的 写法 ， 那 么 设备 端的 驱动 将 会 重复 的 编号 好 几 次 。 显 然 在 Linux 驱动 程 
序 中 这 种 写法 是 不 推荐 的 , 最 好 的 做 法 就 是 每 个 平台 的 DC 控制 器 都 提供 一 个 统一 的 接口 (也 叫 
做 主机 驱动 )， 每 个 设备 的 话 也 只 提供 一 个 驱动 程序 (设备 驱动 )， 每 个 设备 通过 统一 的 DC 接口 
驱动 来 访问 ， 这 样 就 可 以 大 大 简化 驱动 文件 ， 比 如 54.1.1 中 三 种 平台 下 的 MPU6050 驱动 框架 
就 可 以 简化 为 图 54.1.2 所 示 : 
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主机 驱动 | 核心 层 | 设备 驱动 








图 54.1.2 改进 后 的 设备 驱动 
实际 的 12C 驱动 设备 肯定 有 很 多 种 , 不止 MPU6050 这 一 个 ,那么 实际 的 驱动 架构 如 图 54.1.3 
所 示 : 


主机 驱动 核心 层 | 设备 驱动 











图 54.1.3. 分 隔 后 的 驱动 框架 

这 个 就 是 驱动 的 分 隔 ， 也 就 是 将 主机 驱动 和 设备 驱动 分 隔 开 来 ， 比 如 DPC、SPI 等 等 都 会 采 
用 驱动 分 隔 的 方式 来 简化 驱动 的 开发 。 在 实际 的 驱动 开发 中 ， 一 般 PC 主机 控制 器 驱动 已 经 由 
半导体 三 家 编写 好 了 ， 而 设备 驱动 一 般 也 有 设备 器 件 的 厂家 编写 好 了 ， 我 们 只 需要 提供 设备 信 
息 即 可 ， 比 如 DC 设备 的 话 提供 设备 连接 到 了 哪个 I2C 接口 上 ，I2C 的 速度 是 多 少 等 等 。 相 当 
于 将 设备 信息 从 设备 驱动 中 剥离 开 来 , 驱动 使 用 标准 方法 去 获取 到 设备 信息 (比如 从 设备 树 中 获 
取 到 设备 信息 )， 然 后 根据 获取 到 的 设备 信息 来 初始 化 设备 。 这 样 就 相当 于 驱动 只 需要 负责 驱 
动 , 设备 只 需要 设备 , 想 办 法 将 两 者 进行 匹配 即 可 。 这 个 就 是 Linux 中 的 总 线 (bus)、 驱 动 (driver) 
和 设备 (device) 模 型 ， 也 就 是 常 说 的 驱动 分 离 。 总 线 就 是 驱动 和 设备 信息 的 月 老 ， 负 责 给 两 者 牵 
线 搭桥 ， 如 图 54.1.4 所 示 : 
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驱动 设备 信息 











54.1.4 Linux 总 线 、 驱 动 和 设备 模式 
当 我 们 向 系统 注册 一 个 驱动 的 时 候 ， 总 线 就 会 在 右 侧 的 设备 中 查找 ， 看 看 有 没有 与 之 匹配 
的 设备 ， 如 果 有 的 话 就 将 两 者 联系 起 来 。 同 样 的 ， 当 向 系统 中 注册 一 个 设备 的 时 候 ， 总 线 就 会 
在 左 侧 的 驱动 中 查找 看 有 没有 与 之 匹配 的 设备 ， 有 的 话 也 联系 起 来 。Linux 内 核 中 大 量 的 驱动 
程序 都 采用 总 线 、 驱 动 和 设备 模式 ， 我 们 一 会 要 重点 讲解 的 platform 驱动 就 是 这 一 思想 下 的 产 




















物 。 


54.1.2. 驱动 的 分 层 


上 一 小 节 讲 了 驱动 的 分 隔 与 分 离 ， 本 节 我 们 来 简单 看 一 下 驱动 的 分 层 ， 大 家 应 该 听 说 过 网 
络 的 7 层 模型 ， 不 同 的 层 负 责 不 同 的 内 容 。 同 样 的 ，Linux 下 的 驱动 往往 也 是 分 层 的 ， 分 层 的 目 
的 也 是 为 了 在 不 同 的 层 处 理 不 同 的 内 容 。 以 其 他 书籍 或 者 资料 常常 使 用 到 的 input( 输 入 子 系统 ， 
后 面 会 有 专门 的 章节 详细 的 讲解 ) 为 例 ， 简 单 介绍 一 下 驱动 的 分 层 。input 子 系统 负责 管理 所 有 
跟 输 入 有 关 的 驱动 ， 包 括 键盘 、 鼠 标 、 触 摸 等 ， 最 底层 的 就 是 设备 原始 驱动 ， 负 责 获取 输入 设 
备 的 原始 值 ， 获 取 到 的 输入 事件 上 报 给 input 核心 层 。input 核心 层 会 处 理 各 种 IO 模型 ， 并 且 提 
供 file operations 操作 集合 。 我 们 在 编写 输入 设备 驱动 的 时 候 只 需要 处 理 好 输入 事件 的 上 报 即 
可 ， 至 于 如 何 处 理 这 些 上 报 的 输入 事件 那 是 上 层 去 考虑 的 ， 我 们 不 用 管 。 可 以 看 出 借助 分 层 模 
型 可 以 极 大 的 简化 我 们 的 驱动 编写 ， 对 于 驱动 编写 来 说 非常 的 友好 。 


54.2 platform 平台 驱动 模型 简介 


前 面 我 们 讲 了 设备 驱动 的 分 离 ， 并 且 引 出 了 总 线 (bus)、 驱 动 (driver) 和 设备 (device) 模 型 ， 比 
如 I2C、SPI、USB 等 总 线 。 但 是 在 SOC 中 有 些 外 设 是 没有 总 线 这 个 概念 的 ， 但 是 又 要 使 用 总 
线 、 驱 动 和 设备 模型 该 怎么 办 呢 ?” 为 了 解决 此 问题 ,Linux 提出 了 platform 这 个 虚拟 总 线 ， 相应 
的 就 有 platform driver 和 platform device. 













































































54.2.1 platform 总 线 








Linux 系统 内 核 使 用 bus type 结构 体 表示 总 线 , 此 结构 体 定义 在 文件 include/linux/device.h， 
bus_type 结构 体内 容 如 下 : 
示例 代码 54.2.1.1 bus_type 结构 体 代 码 段 
1 SEEUGE bus ctype i 
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2 const char *name; /* 总 线 名 字 */ 
3 (CONSE. en *dev name; 

4 Gne UK eevee dey roor 

5 struct Cevice attribute "ev autre, 

6 Const Strut attr iowte Group wous Groups, /* 总 线 属 性 */ 
F Const SEruer attriioute group vde oF00DS? /* 设备 属性 */ 
8 const struct attribute group **drv groups; /* 驱动 属性 */ 
9 

10 iat (maten) (struct device vaev, struct devices river dr)? 
ial int (“uevene) (Struct device “ev, Struct koboj tevent eny emn), 
112 int (*probe) (struct device *dev); 

13 int (*remove) (struct device *dev); 

14 void (*shutdown) (struct device *dev); 

1S 

16 int (*online) (struct device *dev); 

del int (*offline) (struct device *dev); 

18 iat  ((senwegpxexaeb) (struct device “dev, pm messege t state), 

T9 int (*resume) (struct device *dev); 

20 Glue SUC OK pm OJOS gui 

2 const struct iommu ops *iommu ops; 

D Seree SSUESYS Oriyat "OB 

29 struct Lock Clase key lock keyp; 

24 yr 

















第 10 fT, match 函数 ， 此 函数 很 重要 ， 单 词 match 的 意思 就 是 “匹配 、 相 配 ” 因此 此 函数 
就 是 完成 设备 和 驱动 之 间 匹 配 的 ， 总 线 就 是 使 用 match 函数 来 根据 注册 的 设备 来 查找 对 应 的 驱 
动 , 或 者 根据 注册 的 驱动 来 查找 相应 的 设备 , 因此 每 一 条 总 线 都 必须 实现 此 函数 。 match 函数 有 
两 个 参数 : dev 和 drv， 这 两 个 参数 分 别 为 device 和 device driver 类 型 ， 也 就 是 设备 和 驱动 。 

platform 总 线 是 bus_type 的 一 个 具体 实例 ， 定 义 在 文件 drivers/base/platform.c，platform 总 
线 定义 如 下 : 





























示例 代码 54.2.1.2 platform 总 线 实 例 


L ercuct Dus ype Plariorm ue = i 

2 . name = "platform", 

B .dev groups = platform dev groups, 
4 .match = platform match, 

5 .uevent = platform uevent, 

6 .pm = &platform dev pm ops, 
7 8 








platform bus type 就 是 platform 平台 总 线 ， 其 中 platform match 就 是 匹配 函数 。 我 们 来 看 
一 下 驱动 和 设备 是 如 何 匹 配 的 ，platform match 函数 定义 在 文件 drivers/base/platform.c F, RK 
数 内 容 如 下 所 示 : 





示例 代码 54.2.1.3 platform 总 线 实 例 
L tatic int nome n(n clewiiee vxelew; 


SEEUEE device driver GE) 
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2 

3 struct platform device *pdev = to platform device (dev); 
4 struct plettorm em mm (drev) p 
5 

6 / noen driver override is Sotronly bind co the macocning driver / 
7 if (pdev-»driver override) 

8 return !strcmp(pdev-»driver override, drv-»name); 

9 

10 /* Attempt an OF style match first */ 

qu if (of driver match device(dev, drv)) 

22 return 1; 

13 

14 /* Then try ACPI style match */ 

15 if (acpi_driver_match_device (dev, drv)) 

16 return 1; 

17 

T8 /* Then try to match against the id table */ 

19 if (pdrv->id table) 

20 return platform match id(pdrv-»id table, pdev) !- NULL; 
2T 

22 AW al eevee inmane mate SA 

23 return (strcmp (pdev->name, drv->name) == 0); 

24 ) 


驱动 和 设备 的 匹配 有 四 种 方法 ， 我 们 依次 来 看 一 下 : 

第 11~12 行 ， 第 一 种 匹配 方式 ， OF 类 型 的 匹配 ， 也 就 是 设备 树 采 用 的 匹配 方式 ， 
of driver match device 函数 定义 在 文件 include/linux/of device.h 中 。device_driver 结构 体 (表示 
设备 驱动 ) 中 有 个 名 为 of match. table 的 成 员 变 量 , 此 成 员 变量 保存 着 驱动 的 compatible 匹配 表 ， 











设备 树 中 的 每 个 设备 节点 









































的 compatible 属性 会 和 of match table 表 中 的 所 有 成 员 比 较 ， 查 看 是 











否 有 相同 的 条 目 ， 如 果 有 的 话 就 表示 设备 和 此 驱动 匹配 ， 设 备 和 驱动 匹配 成 功 以 后 probe 函数 


就 会 执行 。 














第 15-16 行 ， 第 二 种 匹配 方式 ，ACPI 匹配 方式 。 
第 19~20 行 ， 第 三 种 匹配 方式 ，id_table 匹配 ， 每 个 platform driver 结构 体 有 一 个 id table 
成 员 变 量 ， 顾 名 思 义 ， 保 存 了 很 多 id 信息 。 这 些 id 信息 存放 着 这 个 platformd 驱动 所 只 是 的 驱 




















动 类 型 。 


第 23 行 ， 第 四 种 匹 再 








E 方 式 ， 如 果 第 三 种 匹配 方式 的 id. table 不 存在 的 话 就 直接 比较 驱动 和 











设备 的 name 字段 ， 看 看 是 不 是 相等 ， 如 果 相 等 的 话 就 匹配 成 功 。 
对 于 支持 设备 树 的 Linux 版 本 号 ， 一 般 设备 驱动 为 了 兼容 性 都 支持 设备 树 和 无 设备 树 两 种 








匹配 方式 。 也 就 是 第 一 种 
用 的 最 多 的 还 是 第 四 种 ， 











54.2.2 platform 驱动 


platform driver 结 


匹配 方式 一 般 都 会 存在 ， 第 三 种 和 第 四 种 只 要 存在 一 种 就 可 以 ， 一 般 
也 就 是 直接 比较 驱动 和 设备 的 name 字段 ， 毕 竟 这 种 方式 最 简单 了 。 














构 体 表示 platform 了 驱动， 此 结构 体 定义 在 文件 


T 














include/linux/platform device.h 中 ， 内 容 如 下 : 
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示例 代码 54.2.2.1 platform. driver 结构 体 





L gtruct plattorm ceiver i 

2 int (probe) (struct pleniore clewiee wp» 

3 inat (vrenmoyve) (struct platiorm device 5 

4 void (*shutdown) (struct platform device *); 

5 umi (“suspence (struct platiorm device =, pm message t state)? 
6 zur (vresvume) (Struct Plarctorm devices ); 

7 struct deyice driver driver} 

8 Const Struct Platiorm devica ie wied table; 

9 bool prevent deferred probe; 

10 


第 2 íT, probe 函数 , 当 驱 动 与 设备 匹配 成 功 以 后 probe 函数 就 会 执行 , 非常 重要 的 函数 1! 
一 般 驱 动 的 提供 者 会 编号， 如果 自己 要 编写 一 个 全 新 的 驱动 ， 那 么 probe 就 需要 自行 事项 。 

第 7 行 ，driver 成 员 ， 为 device driver 结构 体 变量 ，Linux 内 核 里 面 大 量 使 用 到 了 面向 对 象 
的 思维 , device driver 相当 于 基 类 , 提供 了 最 基础 的 驱动 框架 。plaform_driver 继承 了 这 个 基 类 ， 
然后 在 此 基础 上 又 添加 了 一 些 特 有 的 成 员 变 量 。 

第 8 行 , id_ table 表 , 也 就 是 我 们 上 一 小 节 讲 解 platform 总 线 匹配 驱动 和 设备 的 时 候 采 用 的 
第 三 种 方法 ，id table 是 个 表 ( 也 就 是 数组 )， 每 个 元 素 的 类 型 为 platform device id, 
platform device id 结构 体内 容 如 下 : 

示例 代码 54.2.2.2 platform device id 结构 体 

Ue pletiorn Cevice tol d 


2 char name[PLATFORM NAME SIZE]; 























































































































3 kernel ulong t driver date; 

y, 

device driver 结构 体 定义 在 include/linux/device.h, device driver 结构 体内 容 如 下 : 
示例 代码 54.2.2.3 device, driver 结构 体 





Ut ec Chalvet d 

Z constiehanr *name; 

3 skruet loyer see SG 

4 

struct mocule *owner; 

(5  YeXoWaksnE Cheu *mod name; /* used for built-in modules 7/ 
7 

8 bool pere Dind artro; /Jerse bacy Ummen wie Systa =/ 
9 

10 const struct of device_id *of match table; 

l1. const struct ecol device idl vacl macchi rable; 

12 


13 int (*probe) (struct device *dev); 

14 int (*remove) (struct device *dev); 

15 void (*shutdown) (struct device *dev); 

Wome ue (struct Glewace dey, pm message © state); 


17 int (*resume) (struct device *dev); 
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Ie eenSe SEEUEEaECESEUOUEE GOVO eu 

ls, 

Z0 (owes Steuet Cev pom oos em 

Zl 

2Z Sn Ariyer privats vp 


29 


}; 
第 10 fT, of match table 就 是 采用 设备 树 的 时 候 驱 动 使 用 的 匹配 表 ， 同 样 是 数组 ， 每 个 匹 











配 项 都 为 of device id 结构 体 类 型 ， 此 结构 体 定义 在 文件 include/linux/mod_devicetable.h 中 ， 内 


容 如 下 : 
示例 代码 54.2.2.4 of. device id 结构 体 
lve (ur elec Lel d 
2 Chiar name[32]; 
B char type[32]; 
4 char compatible[128]; 
S: onst ome vdata; 
6 











第 4 行 的 compatible 非常 重要 ， 因 为 对 于 设备 树 而 言 ， 就 是 通过 设备 节点 的 compatible 属 

















性 值 和 of match table 中 每 个 项 目的 compatible 成 员 变 量 进行 比较 ， 如 果 有 相等 的 就 表示 设备 
和 此 驱动 匹配 成 功 。 





在 编写 platform 驱动 的 时 候 ， 首 先 定 义 一 个 platform driver 结构 体 变量 ， 然 后 实现 结构 体 














中 的 各 个 成 员 变量 ， 重 点 是 实现 匹配 方法 以 及 probe 函数 。 当 驱动 和 设备 匹配 成 功 以 后 probe 
函数 就 会 执行 ， 有 具体 的 驱动 程序 在 probe 函数 里 面 编写 ， 比 如 字符 设备 驱动 等 等 。 


























当 我 们 定义 并 初始 化 好 platform. driver. 结构 体 变量 以 后 ， 需 要 在 驱动 入 口 函数 里 面 调用 





platform driver register 函数 癌 Linux 内 核 注 册 一 个 platform 驱动 ，platform_ driver register 函数 
原型 如 下 所 示 : 


int platform driver register (struct platform driver ^ *driver) 

函数 参数 和 返回 值 含 义 如 下 : 

driver: 要 注册 的 platform 驱动 。 

返回 值 ， 负数 ， 失 败 ; 0， 成 功 。 

还 需要 在 驱动 卸载 函数 中 通过 platform driver unregister 函数 卸载 platform 驱动 ， 





platform driver unregister 函数 原型 如 下 : 


Es RN 


void platform driver unregister(struct platform driver *drv) 
函数 参数 和 返回 值 含义 如 下 : 
drv: ZER platform 驱动 。 
返回 值 : 无 。 
platform 驱动 框架 如 下 所 示 : 
示例 代码 54.2.2.5 platform 驱动 框架 








/* 设备 结构 体 */ 
SErUuee = Cevi 


struct cdev cdev; 


/* 设备 结构 体 其 他 具体 内 容 */ 





bg 
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6 struct xxx dev xxxdev;  /* 定义 个 设备 结构 体 变量 */ 
7 


8 statie int zzz Open(stiuet niocce struct tile virile 
29 q 


10 /* 函数 具体 内 容 */ 
Ial return 0; 

TAE 

1.3) 


I4 tatie Sn t coe Wwaeibte((enricuwenE iile viilp, Const Char _ vser Aout, 
Eu 1t Cmt, loti t vVOXiu) 








MORRI 

16 /* 函数 具体 内 容 */ 

ALT return 0; 

318 i 

19 

20m 

21 * 字符 设备 驱动 操作 集 

22 — m 

25 Statio ptruct file operations xx TOPS S d 
24 .owner = THIS MODULE, 
25 .open = xxx open, 

216 .write S xxx write, 
27 y; 

28 

29 Jf 


30 * platform 驱动 的 probe 函数 
31 * 驱动 与 设备 匹配 成 功 以 后 此 函数 就 会 执行 


QoS 

35 Statie imt xx Toxsoloxe (se erm ee ele) 
34 ( 

35° rer 

36 cdev init(&xxxdev.cdev, &xxx fops); /* 注册 字符 设备 驱动 */ 
37 /* KAREAR */ 

38 return 0; 

399) 

40 

41 static int xxx remove(struct platform device *dev) 
42 ( 

AES EE 

44 cdev del(&xxxdev.cdev);/* 删除 cdev */ 

45 /* 函数 具体 内 容 */ 

46 return 0; 

AY 3 
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48 

49 /* AE */ 

3(0 gtatie Const struct Qu device id zx OK matenaj = 4 
li ( .compatible - "xxx-gpio" J, 

52 [人 SET Y 

53 }; 

54 

ij fus 

56 * platform 平 台 驱 动 结构 体 

m xf 

3 statie struct plartorm river wx hee — i 

59 .driver = { 

60 . name = "XXX"; 

Sal .of match table - xxx of match, 

62 }, 

[61] .probe = xxx probe, 

64 . remove = xxx_remove, 

65 }; 

66 

67 /* 驱动 模块 加 载 */ 

SEs eae ntl) 

Gol 

70 return platform driver register(&xxx driver); 
qal. T 

EE 

73 /* WNWREUEHER */ 

TA statie voici ^ > xemwoheiwese exit (vonc) 

TES A 

76 platform driver unregister(&xxx driver); 
E 

78 

79 module init(xxxdriver init); 


80 
81 
82 


module exit(xxxdriver exit); 
MODULE LICENSE("GPL"); 


MODULE AUTHOR ("zuozhongkai"); 
第 1-27 行 ， 传 统 的 字符 设备 驱动 ,所 谓 的 platform 驱动 并 不 是 独立 于 字符 设备 驱动 、 块 设 












































备 驱动 和 网 络 设备 驱动 之 外 的 其 他 种 类 的 驱动 。platform 只 是 为 了 驱动 的 分 离 与 分 层 而 提出 来 
的 一 种 框架 ， 其 驱动 的 具体 实现 还 是 需要 字符 设备 驱动 、 块 设备 驱动 或 网 络 设备 驱动 。 











第 33~39 行 ，xxx_probe 函数 ， 当 驱动 和 设备 匹配 成 功 以 后 此 函数 就 会 执行 ， 以 前 在 驱动 



































AH init 函数 里 面 编写 的 字符 设备 驱动 程序 就 全 部 放 到 此 probe 函数 里 面 。 比 如 注册 字符 设备 
驱动 、 添 加 cdev、 创 建 类 等 等 。 
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第 41-47 fT, xxx remove 函数 , platform. driver 结构 体 中 的 remove 成 员 变 量 , 当 关 闭 platfor 



































备 驱动 的 时 候 此 函数 就 会 执行 ， 以 前 在 驱动 卸载 exit 函数 里 面 要 做 的 事情 就 放 到 此 函数 中 来 。 
比如 ， 使 用 iounmap 释放 内 存 、 删 除 cdev， 注 销 设备 号 等 等 。 

第 50-53 行 ，xxx_of match 匹配 表 ， 如 果 使 用 设备 树 的 话 将 通过 此 匹配 表 进 行 驱动 和 设备 
的 匹配 。 第 51 行 设置 了 一 个 匹配 项 ， 此 匹配 项 的 compatible 值 为 “xxx-gpio” 因此 当 设 备 树 中 
设备 节点 的 compatible 属性 值 为 “xxx-gpio” 的 时 候 此 设备 就 会 与 此 驱动 匹配 。 第 52 行 是 一 个 
标记 ，of device id 表 最 后 一 个 匹配 项 必须 是 空 的 。 

第 58-65 ÍT, 定义 一 个 platform_driver 结构 体 变量 xxx. driver, 表示 platform 驱动 , 第 59~62 
行 设置 paltform_ driver 中 的 device driver 成 员 变 量 的 name 和 of match table 这 两 个 属性 。 其 中 
name 属性 用 于 传统 的 驱动 与 设备 匹配 ， 也 就 是 检查 驱动 和 设备 的 name 字段 是 不 是 相同 。 
of match table 属性 就 是 用 于 设备 树 下 的 驱动 与 设备 检查 。 对 于 一 个 完整 的 驱动 程序 ,必须 提供 
有 设备 树 和 无 设备 树 两 种 匹配 方法 。 最 后 63 和 64 这 两 行 设 置 probe 和 remove 这 两 成 员 变 量 。 

第 68~71 行 ,驱动 入 口 函数 ,调用 platform driver register FK Zt [8] Linux 内 核 注 册 一 个 platform 
驱动 ， 也 就 是 上 面 定义 的 xxx driver 结构 体 变量 。 
第 74~77 行 ， 驱 动 出 口 函 数 ， 调 用 platform driver unregister FK ICI BU MEJ E). platform 
驱动 。 

总 体 来 说 ，platform 驱动 还 是 传统 的 字符 设备 驱动 、 块 设备 驱动 或 网 络 设备 驱动 ， 只 是 套 
上 了 一 张 “platform” 这 张 皮 皮 ， 目 的 是 为 了 使 用 总 线 、 驱 动 和 设备 这 个 驱动 模型 来 实现 驱动 
的 分 离 与 分 层 。 













































































S? 
















































































54.2.3 platform 设备 


platform a 我 们 还 需要 platform 设备 ， 否 则 的 话 单单 一 个 驱动 也 做 不 了 
{tó o platform device 这 个 结构 体 表示 platform 设备 ， 这 里 我 们 要 注意 ， 如 果 内 核 文 持 设备 树 
的 话 就 不 要 在 使 用 died 来 描述 设备 了 ， 因 为 改 用 设备 树 去 描述 了 。 当 然 了 ， 你 如 果 
一 定 要 用 platform. device 来 描述 设备 信息 的 话 也 是 可 以 的 。platform device 结构 体 定义 在 文件 
include/linux/platform device.h 中 ， 结 构 体 内 容 如 下 : 

示例 代码 54.2.3.1 platform device 结构 体 代码 段 


22 giu jleuionu device | 


























































































































25 const char *name; 

24 simis ele 

29 bool iol auto; 

26 struct device clev? 

AN 18.32 num resources; 

28 Bi:IEICUKE Eee so ec "resource; 

29 

30 Const GETUCE Plattorm device ie wied entry, 
ST char *dariver override; /* Driver name to force a match */ 
92 

33 7 ME ec neen 

34 Ser mE CSLL timete Call, 

35 

36 /* arch specific additions */ 

37, struct pdev archdata archdata; 
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第 23 ÍT, name 表示 设备 名 字 ， 要 和 所 使 用 的 platform 驱动 的 name 字段 相同 ， 否 则 的 话 设 
备 就 无 法 匹配 到 对 应 的 驱动 。 比 如 对 应 的 platform 驱动 的 name 字段 为 “xxx-gpio” 那么 此 name 
字段 也 要 设置 为 “xxx-gpio”。 
第 27 fT, num resources 表示 资源 数量 ， 一 般 为 第 28 fT resource 资源 的 大 小 。 
第 28 行 , resource 表示 资源 , 也 就 是 设备 信息 , 比如 外 设 寄存 器 等 。 Linux 内 核 使 用 resource 
结构 体 表示 资源 ，resource 结构 体内 容 如 下 : 
示例 代码 54.2.3.2 resource 结构 体 代 码 段 




















lei steruct resource rl 





1L resource size t tarty 

20 TeSOuUrCS S176 E nd; 

zu Censt Oner? *name; 

22 unsigned long flags; 

2/5) struct resource *parent, *sibling, *child; 
24 Ve 





start 和 end 分 别 表示 资源 的 起 始 和 终止 信息 ， 对 于 内 存 类 的 资源 ， 就 表示 内 存 起 始 和 终止 
地 址 ，name 表示 资源 名 字 ，flags 表示 资源 类 型 ， 可 选 的 资源 类 型 都 定义 在 了 文 们 
include/linux/ioport.h 里 面 ， 如 下 所 示 : 
示例 代码 54.2.3.3 资源 类 型 





T 





















































29 s4define IORESOURCE BITS QpqOOXOYOO)O sh 7 Büs-specifie bits nof 
30 

31 4$define IORESOURCE TYPE BITS 0x00001f00 /* Resource type ivi 

32 #define IORESOURCE IO (55:0 IET S SEE COST ATE ANM CONUS OT e SO 
33 define IORESOURCE MEM 0x00000200 

34 d$define IORESOURCE REG x00000500 55 Regi gter qQuescexewst 

35 4define IORESOURCE IRQ 0x00000400 

36 {define IORESOURCE DMA 0x00000800 

37 define IORESOURCE BUS 0x00001000 





























TOJ y> PCI control bits- Shares TORESOURCE BITS with above PCI ROM. “y 
105 $define IORESOURCE PCI FIXED (1««4) /* Do not move resource */ 
在 以 前 不 支持 设备 树 的 Linux 版 本 中 ,用 户 需 要 编写 platform_device 变量 来 描述 设备 信息 ， 
然后 使 用 platform device register 函数 将 设备 信息 注册 到 Linux 内 核 中 ， 此 函数 原型 如 下 所 示 : 

int platform device register(struct platform device *pdev) 

函数 参数 和 返回 值 含义 如 下 : 

pdev: 要 注册 的 platform 设备 。 

返回 值 :， 负数 ， 失 败 ; 0， 成 功 。 

如 果 不 再 使 用 platform 的话 可 以 通过 platform device unregister 函数 注销 掉 相 应 的 platform 
设备 ，platform device unregister 函数 原型 如 下 : 

void platform device unregister(struct platform device *pdev) 


函数 参数 和 返回 值 含 义 如 下 : 
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pdev: 要 注销 的 platform 设备 。 


o ao e UE INE CETTE OUO QS NOS 


PP PE PE 
Sn ICONE WS 


WT RY Ry RW NI TW Ny 
cal oA CF A CO DO bs 


a COMIS 
DO 


OFU 
>e w N 


ENS 
36 
Sur) 
38 
E 


返回 值 : 无 。 
platform 设备 信息 框架 如 下 所 示 ; 
示例 代码 54.2.3.4 platfotm 设备 框架 








/* 寄存 器 地 址 定义 */ 

#define PERIPH1 REGISTER BASE (0x20000000) /* 外 设 1 寄存 器 首 地 址 */ 
#define PERIPH2 REGISTER BASE (0X020E0068) /* 外 设 2 寄存 器 首 地 址 */ 
#define REGISTER LENGTH 4 






































EDI 




















































































































statie SETCE TESCUT xx esouseces[ = d 

[03 e d 
.Start SS PERIPHI REGISTER BASE, 
.end - (PERIPH1 REGISTER BASE SERES SS ERIS ES NIS E T); 
.flags 2 IORESOURCE MEM, 

), 

[uy e d 
.Start = PERIPH2 REGISTER BASE, 
.end = (PERIPH2 REGISTER BASE * REGISTER LENGTH - iy s 
.flags = IORESOURCE MEM, 


bg 


/* platform 设备 结构 体 */ 














statie struct plarciorm device xoeswelewulee c i 
.name = "xxx-gpio", 
odigl Ex cy 
SINUDÉEECSOUBeecSE ARRAY SIZE(xxx resources), 
.resource - xxx resources, 
}; 
/* 设备 模块 加 载 */ 
statie ne le (volc) 
{ 
return platform device register(&xxxdevice); 
} 
/* 设备 模块 注销 */ 
statie void — exit xx Tesourcesdevics ext (vorc) 
{ 


platform device unregister(&xxxdevice); 





} 
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40 module init(xxxdevice init); 

41 module exit(xxxdevice exit); 

42 MODULE LICENSE ("GPL"); 

43 MODULE AUTHOR ("zuozhongkai"); 

第 7-18 行 ， 数 组 xxx. resources 表示 设备 资源 ， 一 共有 两 个 资源 ， 分 别 为 设备 外 设 1 和 外 
设 2 的 寄存 器 信息 。 因 此 flags 都 为 IJORESOURCE MEM, 表示 资源 为 内 存 美 型 的 。 

第 21-26 ÍT, platform 设备 结构 体 变 量 ， 注 意 name 字段 要 和 所 使 用 的 驱动 中 的 name 字段 
一 致 , 否则 驱动 和 设备 无 法 匹配 成 功 .num_ resources 表示 资源 大 小 , 其 实 就 是 数组 xxx. resources 
的 元 素数 量 ， 这 里 用 ARRAY SIZE 来 测量 一 个 数组 的 元 素 个 数 。 

第 29-32 ÍT, 设备 模块 加 载 函 数 , 在 此 函数 中 调用 platform. device register 向 Linux 内 核 注 
册 platform 设备 。 

第 35-38 ÍT, 设备 模块 扼 载 函 数 , 在 此 函数 中 调用 platform device_unregister 从 Linux 内 核 
HEIE platform 设备 。 

示例 代码 542.3.4 主要 是 在 不 支持 设备 树 的 Linux 版 本 中 使 用 的 ， 当 Linux 内 核 支 持 了 设 
备 树 以 后 就 不 需要 用 户 手动 去 注册 platform 设备 了 。 因 为 设备 信息 都 放 到 了 设备 树 中 去 描述 ， 
Linux 内 核 启动 的 时 候 会 从 设备 树 中 读 取 设 备 信息 ， 然 后 将 其 组 织 成 platform. device 形式 ， 至 
于 设备 树 到 platform device 的 具体 过 程 就 不 去 详细 的 追究 了 ， 感 兴趣 的 可 以 去 看 一 下 ， 网 上 也 
有 很 多 博客 详细 的 讲解 了 整个 过 程 。 

AT platform 下 的 总 线 、 驱 动 和 设备 就 讲解 到 这 里 ， 我 们 接 下 来 就 使 用 platform 驱动 框架 
来 编写 一 个 LED 灯 驱 动 ， 本 章 我 们 不 使 用 设备 树 来 描述 设备 信息 ， 我 们 采用 自 定 义 
pum device 这 种 "古老 "方式 来 编写 LED 的 设备 信息 。 下 一 章 我 们 来 编写 设备 树 下 的 platform 
驱动 ， 这 样 我 们 就 掌握 了 无 设备 树 和 有 设备 树 这 两 种 platform 驱动 的 开发 方式 。 


54.3 硬件 原理 图 分 析 

本 章 实验 我 们 只 使 用 到 IMX6U-ALPHA 开发 板 上 的 LED 灯 , 因此 实验 硬件 原理 图 参考 8.3 
小 节 即 可 。 
54.4 试验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 2. Linux 驱动 例 程 -> 17_platform。 

本 章 实验 我 们 需要 编写 一 个 驱动 模块 和 一 个 设备 模块 , 其 中 驱动 模块 是 platform 驱动 程序 ， 
设备 模块 是 platform 的 设备 信息 。 当 这 两 个 模块 都 加 载 成 功 以 后 就 会 匹配 成 功 ， 然 后 platform 
驱动 模块 中 的 probe 函数 就 会 执行 ，probe 函数 中 就 是 传统 的 字符 设备 驱动 那 一 套 。 


















































































































































































































































































































































































































































54.4.1 platform 设备 与 驱动 程序 编写 


新 建 名 为 “17_platform ”的 文件 夹 ， 然 后 在 17_platform 文件 夹 里 面 创建 vscode 工程 , 工作 
区 命名 为 “platform”。 新 建 名 为 leddevice.c 和 leddriver.c 这 两 个 文件 ， 这 两 个 文件 分 别 为 LED 
ATI] platform 设备 文件 和 LED 灯 的 platform 的 驱动 文件 。 在 leddevice.c 中 输入 如 下 所 示 内 容 : 
示例 代码 54.4.1.1 leddevice.c 文件 代码 段 

finclude <linux/types.h> 

finclude «linux/kernel.h» 

finclude «linux/delay.h» 

finclude «linux/ide.h» 















































TESI DE 
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finclude <linux/init.h> 


5 

6  d4include «linux/module.h» 

7 | $include Xlinux/errno.h» 

8  d£dinclude Xlinux/gpio.h» 

9  $include «Xlinux/cdev.h» 

10 4include Xlinux/device.h» 

11 d4£include «Xlinux/of gpio.h» 
12 d$include «linux/semaphore.h» 
13 d£include Xlinux/timer.h» 

14 4include «linux/irq.h» 

15 4include Xlinux/wait.h» 

16 d£include Xlinux/poll.h» 

17 d£include «linux/fs.h» 

18 4include Xlinux/fcntl.h» 

19 #include «linux/platform device.h» 





20 $include «asm/mach/map.h» 
21 #include «asm/uaccess.h» 
22 d$4include «asm/io.h» 


25 /汪汪 大 火炎 类 类 火炎 大大 大 大 火炎 大 大 火炎 大 类 类 大 大 类 类 大 大大 类 大 类 大 类 大 类 大大 大 大 类 类 大 类 大 类 大 类 大 类 大 类 大 类 大 类 大 大 大 大大 大 大 








24 Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
25 文件 名 : leddevice.c 






































DES : 左 忠 凯 

27 版 本 a Wi 

28 描述 : platform 设备 

29 其 他 207 

30 VOE : www.openedv.com 

31 卓志 : 初版 V1.0 2019/8/13 左 忠 凯 创建 

32 RAK AK K E K E AE E AK AK E A E A E A A A K E K E K E A K KK A K K K K K KK K KK A K K K K K KK KK K K / 
BS 

94 * 

35  * 寄存 器 地 址 定义 

CR 

37 #define CCM CCGR1 BASE (0X020C406C) 
38 4define SW MUX GPIO1 IO03 BASE (0X020E0068) 
39 $define SW PAD GPIO1 IO03 BASE (0X020E02F4) 
40 $define GPIOl DR BASE (0X0209C000) 
41 ddefine GPTOT GDIR BASE (0x0209C004) 
42 ddefine REGISTER LENGTH 4 

43 


44 /* Qdescription  : 释放 flatform 设 备 模块 的 时 候 此 函数 会 执行 
45  * Qparam - dev : 要 释放 的 设备 

46  * Qreturn & JE 

47 */ 
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48 
49 
50 
5l 
52 
ES 
54 
55 
56 
57 
58 
59: 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
TAL 
TZ 
3 
74 
JS 
76 
7] 
78 
3/8) 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 


e31E m B 


论坛 :www.opendev.com 


statie void) led selesse(stusr eewies "olew) 


{ 
printk("led device releas 


gll wie wm e 





/ * 
* 设备 资源 信息 ， 也 就 是 LED0 所 使 月 
E 


SEC 人 ES 人 和 证 Ql 36 





目的 所 有 寄存 器 





[0] = { 
Stone = CCM CCORI BA 





sources[] = 


SE, 









































ENGTH - 1), 











REGISTER LENGTH - 1), 








































































































REGISTER LENGTH - 1), 


ENGTH - 1), 

















ENGTH - 1), 























.end = (CCM CCGR1 BASE * REGISTER L 
.flags = IORESOURCE MEM, 
}, 
EDI S0 
.start = SW MUX GPIO1 IO03 BASE, 
.end - (SW MUX GPIO1 IO03 BASE ar 
.flags = IORESOURCE MEM, 
}, 
Lei = i 
.start = SW PAD GPIO1 IO03 BASE, 
.end = (SW PAD GPIOl1 IO03 BASE + 
.flags 2 IORESOURCE MEM, 
}, 
ea = 
Teor ME CE OMIM ASRP 
.end = (GPIO1 DR BASE + REGISTER L 
.flags = IORESOURCE MEM, 
}, 
[4] = { 
.Start = GPIO1 GDIR BASE, 
.end = (GPIO1 GDIR BASE + REGISTER L 
.flags = IORESOURCE MEM, 
}, 
}; 
[= 
* platform 设备 结构 体 
x 
statie struct platiorm davice lecelewiee = 1 
.name = "imxóul-led", 
alol E3 el, 
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9 .dev = { 

92 .release = &led release, 

93 }, 

94 .num resources = ARRAY SIZE(led resources), 
95 ncsoueece = leed resources, 

DONE 

9 

98 fes 

99  * Qdescription : 设备 模块 加 载 

100 * param S 

101 * Greturn s JE 

10509. 

109 statice imt _ imit leddeyvice Imir (voici) 

104 { 

105 return platform device register(&leddevice); 
106 T 

LOT 

OS/ 

109 * (description : 设备 模块 注销 

110 人 ES 

111 * Qreturn 3 JE 

i122 $5 

IIS statie void _ exit ve esa (vonc) 

114 ( 

ds platform device unregister(&leddevice); 

i 

dE gi 


118 module init(leddevice init); 
11.5) mocule (ell ee 
120 MODULE LICENSE("GPL"); 
121 MODULE AUTHOR ("zuozhongkai"); 

leddevice.c 文件 内 容 就 是 按照 示例 代码 54.2.3.4 的 platform 设备 模板 编写 的 。 

第 56-82 ÍT, led resources 数组 , 也 就 是 设备 资源 , 描述 了 LED 所 要 使 用 到 的 寄存 器 信息 ， 
也 就 是 IORESOURCE MEM 资源 。 

第 88~96，platform 设备 结构 体 变量 leddevice， 这 里 要 注意 name 字段 为 “imx6ul-led”， 所 
以 稍 后 编写 platform 驱动 中 的 name 字段 也 要 为 “imx6ul-led”， 和 否则 设备 和 驱动 匹配 失败 。 

第 103-106 行 , 设备 模块 加 载 函数 , 在 此 函数 里 面 通过 platform device register 向 Linux 内 
核 注册 leddevice 这 个 platform 设备 。 

第 113-116 ÍF, VERE EROR ER ZO TEJE PR CHR IDEST platform device_unregister 从 Linux 
内 核 中 删除 掉 leddevice 这 个 platform 设备 。 

leddevice.c 文件 编写 完成 以 后 就 编写 leddriver.c 这 个 platform 驱动 文件 ， 在 leddriver.c 里 
面 输入 如 下 内 容 : 








































































































示例 代码 54.4.1.2 leddrivet.c 文件 代码 段 
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finclude <linux/types.h> 

finclude «linux/kernel.h» 

finclude «linux/delay.h» 

finclude «linux/ide.h» 

finclude «linux/init.h» 

finclude <linux/module.h> 


dinclude «linux/errno.h» 


OON ON E E NN 


#include <linux/gpio.h> 
9 #include <linux/cdev.h> 
10 #include <linux/device.h> 
11 #include <linux/of gpio.h> 














12 #include <linux/semaphore.h> 

13 d£include Xlinux/timer.h» 

14 d4include Xlinux/irq.h» 

15 d£include Xlinux/wait.h» 

16 4$include Xlinux/poll.h» 

17 £include Xlinux/fs.h» 

18 4include «linux/fcntl.h» 

19 4include Xlinux/platform device.h» 
20 #include «asm/mach/map.h» 








21 d$include «asm/uaccess.h» 
22 dinclude «asm/io.h» 


ES /玉米 大火 炎炎 大 类 炎炎 大 大 大 类 类 大 大 炎炎 大大 炎炎 大 大 类 大 大 类 类 大 类 大 类 大 类 大 类 大 类 大大 大 类 大 类 大 类 类 类 大 大大 大大 大大 大大 大大 类 大 











24 Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
DONUM : leddriver.c 
































26 MET : 左 忠 凯 

27 版 本 EDD 

28 描述 : platform 驱动 

29 其 他 EIE 

30 iex : Www.openedv.com 

31 Hz : WIR v1.0 2019/8/13 左 忠 凯 创建 
DUO——ARAR———R—————ARARAR————————WV——W—VESÓA 
BS 

34 define LEDDEV CNT 1 /* 设备 号 长 度 */ 
35 #define LEDDEV NAME uae eol /* 设备 名 字 A 
36 d define LEDOFF 0 

37 #define LEDON Il 

38 


39 /* 寄存 器 名 */ 

40 etatie woe! iomem tIDMPXOU! CCM CCERL? 
41 static void — iomem *SW MUX GPIOT IO03; 
i2 oratie voici _ iomem S WEE AUS MEC; PATH 5 (997 
45 ë prtartie void iomem ZEPIOL DRE 
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44 static void — iomem *GPIOT GDIR; 
45 


46 /* leddev 设备 结构 体 */ 
Al erruct lexdelew dewi 





























48 dev t devid; ] WES i 
49 gEruCE Cey E /* cdev = 
50 struct class *class; /* 3E 2». 
Sl struct device *device; /* 设备 a 
52 int major; /* 主 设备 号 9 
53 }; 

54 

55 struct leddev dev leddev; /* led 设备 < 
56 

DUM AS 

58  * Qdescription  : LED 打开/ 关闭 

59  * Q(param - sta  : LEDON(0) JJF LED, LEDOFF(1) 关闭 LED 
60  * Qreturn 8 Jb 

GIC. 

62 void led0 switch(u8 sta) 

Sa N 

64 a32 val = 07 

65 if(sta == LEDON)( 

66 val = readl(GPIOl1 DR); 

67 val &= «(1 << 3); 

68 weitelival, CEIOl DR) P 

69 }else if(sta == LEDOFF)( 

TAO val 5 readl(GPIO1 DR); 

9h va Ms (ub x sp 

p^ weitel{val, (GNI. DR) 

Y3 } 

74 } 

E 

TE AS 

7] = Qdescription s Meva 


78 * @param - inode : 传递 给 驱动 的 inode 
79  * Qparam - filp : 设备 文件 ，file 结构 体 有 个 叫做 private data 的 成 员 变 量 





80 * 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
81 * @return : 0 成 功 ;其 他 失败 
82 */ 


$3 tatie int led open(otruct inode “inode, Struct Tile wiii) 
84 { 

85 filp-»private data = &leddev; /* 设置 私有 数据 */ 

86 return 0; 
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Bur 

88 

ODE A 

90  * Qdescription  : 向 设备 写 数 据 

DII * Qparam - filp : 设备 文件 ， 表 示 打 开 的 文件 描述 符 

92  * Q(param - buf  : 要 写 给 设备 写 入 的 数据 

93  * (param - cnt  : ES AGSUEIKHE 

94  * Q(param - offt : 相对 于 文件 首 地 址 的 偏 移 

95 — * (return : 写 入 的 字 节 数 ， 如 果 为 负 值 ， 表 示 写 入 失败 

DOREM S 

27 statie gsize t (le tile wiilo, Const Char user VIS, 
Gize "t Cmte, lori t vott) 

















eer i 

9 int retvalue; 

100 unsigned char databuf[1]; 

ON unsigned char ledstat; 

102 

103 retvalue = copy from user(databuf, buf, cnt); 
104 if(retvalue « 0) ( 

TOS return -EFAULT; 

106 ) 

107 

108 ledstat = databuf[0]; /* 获取 状态 值 */ 
109 if(ledstat == LEDON) ( 

110 led0 switch (LEDON) ; yw FIF LEDI =*/ 
Iaka }else if(ledstat == LEDOFF) { 

"ie led0 switch (LEDOFF); /* XRH]LEDAT  */ 
TIS ) 

114 return 0; 

138 

ENIMS 


117 /* 设备 操作 函数 */ 


We statie gsteruct tile operationes lec topes = i 





Ilag .owner = THIS MODULE, 

220) .open = led open, 

121 .write > led write, 

10272. 8 

129 

TAA ye 

125 * @description  : flatform 驱动 的 probe 函数 ， 当 驱动 与 设备 
126 * 匹配 以 后 此 函数 就 会 执行 

127 * @param - dev  : platform 设备 

128 * QGreturn : 0， 成 功 ;其 他 负 值 , 失败 
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ILE 

1.540) tatie inme lec probe (struct platctorm device veles) 

13491 

197 int i = 0; 

LIS int ressize[5]; 

134 u32 val = 0; 

SS struct resource *ledsource[5]; 

136 

Te printk("led driver and device has matched!\r\n"); 

138 /* l. dRHORUM */ 

139 for GU =O: n <5 tt) 

140 ledsource[i] 2 platform get resource(dev, IORESOURCE MEM, i); 
141 if (!ledsource[i]) ( 

142 dev err(&dev-»2dev, "No MEM resource for always onn"); 
143 return -ENXIO; 

144 } 

EAS ;esexge|b] e ieeeuwsce suze(lselseusee|il) s 

146 ) 

147 


148 /* 2、 初 始 化 LED */ 
149 /* 寄存 器 地 址 映射 */ 








150 IMX6U CCM CCGRI 2 ioremap(ledsource[0]-»start, ressize[0]); 
1:8) dE SW MUX CPITOI TO03 = loremap Eee oe ll > ne sh lily? 
152 SW PAD GPIOL IO03 > ioremap(ledsource[2]-»start, ressize[2]1); 
WSS GPITOL DR ecm Eels evee ll > Sen es 1)», 

T54 GPIOT GDIR © ioremap(ledsource[4]-»start, ressrize[4]); 

L55 

1.5/6 val = readl(IMX6U CCM CCGR1); 

1:57 val &= «(3 << 26); /* 清除 以 前 的 设置 ” */ 

158 val ja (3 < 26)? /* 设置 新 值 y 

2156) writel(val, IMX6U CCM CCGR1); 

160 

161 /* WE GPIOl 1003 复 用 功能 ， 将 其 复 用 为 SGPIO1_ IO03 */ 

162 writel(5, SW MUX GPIO1 IO03); 

ISS; writel(0x10B0, SW PAD GPIO1 IO03); 

164 

165 /* 设置 GPIO1 1003 为 输出 功能 */ 

166 val —- readl(GPIO1 GDIR); 

167 val &- «(1 «« 3); /* 清除 以 前 的 设置 ” */ 

168 val js (Ll 22 3)? /* 设置 为 输出 $y 

S9 writel(val, GPIOL GDIR); 

170 


TE /* 默认 关闭 LEDI */ 
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TTA val = readl(GPIO1 DR); 
13 val |= (1 << 3) ; 
174 wreitel (val, GCPIOL ID p 
S 
176 /* 注册 字符 设备 驱动 */ 
177 /人 xd、 创建 设备 号 */ 
178 if (leddev.major) ( /* 定义 了 设备 号 oA 
179 leddev.devid = MKDEV(leddev.major, 0); 
180 register chrdev region(leddev.devid, LEDDEV CNT, 
LEDDEV NAME); 
181 ) else ( WE S */ 
12 alloc chrdev region(&leddev.devid, 0, LEDDEV CNT} 
LEDDEV NAME); 
183 leddev.major = MAJOR(leddev.devid); 
184 } 
15805] 
186 /* 2. PUE cdev */ 
NEm leddev.cdev.owner = THIS MODULE; 
188 cdev init(&leddev.cdev, &led fops); 
189 
190 /* 3. VN 个 cdev */ 
TESI cdev add(&leddev.cdev, leddev.devid, LEDDEV CNT); 
HR 
193 /* 4. GJEE2S */ 
194 leddev.class = class create(THIS MODULE, LEDDEV NAME); 
1:95 suos (ES uREL(Ubeckekew.cless)) 
196 return PTR ERR(leddev.class); 
197 } 
198 
199 /* 5. 创建 设备 */ 
200 lesdew.elewics — cewice ezese(iecelew.elsss, nu, legekew.elewi; 
NULL, LEDDEV NAME); 
20i eus (US miegm(Leelsew .ckewiieey) E 
202 return PTR ERR(leddev.device); 
203 ) 
204 
205 return 0; 
206 ] 
207 
2S). fos 
209 * Qdescription  :«$f& platform 驱动 的 时 候 此 函数 会 执行 
210 * G8param - dev  : platform ør 
211 * Qreturn : 0， 成 功 ;其 他 负 值 , 失败 
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21g sy 


21,9 tatic ine lec remove (struct platciorm cevice tvelew) 
214 { 























215 iounmap(IMX6U CCM CCGR1); 

216 iounmap(SW MUX GPIO1 IO03); 

a iounmap(SW PAD GPIO1 IO03); 

218 iounmap(GPIO1 DR); 

2 iounmap(GPIO1 GDIR); 

220 

QoS cdev del(&leddev.cdev); /* 删除 caev */ 
9o unregister chrdev region(leddev.devid, LEDDEV CNT); 
223 device destroy(leddev.class, leddev.devid); 
224 cih emdee roy (ES ol ens 

295 return 0; 

22160m} 

228 

228 /* platform 驱动 结构 体 */ 

225 SmteNEILC. struct plattorm ETVEE leel crivyer 5 04i 
290 .driver = { 

ZEE aude miscuit ci /* 驱动 名 字 ， 用 于 和 设备 匹配 */ 
239 ) 

293 .probe = led probe, 

234 .remove = led remove, 

238 »g 

236 

2s fs 

238 * Qdescription  : 驱动 模块 加 载 函 数 

239 * Qparam 8 3 

240 * Qreturn 3 JE 

Qu se 

24/7 Starcie hant — imit leddriyer 3bsobE (voici) 

245301 

244 return platform driver register(&led driver); 
245 ] 

246 

Zu qe 

248 * (description : IKARIERA 

249 * Qparam e JB 

250 * Greturn 3 JE 

DIOE, 

252 ertatie vodil  — exit leddriver (eel 

2:959 

254 platform driver unregister(&led driver); 
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AIS A 
256 


257 module init (lededriyer init) p 





256 module exit (leddriyer exit) P 
259 MODULE LICENSE ("GPL"); 
260 MODULE AUTHOR ("zuozhongkai"); 

leddriver.c 文件 内 容 就 是 按照 示例 代码 54.2.2.5 的 platform 驱动 模板 编写 的 。 

第 34~122 行 ， 传 统 的 字符 设备 驱动 。 

第 130-206 fT, probe 函数 ， 当 设备 和 驱动 匹配 以 后 此 函数 就 会 执行 ， 当 匹配 成 功 以 后 会 在 
终端 上 输出 “led driver and device has matched!” 这 样 语句 。 在 probe 函数 里 面 初 始 化 LED、 注 
册 字 符 设 备 驱 动 。 也 就 是 将 原来 在 驱动 加 载 函 数 里 面 做 的 工作 全 部 放 到 probe 函数 里 面 完成 。 

第 213-226 行 ，remobe Kt, 78] 2; platform 驱动 的 时 候 此 函数 就 会 执行 。 在 此 函数 里 面 
释放 内 存 、 注销 字符 设备 等 。 也 就 是 将 原来 驱动 卸载 函数 里 面 的 工作 全 部 都 放 到 remove 函数 中 
完成 。 

第 229~235 行 ，platform_driver 驱动 结构 体 ， 注 意 name 字段 为 "imx6ul-led"， 和 我 们 在 
leddevice.c 文件 里 面 设置 的 设备 name 字段 一 致 。 

第 242-245 行 ， 驱 动 模块 加 载 函 数 ， 在 此 函数 里 面 通过 platform. driver register 向 Linux 内 
核 注 册 led_driver 驱动 。 
第 252~255 行 ， 驱 动 模块 伙 载 函数 ， 在 此 函数 里 面 通过 platform. driver unregister 从 Linux 
VERAX led driver 驱动 。 











































































































54.4.2 测试 APP 编写 


测试 APP 的 内 容 很 简单 ， 就 是 打开 和 关闭 LED 灯 ， 新 建 ledApp.c 这 个 文件 ， 然 后 在 里 面 
输入 如 下 内 容 : 














示例 代码 54.4.2.1 ledApp.c 文件 代码 段 









































JJ amesiudgcq st e 

2) —wgabevelbxokei ne 

3 4include "sys/types.h" 

4 d*$include "sys/stat.h" 

5 #include "fcntl.h" 

6 4include "stdlib.h" 

mo aaeocae sre 

B foedo oko koe kk oko ko kk ko ko ko ko kk kk ek kk ok kk ok ek kk ek ek kk 
9 Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
10 文件 名 : ledApp.c 

L1 fE : 左 忠 凯 

12 版 本 3 VLO 

13 描述 : platform 驱动 驱 测 试 APP. 

14 其 他 天 

15 使 用 方法 : ./ledApp /dev/platled 0 关闭 LED 

16 ./ledApp /dev/platled 1 aT LED 

1,7) VA : www.openedv.com 

18 Hx : 初版 V1.0 2019/8/16 左 忠 凯 创建 
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19 KCKCKCKCkCKCk kCkCk k kk kCk Ck Ck kCkCk k kk k kc k k kc k Ck k Ck Ck kCk Ck k kc k k k Ck k kc k Ck kck ck kck ck ckck ck ckckck kk e kk / 


20 4define LEDOFF 0 
21 £$define LEDON i 




















212 

Zr JP 

24 * (description : main 主 程序 

25 * Qparam - aroge  : argv wv 

26 * Q8param - argv ”具体 参数 

27 * Qreturn : 0 成 功 ;其 他 失败 

PONE 

29 int main(int argc, char *argv[]) 

300 1 

BA iae Eol eue 

32 char *filename; 

SIS] unsigned char databuf[2]; 

34 

35 if (aroge !- 3)( 

36 em (nn QUlsrexsie D we Wai) e 

SYI return -1; 

38 } 

EN 

40 filename = argv[!]; 

41 /* 打开 led 驱动 */ 

42 fd 2 open(filename, O RDWR); 

43 if(fd « O)( 

44 printf("file $s open failed!NrNMn", argv[1]); 
45 return -1; 

46 ) 

47 

48 databuf[0] = atoi(argv[21); /* 要 执行 的 操作 : 打开 或 关闭 */ 
49 retvalue = write(fd, databuf, sizeof(databuf)); 
50 if(retvalue « O)( 

il primer (C gap). Cone rolka ledi woe wie) p 

52 close (fd); 

59 return -1; 

54 } 

S5 

56 retvalue 2 close(fd); /* XHMx[ft */ 

5 if(retvalue < 0){ 

58 printf("file $s close failed!NrMn", argv[1]); 
59 return -1; 

60 } 

61 return 0; 
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Gs 


ledApp.c 文件 内 容 很 简单 , 就 是 控制 LED 灯 的 亮 灭 , 和 第 四 十 一 章 的 测试 APP 基本 一 致 ， 
这 里 就 不 重复 讲解 了 。 



































54.5 运行 测试 
54.5.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 
编写 Makefile 文件 ， 本 章 实 验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 “leddevice.o leddrivero” Makefile 内 容 如 下 所 示 : 
示例 代码 54.5.1.1 Makefile 文件 
1 KERNELDIR = /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
rel imz 421519 2-1-0 ge aliesntelk 






































4 obj-m := leddevice.o leddriver.o 














12 S$(MAKE) -C S(KERNELDIR) Mz$ (CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 “leddevice.o leddriver.o ". 
输入 如 下 命令 编译 出 驱动 模块 文件 : 
make -j32 
编译 成 功 以 后 就 会 生成 一 个 名 为 “leddevice.ko leddriver.ko” 的 驱动 模块 文件 。 
、 编 译 测 试 APP 
输入 如 下 命令 编译 测试 ledApp.c 这 个 测试 程序 : 
arm-linux-gnueabihf-gcc ledApp.c -o ledApp 
编译 成 功 以 后 就 会 生成 ledApp 这 个 应 用 程序 。 














N 











54.4.2 运行 测试 





将 上 一 小 节 编 译 出 来 leddevice.ko . leddriverko 和 ledApp 这 两 个 文件 拷贝 到 
rootfs/lib/modules/4.1.15 目录 中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 
加 载 leddevice.ko 设备 模块 和 leddriverko 这 个 驱动 模块 。 

depmod // 第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 

modprobe leddevice.ko // 加 载 设 备 模块 

modprobe leddriver.ko // 加 载 驱 动 模块 


根 文件 系统 中 /sys/bus/platform/ 目 录 下 保存 着 当前 板子 platform 总 线 下 的 设备 和 驱动 ， 其 中 
devices 子 目录 为 platform 设备 ，drivers 子 目 录 为 plartofm 驱动 。 查 看 /sys/bus/platform/devices/ 
目录 ， 看 看 我 们 的 设备 是 否 存在 ， 我 们 在 leddevice.c 中 设置 leddevice(platform device 类 型 ) 的 
name 字段 为 “imx6ul-led” 也 就 是 设备 名 字 为 imx6ul-led， 因 此 肯定 在 /sys/bus/platform/devices/ 
目录 下 存在 一 个 名 字 “imx6ul-led” 的 文件 , 否则 说 明 我 们 的 设备 模块 加 载 失 败 , 结果 如 图 54.4.2.1 
所 示 : 
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|/lib/modules/4.1.15 # is CI 
20cc000. snvs:snvs-powerke m 

20cc000. snvs: snvs-powero 
20cc000. snvs: snvs-rtc-lp 


图 54.4.2.1 imx6ul-led 设备 

同 理 ， 查 看 /sys/bus/platform/drivers/ 目 录 ， 看 一 下 驱动 是 否 存 在 ， 我 们 在 leddriver.c 中 设置 
led driver (platform driver 类 型 ) 的 name 字段 为 “imx6ul-led”， 因 此 会 在 /sys/bus/platform/drivers/ 
目录 下 存在 名 为 “imx6ul-led” 这 个 文件 ， 结 果 如 图 54.4.2.2 所 示 : 
|/1ib/modules/4. 1.15 $ is /sys/bus/platform drivers 


gpio-mxc 1x65» nc! 动 smc911x 
gpio-rc-recv [iméul-led — smc91x 
图 54.4.2.2 imx6ul-led 驱动 

驱动 模块 和 设备 模块 加 载 成 功 以 后 platform 总 线 就 会 进行 匹配 ， 当 驱动 和 设备 匹配 成 功 以 
后 就 会 输出 如 图 54.4.2.3 所 示 一 行 语句 : 


/Nib/modules/4. 1.15 # — leddevice.ko 
nodpro eddriver. ko 


device E de 驱动 和 设备 匹配 成 功 


图 54.4.2.3 驱动 和 设备 匹配 成 功 
驱动 和 设备 匹配 成 功 以 后 就 可 以 测试 LED 灯 驱 动 了 ， 输 入 如 下 命令 打开 LED 灯 : 
/ledApp /dev/platled 1 /打开 LED 灯 
在 输入 如 下 命令 关闭 LED AT: 
/ledApp /dev/platled 0 /关闭 LED 灯 
观察 一 下 LED 灯 能 否 打 开 和 关闭 ， 如 果 可 以 的 话 就 说 明 驱 动工 作 正常 , 如 果 要 和 凶 载 驱动 的 
舌 输 入 如 下 命令 即 可 : 


rmmod leddevice.ko 


























































led driv ver anc e 

















4 











rmmod leddriver.ko 
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第 五 十 五 章 设备 树 下 的 platform 驱动 编写 


上 一 章 我 们 详细 的 讲解 了 Linux 下 的 驱动 分 离 与 分 层 ， 以 及 总 线 、 设 备 和 驱动 这 样 的 驱动 
框架 。 基 于 总 线 、 设 备 和 驱动 这 样 的 驱动 框架 ，Linux 内 核 提出 来 platform 这 个 虚拟 总 线 ， 相 应 
的 也 有 platform 设备 和 platform 驱动 。 上 一 章 我 们 讲解 了 传统 的 、 未 采用 设备 树 的 platform 设 
备 和 驱动 编写 方法 。 最 新 的 Linux 内 核 已 经 支持 了 设备 树 ， 因 此 在 设备 树 下 如 何 编写 platform 
驱动 就 显得 尤为 重要 ， 本 章 我 们 就 来 学 习 一 下 如 何在 设备 树 下 编写 platform 驱动 。 
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55.1 设备 树 下 的 platform 驱动 简介 
platform 驱动 框架 分 为 总 线 、 设备 和 驱动 ， 其 中 总 线 不 需要 我 们 这 些 驱 动 程序 员 去 管理 , 这 












































个 是 Linux 内 核 提 供 的 ， 我 们 在 编写 驱动 的 时 候 只 要 关注 于 设备 和 驱动 的 具体 实现 即 可 。 在 未 
设备 树 的 Linux 内 核 下 , 我 们 需要 分 别 编写 并 注册 platform. device 和 platform. driver, 分 别 代表 
设备 和 驱动 。 在 使 用 设备 树 的 时 候 ， 设 备 的 描述 被 放 到 了 设备 树 中 ， 因 此 platform. device 就 不 
需要 我 们 去 编写 了 ， 我 们 只 需要 实现 platform driver 即 可 。 在 编写 基于 设备 树 的 platform 驱动 
的 时 候 我 们 需要 注意 一 下 几 点 : 

1、 在 设备 树 中 创建 设备 节点 

毫 无 疑问 , 肯定 要 先 在 设备 树 中 创建 设备 节点 来 描述 设备 信息 , 重点 是 要 设置 好 compatible 
BIERE, 因为 platform 总 线 需 要 通过 设备 节点 的 compatible 属性 值 来 匹配 驱动 ! 这 点 要 切记 。 
比如 ， 我 们 可 以 编写 如 下 所 示 的 设备 节点 来 描述 我 们 本 章 实验 要 用 到 的 LED 这 个 设备 : 
示例 代码 55.1.1 gpioled 设备 节点 




























































































gpioled { 
faddress-cells = «1»; 
fsize-cells = «1»; 
compatible = "atkalpha-gpioled"; 
pinctrl-names = "default"; 
pinctrl-0 2 «&pinctrl led»; 
led-gpio = «&gpiol 3 GPIO ACTIVE LOW»; 





Strarus = Voom 


OO A E R EIS MESE 


}; 
示例 55.1.1 中 的 gpioled 节点 其 实 就 是 45.4.1.2 小 节 中 创建 的 gpioled 设备 节点 ， 我 们 可 以 

直接 拿 过 来 用 。 注 意 第 4 行 的 compatible 属性 值 为 “atkalpha-gpioled”， 因此 ， 我 们 一 会 在 编写 
platform 驱动 的 时 候 一 定 要 设置 of match. table 也 有 此 值 。 

2、 编 写 platform 驱动 的 时 候 要 注意 兼容 属性 

上 一 章 已 经 详细 的 讲解 过 了 ， 在 使 用 设备 树 的 时 候 platform 驱动 会 通过 of match table 来 
保存 兼容 性 值 ， 也 就 是 表明 此 驱动 兼容 哪些 设备 。 所 以 ，of match table 将 会 尤为 重要 ， 比 如 本 
例 程 的 platform 驱动 中 platform. driver 就 可 以 按照 如 下 所 示 设 置 : 

示例 代码 55.1.2 of_match_table 匹配 表 的 设置 

static const struct of device id leds of match[] = ( 

( .compatible = "atkalpha-gpioled" ), /* 兼容 属性 */ 

( /* Sentinel */ } 







































































hg 


MODULE DEVICE TABLE(of, leds of match); 


statie struct platiorm river lede polentitexwa driver = 4i 


«oO 0 -1 0 a i» t N H 


.driver = ( 


m 
o 


.name = "imx6ul-led", 


.of match table - leds of match, 


[24 opp5 
S» dq 


}, 
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13 .probe = leds probe, 

14 . remove = leds remove, 

J5 dg 








第 1-4 fT. of device id 表 , 也 就 是 驱动 的 兼容 表 , 是 一 个 数组 ,每 个 数组 元 素 为 of device id 
类 型 。 每 个 数组 元 素 都 是 一 个 兼容 属性 ， 表 示 兼 容 的 设备 ， 一 个 驱动 可 以 跟 多 个 设备 匹配 。 这 
里 我 们 仅仅 匹配 了 一 个 设备 ， 那 就 是 55.1.1 中 创建 的 gpioled 这 个 设备 。 第 2 行 的 compatible 值 
为 “atkalpha-gpioled”， 驱 动 中 的 compatible 属性 和 设备 中 的 compatible 属性 相 匹 配 ， 因 此 驱动 
中 对 应 的 probe 函数 就 会 执行 。 注 意 第 3 行 是 一 个 空 元 素 , 在 编写 of device id 的 时 候 最 后 一 个 
元 素 一 定 要 为 空 ! 

第 6 行 ， 通 过 MODULE DEVICE TABLE 声明 一 下 leds of match 这 个 设备 匹配 表 。 

第 11 行 ， 设 置 platform_ driver 中 的 of match table 匹配 表 为 上 面 创 建 的 leds_ of match, € 
此 我 们 就 设置 好 了 platform 驱动 的 匹配 表 了 。 


3. f$ 5j platform 驱动 


基于 设备 树 的 platform 驱动 和 上 一 章 无 设备 树 的 platform 驱动 基本 一 样 ， 都 是 当 驱 动 和 设 
备 匹 配 成 功 以 后 就 会 执行 probe 函数 。 我 们 需要 在 probe 函数 里 面 执行 字符 设备 驱动 那 一 套 ， 
当 注 销 驱 动 模 块 的 时 候 remove 函数 就 会 执行 ， 都 是 大 同 小 异 的 。 


55.2 硬件 原理 图 分 析 

本 章 实验 我 们 只 使 用 到 IMX6U-ALPHA 开发 板 上 的 LED 灯 , 因此 实验 硬件 原理 图 参考 8.3 
小 节 即 可 。 
55.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 ， 开 发 板 光盘 -> 2、Linux 驱动 例 程 -> 18_dtsplatform。 
本 章 实验 我 们 编写 基于 设备 树 的 platform 驱动 ， 所 以 需要 在 设备 树 中 添加 设备 节点 ， 然 后 
我 们 只 需要 编写 platform 驱动 即 可 。 
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55.3.1 修改 设备 树 文件 


首先 修改 设备 树 文 件 ， 加 上 我 们 需要 的 设备 信息 ， 本 章 我 们 就 使 用 到 一 个 LED 灯 ， 因 此 可 
以 直接 使 用 45.4.1 小 节 编 写 的 gpioled 子 节点 即 可 ， 不 需要 在 重复 添加 。 









































55.3.2 platform 驱动 程序 编写 


设备 已 经 准备 好 了 ， 接 下 来 就 要 编写 相应 的 platform 驱动 了 ， 新 建 名 为 “18 dtsplatform" 
的 文件 来， 然后 在 18_dtsplatform 文件 夹 里 面 创建 vscode 工程 ， 工 作 区 命名 为 “dtsplatform ”。 
新 建 名 为 leddriver.c 的 驱动 文件 ， 在 leddriverc 中 输入 如 下 所 示 内 容 : 
示例 代码 55.3.2.1 leddriver.c 文件 代码 段 















































1 #include <linux/types.h> 
2 Xlinux/kernel.h» 
3  £dinclude «linux/delay.h» 
4 include Xlinux/ide.h» 

5  $dinclude Xlinux/init.h» 

6 #include <linux/module.h> 
7 | $include Xlinux/errno.h» 
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8 #include «linux/gpio.h» 
9  £$include Xlinux/cdev.h» 


10 4include Xlinux/device.h» 

11 4£include X«linux/of gpio.h» 
12 d£include Xlinux/semaphore.h» 
13 4include Xlinux/timer.h» 

14 ds£include Xlinux/irq.h» 

15 d£include Xlinux/wait.h» 

16 d£include Xlinux/poll.h» 

17 d£include Xlinux/fs.h» 

18 4include «Xlinux/fcntl.h» 

19 #include Xlinux/platform device.h» 
20 #include Xasm/mach/map.h» 





21 4$include «asm/uaccess.h» 


22 dinclude Xasm/io.h» 


23 大 大 大人 大 大 大 人大 大 大。 人大。 人 kk kk kk kk kk kk kk kk kc k kc kck kc kck kck kck kck kck kck kck ck ck ck ck ck ck koc 








24. COPY r oN XO) GNU Co tee 99 2029 AL Fones ES Eredi 
25 文件 名 : leddriver.c 
































26 fr : ZEB 

27 版 本 5 V-O 

28 描述 : 设备 树 下 的 platform 驱动 

29 其 他 25 

30 ie : www.openedv.com 

引用 Els : 初版 V1.0 2019/8/13 左 忠 凯 创建 

no KOKCKCKCKCKCKCkCk kCkCk kCk k Ck kCkCk kCk ck k kk k kk Ck k k Ck kCk Ck k kc k k kc k Ck kc k Ck kck ck kck ck ckck ck ckck ck kck c ke kx f 
33 define LEDDEV CNT 1 /* 设备 号 长 度 */ 
34 #define LEDDEV NAME wanes ical /* 设备 名 字 f 
35 d define LEDOFF 0 

36 #define LEDON 1 

Si 


38 /* leddev 设备 结构 体 */ 
Serum liexedelew dewi 








40 dev t devid; /* 设备 号 3 
41 struct cdev cdev; /* cdev a 
42 struct Glass  ""elass /* 28 ay 
43 struct device *device; /* 设备 x 
44 int major; /* 主 设备 号 x 
45 struct device node *node;  /* LED WA Wi */ 
46 ine led0; /* LED 灯 GPIO 标 号 */ 
47 py; 

48 

49 struct leddev dev ledadev; /* led 设备 rA 
50 
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SUE AS 

52  * Qdescription  : LED 打开/ 关闭 

53  * Q8param - sta  : LEDON(0) 1]Jf LED, LEDOFF S 

54  * Qreturn 8 B 

5E 

56 void led0 switch(u8 sta) 

eL 

58 if (sta == LEDON ) 

59 goio set valus (ecelew.les0, uy 

60 else if (sta == LEDOFF) 

61 goio set welwe(ecelew.les0, 1) è 

S20 

63 

64 f 

65  * Qdescription  : 打开 设备 

66  * (param - inode : 传递 给 驱动 的 inode 

67 * (param - filp : 设备 文件 ，file 结构 体 有 个 叫做 private data 的 成 员 变 量 

68 * 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 

63 dis extet sm : 0 成 功 ;其 他 失败 

90 S/ 

71. tatie int lec! open (se inode wincde, struct Tile wiris) 

qw 

73 filp->private_data = &leddev; /* 设置 私有 数据 */ 

74 return 0; 

Uc) 

76 

WU gue 

78  * Qdescription : 向 设备 写 数据 

79  * Qparam - filp : 设备 文件 ， 表 示 打 开 的 文件 描述 符 

SOM (param - buf : 要 写 给 设备 写 入 的 数据 

81  * (param - cnt  : 要 写 入 的 数据 长 度 

82  * @param - offt : 相对 于 文件 首 地 址 的 偏 移 

83  * Qreturn : 写 入 的 字 节 数 ， 如 果 为 负 值 ， 表 示 写 入 失败 

84  */ 

$95 statie gsize t lee vrite(struct tile wiilo, Const Char _ user "uf, 
Size © Cmt, loti "E vorrt)) 

BE 

87 int retvalue; 

88 unsigned char databuf[2]; 

89 unsigned char ledstat; 

90 

91 retvalue 三 copy from user(databuf, buf, cnt); 

92 if(retvalue « 0) ( 
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DIS 

94 printk("kernel write failed!Nrin"); 
95 return -EFAULT; 

96 } 

97 

98 ledstat = databuf[0]; 

99 if (ledstat == LEDON) { 

100 led0_switch (LEDON) ; 

101 ) else if (ledstat == LEDOFF) ( 

WOZ led0 switch (LEDOFF); 

103 ) 

104 return 0; 

is. 4 

106 


107 /* 设备 操作 函数 */ 


lOG gteatic gtruct file operatione lec tops 三 d 








109 .owner = THIS MODULE, 

110 .open = led open, 

dab .write > led write, 

W N 

3S) 

qd x 

115 * Qdescription  : flatform 驱动 的 probe 函数 ， 当 驱动 与 
116 * 设备 匹配 以 后 此 函数 就 会 执行 

117 * @param - dev : platform 设备 

118 * @return : 0， 成 功 ;其 他 负 值 , 失败 

MAS A 

12) gteatic imne lec oe ue platiorm devices vdew) 


1230 






























































112727 printk("led driver and device was matched!NrNn"); 

123 /* 1. KEWE S */ 

124 if (leddev.major) ( 

15225) leddev.devid = MKDEV(leddev.major, 0); 

1L (5 register chrdev region(leddev.devid, LEDDEV CNT, 
LEDDEV NAME); 

15257 ) else ( 

12g alloc chrdev region(&leddev.devid, 0, LEDDEV CNT, 

LEDDEV NAME); 

129 leddev.major = MAJOR(leddev.devid); 

130 ) 

iL Sp 

132 /* 2. IER CE = 

133 cdev init(&leddev.cdev, &led fops); 
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134 cdev add(&leddev.cdev, leddev.devid, LEDDEV CNT); 

T35 

136 /* 3、 创 建 类 n 

1:519] leddev.class 2 class create(THIS MODULE, LEDDEV NAME); 

138 if (IS ERR(leddev.class)) t 

1519] return PTR ERR(leddev.class); 

140 ) 

141 

142 /* 4、 创建 设备 */ 

143 leddev.device = device create(leddev.class, NULL, leddev.devid, 
NULL, LEDDEV NAME); 

144 if (IS ERR(leddev.device)) ( 

Jas return PTR ERR(leddev.device); 

146 ) 

147 

148 /* 5. Wii 10 */ 

dL) leddev.node = of find node by path("/gpioled"); 

150 if (leddev.node == NULL) { 

il sull printk("gpioled node nost find!NrNn"); 

152 return -EINVAL; 

153 } 

154 

ISS leddeyv lec = oft get name! gieso(esclew.mose, "lsc-spio", U)? 

156 if (leddev.led0 < 0) { 

sy Denman ee ger Ed one wan) p 

158 return -EINVAL; 

ISS) ) 

160 

161 gipio resguest (Leddev. legt, "iet 

162 gpio direction output(leddev.led0, 1); / REJM. RARA */ 

163 return 0; 

164 ) 

E65 

SG 

167 * Qdescription  : remove ŘÁžt, WIR platform 驱动 的 时 候 此 函数 会 执行 

168 * @param - dev  : platform 设备 

169 * Qreturn : 0， 成 功 ;其 他 负 值 , 失败 

3g. ssp 


iJi statie int led remoyvelortruct platitor device volew) 

13124 

ES gpio set value(leddev.led0O, 1); /* ERIKA RHR H] LED */ 
174 " o 

15 cdev del(&leddev.cdev); /* 删除 cdaev */ 
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176 unregister chrdev region(leddev.devid, LEDDEV CNT); 

STN device destroy(leddev.class, leddev.devid); 

IS class gcesuzoy (eelelew.elsass) ? 

JEN S) return 0; 

1S0) 

Jon 


182 /* 匹配 列表 */ 


les gtatic Const Sitrwelt OE device ic led ot matca = i 


184 { .compatible = "atkalpha-gpioled" }, 

185 (m Sentinel sy 

dm e 

111917] 

188 /* platform 驱动 结构 体 */ 

leS gratie struct plattorm driver leel criver = qi 
190 .driver = { 

191 .name S "imx6ul-led", /* 驱动 名 字 ， 用 于 和 设备 匹配 */ 
192 .of match table = led of match, /* 设备 树 匹配 表 a 
EOS ), 

194 .probe = led probe, 

195 . remove = led remove, 

IS 3g 

LSN 

I9 ur 

199 * Qdescription : 驱动 模块 加 载 函 数 

200 * Gparam B JE 

201 * Greturn 2 JE 

2E wy 

203 orcatie inc — init s imit (noue 

204 { 

205 return platform driver register(&led driver); 
206 } 

ZAO 

20s s 

209 * Qdescription : 驱动 模块 卸载 函数 

210 = Gparam 8 JE 

2 re e Jb 

212 5 

21.5. greti volc exit leceiver exa (wee) 

214 ( 

215 platform driver unregister(&led driver); 
216 ]) 

ALT 


21/8 module init ((leddriyer init); 
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21/5) module exit (leddriyer exit)? 








220 MODULE LICENSE ("GPL"); 
221 MODULE AUTHOR ("zuozhongkai"); 

第 33-112 行 ， 传 统 的 字符 设备 驱动 ， 没 什么 要 说 的 。 

第 120-164 ÍF, platform 驱动 的 probe 函数 ， 当 设备 树 中 的 设备 节点 与 驱动 之 间 匹 配 成 功 
以 后 此 函数 就 会 执行 ， 原 来 在 驱动 加 载 函 数 里 面 做 的 工作 现在 全 部 放 到 probe 函数 里 面 完成 。 

第 171-180 行 ，remobe Kžt, HEIE platform 驱动 的 时 候 此 函数 就 会 执行 。 在 此 函数 里 面 
释放 内 存 、 注销 字符 设备 等 , 也 就 是 将 原来 驱动 卸载 函数 里 面 的 工作 全 部 都 放 到 remove 函数 中 
完成 。 

第 183~186 行 ， 匹 配 表 ， 描 述 了 此 驱动 都 和 什么 样 的 设备 匹配 ， 第 184 行 添 加 了 一 条 值 为 
"atkalpha-gpioled" 的 compatible 属性 值 ， 当 设备 树 中 某 个 设备 节点 的 compatible 属性 值 也 为 

“atkalpha-gpioled” 的 时 候 就 会 与 此 驱动 匹配 。 

第 189~196 íT, platform driver 驱动 结构 体 , 191 行 设置 这 个 platform 驱动 的 名 字 为 “imx6ul- 
led”， 因 此 ， 当 驱动 加 载 成 功 以 后 就 会 在 /sys/bus/platformy/drivers/ 目 录 下 存在 一 个 名 为 “imx6u- 
led” 的 文件 。 第 192 行 设置 of match table 为 上 面 的 led_of match. 

第 203-206 行 ， 驱 动 模块 加 载 函 数 ， 在 此 函数 里 面 通 过 platform. driver register 向 Linux 内 
核 注 册 led driver 驱动 。 
第 213-216 行 ， 驱 动 模块 卸载 函数 ， 在 此 函数 里 面 通过 platform. driver unregister 从 Linux 
VERIS led driver 驱动 。 
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55.3.3 编写 测试 APP 
测试 APP 就 直接 使 用 上 一 章 54.4.2 小 节 编 写 的 ledApp.c 即 可 。 























55.4 运行 测试 
55.4.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 

编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 “leddrivero” Makefile 内 容 如 下 所 示 : 
示例 代码 55.4.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 






































rel ims 451515 2.1.0 ee alientelk 
4 obj-m := leddriver.o 





12 S$(MAKE) -C S(KERNELDIR) M=$ (CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 “leddrivero ". 
输入 如 下 命令 编译 出 驱动 模块 文件 : 
make -j32 
编译 成 功 以 后 就 会 生成 一 个 名 为 “leddriver.o” 的 驱动 模块 文件 。 
2、 编 译 测试 APP 
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测试 APP 直接 使 用 上 一 章 的 ledApp 这 个 测试 软件 即 可 。 




















55.4.2. 运行 测试 


将 上 一 小 节 编 译 出 来 leddriver.ko 拷贝 到 rootfs/lib/modules/4.1.15 目录 中 ， 
入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 加 载 leddriver.ko 这 个 驱动 模块 。 

depmod /第 一 次 加 载 驱动 的 时 候 需 要 运行 此 命令 

modprobe leddriver.ko /加 载 驱动 模块 

驱动 模块 加 载 完成 以 后 到 /sys/bus/platformy/drivers/ 目录 下 查看 驱动 是 否 存在 ， 我 们 在 
leddriverc 中 设置 led driver (platform driver 类型) 的 name 字段 为 “imx6ul-led”， 因 此 会 在 
/sys/bus/platform/drivers/ 目 录 下 存在 名 为 “imx6ul-led” 这 个 文件 ， 结 果 如 图 55.4.2.1 所 示 : 


lib/modules/4.1.15 # 1s /sys/bus/platform/drivers 
gpio-mxc imx6sx-pinctr] smc911x 
gpio-rc-recv imx6ul-led | 一 驱动 smc91x 


图 55.4.2.1 imx6ul-led 驱动 
同 理 , fE/sys/bus/platform/devices/ H 3€ F ETE led 的 设备 文件 , 也 就 是 设备 树 中 gpioled 这 
个 节点 ， 如 图 55.4.2.2 所 示 : 


limi 
muy 





局 开发 板 ， 进 















































/lib/modules/4.1.15 £ ls /sys/bus/platform/devices/ 
20ca000.usbphy ci hdrc.1 设备 
20cc000. snvs 


图 55.4.2.2 gpioled 设备 
驱动 和 模块 都 存在 ， 当 驱动 和 设备 匹配 成 功 以 后 就 会 输出 如 图 55.4.2.3 所 示 一 行 语句 : 
| ib/moc as /4 z modpnrobe eddriver.ko 
led driver and device was matched! 驱动 和 设备 匹配 成 功 


1D/moau ies 












a " 


图 55.4.2.3 驱动 和 设备 匹配 成 功 

驱动 和 设备 匹配 成 功 以 后 就 可 以 测试 LED 灯 驱 动 了 ， 输 入 如 下 命令 打开 LED J: 
.ledApp /dev/dtsplatled 1 //TT7F LED 灯 

在 输入 如 下 命令 关闭 LED AT: 

./ledApp /dev/dtsplatled 0  //X M] LED 灯 


























观察 一 下 LED 灯 能 否 打 开 和 关闭 ,如 果 可 以 的 话 就 说 明 驱 动工 作 正 常 ， 如 果 要 撮 载 驱动 的 
话 输入 如 下 命令 即 可 : 

















rmmod leddriver.ko 
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第 五 十 六 章 Linux 自 带 的 LED 灯 驱 动 实验 





前 面 我 们 都 是 自己 编写 LED 灯 驱 动 ， 其 实 像 LED 灯 这 样 非常 基础 的 设备 驱动 ，Linux 内 
核 已 经 集成 了 。Linux 内 核 的 LED 灯 了 驱动 采用 platform 框架 ， 因 此 我 们 只 需要 按照 要 求 在 设备 
树 文件 中 添加 相应 的 LED 节点 即 可 ， 本 章 我 们 就 来 学 习 如 何 使 用 Linux 内 核 自 带 的 LED 驱动 
来 驱动 LMX6U-ALPHA 开发 板 上 的 LED0。 
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56.1 Linux 内 核 自 带 LED 驱动 使 能 


上 一 章节 我 们 编写 基于 设备 树 的 platform LED 灯 驱 动 , 其 实 Linux 内 核 已 经 自 带 了 LED 灯 
驱动 ， 要 使 用 Linux 内 核 自 带 的 LED 灯 驱 动 首先 得 先 配 置 Linux 内 核 ， 使 能 自 带 的 LED 灯 纲 
动 ， 输 入 如 下 命令 打开 Linux 配置 菜单 : 

make menuconfig 

按照 如 下 路 径 打 开 LED 驱动 配置 项 : 

-> Device Drivers 

-> LED Support (NEW LEDS [-y]) 
->LED Support for GPIO connected LEDs 

按照 上 述 路 径 ， 选 择 “LED Support for GPIO connectedLEDs”， 将 其 编译 进 Linux 内 核 ， 也 
即 是 在 此 选项 上 按 下 “Y” 键 ， 使 此 选项 前 面 变 为 “<*>” 如 图 56.1.1 所 示 : 


























LED Support 
Arrow keys navigate the menu. <Enter> selects submenus ---> (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. 
Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 
<M> module < > module capable 


--- LED Support 
<*> LED Class Support 
mE LED Flash Class Support 


*** LED drivers *** s ; 
< > LCD Backlight driver for LM3530 选中 Linux 内 核 自 带 LED 驱 动 
< > LED support for LM3642 Chip 


Dus ED Support for GPIO connected LEDs 


< Exit» «Help» < Save> < Load > 





图 56.1.1 使 能 LED 4T IKZ 
TE “LED Support for GPIO connectedLEDs” 上 按 下 可 以 打开 此 选项 的 帮助 信息 ， 如 图 56.1.2 
所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 








LED Support for GPIO connected LEDs 
CONFIG LEDS GPIO: 


This option enables support for the LEDs connected to GPIO 
outputs. To be useful the particular board must have LEDs 

and they must be connected to the GPIO lines. The LEDs must be 
defined as platform devices and/or OpenFirmware platform devices. 
The code to use these bindings can be selected below. 


Symbol: LEDS GPIO [=y] 
Type : tristate 
Prompt: LED Support for GPIO connected LEDs 
Location: 
-» Device Drivers 
-> LED Support (NEW LEDS [=y]) 











图 56.1.2 内 部 LED 灯 驱 动 帮 助 信息 
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从 图 561.2 可 以 看 出 ， 把 Linux 内 部 自 带 的 LED 灯 驱 动 编译 进 内 核 以 后 ， 
CONFIG LEDS GPIO 就 会 等 于 “y”, Linux 会 根据 CONFIG LEDS GPIO 的 值 来 选择 如 何 编译 
LED 灯 驱 动 ， 如 果 为 “y” 就 将 其 编译 进 Linux WE. 

配置 好 Linux 内 核 以 后 退出 配置 界面 ,打开 .config 文件 ,会 找到 “CONFIG LEDS_GPIO=y” 
这 一 行 ， 如 图 56.1.3 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 


















































CONFIG LEDS GPIO-y 





图 56.1.3 .config 文件 内 容 
重新 编译 Linux 内 核 ， 然 后 使 用 新 编译 出 来 的 zImage 镜像 启动 开发 板 。 


56.2 Linux 内 核 自 带 LED 驱动 简介 


56.2.1 LED 灯 驱 动 框架 分 析 


LED 灯 驱 动 文件 为 /drivers/leds/leds-gpio.c， 大 家 可 以 打开 /drivers/leds/Makefile 这 个 文件 ， 
找到 如 下 所 示 内 容 : 























示例 代码 56.2.1.1 /drivers/leds/Makefile 文件 代码 段 
2 4d LED Core 









































3 obi- (CONFIG NEW LEDS) += led-core.o 

23 obj-S$(CONFIG LEDS GPIO REGISTER) += leds-gpio-register.o 
24 obj-$ (CONFIG LEDS GPIO) += leds-gpio.o 

25 obj-$ (CONFIG LEDS LP3944) += leds-1p3944.0 








第 25 fT, 如 果 定 义 了 CONFIG LEDS GPIO 的 话 就 会 编译 leds-gpio.c 这 个 文件 , 在 上 一 小 
节 我 们 选择 将 LED 驱动 编译 进 Linux 内 核 , 在 .config 文件 中 就 会 有 CONFIG LEDS_GPIO=y” 
这 一 行 ， 因 此 leds-gpio.c 驱动 文件 就 会 被 编译 。 
接 下 来 我 们 看 一 下 leds-gpio.c 这 个 驱动 文件 ， 找 到 如 下 所 示 内 容 : 
示例 代码 56.2.1.2 leds-gpio.c 文件 代码 段 


29e eretice Const ue Or device ie Our golo leds macca = d 









































23n ( .compatible = "gpio-leds", h, 

250 , 

DESDE 

Z0 eretle Suec plactorm driver goto lex ciyer = d 
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ZION .probe — gpio led probe, 

202 .remove =o gpio led remove, 

293 .driver = { 

294 .name = "leds-gpio", 

295 .of match table = of gpio leds match, 

296 m 

297 

298 


299 module platform driver(gpio led driver); 

第 236-239 fT, LED 驱动 的 匹配 表 , 此 表 只 有 一 个 匹配 项 , compatible 内 容 为 “gpio-leds”， 
因此 设备 树 中 的 LED 灯 设 备 节 点 的 compatible 属性 值 也 要 为 “gpio-leds”， 否则 设备 和 驱动 丐 
配 不 成 功 ， 驱 动 就 没 法 工作 。 

第 290~296 行 ， driver 驱动 结构 体 变量 ， 可 以 看 出 ，Linux 内 核 自 带 的 LED 驱动 
采用 了 platform 框架 。 第 291 行 可 以 看 出 probe 函数 为 gpio led _probe， 因 此 当 驱 动 和 设备 匹配 
成 功 以 后 gpio led probe 函数 就 会 执行 。 从 294 行 可 以 看 出 ， 驱 动 名 字 为 “leds-gpio” 因此 会 
在 /sys/bus/platform/drivers 目录 下 存在 一 个 名 为 “leds-gpio” 的 文件 ， 如 图 56.2.1.1 所 示 : 


















































/Vib/modules/4.1.15 # 1s Jn du rcl gage du dii 
imx-gpcv2 02p5 -dummy 自 带 LED 驱 动 sram 
imx-i2c stmpe-ts 





图 56.2.1.1 leds-gpio 驱动 文件 
第 299 行 通过 module platform driver 函数 癌 Linux 内 核 注 册 gpio led driver 这 个 platform 
驱动 。 








56.2.2 module platform driver 函数 简 析 








在 上 一 小 节 中 我 们 知道 LED 驱动 会 采用 module platform driver 函数 向 Linux 内 核 注 册 
platform 驱动 ， 其 实在 Linux 内 核 中 会 大 量 采用 module platform driver 来 完成 向 Linux. 内 核 注 
册 platform 驱动 的 操作 。module_platform driver 定义 在 include/linux/platform device.h 文件 中 ， 
为 一 个 宏 ， 定 义 如 下 : 




















示例 代码 56.2.2.1 module platform driver 函数 
221 detine module platform driver( platform driver) r 
222 module driver( platform driver, Platform driver register, \ 
223 platform driver unregister) 
可 以 看 出 ，module platform driver 依赖 module driver, module driver 也 是 一 个 宏 ， 定义 在 
include/linux/device.h 文件 中 ， 内 容 如 下 : 
示例 代码 56.2.2.2 module, driver 函数 











1260 detine ee) 
1261 static int _ iait _ driveri loit{vaid) 1 
152082. N 


1263 return register(&(__driver) , 44 VA ARGS ); \ 
125p 

1265 module init( driveri init); \ 

l266 static vold exit __ driverii exit (void) i 

1260 N 
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1268 


| unregister(&( driver) 


3209 p. N 


1270 module esbe(( driveri esu) 





借助 示例 代码 56.2.2.1 和 示例 代码 56.2.2.2, 34: 


module platform driver(gpio led driver) 
展开 以 后 就 是 : 


static int init gpio led driver init(void) 


{ 


} 


module init(gpio led driver init); 


static void — exit gpio led driver exit(void) 


{ 


} 


module exit(gpio led driver exit); 
上 面 的 代码 不 就 是 标准 的 注册 和 删除 platform 驱动 吗 ? 因此 module_platform driver 函数 的 
功能 就 是 完成 platform 驱动 的 注册 和 删除 。 





56.2.3 gpio led probe 函数 简 析 


当 了 驱动 和 设备 匹配 以 后 gpio led probe 函数 就 会 执行 ， 此 函数 主要 是 从 设备 树 中 获取 LED 
灯 的 GPIO 信息 ， 缩 减 后 的 函数 内 容 如 下 所 示 : 
示例 代码 56.2.3.1 gpio led probe 函数 
GE gplo leel prolbelstruct platciorm device 39e) 


244 ( 
245 


246 
247 
248 
249 


268 
269 
2710 
271 
22 
总 
274 
25 
2m6 
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, ## VA ARGS ); \ 


return platform driver register (&(gpio led driver)); 


platform driver unregister (&(gpio led driver) ); 


struct gpio led platform data *pdata - 


dev get platdata (&pdev-»dev); 


Sitze goo leds priy woprivp 


Skane akp Wetene E 0 


if (pdata && pdata->num leds) ( 
/* W platform device 信息 */ 


priv — gpio leds create (pdev); 


if (IS ERR(priv)) 


return PTR ERR(priv); 


platform set drvdata(pdev, priv); 


return 0; 
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第 269-271 行 ， 如 果 使 用 设备 树 的 话 ， 使 用 gpio leds create 函数 从 设备 树 中 提取 设备 信 























上 县， 获取 到 的 LED XT GPIO 信息 保存 在 返回 值 中 ，gpio_leds_create 函数 内 容 如 下 : 
示例 代码 56.2.3.2 gpio leds create 函数 


157 Statie struct guo leds priy wool leds Createlstruct 








platform device *pdev) 




































































168 ( 

T69 struct device *dev = &pdev->dev; 

IO struct fwnode handle *child; 

Taa struct goio leds priy worivy 

I2 Hac Glow. ISP 

1L 2/5] struct device node mo, 

174 

US count = device get child node count (dev); 

176 if (!count) 

15757 return ERR PTR(-ENODEV); 

Ime 

19 priv = devm kzalloc(dev, sizeof gpio leds priv(count), 
GFP KERNEL); 

180 su (ny) 

ileal return ERR PTR(-ENOMEM); 

182 

183 device for each child node(dev, child) ( 

184 Gee goro lex! led = {i7 

185 const char *state - NULL; 

186 

187 led.gpiod = devm get gpiod from child(dev, NULL, child); 

188 if (1S ERR(led.gpiod)) ( 

189 fwnode handle put (child); 

190 ret = PTR ERR(led.gpiod); 

9 goto err; 

T92 } 

9 

194 np = of node(child); 

19/5 

196 if (fwnode property present(child, "iabel")) ( 

197 fwnode property read string(child, "label", &led.name); 

198 ) else ( 

199 if (IS ENABLED(CONFIG OF) && !led.name && np) 

200 led.name - np-»name; 

ZAO if (!led.name) 

202 return ERR PTR(-EINVAL); 

203 } 
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204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
Zu 
ZU 
ZA 
220 
221 
222 
29 
224 
295 
2210 
2 
228 
229 
2S0 
ZONE 
ED 
2195 
234 
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fwnode property read string(child, "linux,default-trigger", 


&led.default trigger); 


if (!fwnode property read string(child, "default-state", 


&state)) ( 
if ('!strcemp(state, "keep")) 


led.default state = LEDS GPIO DEFSTATE KEEP; 


else if (!strcmp(state, "on")) 


led.default state = LEDS GPIO DEFSTATE ON; 


else 


led.default state - LEDS GPIO DEFSTATE OFF; 





if (fwnode property present(child, "retain-state-suspended")) 


lloc scommesse c EM 


ret = create gpio led(&led, &priv-»leds[priv-»num leds], 


dev, NULL); 
sus (Gee < 0» (i 
fwnode handle put (child); 


goto err; 


return priv; 


err; 


cos (Count > priynumn leds — 2; Cow > 09 Goumt--) 


delete gpio led(&priv-»1leds[count]); 

return ERR PTR(ret); 
} 
第 175 fT. 调用 device get child node count 函数 统计 子 节点 数量 , 一 











般 在 在 设备 树 中 创建 


一 个 节点 表示 LED 灯 ， 然 后 在 这 个 节点 下 面 为 每 个 LED 灯 创建 一 个 子 节点 。 因 此 子 节点 数量 
也 是 LED 灯 的 数量 。 





第 183 行 ， 遍 历 每 个 子 节 上 点， 获取 每 个 子 节点 的 信息 。 
第 187 行 ， 获 取 LED 灯 所 使 用 的 GPIO 信息 。 














第 196~197 行 ， 读 取 子 节点 label 属性 值 ， 因 为 使 用 label 属性 作为 LED 的 名 字 。 
第 204-205 行 ， 获取“linux,default-trigger” 属 性 值 ， 可 以 通过 此 属性 设置 某 个 LED 灯 在 
Linux 系统 中 的 默认 功能 ， 比 如 作为 系统 心跳 指示 灯 等 等 。 
































第 207~215 行 ， 获 取 “default-state” 属 性 值 ， 也 就 是 LED 灯 的 默认 省 
































态 属 性 。 





第 220 行 ， 调 用 create gpio led 函数 创建 LED 相关 的 io， 其实 就 是 设置 LED 所 使 用 的 io 
为 输出 之 类 的 。create_gpio_led 函数 主要 是 初始 化 led dat 这 个 gpio led data 结构 体 类 型 变量 ， 
led dat 保存 了 LED 的 操作 函数 等 内 容 。 
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关于 gpio led probe 函数 就 分 析 到 这 里 ，gpio_led_probe 函数 主要 功能 就 是 获取 LED 灯 的 
设备 信息 ， 然 后 根据 这 些 信 息 来 初始 化 对 应 的 IO， 设 置 为 输出 等 。 


56.3. 设备 树 节点 编写 


打开 文档 Documentation/devicetree/bindings/leds/leds-gpio.txt, 此 文档 详细 的 讲解 了 Linux El 
带 驱 动 对 应 的 设备 树 节点 该 如 何 编写 ， 我 们 在 编写 设备 节点 的 时 候 要 注意 一 下 几 点 : 

、 创 建 一 个 节点 表示 LED 灯 设 备 , 比如 dtsleds, 如 果 板 子 上 有 多 个 LED 灯 的 话 每 个 LED 
灯 都 作为 dtsleds 的 子 节点 。 

®©, dtsleds 节点 的 compatible 属性 值 一 定 要 为 “gpio-leds”。 

©, KE label 属性 ， 此 属性 为 可 选 ， 每 个 子 节点 都 有 一 个 label 属性 ，label 属性 一 般 表示 
LED 灯 的 名 字 ， 比 如 以 颜色 区 分 的 话 就 是 red、green 等 等 。 

曲 、 每 个 子 节 点 必须 要 设置 gpios 属性 值 ， 表 示 此 LED 所 使 用 的 GPIO 引 脚 ! 

©, YURE "linuxdefault-trigger" RIEBE, t EXE LED 灯 的 默认 功能 ， 可 以 查阅 
Documentation/devicetree/bindings/leds/common.txt 这 个 文档 来 查看 可 选 功能 ， 比 如 : 

backlight: LED 灯 作 为 背光 。 

default-on: LED 灯 打 开 

heartbeat: LED 灯 作 为 心跳 指示 灯 ， 可 以 作为 系统 运行 提示 灯 。 

ide-disk: LED 灯 作 为 硬盘 活动 指示 灯 。 

timer: LED 灯 周 期 性 闪烁 ， 由 定时 器 驱动 ， 闪 烁 频率 可 以 修改 

@、 可 以 设置 “default-state” 属 性 值 ， 可 以 设置 为 on、off 或 keep， 为 on 的 时 候 LED 灯 默 
认 打 开 ， 为 off 的 话 LED 灯 默 认 关 闭 ， 为 keep 的 话 LED 灯 保 持 当 前 模式 。 

根据 上 述 几 条 要 求 在 imx6ull-alientek-emmce.dts 中 添加 如 下 所 示 LED 灯 设 备 节点 : 

示例 代码 56.3.1 dtsleds 设备 节点 






































































































































i dtsleds ( 

2 compatible = "gpio-leds"; 

3 

4 ledO ( 

5 label = "red"; 

6 gpios = «&gpiol 3 GPIO ACTIVE LOW»; 
7 default-state - "off"; 

8 ] 

9 Dg 








因为 LMX6U-ALPHA 开发 板 只 有 一 个 LED0， 因 此 在 dtsleds 这 个 节点 下 只 有 一 个 子 节点 
led0，LED0 名 字 为 red， 默 认 关 闭 。 修 改 完成 以 后 保存 并 重新 编译 T" 然后 用 新 的 设备 树 
启动 开发 板 。 



































56.4 运行 测试 


用 新 的 zImage 和 imx6ull-alientek-emmc.dtb 启动 开发 板 ， 启动 以 后 查看 
/sys/bus/platform/devices/dtsleds 这 个 目录 是 否 存 在 ， 如 果 存 在 的 话 就 如 到 此 目录 中 ， 如 图 56.4.1 
所 示 : 

/sys/devices/platform/dtsleds # 1s 


driver leds of_node subsystem 
driver_override modalias power uevent 
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图 56.4.1 dtsleds 目录 
进入 到 leds 目录 中 ， 此 目录 中 的 内 容 如 图 56.4.2 所 示 : 


/sys/devices/platform/dtsleds/leds & ls 
re 








/sys/devices/platform/dtsleds/leds £ 


图 56.4.2 leds 目录 内 容 
从 图 56.4.2 可 以 看 出 , 在 leds 目录 下 有 一 个 名 为 “red” 子 目录 ， 这 个 子 目 录 的 名 字 就 是 我 
们 在 设备 树 中 第 5 行 设 置 的 label 属性 值 。 
我 们 的 设置 究竟 有 没有 用 ， 最 终 是 要 通过 测试 才能 知道 的 ， 首 先 查 看 一 下 系统 中 有 没有 
“sys/class/leds/red/brightness” 这 个 文件 ， 如 果 有 的 话 就 输入 如 下 命令 打开 RED 这 个 LED AJ: 









































echo 1 > sys/class/leds/red/brightness /打开 LED0 
关闭 RED 这 个 LED 灯 的 命令 如 下 : 
echo 0 > sys/class/leds/red/brightness /关闭 LEDO 


如 果 能 正常 的 打开 和 关闭 LED 灯 话 就 说 明 我 们 Linux 内 核 自 带 的 LED 灯 驱 动工 作 正常 。 
我 们 一 般 会 使 用 一 个 LED 灯 作 为 系统 指示 灯 ， 系 统 运 行 正常 的 话 这 个 LED 指示 灯 就 会 一 内 一 
闪 的 。 里 我 们 设置 LEDO 作为 系统 指示 灯 , 在 dtsleds 这 个 设备 节点 中 加 入 “linux,default-trigger” 
属性 信息 即 可 ， 属 性 值 为 “heartbeat”， 修改 完 以 后 的 dtsleds 节点 内 容 如 下 : 
示例 代码 56.3.2 dtsleds 设备 节点 
































dtsleds { 
compatible = "gpio-leds"; 


il 

2 

3 

4 ledO ( 

5 label = "red"; 
6 gpios - «&gpiol 3 GPIO ACTIVE LOW»; 
3 

8 

9 





linux,default-trigger = "heartbeat"; 


default-state = "on"; 


10 > 

第 7 行 ， 设 置 LED0 为 heartbeat. 

第 8 行 ， 默 认 打开 LED0。 

重新 编译 设备 树 并 且 使 用 新 的 设备 树 启动 Linux 系统 ， 启 动 以 后 LED0 就 会 闪烁 ， 作 为 系 
统 心跳 指示 灯 ， 表 示 系 统 正在 运行 。 
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第 五 十 七 章 Linux MISC 驱动 实验 


misc 的 意思 是 混合 、 杂 项 的 ， 因 此 MISC 驱动 也 叫做 杂项 驱动 ， 也 就 是 当 我 们 板子 上 的 某 


























些 外 设 无 法 进行 分 类 的 时 候 就 可 以 使 用 MISC 驱动 。MISC 驱动 其 实 就 是 最 简单 的 字符 设备 驱 
zh, IH ETE platform 总 线 驱 动 中 ， 实 现 复 杂 的 驱动 ， 本 章 我 们 就 来 学 习 一 下 MISC 驱动 的 


编写 。 














Eü 
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57.1 MISC 设备 驱动 简介 


所 有 的 MISC 设备 驱动 的 主 设备 号 都 为 10， 不 同 的 设备 使 用 不 同 的 从 设备 号 。 随 着 Linux 
字符 设备 驱动 的 不 断 增 加 ， 设 备 号 变 得 越 来 越 紧 张 , 尤其 是 主 主 设备 号 , MISC 设备 驱动 就 用 于 
解决 此 问题 。MISC 设备 会 自动 创建 cdev, 不 需要 像 我 们 以 前 那样 手动 创建 , 因此 采用 MISC ix 
备 驱动 可 以 简化 字符 设备 驱动 的 编写 。 我 们 需要 向 Linux 注册 一 个 miscdevice 设备 ，miscdevice 
是 一 个 结构 体 ， 定 义 在 文件 

示例 代码 57.1.1 miscdevice 结构 体 代码 
57 struct miscdevice ( 
























































58 int minor; /* 子 设备 号 A 
59 const char *name; /* 设备 名 字 in 
60 Const iciwCdE tile operations VAEOIS E /* 设备 操作 集 um 
61 Srvuee dist nead listy 

62 struct device *parent; 

63 struct device mis device? 

64 Const eu os 

65 ONSE Glue Viene? 

66 umode t mode; 

67 }; 


定义 一 个 MISC 设备 (miscdevice 类 型 ) 以 后 我 们 需要 设置 minor. name 和 fops 这 三 个 成 员 
变量 。minor 表示 子 设备 号 ，MISC 设备 的 主 设备 号 为 10， 这 个 是 固定 的 ， 需 要 用 户 指定 子 设 备 
F, Linx 系统 已 经 预定 义 了 一 些 MISC 设备 的 子 设备 号 ， 这 些 预定 义 的 子 设备 号 定义 在 
include/linux/miscdevice.h 文件 中 ， 如 下 所 示 : 

示例 代码 57.1.2 预定 义 的 MISC 设备 子 设备 号 



























































13 #define PSMOUSE MINOR 1 

14 #define MS BUSMOUSE MINOR PONE SCC 

15 4$define ATIXL BUSMOUSE MINOR 3 4*5 wummeeo */ 

16 /*#define AMIGAMOUSE MINOR 4  FIXME OBSOLETE */ 
17 #define ATARIMOUSE MINOR DO /* mausad =/ 

18 #define SUN MOUSE MINOR 3 UD UIS 

52 $define MISC DYNAMIC MINOR 253 











我 们 在 使 用 的 时 候 可 以 从 这 些 预 定义 的 子 设 备 号 中 挑选 一 个 ， 当 然 也 可 以 自己 定义 ， 只 要 
这 个 子 设 备 号 没有 被 其 他 设备 使 用 接口 。 

name 就 是 此 MISC 设备 名 字 , 当 此 设备 注册 成 功 以 后 就 会 在 /dev 目录 下 生成 一 个 名 为 name 
的 设备 文件 。fops 就 是 字符 设备 的 操作 集合 ，MISC 设备 驱动 最 终 是 需要 使 用 用 户 提供 的 fops 
操作 集合 。 

当 设 置 好 miscdevice 以 后 就 需要 使 用 misc register 函数 向 系统 中 注册 一 个 MISC 设备 ， 此 
函数 原型 如 下 : 

int misc register(struct miscdevice * misc) 

函数 参数 和 返回 值 含 义 如 下 : 

mise: 要 注册 的 MISC 设备 。 

返回 值 ， 负数 ， 失 败 ; 0， 成 功 。 
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以 前 我 们 需要 自己 调用 一 堆 的 函数 去 创建 设备 ， 比 如 在 以 前 的 字符 设备 驱动 中 我 们 会 使 用 
如 下 几 个 函数 完成 设备 创建 过 程 : 
示例 代码 57.1.3 传统 的 创建 设备 过 程 











1 alloc chrdev region(); /* 申请 设备 号 nu 
2 cdev init(); /* 初始 化 cdev */ 
3 cdev add(); /* 添加 cdev */ 
4 class create(); /* 创建 类 */ 
5 device create(); /* 创建 设备 yl 








现在 我 们 可 以 直接 使 用 misc. register 一 个 函数 来 完成 示例 代码 57.1.2 中 的 这 些 步骤 。 当 我 
们 外 载 设备 驱动 模块 的 时 候 需 要 调用 misc_deregister 函数 来 注销 掉 MISC 设备 , 函数 原型 如 下 : 

int misc deregister(struct miscdevice *misc) 

函数 参数 和 返回 值 含 义 如 下 : 

misce: 要 注销 的 MISC 设备 。 

返回 值 ， 负数 ， 失 败 ; 0， 成 功 。 

以 前 注销 设备 驱动 的 时 候 ， 我 们 需要 调用 一 堆 的 函数 去 删除 此 前 创建 的 cdev、 设 备 等 等 
容 ， 如 下 所 示 : 























示例 代码 57.1.3 传统 的 删除 设备 的 过 程 


1 eder Cell); /* 删除 eduev — */ 
2 unregister chrdev region();  /* ike —*/ 
3 device destroy(); /* 删除 设备 mf 
4 class destroy(); /* 删除 类 A 





现在 我 们 只 需要 一 个 misc deregister 函数 即 可 完成 示例 代码 57.1.3. 中 的 这 些 工 作 。 关 于 
MISC 设备 驱动 就 讲解 到 这 里 ， 接 下 来 我 们 就 使 用 platform 加 MISC 驱动 框架 来 编写 beep IIIS 
器 驱动 。 


57.2 硬件 原理 图 分 析 


本 章 实 验 我 们 只 使 用 到 IMX6U-ALPHA 开发 板 上 的 BEEP 蜂 鸣 器 , 因此 实验 硬件 原理 图 参 
考 14.3 小 节 即 可 。 


57.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 2、Linux 驱动 例 程 -> 17_misc。 
本 章 实验 我 们 采用 platform 加 misc 的 方式 编写 beep 驱动 ， 这 也 是 实际 的 Linux 驱动 中 很 
常用 的 方法 。 采 用 platform 来 实现 总 线 、 设 备 和 驱动 ，misc 主要 负责 完成 字符 设备 的 创建 。 






















































































57.3.1 修改 设备 树 


本 章 实 验 我 们 需要 用 到 蜂 鸣 器 , 因此 需要 在 imx6ull-alientek-emmc.dts 文件 中 创建 蜂 鸣 器 设 
备 节 点 ， 这 里 我 们 直接 使 用 46.3.1 小 节 创 建 的 beep 这 个 设备 节点 即 可 。 



































57.3.2 beep 驱动 程序 编写 


新 建 名 为 “19_miscbeep” 的 文件 来， 然后 在 19_miscbeep 文件 夹 里 面 创建 vscode 工程 ， 工 
作 区 命名 为 “miscbeep。 新 建 名 为 miscbeep.c 的 驱动 文件 , 在 miscbeep.c 中 输入 如 下 所 示 内 容 : 
示例 代码 57.3.2.1 miscbeep.c 文件 代码 段 
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finclude <linux/types.h> 


finclude «linux/kernel.h» 
finclude «linux/delay.h» 
finclude «linux/ide.h» 
finclude «linux/init.h» 
#include <linux/module.h> 


include «linux/errno.h» 


COE IS CYCLES COREISS I ES 


finclude «linux/gpio.h» 

9  $include Xlinux/cdev.h» 

10 4include Xlinux/device.h» 

11 d4include Xlinux/of.h» 

12 4$include Xlinux/of address.h» 

13 4£include «linux/of gpio.h» 

14 #include Xlinux/platform device.h» 











15 d£include «Xlinux/miscdevice.h» 
16 4$include «asm/mach/map.h» 

17 #include «asm/uaccess.h» 

18 4include «asm/io.h» 


19 J[KCKCKCKCKCKCkCk kCkCk kCkCk KC KCKCkCKCkCk KC KC kCKCK kCKCKCkCKCkCk kCkCk kCk ck Ck kCk Ck kc k Ck k kc k k kc k kck ck ck kck ck ck ck k 








20 Copyrigat ATO NIE Coor beci 1998-2029; AIL sn 






































21 文件 名 : miscbeep.c 

22 AE : 左 忠 凯 

23 版 本 SENE 

24 描述 : 采用 MISC 的 蜂 鸣 器 驱动 程序 。 

25 其 他 : oh 

26 论坛 : Www.openedv.com 

27 四 二 : 初版 V1.0 2019/8/20 左 忠 凯 创建 

28 KOKCKCKCKCkCKCkCk kCkCk kCk k Ck kCk Ck kCk ck k kk k kc k Ck k k Ck kc kc k k kc k k k k Ck kc k Ck kck ck kck ck ckckck ck ck ck kck ck ke kk f 
29 #define MISCBEEP NAME "miscbeep" sd sy 
30 #define MISCBEEP MINOR 144 l= Paa */ 
31 #define BEEPOFF 0 /* AME */ 
32 4define BEEPON íl /* 开 蜂 鸣 器 */ 

















34 /* miscbeep 设备 结构 体 */ 
35 Struct muscles deyi 





36 dev t devid; /* 设备 号 2 
2] struct Gey edev? /* cdev nA 
38 struct Class "elsasss? [E mE A 
39 struct device *device; /* 设备 */ 
40 struct device node *nd; /* 设备 节点 2 
41 int beep gpio; /* beep 所 使 用 的 GPIO 编号 */ 
Am Jj 

43 
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44 struct miscbeep dev miscbeep; /* beep 设备 w 
45 

GE Lx 

47  * Qdescription  : 打开 设备 


48  * Qparam - inode : 传递 给 驱动 的 inode 
49  * Qparam - filp : 设备 文件 ，file 结构 体 有 个 叫做 private data 的 成 员 变 量 





50 E 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 
5a * @return : 0 成 功 ;其 他 失败 
5:2 e f 


5% tatic int mischbesp opeum(sicucu inode vinode, struct tile wE) 
54 ( 


55 filp-»private data = &miscbeep; /* 设置 私有 数据 */ 
56 return 0; 

i 

58 

5G yx 


60  * QGdescription  : 向 设备 写 数 据 

61 * Qparam - filp : 设备 文件 ， 表 示 打 开 的 文件 描述 符 

62 parani mE : 要 写 给 设备 写 入 的 数据 

S * (param = cnt : 要 写 入 的 数据 长 度 

64  * @param - offt : 相对 于 文件 首 地 址 的 偏 移 

65  * Qreturn : 写 入 的 字 节 数 ， 如 果 为 负 值 ， 表 示 写 入 失败 
GO/ 

57 Bite EXC Sede t aiiecloeejo write(struct iile ux. 


Conste Char _ Uger voui, size t Gnt, loui t Ot) 




















68 { 

69 int retvalue; 

70 unsigned char databuf[1]; 

pal unsigned char beepstat; 

72 struct miscbeep dev *dev = filp-»private data; 

Tj 

74 retvalue 5 copy from user(databuf, buf, cnt); 

38 if(retvalue « 0) ( 

76 printk("kernel write failed!NrNin"); 

E return -EFAULT; 

78 ) 

了 3 

80 beepstat = databuf Tol, /* 获取 状态 值 rA 
81 if(beepstat == BEEPON) ( 

82 gpio set value(dev-»beep gpio, 0); /* 打开 蜂 鸣 器 r1 
83 ) else if(beepstat == BEEPOFF) ( 

84 gpio set value(dev-»beep gpio, 1); /* 关闭 蜂 鸣 器  */ 
85 ) 
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86 return 0; 

87 ) 

88 

89 /* 设备 操作 函数 */ 

S0 statie struct iile operations miselhbesp Tops = i 

dl .owner = THIS MODULE, 

92 .open = miscbeep open, 

95 .write = miscbeep write, 

Su jg 

25 

96 /* MISC 设备 结构 体 */ 

9| etatie struct miscdevice besp miescder = q 

98 .minor = MISCBEEP MINOR, 

EO .name = MISCBEEP NAME, 

100 .fops = &miscbeep fops, 

ib jp 

102 

TOSH ote 

104  * Qdescription : flatform 驱动 的 probe 函数 ， 当 驱动 与 

10a ~= 设备 匹配 以 后 此 函数 就 会 执行 

106 * @param - dev : platform 设备 

107  * Qreturn : 0， 成 功 ;其 他 负 值 , 失败 

ok 

109 gteatic amissi creo To credere platiorm device wdew)) 

Tako 

Lail int ret -2 0; 

3102 

108 printk("beep driver and device was matched!NrMn"); 

114 /* WE BEER PEHY GETO */ 

1.105 /* 1、 获 取 设 备 节 点 : beep */ 

116 wiLexeloxeego no = xr find node Dy joxencim((" /beep )) p 

J if(miscbeep.nd == NULL) { 

118 printk("beep node not find!WNrNn"); 

1119 return -EINVAL; 

120 } 

IEZA 

122 /* 2. 获取 设备 树 中 的 gpio 属性 ， 得 到 BEEP 所 使 用 的 BEEP 编号 */ 

32:9) miscbeep.beep goio — of get named gpio(miscbeep.nd, "beep-gpio", 
0); 

124 if(miscbeep.beep gpio < 0) d 

3125; printk("can't get beep-gpio"); 

15216 return -EINVAL; 

127 } 


1342 


LMX6U WAR Linux 驱动 开发 指南 O ERAF 

















原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
128 

129 /* 3. RA GPIO5_I001 为 输出 ， 并 且 输 出 高 电 平 ， 默 认 关 闭 BEEP */ 
130 ret = golo Cirection output (QGulecelseep.sesp gelo, p 

T31 if(ret « O) ( 

1L 92 Bene oan t set reposo Nie aw) e 

133 } 

134 


135 /* 一 般 情况 下 会 注册 对 应 的 字符 设备 ， 但 是 这 里 我 们 使 用 MISC 设备 
136 * 所 以 我 们 不 需要 自己 注册 字符 设备 驱动 ， 只 需要 注册 misc 设备 驱动 即 可 
137 *f 








138 ret = misc register(&beep miscdev); 

139 if(ret « O)|( 

140 printk ("misc device register failed!NrMn"); 
IEAS return -EFAULT; 

142 } 

143 

144 return 0; 

145 } 

146 

TAES 

148 * Qdescription  : remove IKZ5, WR platform 驱动 的 时 候 此 函数 会 执行 
149 * @param - dev : platform 设备 

WSO e Grewrtian : 0, 成 功 ;其 他 负 值 , 失败 

1b oes 


1.5/2 statie int migscbeep renove lstruct plarctorm Glewiiee vdev)) 
TS 
154 /* 注销 设备 的 时 候 关闭 LED AI */ 





1965 gpio set value(miscbeep.beep gpio, 1); 
156 

15) 7 /* 注销 misc 设备 驱动 */ 

158 mise cderegister (besp uuibscolew) p 

1:59) return 0; 

60) 

dL 


162 /* 匹配 列表 */ 


les static const struct ot devices il besp ot matchi = d 


164 { .compatible = "atkalpha-beep" }, 

165 ( /* Sentinel */ j 

LEa E 

167 

168 /* platform 驱动 结构 体 */ 

169 static struct platform driver besp driver = ( 
170 .driver = { 
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Lm .name  - "imx6ul-beep", /* 驱动 名 字 an 
152 .of match table = beep of match,  /* 设备 树 匹 配 表 */ 
d 3/8) p 

174 .probe = miscbeep probe, 

INS . remove = miscbeep remove, 

dU JB 

JE gi 

Ur s 

179 * Qdescription : 驱动 出 口 函数 

180 * param S JE 

181 * Greturn s JE 

192. 3 

18,5) Sratic imt _ imirt mistbego imit (voici) 

184 { 

ies return platform driver register(&beep driver); 

186 T 

1:67 

MERE ffe 

189 * QGdescription : 驱动 出 口 函 数 

190 * Qparam 8 JE 

191 * @return 8 3E 

192. wy 

19/53 Static void  — exit miedbssp eub (voie) 

194 ( 

E95 platform driver unregister(&beep driver); 

196 } 

31:97 


1$ mocule init(mischbesp imit) p 

199 module exit(miscbeep exit); 

200 MODULE LICENSE ("GPL"); 

201 MODULE AUTHOR ("zuozhongkai"); 
第 29-94 行 ， 标 准 的 字符 设备 驱动 。 



































第 97-101 fT, MISC 设备 beep_miscdev， 第 98 行 设 置 子 设备 号 为 144， 第 99 行 设置 设备 
名 字 为 “miscbeep”， 这 样 当 系统 启动 以 后 就 会 在 /dev/ 目 录 下 存在 一 个 名 为 “miscbeep” 的 设备 





文件 。 第 100 行 ， 设 置 MISC 设备 的 操作 函数 集合 ， 为 file_operations 类 型 。 











第 109~145 ÍF, platform 框架 的 probe 函数 ， 当 驱动 与 设备 匹配 以 后 此 函数 就 会 执行 ,首先 
在 此 函数 中 初始 化 BEEP 所 使 用 的 IJO。 最 后 在 138 行 通 过 misc. register 函数 向 Linux 内 核 注 册 


























MISC 设备 ， 也 就 是 前 面 定义 的 beep_miscdev。 











第 152-160 fT, platform 框架 的 remove 函数 ， 在 此 函数 中 调用 misc_deregister 函数 来 注销 


MISC 设备 。 
第 163~196， 标 准 的 platform 驱动 。 
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57.3.3. 编写 测试 APP 





新 建 miscbeepApp.c 文件 ， 然 后 在 里 面 输入 如 下 所 示 内 容 : 


#include 
finclude 
finclude 
finclude 
finclude 
finclude 


neiude 


e E ea CH S IE 





示例 代码 57.3.2.2 miscbeepApp.c 文件 代码 段 
MSEE c dn 
irme 
"sys/types.h" 
Ns S Asta NY 
Vsgteaeme dL - Ini 
Mene sudo) 


We star «nr 


Jf[ FCKCKCKCKCk KCkCk kCkCk kCkCk kCkCkCkCKCkCk KCkCk kCkCK KC Ck kCkCk kCkck kCk Ck Ck kCk Ck kc k ck kck k kck ck kck ck ckckck ko ko 





9 Gopysstgih O AFTENTHEK ICO NN Teo 2029 ATI giis reserved 


10 文件 名 
11 [Exi 
12 版 本 
13 描述 
14 其 他 
15 使 用 方法 





J 


18 Ez 


miscbeepApp.c 


A 左 忠 凯 

8 Web s (0) 

: MISC 驱动 框架 下 的 beep 测试 APP. 
SUE 


./miscbeepApp /dev/miscbeep 0 关闭 蜂 鸣 器 
./misdcbeepApp /dev/miscbeep 1 打开 蜂 鸣 器 
www.openedv.com 


: 初版 V1.0 2019/8/20 左 忠 凯 创建 


19 KCKCKCKCkCKCk kCkCk k kk k kk Ck kCk Ck k kk k kc k k kc k Ck k Ck Ck kCkCk k kk k kk Ck kc k Ck kck ck kck ck ckck ck ckckck ck ck e k kx f 




















20 4$define BEEPOFF 0 

21 $define BEEPON ii 

22 

DOM 

24 * (description : main 主 程序 

25 * Qparam - argo  : argv XUBZURA 
26 * Q8param - argv  : 有 具体 参数 

27 * Qreturn : 0 成 功 ;其 他 失败 
Zn ue 

Zeme em (me ewe ne 
20 

Sn int fd, retvalue; 

32 char *filename; 

ES unsigned char databuf[1]; 

34 

35 if (argc != 3)( 

36 printf (Error Usagel We 
2 return -1; 

38 ) 

B9 
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40 filename = argv[!]; 

41 fd = open(filename, O RDWR); /* 打开 beep 驱动 */ 
42 if(fd < 0){ 

43 printf("file ss open failed!NrWin", argv[1]); 
44 return -1; 

45 } 

46 

47 darau [o] e aroilargv hlii) B /* 要 执行 的 操作 : 打开 或 关闭 */ 
48 retvalue = write(fd, databuf, sizeof(databuf)); 
49 if(retvalue « 0)( 

50 pruntst(" BEHEP GComntrol Eauded! Vemm 

5l close(fd); 

52 return -1; 

53 } 

54 

55 retvalue = close(fd); /* 关闭 文件 */ 

56 if(retvalue « O)( 

Sj printf (O tile ss close fairlediN\rAni argy b) 
58 return -1; 

59 } 

60 return 0; 

61 ] 


miscbeepA pp.c 文件 内 容 和 其 他 例 程 的 测试 APP 基本 一 致 ， 很 简单 ， 这 里 就 不 讲解 了 。 





57.4 运行 测试 
57.4.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 

编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 “leddevice.o leddriver.o", Makefile 内 容 如 下 所 示 : 
示例 代码 57.4.1.1 Makefile 文件 
1 KERNELDIR :- /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 


























iel imz 4.1.15 24150 ge alisntek 
4 obj-m := miscbeep.o 
11 clean: 
12 S$(MAKE) -C S$(KERNELDIR) M=$ (CURRENT PATH) clean 
第 4 行 ， 设置 obj-m 变量 的 值 为 “miscbeep.0”。 
输入 如 下 命令 编译 出 驱动 模块 文件 : 
make -j32 
编译 成 功 以 后 就 会 生成 一 个 名 为 “miscbeep.ko” 的 驱动 模块 文件 。 
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2、 编 译 测 试 APP 


输入 如 下 命令 编译 测试 miscbeepApp.c 这 个 测试 程序 : 
arm-linux-gnueabihf-gcc miscbeepApp.c -o miscbeepApp 


编译 成 功 以 后 就 会 生成 miscbeepA pp 这 个 应 用 程序 。 








57.4.2. 运行 测试 











将 上 一 小 节 编 译 出 来 miscbeep.ko 和 miscbeepApp 这 两 个 文件 拷贝 到 
rootfs/lib/modules/4.1. 15 目录 中 ， 重 启 开 发 板 , 进入 到 目录 lib/modules/4.1.15 中 ， 输 入 如 下 命令 
加 载 miscbeep.ko 这 个 驱动 模块 。 

depmod // 第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 

modprobe miscbeep.ko // 加 载 设 备 模块 

当 了 驱动 模块 加 载 成 功 以 后 我 们 可 以 在 /sys/class/misc 这 个 目录 下 看 到 一 个 名 为 “miscbeep” 
的 子 目 录 ， 如 图 57.4.2.1 所 示 : 


/lib/modules/4.1.15 s n /sy eie pe ir 
autofs - 3 
cpu- _dma_latency 

















mxc asrc watchdog 
hw. | Ages dd network - ee 
loo "d network throughput 
/li E A 1.15 $ 


图 57.4.2.1 misbeep 子 目录 
所 有 的 mise 设备 都 属于 同一 个 类 ，/sys/class/misc 目录 下 就 是 misc 这 个 类 的 所 有 设备 ， 每 
个 设备 对 应 一 个 子 目 录 。 
驱动 与 设备 匹配 成 功 以 后 就 会 生成 /devwmiscbeep 这 个 设备 驱动 文件 ， 输 入 如 下 命令 查看 这 
个 文件 的 主 次 设备 号 : 
ls /dev/miscbeep -1 
结果 如 图 57.4.2.2 所 示 : 


/lib/modules/4.1.15 # ls Ep -] 


crw-rw---- 10 10, 144 Jan 1 05:07 /dev/miscbeep 
/lib/modules/4.1.15 # J 


























图 57.4.2.2 /dev/miscbeep 设备 文件 
从 图 57.4.2.2 可 以 看 出 ，/dev/miscbeep 这 个 设备 的 主 设备 号 为 10， 次 设备 号 为 144， 和 我 
们 驱动 程序 里 面 设置 的 一 致 。 
输入 如 下 命令 打开 BEEP: 
./miscbeepApp /dev/miscbeep 1 /打开 BEEP 
在 输入 如 下 命令 关闭 LED 4T: 
/miscbeepApp /dev/miscbeep 0 /关闭 BEEP 
观察 一 下 BEEP 能 否 打开 和 关闭 ， 如 果 可 以 的 话 就 说 明 驱 动工 作 正 常 ， 如 果 要 撮 载 驱动 的 
正 输入 如 下 命令 即 可 : 


rmmod miscbeep.ko 






























































zi 
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第 五 十 八 章 Linux INPUT 子 系统 实验 

















按键 、 鼠 标 、 键 盘 、 和 触摸屏 等 都 属于 输入 (inpub 设 备 , Linux 内 核 为 此 专门 做 了 一 个 叫做 input 
子 系统 的 框架 来 处 理 输入 事件 。 输 入 设备 本 质 上 还 是 字符 设备 ,只 是 在 此 基础 上 套 上 了 input {E 
架 , 用 户 只 需要 负责 上 报 输入 事件 , 比如 按键 值 、 坐 标 等 信息 , input 核心 层 负责 处 理 这 些 事件 。 
本 章 我 们 就 来 学 习 一 下 Linux 内 核 中 的 input 子 系统 。 
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58.1 input 子 系统 


58.1.1 input 子 系统 简介 
input 就 是 输入 的 意思 ， 因 此 input 子 系统 就 是 管理 输入 的 子 系统 ， 和 pinctrl 和 gpio 子 系统 














一 样 ， 都 是 Linux 内 核 针 对 某 一 类 设备 而 创建 的 框架 。 比 如 按键 输入 、 键 盘 、 鼠 标 、 和 触摸 屏 等 
等 这 些 都 属于 输入 设备 ， 不 同 的 输入 设备 所 代表 的 含义 不 同 ， 按 键 和 键盘 就 是 代表 按键 信息 ， 
鼠标 和 触摸 屏 代表 坐标 信息 ， 因 此 在 应 用 层 的 处 理 就 不 同 ， 对 于 驱动 编写 者 而 言 不 需要 去 关心 
应 用 层 的 事情 ， 我 们 只 需要 按照 要 求 上 报 这 些 输入 事件 即 可 。 为 此 input 子 系统 分 为 input 驱动 
层 、input Ez. input 事件 处 理 层 ， 最 终 给 用 户 空间 提供 可 访问 的 设备 节点 ，input 子 系 统 框 
架 如 图 58.1.1.1 所 示 : 


硬件 输入 设备 内 核 空间 用 户 空间 

























































































按键 


USB 键 盘 / 鼠标 










图 58.1.1.1 input 子 系统 结构 图 
图 58.1.1 中 左边 就 是 最 底层 的 具体 设备 , 比如 按键 、USB 键盘 /鼠标 等 , 中 间 部 分 属于 Linux 












































内 核 空 间 ， 分 为 驱动 层 、 核 心 屋 和 时 间 层 ， 最 右边 的 就 是 用 户 空间 ， 所 有 的 输入 设备 以 文件 的 
形式 供用 户 应 用 程序 使 用 。 可 以 看 出 input 子 系统 用 到 了 我 们 前 面 讲 解 的 驱动 分 层 模型 , 我 们 编 
写 驱 动 程序 的 时 候 只 需要 关注 中 间 的 驱动 屋 、 核 心 层 和 事件 层 ， 这 三 个 层 的 分 工 如 下 : 
驱动 层 : 输入 设备 的 具体 驱动 程序 ， 比 如 按键 驱动 程序 ， 向 内 核 层 报告 输入 内 容 。 
Bit: 承上启下 ， 为 驱动 层 提供 输入 设备 注册 和 操作 接口 。 通 知事 件 层 对 输入 事件 进行 
处 理 。 
事件 层 : 主要 和 用 户 空 间 进行 交互 。 































































































58.1.2 input 驱动 编写 流程 


input 核心 层 会 向 Linux 内 核 注册 一 个 字符 设备 ， 大 家 找到 drivers/input/input.c 这 个 文件 ， 
input.c 就 是 input 输入 子 系统 的 核心 层 ， 此 文件 里 面 有 如 下 所 示 代 码 : 
示例 代码 58.1.2.1 input 核心 层 创建 字符 设备 过 程 











1 7187 Sew Class mont Class = d 
1768 .name = 

ES .devnode = input devnode, 
ITORI 


ZAA Stewe Mae _ imit iaoe aie hote) 
2415 
2416 alione (XS P 
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2417 
2418 err = class register(&input class); 


2419 IE (err) í 


2420 pr err ("unable to register inpūt dey classin"): 
2421 return err; 

2422 } 

2423 


2424 err c3 input proc init)? 
2425 sus (rT) 


2426 goto faill; 

2427 

2428 err = register chrdev region (MKDEV(INPUT MAJOR, 0), 
2429 INPUT MAX CHAR DEVICES, "input"); 
2430 if (err) ( 

2431 [Ou err( unele to es er Chac major SCHy TNEPUT WAJOR)) P 
2432 goto fail2; 

2433 } 

2434 

2435 return 0; 

2436 

2 fl Taput Proe exc P 

2 OMNIS class unregister(&input class); 

2439 return err; 

2440 ) 


第 2418 行 ， 注 册 一 个 input 类 ， 这 样 系统 启动 以 后 就 会 在 /sys/class 目录 下 有 一 个 input 子 
目录 ， 如 图 58.12.1 所 示 : 


/ # 1s sys/class/ 














ata device gpio misc regulator tty 
ata link graphics mmc host rfkill ubi 
ata port 12c-dev mtd rtc udc 
backlight jeee80 net scsi device vc 

1 power supply scsi_disk video4linux 
block cd pps scsi host vtconsole 
dma leds ptp sound watchdog 
drm mdio bus pwm spi master 
? P mem rc thermal 





图 58.1.2.1 input 类 

第 2428-2429 行 ， 注 册 一 个 字符 设备 ， 主 设备 号 为 INPUT_MAJOR，INPUT_MAJOR 定义 
在 include/uapi/linux/major.h 文件 中 ， 定 义 如 下 : 

#define INPUT MAJOR 13 

因此 ，input 子 系统 的 所 有 设备 主 设备 号 都 为 13， 我 们 在 使 用 input 子 系统 处 理 输入 设备 
的 时 候 就 不 需要 去 注册 字符 设备 了 了 ， 我 们 只 需要 向 系统 注册 一 个 input device 即 可 。 

1、 注 册 input_dev 
在 使 用 input 子 系 统 的 时 候 我 们 只 需要 注册 一 个 input 设备 即 可 ,input_dev 结构 体 表示 input 
设备 ， 此 结构 体 定义 在 include/linux/input.h 文件 中 ， 定 义 如 下 (有 省 略 ): 


1350 























LMX6U RAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
示例 代码 58.1.2.2 input. dev 结构 体 


iZi gtruce input cev i 















































JE const char *name; 

123 const Chaw tole P 

124 eemsE elect Unie 

125 Struct impur iel iel; 

126 

127 unsigned long propbit[BITS TO LONGS(INPUT PROP CNT)]; 

Jd S 

129 unsigned long evbit[BITS TO LONGS(EV CNT)]; /* 事件 类 型 的 位 图 */ 
130 unsigned long keybit[BITS TO LONGS(KEY CNT)]; /* 按键 值 的 位 图 eu 
sl unsigned long relbit[BITS TO LONGS(REL CNT)]; /* 相对 坐标 的 位 图 */ 
132 unsigned long absbit[BITS TO LONGS(ABS CNT)]; /* 绝对 坐标 的 位 图 */ 
133 unsigned long mscbit[BITS TO LONGS(MSC CNT)]; /* 杂项 事件 的 位 图 */ 
134 unsigned long ledbit[BITS TO LONGS(LED CNT)]; /*LED 相关 的 位 图 */ 
135 unsigned long sndbit[BITS TO LONGS(SND CNT)];/* sound 有 关 的 位 图 */ 
136 unsigned long ffbit[BITS TO LONGS(FF CNT)];  /* 压力 反馈 的 位 图 */ 
11357 unsigned long swbit[BITS TO LONGS(SW CNT)];  /* 开 关 状 态 的 位 图 */ 
189 bool devres managed; 

JUS qp 


第 129 fT, evbit 表示 输入 事件 类 型 ， 可 选 的 事件 类 型 定义 在 include/uapi/linux/input.h 文件 
中 ， 事 件 类 型 如 下 : 





示例 代码 58.1.2.3 事件 类 型 

















#define EV SYN 0x00 ”/* 同步 事件 up 
&define EV KEY oxoi /* 按键 事件 sni 
&define EV REL 0x02 /* 相对 坐标 事件 ey 
#define EV ABS 0x03 — /* 绝对 坐标 事件 xf 
&define EV MSC 0x04 — /* 杂项 (其 他 ) 事件 */ 
#define EV SW 0x05 s IREF */ 
$define EV LED 0x11 /DD wy 
#define EV SND 0x12 /* sound (声音 ) */ 
&define EV REP Ox14 — /* 重复 事件 uri 
Kdefine EV FF pour M EE ES: xf 
&define EV PWR 0x16 /* 电源 事件 BW 
#define EV FF STATUS 0x17 ”/* 压力 状态 事件 x 





比如 本 章 我 们 要 使 用 到 按键 ， 那 么 就 需要 注册 EV_KEY 事件 ， 如 果 要 使 用 连 按 功能 的 话 
还 需要 注册 EV_REP 事件 。 

继续 回 到 示例 代码 58.1.2.2 中 ， 第 129 行 ~137 行 的 evbit、keybit、relbit 等 等 都 是 存放 不 同 
事件 对 应 的 值 。 比 如 我 们 本 章 要 使 用 按键 事件 ， 因 此 要 用 到 keybit，keybit 就 是 按键 事件 使 用 的 
位 图 ，Linux 内 核定 义 了 很 多 按键 值 ， 这 些 按键 值 定义 在 include/uapi/linux/input.h 文件 中 ,按键 
值 如 下 : 












































示例 代码 58.1.2.4 按键 值 
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215 #define KEY RESERVED 0 
216 poetine KEY ESC il 
217 veetine KEY 1 2 
21/8 petine KEX 2 3 
219 #define KEY 3 4 
220 $define KEY 4 5 
221 seexime KEY 5 6 
222 #define KEY 6 7 
225 gueiime KEY 7 8 
224 $define KEY 8 9 
225 qeexime KEY 9 10 
22/5 petine KEX 0 al 
794 #define BTN TRIGGER HAPPY39 0x2e6 





795 $define BIN TRIGGER HAPPYA40 0x2e7 

我 们 可 以 将 开发 板 上 的 按键 值 设置 为 示例 代码 58.1.2.4 中 的 任意 要 一 个 ， 比 如 我 们 本 章 实 
验 会 将 LMX6U-ALPHA 开发 板 上 的 KEY 按键 值 设 置 为 KEY 0。 
在 编写 input 设备 驱动 的 时 候 我 们 需要 先 申 请 一 个 input dev 结构 体 变 量 ， 使 用 
input allocate device 函数 来 申请 一 个 input_dev， 此 函数 原型 如 下 所 示 : 
struct input dev *input allocate device(void) 

函数 参数 和 返回 值 含义 如 下 : 

参数 : 无 。 

返回 值 ， 申请 到 的 input dev. 

如 果 要 注销 的 input 设备 的 话 需要 使 用 input free device 函数 来 释放 掉 前 面 申 请 到 的 
input dev, input free device 函数 原型 如 下 ; 

void input free device(struct input dev *dev) 

函数 参数 和 返回 值 含义 如 下 : 

dev: 需要 释放 的 input_dev。 

返回 值 : 无 。 

申请 好 一 个 input dev 以 后 就 需要 初始 化 这 个 input dev， 需 要 初始 化 的 内 容 主 要 为 事件 类 
型 (evbit) 和 事件 值 (keybit) 这 两 种 。input_dev 初始 化 完成 以 后 就 需要 向 Linux 内 核 注 册 input. dev 
了 ， 需 要 用 到 input_register_device 函数 ， 此 函数 原型 如 下 : 

int input register device(struct input dev *dev) 

函数 参数 和 返回 值 含义 如 下 : 

dev: 要 注册 的 input_dev . 

返回 值 ，0，input_dev 注册 成 功 ; 负 值 ，input_dev 注册 失败 。 

同样 的 ， 注 销 input 驱动 的 时 候 也 需要 使 用 input unregister device 函数 来 注销 掉 前 面 注册 
HJ input dev, input unregister device 函数 原型 如 下 : 

void input unregister device(struct input dev *dev) 

函数 参数 和 返回 值 含义 如 下 : 

dev: 要 注销 的 input dev 。 

返回 值 : 无 。 

£k EPI, input dev 注册 过 程 如 下 : 
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©, EH input allocate device 函数 申请 一 个 input dev. 

包 、 初 始 化 input_derv 的 事件 类 型 以 及 事件 值 。 

©, fH input unregister device 函数 站 Linux 系统 注册 前 面 初始 化 好 的 input_dev。 

©, EER input 驱动 的 时 候 需 要 先 使 用 input_unregister_device 函数 注销 掉 注 册 的 input dev; 
然后 使 用 input. free device 函数 释放 掉 前 面 申请 的 input. dev。input dev 注册 过 程 示例 代码 如 下 
所 示 : 























示例 代码 58.1.2.5 input_dev 注册 流程 
struct input dev *inputdev; /* input 结构 体 变量 */ 


il 
2 
3 /* NE E */ 

4 rakie ime ioie sexes abaubu (wea 
5 

6 

T 

8 





























































































































{ 

inputdev = input allocate device(); /* 申请 input dev uA 

inputdev-»name = "test inputdev"; /* 设置 input dev ZF */ 
9) 
10 Jk koceexioex e cq GT SEC CES PEAELER] Jg d OR SR ko oe ox / 
11 . set bit(EV KEY, inputdev-»evbit); /* 设置 产生 按键 事件 ef 
12 . Set bit(EV REP, inputdev-»evbit); /* 重复 事件 m 
13 . Set bit(KEY 0, inputdev-»keybit); /x* 设 置 产生 哪些 按键 值 my 
JA J| KCKCKCKCKCKCkCk KCkCk kk kCKCkCkCKCkCk KOC k kk kCkCk Ck kckckckokck ckckck ck ck ck kk e kk f 
15 
16 xxxxxxxxx 第 二 种 设置 事件 和 事件 值 的 方法 xxxxxxxxxxx/ 
13) keyinputdev.inputdev-»evbit[0] 2 BIT MASK(EV KEY) | 

BIT MASK(EV REP); 
18 keyinputdev.inputdev-»-keybit[BIT WORD(KEY 0)] |= 
BIT MASK(KEY 0); 
19 /kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkx/ 
20 
21 xxxxxxxxx 第 三 种 设置 事件 和 事件 值 的 方法 xxxxxxxxxxx/ 
22 keyinputdev.inputdev-»evbit[0] 2 BIT MASK(EV KEY) | 
BIT MASK(EV REP); 

29 input set capability(keyinputdev.inputdev, EV KEY, KEY 0); 
24 [CRI Ck kk kk kc ke ke kk KK ok Rok KICK ok k KICK kool Kok koci kx / 
25 
26 /* 注册 input dev */ 
2n Taput register device non P 
28300 Y. 
29 return 0; 
EON) 
Siil 


32 /* 驱动 出 口 函数 */ 


$5 tatic vorc _ erit (eae) 
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34 ( 

35 input unregister device (inputdev); /* 注销 input dev  */ 
36 input free device (inputdev); /* WES input dev */ 
37 ) 


第 1 行 ， 定 义 一 个 input dev 结构 体 指针 变量 。 

第 4-30 行 ， 驱 动 入 口 函数 ， 在 此 函数 中 完成 input dev 的 申请 、 设 置 、 注 册 等 工作 。 第 7 
行 调用 input allocate device 函数 申请 一 个 input dev。 第 10-23 行 都 是 设置 input 设备 事件 和 按 
键 值 ， 这 里 用 了 三 种 方法 来 设置 事件 和 按键 值 。 第 27 行 调用 input. register device 函数 向 Linux 
内 核 注 册 inputdev。 

第 33-37 行 ， 驱 动 出 口 函 数 ， 第 35 行 调用 input unregister device 函数 注销 前 面 注册 的 
input dev， 第 36 行 调用 input free. device 函数 删除 前 面 申 请 的 input. dev. 

2、 上 报 输入 事件 

当 我 们 向 Linux 内 核 注册 好 input. dev 以 后 还 不 能 高 枕 无 忧 的 使 用 input 设备 ,input 设备 都 
是 具有 输入 功能 的 ， 但 是 具体 是 什么 样 的 输入 值 Linux 内 核 是 不 知道 的 ， 我 们 需要 获取 到 具体 
的 输入 值 ， 或 者 说 是 输入 事件 ， 然 后 将 输入 事件 上 报 给 Linux 内 核 。 比 如 按键 ， 我 们 需要 在 按 
键 中 断 处 理 函 数 ， 或 者 消 拌 定 时 器 中 断 函 数 中 将 按键 值 上 报 给 Linux 内 核 ， 这 样 Linux 内 核 才 
能 获取 到 正确 的 输入 值 。 不 同 的 事件 ， 其 上 报 事件 的 API 函数 不 同 ， 我 们 依次 来 看 一 下 一 些 常 
用 的 事件 上 报 API 函数 。 
首先 是 input event 函数 ， 此 函数 用 于 上 报 指 定 的 事件 以 及 对 应 的 值 ， 函 数 原型 如 下 : 























































































































































































































void input event(struct input dev *dev, 
unsigned int type, 
unsigned int code, 
int value) 


函数 参数 和 返回 值 含 义 如 下 : 

dev: 需要 上 报 的 input_dev。 

type: 上 报 的 事件 类 型 ， 比 如 EV KEY. 

code: 事件 码 ， 也 就 是 我 们 注册 的 按键 值 ， 比 如 KEY 0. KEY _1 等 等 。 

value: 事件 值 ， 比 如 1 表示 按键 按 下 ，0 表示 按键 松 开 

返回 值 : 无 。 

input_event 函数 可 以 上 报 所 有 的 事件 闫 型 和 [事件 值 ，Linux 内 核 也 提供 了 其 他 的 针对 具体 
事件 的 上 报 函 数 ， 这 些 函 数 其 实 都 用 到 了 input event 函数 。 比 如 上 报 按键 所 使 用 的 
input report key 函数 ， 此 函数 内 容 如 下 ; 

例 代 码 58.1.2.6 input report. key 函数 


statie inlines voc) input report key (struct input chew ESY7 






























































unsigned int code, int value) 











input event (Cev, EV Kax, Cole, oh value) 





从 示例 代码 58.1.2.6 可 以 看 出 ，input report key 函数 的 本 质 就 是 input event 函数 ， 如 果 
要 上 报 按键 事件 的 话 还 是 建议 大 家 使 用 input : report key 函数 。 
同样 的 还 有 一 些 其 他 的 事件 上 报 函 数 ， 这 些 函数 如 下 所 示 ; 


void input report rel(struct input dev *dev, unsigned int code, int value) 









































void input report abs(struct input dev *dev, unsigned int code, int value) 
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void input report ff status(struct input dev *dev, unsigned int code, int value) 


void input report switch(struct input dev *dev, unsigned int code, int value) 
void input mt sync(struct input dev *dev) 
当 我 们 上 报 事件 以 后 还 需要 使 用 input. sync 函数 来 告诉 Linux 内 核 input 子 系统 上 报 结束 ， 
input sync 函数 本 质 是 上 报 一 个 同步 事件 ， 此 函数 原型 如 下 所 示 : 
void input sync(struct input dev *dev) 
函数 参数 和 返回 值 含 义 如 下 : 
dev: 需要 上 报 同步 事件 的 input_dev。 
返回 值 : 无 。 
综 上 所 述 ， 按 键 的 上 报 事件 的 参考 代码 如 下 所 示 : 
示例 代码 58.1.2.7 事件 上 报 参 考 代 码 












































1 /* 用 于 按键 消 拌 的 定时 器 服务 函数 */ 

2 void timer function(unsigned long arg) 

St 

4 unsigned char value; 

E 

6 value = gpio get value (keydesc-»gpio); /* REX 104 — */ 

7 if (value == 0)( /* 按 下 按键 2 

8 /* 上 报 按键 值 */ 

9 input report key(inputdev, KEY 0, 1); /* 最 后 一 个 参数 1， 按 下 */ 
10 input_sync (inputdev) ; /* 同步 事件 */ 

iil ) else ( /* 按键 松 开 n 

12 input report key(inputdev, KEY 0, 0); /* 最 后 一 个 参数 0， 松 开 */ 
13 input sync (inputdev); /* 同步 事件 m 

14 ) 

is ) 


第 6 行 ， 获 取 按 键 值 ， 判 断 按 键 是 否 按 下 。 

第 9-10 行 ， 如 果 按 键 值 为 0 那么 表示 按键 被 按 下 了 ， 如 果 按 键 按 下 的 话 就 要 使 用 
input report key 函数 向 Linux 系统 上 报 按键 值 ， 比 如 向 Linux 系统 通知 KEY. 0 这 个 按键 按 下 
JT 

第 12-13 行 ， 如 果 按 键 值 为 1 的 话 就 表示 按键 没有 按 下 ， 是 松 开 的 。 向 Linux 系统 通知 
KEY 0 这 个 按键 没有 按 下 或 松 开 了 。 




















A 



































58.1.3 input event 结构 体 


Linux 内 核 使 用 input event 这 个 结构 体 来 表示 所 有 的 输入 事件 ， input envent 结构 体 定义 在 
include/uapi/linux/input.h 文件 中 ， 结 构 体 内 容 如 下 : 
示例 代码 58.1.3.1 input_event 结构 体 


24 SEruetE abwyowne event d 








Z5 struct timeval time; 
26 . iG type? 

AN . 3G code; 

28 EN- "ade 

29 B 
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我 们 依次 来 看 一 下 input event 结构 体 中 的 各 个 成 员 变 量 : 

time: 时 间 ， 也 就 是 此 事件 发 生 的 时 间 ， 为 timeval 结构 体 类 型 ，timeval 结构 体 定义 如 下 : 
示例 代码 58.1.3.2 timeval 结构 体 


OE HT Ca 














typedef long En t? 
typedef . kernel long t Kerm ipae 65 
typedef . kernel long t — kernel sūeeconcle ©? 
struct timeval ( 

J kernel time t tv sec; Jnd m 

. kernel suseconds t tv usec;  /* 微 秒 B 
) 








从 示例 代码 58.1.3.2 可 以 看 出 , tv. sec 和 tv_usec 这 两 个 成 员 变量 都 为 long 类 型 , 也 就 是 32 

















位 ， 这 个 一 定 要 记 住 ， 后 面 我 们 分 析 event 事件 上 报 数据 的 时 候 要 用 到 。 

















type: 事件 类 型 ， 比 如 EV_KEY， 表 示 此 次 事件 为 按键 事件 ， 此 成 员 变量 为 16 位 。 


code; 事件 码 ， 比 如 在 EV KEY 事件 中 code 就 表示 具体 的 按键 码 ， 如 : KEY 0. KEY 1 




















等 等 这 些 按键 。 此 成 员 变 量 为 16 位。 








value: 值 ， 比 如 EV_KEY 事件 中 value 就 是 按键 值 ， 表 示 按 键 有 没有 被 按 下 ， 如 果 为 1 的 








a: 








i 说 明 按键 按 下 ， 如 果 为 0 的 话说 明 按键 没有 被 按 下 或 者 按键 松 开 了 。 






































input envent 这 个 结构 体 非常 重要 ， 因 为 所 有 的 输入 设备 最 终 都 是 按照 input event 结构 体 





呈现 给 用 户 的 ,用户 应 用 程序 可 以 通过 input. event 来 获取 到 具体 的 输入 事件 或 相关 的 值 ， 比 如 


按键 值 等 。 关 于 input 子 系统 就 讲解 到 这 里 ， 接 下 来 我 们 就 以 开发 板 上 的 KEY0 按键 为 例 ， 讲 



































解 一 下 如 何 编写 input 驱动 。 
58.2 硬件 原理 图 分 析 











本 章 实验 硬件 原理 图 参考 15.2 小 节 即 可 。 





58.3 实验 程序 编写 


本 实验 对 应 的 例 程 路 径 为: 开发 板 光 盘 -> 2. Linux 驱动 例 程 -> 20_input。 

















58.3.1 修改 设备 树 文件 








直接 使 用 49.3.1 小 节 创 建 的 key 节点 即 可 。 

















58.3.2 按键 input 驱动 程序 编写 











新 建 名 为 “20_input” 的 文件 夹 ， 然 后 在 20_input 文件 夹 里 面 创建 vscode 工程 ， 工 作 


xi 
a 











名 为 “keyinput”。 工 程 创 建 好 以 后 新 建 keyinput.c 文件 ， 在 keyinput.c 里 面 输入 如 下 内 容 : 


TO 








示例 代码 58.3.2.1 keyinput.c 文件 代码 段 
finclude <linux/types.h> 
finclude «linux/kernel.h» 
finclude «linux/delay.h» 
finclude «linux/ide.h» 
finclude «linux/init.h» 
finclude <linux/module.h> 
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E include «Xlinux/errno.h» 


8  £dinclude Xlinux/gpio.h» 

9  $include Xlinux/cdev.h» 

10 4include «linux/device.h» 

11 d£include Xlinux/of.h» 

12 #include <linux/of address.h» 
13 #include «linux/of gpio.h» 
14 #include «linux/input.h» 

15 d£include «Xlinux/semaphore.h» 
16 d4$include Xlinux/timer.h» 

17 4$include «linux/of irg.h» 

18 4$include Xlinux/irq.h» 

19 d£include «asm/mach/map.h» 





20 4$include «asm/uaccess.h» 


21 d4include «Xasm/io.h» 


22 J[ECKCKCKCKCKCKCkCKC Kk Ck kk CkCk kk kk CkCk Kk KC kCk Ck k Ck ck k k ck k k Ck k k Ck k k ck k k kck k ck ck k ck ck kkk kkk kk kk 








23 on © TN Coop hech di.99/9—2(020). ALL setae: sexes 























24 文件 名 : keyinput.c 

25 frd : Zl 

26 版 本 SESTO 

27 描述 : Linux 按键 input 子 系统 实验 

28 其 他 e JE 

29 TAZ : www.openedv.com 

30 B : 初版 V1.0 2019/8/21 左 忠 凯 创建 

31 KOKCKCKCKCKCKCkCk kCkCk kCk k Ck kCkCk kCk ck k kc k k kk Ck k Ck Ck kCkCk k kk k kc k Ck kc k Ck kck ck kck ck ckck ck ckck ck kck ce ke kk f 
32 #define KEYINPUT CNT 1 /* WE STE */ 

33 4define KEYINPUT NAME "keyinput" /* ZF */ 

34 #define KEYOVALUE 0x01 /* KEYO 按键 值 */ 

35 #define INVAKEY OXFF /* 无 效 的 按键 值 */ 

36 define KEY NUM 1 /* 按键 数量 x 

S 

38 /* 中 断 IO 描述 结构 体 */ 

39) erruet irg kevcese i 

40 int gpio; /** jeu A 
41 int irqnum; /* 中 断 号 A 
42 unsigned char value; /* 按键 对 应 的 键 值 “A 
43 char name[10]; /* 名 字 [y 
44 ue eee ne (hancer) (iat, vorc. 9 p /* 中 断 服务 函数 */ 
25 WW 

46 

47 /* keyinput 设备 结构 体 */ 

48 struct keyinput Cevi 

49 dev t devid; /* 设备 号 A 
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50 struct gey colewm /* cdev w 

Sil reme Melia irens /* 3& n 

57 struct device *device;  /* 设备 */ 

5s struct device node *nd; /* X4 A m 

54 struct timer list timer; TO NE — */ 

55 struct irg keydesc irqkeydesc[KEY NUM]; /* 按键 描述 数组 */ 
56 unsigned char curkeynum; /* 当前 的 按键 号 */ 
57 struct input dev *inputdev; /* input 结构 体 */ 
SIS E 

59 

60 struct keyinput dev keyinputdev; /* key input 设备 */ 

61 

62 /* Qdescription : 中 断 服 务 函 数 ， 开 启 定 时 器 ， 延 时 10ms, 

63  * 定时 器 用 于 按键 消 抖 。 

64  * (Qparam - irq 中 断 号 

65  * @param - dev id : 设备 结构 。 

66  * Qreturn : 中 断 执 行 结 果 





GI *f 
GS statie irgreturm © kayO hencler(ime rep VOLC le 1c) 
GONE 











70 strut keyinput dey *elew = (struct keyinput deyv ele ide 
qal 

72 dev->curkeynum = 0; 

FS) dev-»-timer.data - (volatile long)dev id; 

74 moc timer (ccey->timer, Jifiies «7 mesecs Tto Jiititiss (0) 
7/8 return IRQ RETVAL(IRQ HANDLED); 

MH. c 

git 

78 /* 8description  : 定时 器 服务 函数 ， 用 于 按键 消 拌 ， 定 时 器 到 了 以 后 

79 * 再 次 读 取 按键 值 ， 如 果 按 键 还 是 处 于 按 下 状态 就 表示 按键 有 效 。 
80 * @param - arg  : 设备 结构 变量 

81  * Qreturn 8 AB 

e o up 

83 void timer function(unsigned long arg) 

84 f 

85 unsigned char value; 

86 unsigned char num; 

87 struct irg keydesce “keydese, 

88 struct keyinput Cev vdey = (struct keyinput dev warg; 

89 

90 num = dev-»curkeynum; 

9i keydesc = &dev-»irqgkeydesc[num]; 

92 value = gpio get value (keydesc-»gpio); /* iXHX ro fü */ 
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93 if (value == 0)( /* 按 下 按键 */ 
94 /* 上 报 按键 值 */ 
95 //input event(dev-»inputdev, EV KEY, keydesc-»value, 1); 
96 input report key(dev-»inputdev, keydesc-»value, 1);/*1, dXT*/ 
97 input sync (dev-»inputdev); 
98 ) eise ( /* 按键 松 开 */ 
99 //input event(dev-»inputdev, EV KEY, keydesc->value, 0); 
100 input report key(dev-»inputdev, keydesc-»value, 0); 
101 input_sync (dev->inputdev) ; 
102 ) 
103 N 
104 
OS s 
106 * Qdescription  : 按键 IO 初始 化 
107 param s JE 
108 * Qreturn 8 JE 
i9) t 
110 static int keyio init (void) 
Jide 
3L unsigned char i - 0; 
3E) char name[10]; 
114 int ret = 07 
1/1888 
116 keyinputdev.nd = of find node by path("/key"); 
33b) if (keyinputdev.nd-z- NULL)( 
118 printk("key node not find!Nr Win"); 
TALS) return -EINVAL; 
T20 } 
IEZ 
122 /* 提取 GPIO */ 
123 for (i = 0; i < KEY NUM; i++) { 
124 keyinputdev.irqkeydesc[i].gpio = 
of get named gpio(keyinputdev.nd,"key-gpio", i); 
125 if (keyinputdev.irqkeydesc[i].gpio < 0) { 
126 站 
4127 } 
128 ) 
129 
130 /* 初始 化 key 所 使 用 的 To， 并 且 设 置 成 中 断 模 式 */ 
isnt for (i = 0; i < KEY NUM; i++) ( 
1,512) memset(keyinputdev.irqkeydesc[i].name, 0, sizeof(name)); 
133 sprintf(keyinputdev.irgkeydesc[i].name, "KEY%d", i); 
134 gpio request(keyinputdev.irqkeydesc[i].gpio, name); 
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i35 gpio direction input (keyinputdev.irqkeydesc[i].gpio); 
1559/6 keyinputdev.irqgkeydesc[i].irgnum = 
irq of parse and map(keyinputdev.nd, i); 
1,517] } 
138 /* 申请 中 断 */ 
139 keyinputdev.irqkeydesc[0].handler - keyO handler; 
140 keyinputdev.irgkeydesc[0].value - KEY 0; 
141 
142 for (i = 0; i < KEY NUM; i++) ( 
143 ret © request irq(keyinputdev.irqkeydesc[i].irqnum, 
keyinputdev.irgkeydesc[i].handler, 
144 IRQF TRIGGER FALLING|IROF TRIGGER RISING, 
keyinputdev.irqkeydesc[i].name, &keyinputdev); 

145 if(ret < O)( 
146 printk("irq $d request failed!NrMn", 

keyinputdev.irgkeydesc[i].irgnum); 
147 return -EFAULT; 
148 } 
149 } 
150 
pon /* 创建 定时 器 */ 
152 init timer(&keyinputdev.timer); 
153 keyinputdev.timer.function => timer function; 
154 
155 /* HH input dev */ 
156 keyinputdev.inputdev - input allocate device(); 
157 keyinputdev.inputdev-»name = KEYINPUT NAME; 
158 dif O 
159 /* 初始 化 inPut_dev， 设 置 产生 哪些 事件 */ 
160 . Set bit(EV KEY, keyinputdev.inputdev-»evbit); /* 按 键 事件 */ 
161 . Set bit(EV REP, keyinputdev.inputdev-»evbit); /* 重复 事件 */ 
162 
163 /* 初始 化 input_dev， 设 置 产生 哪些 按键 */ 
164 . set bit(KEY 0, keyinputdev.inputdev-»keybit); 
165 #endif 
166 
167 dif O 
168 keyinputdev.inputdev-»evbit[0] = BIT MASK(EV KEY) | 

BIT MASK(EV REP); 
169 keyinputdev.inputdev-»keybit[BIT WORD(KEY 0)] |= 
BIT MASK(KEY 0); 

170 #endif 
YA 


1360 


LMX6U SA X Linux 驱动 开发 指南 O ERAF 














原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 

172 keyinputdev.inputdev-»evbit[0] = BIT MASK(EV KEY) | 
BIT MASK(EV REP); 

173 input set capability(keyinputdev.inputdev, EV KEY, KEY 0); 

174 

175 /* 注册 输入 设备 */ 

176 ret — input register device (keyinputdev.inputdev); 

177 if (ret) { 

178 printk ("register input device failed!\r\n"); 

179 return ret; 

180 } 

181 return 0; 

2529 

183 

Jj fes 

185 * QGdescription : 驱动 入 口 函数 

186 * Qparam S 

187 * @return 8 Jb 

iO. ay 

185) starie imt _ imit keyimour imit (voc) 

1:88) d] 

eSa keyi init() 

T92 return 0; 

DS i 

194 

OS yw 

196 * @description  : 驱动 出 口 函 数 

197 * Gparam s JE 

198 * Qreturn 8 2B 

199 3 

200 gtetie voici _ exit keyimpurt exit (rorci) 

aol 7 

207 unsigned i - 0; 

203 /* 删除 定时 器 */ 

204 del timer sync(&keyinputdev.timer); 

205 

206 /* 释放 中 断 */ 

207 for (i = 0; i < KEY NUM; i++) ( 

208 free irq(keyinputdev.irqkeydesc[i].irgnum, &keyinputdev); 

209 } 

210 /* 释放 input dev */ 

211 input unregister device (keyinputdev.inputdev); 

212 input free device (keyinputdev.inputdev) ; 

2s] p 
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214 


215 module init (keyinput imit)? 
216 module exit(keyinput exit); 
217 MODULE LICENSE ("GPL"); 
218 MODULE AUTHOR ("zuozhongkai"); 
keyinput.c 文件 内 容 其 实 就 是 实验 “13_irq” 中 的 imxeuirq.e 文件 中 修改 而 来 的 ， 只 是 将 其 
中 与 字符 设备 有 关 的 内 容 进行 了 删除 , 加 入 了 input dev 相关 的 内 容 , 我 们 简单 来 分 析 一 下 示例 
代码 58.3.2.1 中 的 程序 。 
第 57 行 ， 在 设备 结构 体 中 定义 一 个 input_dev 指针 变量 。 
第 93-102 行 ， 在 按键 消 拌 定 时 器 处 理 函 数 中 上 报 输入 事件 ， 也 就 是 使 用 input report key 
函数 上 报 按键 事件 以 及 按键 值 , 最 后 使 用 input. sync 函数 上 报 一 个 同步 事件 , 这 一 步 一 定 得 做 ! 
第 156-180 行 ， 使 用 input allocate device 函数 申请 input_dev， 然 后 设置 相应 的 事件 以 及 
事件 码 ( 也 就 是 KEY 模拟 成 那个 按键 , 这 里 我 们 设置 为 KEY_0)。 最 后 使 用 input register device 
函数 向 Linux 内 核 注册 input dev. 
第 211-212 行 ， 当 注销 input 设备 驱动 的 时 候 使 用 input unregister device 函数 注销 挥 前 面 
注册 的 input dev， 最 后 使 用 input free device 函数 释放 掉 前 面 申 请 的 input. dev. 




























































































58.3.3. 编写 测试 APP 


新 建 keyinputApp.c 文件 ， 然 后 在 里 面 输入 如 下 所 示 内 容 : 
示例 代码 58.3.3.1 keyinputApp.c 文件 代码 段 



































jL me lude te 

2 ae le misses 

3 #include "sys/types.h" 

4 dinclude "sys/stat.h" 

S me lude So el 

6 4include "fcntl.nh" 

yc ci Miles eU 

8 4include "string.h" 

9 include Xpoll.h» 

10 finclude Xsys/select.h» 

11 £include «sys/time.h» 

12 $include X€signal.h» 

13 £include «fcntl.h» 

14 £include «linux/input.h» 

15 X KCKCk kk oko K KK kk kdo K KC Kk kk ok A KK Kok ko K KCKCK KOC ok KC KCKCKCKO oko K KOKCK KORR X 
16 Copyright O0 ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
17 文件 名 : keyinputApp.c 

18 fed : AE 

19 版 本 SEU 

20 描述 : input 子 系统 测试 APP。 

21 Rh 3 2E 

22 使 用 方法 : ./keyinputApp /dev/input/eventi 
23 iex : www.openedv.com 
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24 
25 
26 
2 
28 
29 
30 
31 
32 
33 
34 
25 
36 
97, 
38 
E 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
Sil 
52 
SIS 
54 
55 
56 
S7. 
58 
59 
60 
61 


62 
63 


64 


feris : 初版 V1.0 2019/8/26 左 忠 凯 创建 


KCKCKCKCKCKCkCkCk ck k kk k k Ck Ck kCk Ck kc kc k k kc k k kk Ck k Ck Ck kCk k k kc k k kk k kc k ck kck ck kck ck ckck ck ckckck kk kk / 


/* 定义 一 个 input event 变量 ， 存 放 输 入 事件 信息 */ 


statie struct input eyent inpttevent, 


/ * 
* Qdescription : main 主 程序 
* Qparam = argc  : argv 数组 元 素 个 数 
* Qparam - argv  : 有 具体 参数 
* Qreturn : 0 成 功 ;其 他 失败 
*/ 
ime mannin aroe e ehan Aaro) 
{ 
iae ele 
int err = 0; 


char *filename; 
filename = argv[!]:; 


if(argc !- 2) ( 





printf("Error Usage! rn"); 


return -i|; 


fd 2 open(filename, O RDWR); 
if (fd « 0) ( 
printf("Can't open file %s\r\n", filename); 


return -i|; 


while (!) ( 
err = read(fd, &inputevent, sizeof(inputevent)); 
if (err > 0) ( /* 读 取 数 据 成 功 */ 
switch (inputevent.type) ( 











case EV KEY: 
if (inputevent.code < BTN MISC) ( /* 键盘 键 值 */ 


printf("key $d Ss\r\n", inputevent.code, 








inputevent.value ? "press" : "release"); 
) else { 
[eee (neon So nn ne 


inputevent.value ? "press" : "release"); 
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65 break; 

66 

67 /* 其 他 类 型 的 事件 ， 自 行 处 理 */ 
68 case EV REL: 

69 break; 

70 case EV ABS: 

ql break; 

72 case EV MSC: 

73 break; 

74 case EV SW: 

p break; 

76 ) 

aa ) else ( 

78 printf(" 读 取 数 据 失 败 \r\n")， 

T9 } 

80 } 

81 return 0; 

ee 





第 58.1.3 小 节 已 经 说 过 了 ，Linux 内 核 会 使 用 input event 结构 体 来 表示 输入 事件 ， 所 以 我 
们 要 获取 按键 输入 信息 , 那么 必须 借助 于 input. event 结构 体 。 第 28 行 定义 了 一 个 inputevent 变 
量 ， 此 变量 为 input event 结构 体 类 型 。 

第 56 行 ， 当 我 们 向 Linux 内 核 成 功 注 册 input dev 设备 以 后 ， 会 在 /dewinput 目录 下 生成 一 
个 名 为 “eventX(X=0....n)” 的 文件 ， 这 个 /dev/input/eventX 就 是 对 应 的 input 设备 文件 。 我 们 读 
取 这 个 文件 就 可 以 获取 到 输入 事件 信息 , 比如 按键 值 什么 的 。 使 用 read 函数 读 取 输入 设备 文件 ， 
也 就 是 /dev/input/eventX, 读 取 到 的 数据 按照 input event 结构 体 组 织 起 来 。 获取 到 输入 事件 以 后 
(input_event 结构 体 类 型 ) 使 用 switch case 语句 来 判断 事件 类 型 ， 本 章 实验 我 们 设置 的 事件 类 型 
为 EV_KEY， 因 此 只 需要 处 理 EV_KEY 事件 即 可 。 比 如 获取 按键 编号 (KEY_0 的 编号 为 11)、 
获取 按键 状态 ， 按 下 还 是 松 开 的 ? 


































































































58.4 运行 测试 
58.4.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 

编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 “keyinputo” Makefile 内 容 如 下 所 示 : 
示例 代码 58.4.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 






































il imz 415159 25,150 ee alientelk 
4 obj-m := keyinput.o 
11 clean: 
12 S$(MAKE) -C S(KERNELDIR) M=$ (CURRENT PATH) clean 
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第 4 行 ， 设 置 obj-m 变量 的 值 为 “keyinput.0”。 





输入 如 下 命令 
make -j32 
编译 成 功 以 后 就 会 生成 一 个 名 为 “keyinputko” 的 驱动 模块 文件 。 
2、 编 译 测 试 APP 

输入 如 下 命令 编译 测试 keyinputApp.c 这 个 测试 程序 : 
arm-linux-gnueabihf-gcc keyinputApp.c -o EAR 

编译 成 功 以 后 就 会 生成 keyinputApp 这 个 应 用 程序 。 


编译 出 驱动 模块 文件 : 








一 /人 一、 


58.4.2 运行 测试 


将 上 一 小 节 编 译 出 来 keyinput.ko 和 keyinputApp 这 两 个 文件 找 贝 到 rootfs/lib/modules/4.1.15 



































目录 中 ， 重 启 开 发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 。 在 加 载 keyinput.ko 驱动 模块 之 前 ， 先 
看 一 下 /dewinput 目录 下 都 有 哪些 文件 ， 结 果 如 图 58.4.2.1 所 示 : 

/ # ls /dev/input/ -1 

total 0 

crw-rw---- 10 0 13, 64 Jan 1 00:00 eventO 

A 10 0 13, 63 Jan 1 00:00 mice 


图 58.4.2.1 当前 /dewinput 目录 文件 
从 图 58.4.2.1 可 以 看 出 ， 当 前 /dewinput 目录 只 有 event0 和 mice 这 
如 下 命令 加 载 keyinput.ko 这 个 驱动 模块 。 
depmod /第 一 次 加 载 驱动 的 时 候 需要 运 
modprobe keyinput.ko /加 载 驱动 模块 
当 驱 动 模块 加 载 成 功 以 后 再 来 看 一 下 /dewinput 目录 下 有 哪些 文件 ,结果 如 图 58.4.2.2 所 示 : 


EMG nns 1.15 # 1s /dev/input/ -1 
total 0 





这 两 个 文件 。 接 下 来 输入 





行 此 命令 








cw -=== 
i | 
l'Ww--7-- 


0 


13, 64 Jan 1 00:00 eventO 
13, 65 Jan 1 00:41 eventi 
13, 63 Jan 1 00:00 mice 


71ib/modules/4. 1.15 # g 


图 58.4.2.2. 加 载 驱 动 以 后 的 /dev/input 目录 
从 图 58.4.2.2 可 以 看 出 ， 多 了 一 个 eventl 文件 ， 因 此 /dev/input/eventl 就 是 我 们 注册 的 驱动 
所 对 应 的 设备 文件 。 PE 就 是 通过 读 取 /dev/input/eventl 这 个 文件 来 获取 输入 事件 信息 
的 ， 输 入 如 下 测试 命令 : 
.keyinputApp /dev/input/event1 
然后 按 下 开发 板 上 的 KEY 按键 ， 结 果 如 图 58.42.3 所 示 : 
ais E 1.15 # ./keyinputApp /dev/input/eventl 
key 11 press 
key 11 release 
key 11 press 
key 11 release 


key 11 press 
key 11 release 





























图 58.4.2.3. 测试 结果 
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从 图 58.4.2.3 可 以 看 出 ， 当 我 们 按 下 或 者 释放 开发 板 上 的 按键 以 后 都 会 在 终端 上 输出 
的 内 容 ， 提 示 我 们 哪个 按键 按 下 或 释放 了 ， 在 Linux 内 核 中 KEY 0 为 11。 
另外 ， 我 们 也 可 以 不 用 keyinputApp 来 测试 驱动 ， 可 以 直接 使 用 hexdump 命令 来 查看 
/dev/input/eventl 文件 内 容 ， 输 入 如 下 命令 : 
hexdump /dev/input/event1 


然后 按 下 按键 ， 终 端 输出 如 图 58.4.2.4 所 示 信 息 : 
































A 1.15 # jm RC ci Are 
0000000 0c41 0000 d7cd 000 b 0001 0000 
0000010 0541 0000 d7cd 000c 0000 0000 0000 0000 
0000020 0c42 0000 54bb 0000 0001 000b 0000 0000 
0000030 0c42 0000 54bb 0000 0000 0000 0000 0000 
0000040 0c42 0000 8909 0003 0001 000b 0001 0000 
0000050 0c42 0000 8909 0003 0000 0000 0000 0000 
0000060 0c42 0000 84ec 0005 0001 000b 0000 0000 
0000070 0c42 0000 84ec 0005 0000 0000 0000 0000 
0000080 0c42 0000 7c6c 0009 0001 000b 0001 0000 
0000090 0c42 0000 7c6c 0009 0000 0000 0000 0000 
00000a0 0c42 0000 0309 000b 0001 000b 0000 0000 
00000b0 0c42 0000 0309 000b 0000 0000 0000 0000 





图 58.4.2.4 原始 数据 值 








相应 


图 58.4.2.4 就 是 input_event 类 型 的 原始 事件 数据 值 ， 采 用 十 六 进 制 表示 ， 这 些 原 始 数据 的 








含义 如 下 : 
示例 代码 58.4.2.1 input_event 类 型 的 原始 事件 值 

f koooeeeeeieeee*input event 2ÉS7fl» xoxo koc ek ek ek ek ee 
/* 编号 */ /* tv sec */ /* tv usec */ /* type */  /* code */ /* value */ 
0000000 0c41 0000 d7cd 000c 0001 000b 0001 0000 
0000010 0c41 0000 d7cd 000c 0000 0000 0000 0000 
0000020 0c42 0000 54bb 0000 0001 000b 0000 0000 
0000030 0c42 0000 54bb 0000 0000 0000 0000 0000 





type 为 事件 类 型 ， 查 看 示例 代码 58.1.2.3 nA, EV. KEY 事件 值 为 1，EV_SYN 事件 值 为 











0。 因 此 第 1 行 表示 EV. KEY 事件 ， 第 2 行 表示 EV. SYN 事件 。code 为 事件 编码 ， 也 就 是 按键 














号 ， 查 看 示例 代码 58.1.2.4 可 以 ，KEY 0 这 个 按键 编号 为 11， 对 应 的 十 六 进 





1 行 表 示 KEY_0 这 个 按键 事件 , 最 后 的 value 就 是 按键 值 , 为 1 表示 按 下 , 为 0 的 话 表示 松 开 。 


综 上 所 述 ， 示 例 代 码 58.4.2.1 中 的 原始 事件 值 含义 如 下 : 
第 1 行 ， 按 键 (KEY_0) 按 下 事件 。 


4g 




















IPA 0xb, 因 








此 第 





第 2 行 , EV_SYN 同步 事件 ,因为 每 次 上 报 按键 事件 以 后 都 要 同步 的 上 报 一 个 EV_SYN 事 











第 3 行 ， 按 键 KEY 0) 松 开 事 件 。 
第 4 行 ，EV_SYN 同步 事件 ， 和 第 2 行 一 样 。 


58.5 Linux 自 带 按键 驱动 程序 的 使 用 


58.5.1. 自 带 按键 驱动 程序 源码 简 析 
Linux 内 核 也 自 带 了 KEY 驱动 ， 如 果 要 使 用 内 核 自 带 的 KEY 驱动 的 话 需 
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FR, ^i Linux 内 核 一 般 默 认 已 经 
找到 相应 的 配置 选项 : 


-> Device Drivers 


LAK 


I B6 








-> [nput device support 
-> Generic input layer (needed for keyboard, mouse, ...) (INPUT [=y]) 
-> Keyboards (INPUT KEYBOARD [-y]) 
->GPIO Buttons 
选中 “GPIO Buttons” 选 项 ， 将 其 编译 进 Linux 内 核 中 ， 如 图 58.5.1.1 所 示 : 


zuozhongkai@ubuntu: -/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 


Keyboards 

Arrow keys navigate the menu. «Enter» selects submenus 
Highlighted letters are hotkeys. 
Press «Esc»«Esc» to exit, «?» for Help, «/» for Search. 
«M» module < > module capable 

1(-) 

<*> 

< > 

< > 


---> (or empty submenus -). 
Pressing <Y> includes, <N> excludes, <M> modularizes features. 
Legend: [*] built-in [ ] excluded 


AT keyboard 
Atmel AT42QT1070 Touch Sensor Chip 
Atmel AT42QT2160 Touch Sensor Chip 
P ed GPIO butt 
A6408A Keypad Support 


选中 此 选项 


O q 
TCA6416/TC 
TCA8418 Keypad Support 


< EX 二 < Save > < Load > 


< Help > 





图 58.5.1.1 内 核 自 带 KEY 驱动 使 能 选项 


选中 以 后 就 会 在 .config 文人 








FHEIL “CONFIG KEYBOARD _GPIO=y” 这 一 行 ，Linux 内 核 





就 会 根据 这 一 行 来 将 KEY 驱动 文人 


编译 进 Linux 内 核 。Linux 内 核 自 带 的 KEY 驱动 文件 为 








drivers/input/keyboard/gpio_keys.c, gpio_keys.c 采用 了 platform 驱动 框架 ， 在 KEY 驱动 上 使 用 
了 input 子 系统 实现 。 在 gpio keys.c 文件 中 找到 如 下 所 示 内 容 : 


示例 代码 58.5.1.1 gpio_keys 文件 代码 段 








$175 static const ue id golo keys Ot metem = i 
674 ( .compatible = "gpio-keys", J, 

675 (e 

GNO JH 

842 static struct platform driver gpio keys device driver - ( 





843 .probe = gpio keys probe, 

844 . remove = gpio keys remove, 

845 .driver = { 

846 -name = "gpio-keys", 

847 .pm = &gpio keys pm ops, 

848 .of match table - of match ptr(gpio keys of match), 
849 ) 

eux. Jig 

So 

$952 tetic ime _ imit goio keys mit (vasto) 
Ss 
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854 return platform driver register(&gpio keys device driver); 
SH 
856 
S5 oratie woe! eui goio keys exu (vonc) 
858 ( 
GSE) platform driver unregister(&gpio keys device driver); 
860 } 
从 示例 代码 58.5.1.1 可 以 看 出 ， 这 就 是 一 个 标准 的 platform 驱动 框架 ， 如 果 要 使 用 设备 树 
来 描述 KEY 设备 信息 的 话 ， 设 备 节点 的 compatible 属性 值 要 设置 为 “gpio-keys”。 当 设备 和 了 驱 
动 匹配 以 后 gpio keys probe 函数 就 会 执行 ，gpio_keys_probe 函数 内 容 如 下 (为 了 篇 幅 有 缩减 ): 
示例 代码 58.5.1.2 gpio_keys_probe 函数 代码 段 
689 static int gpio keys probe(struct platform device *pdev) 
690 ( 










































































G9 struct device *dev = &pdev-»dev; 

692 Const Sexe. Gol keys jolencixoxw Cere odere = 
dev get platdata (dev); 

693 struct gpio keys drvdata *ddata; 

694 struct 3e e Une dey “1neuty 

695 Sine MESA 

696 aig 3L5 (Xue 

6:97, int wakeup = 0; 

698 

699 if (!pdata) ( 

700 pdata — gpio keys get devtree pdata (dev); 

701 if (IS ERR(pdata)) 

702 return PTR ERR(pdata); 

703 ) 

T13 input = devm input allocate device (dev); 

714 sue (Yaumi) d 

TUS devkerri(dev a oeoa eae EEEN) M 

EG return -ENOMEM; 

TAT } 

THS 

TAO, ddata->pdata = pdata; 

720 ddata->input = input; 

TE mutex init(&ddata-»disable lock); 

TAZ 

TAS platform set drvdata(pdev, ddata); 

724 input set drvdata(input, ddata); 

72/8. 

726 input-»2name = pdata-»name ? : pdev-»name; 


72'1 input-»phys "gpio-keys/input0"; 
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728 input->dev.parent = &pdev-»dev; 

729 input->open = gpio keys open; 

730 input-»close = gpio keys close; 

UST 

732 input-»id.bustype = BUS HOST; 

733 input-»id.vendor = 0x0001; 

734 input-»id.product = 0x0001; 

735 input->id.version = 0x0100; 

736 

JS /* Enable auto repeat feature of Linux input subsystem */ 
738 if (pdata-»rep) 

739 . set bit(EV REP, input-»evbit); 

740 

741 for ìi = 0; i < pdata->nbuttons, i++) { 

742 const struct gpio keys button *button = &pdata-»buttons[i]; 
qus struct gpio button data *bdata = &ddata-»data[i]l; 

744 

745 error = gpio keys setup key(pdev, input, bdata, button); 
746 if (error) 

747 return error; 

748 

749 if (button->wakeup) 

750 wakeup = 1|; 

FAS } 

760 error = input register device (input); 

yei if (error) ( 

EAS. dev err(dev, "Unable to register input device, error: ebat, 
763 error); 

2/163 goto err remove group; 

TES } 

774 } 


第 700 行 ， 调 用 gpio keys get devtree pdata 函数 从 设备 树 中 获取 到 KEY 相关 的 设备 节点 
信息 。 

第 713 行 ， 使 用 devm input allocate device 函数 申请 input dev. 

第 726~735， 初 始 化 input dev. 

第 739 行 ， 设 置 input_dev 事件 ， 这 里 设置 了 EV_REP 事件 。 

第 745 行 ， 调 用 gpio keys setup key 函数 继续 设置 KEY， 此 函数 会 设置 input_dev 的 
EV KEY 事件 已 经 事件 码 (也 就 是 KEY 模拟 为 哪个 按键 )。 

第 760 行 ， 调 用 input register device 函数 向 Linux 系统 注册 input dev. 

我 们 接 下 来 再 来 看 一 下 gpio keys setup key 函数 ， 此 函数 内 容 如 下 : 

示例 代码 58.5.1.3 gpio_keys_setup_key 函数 代码 段 
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437 Statie imt golo keys setup keylotruct plattorm device el 














438 struct input dev impu 

239 struct gpio button data *bdata, 

440 Const Struct golo keys button een 

441 { 

442 Const (meus vdese = barcon- Cese Y bourctcon1=0e86 3 "epulo kaysi? 
443 struct device *dev = &pdev->dev; 

444 ieg hencler 1E i855 

445 unsigned long irgflags; 

446 Tle Leepa 

447 TAE (STONE 

448 

449 bdata-»input - input; 

450 bdata-»button = button; 

451 spin lock init(&bdata-»lock); 

452 

453 if (gpio is valid(button-»gpio)) d 

454 

455 error = devn gpio request one(&pdev-»dev, button-»gpio, 
456 GIPIOE IN. eese)? 

457 IE (Errori «s (00) Wi 

458 dev err(dev, “Failed to reguest GPIO sd, error San 
459 button-»gpio, error); 

460 return error; 

488 ier © gpio keys gpio isr; 

489 irqflags = IROP TRIGGER RISING | TROP TRIGGER FALLING; 
490 

491 ) else ( 

492 E(u on > el 

493 eel ce (elc MEIN CMS (ONES Ciel GI mM) M 

494 return -EINVAL; 

495 ) 

496 bdata-»irq = button-»irg; 

506 

507 ig = gpio keys iro larp 

508 irqflags = 0; 

ES ) 

sl0 

511 input set capability(input, button-»type ?: EV KEY, 


button-»code); 
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540 return 0; 
5319) 




















第 511 fT, UH] input set capability 函数 设置 EV_KEY 事件 以 及 KEY 的 按键 类 型 ， 也 就 
是 KEY 作为 哪个 按键 ? 我 们 会 在 设备 树 里 面 设 置 指定 的 KEY 作为 哪个 按键 。 
一 切 都 准备 就 绪 以 后 剩 下 的 就 是 等 待 按键 按 下 ， 然 后 向 Linux 内 核 上 报 事件 ， 事 件 上 报 是 
在 gpio keys irq isr 函数 中 完成 的 ， 此 函数 内 容 如 下 ; 
示例 代码 58.5.1.4 gbio_keys_itq_ist 函数 代码 段 
JOA ptrarcie irgreturm e goio keys irg istint irGp vorc wder tel) 
DE 










































































394 struct gpio button data *bdata > dev id; 

395 const struct gpio keys button *button = bdata-»button; 
396 struct input dev *input = bdata-»input; 

S9 unsigned long flags; 

398 

399 BUG ON(irq !-2 bdata-»irqg); 

400 

401 spin lock irqsave(&bdata-»lock, flags); 

402 

403 ul pressed) i 

404 if (bdata->button->wakeup) 

405 pm wakeup event(bdata-»input-»dev.parent, 0); 
406 

407 input event(input, EV KEY, button-»code, 1); 
408 input sync (input); 

409 

410 if ('!bdata-c»releasecdelTay) i 

411 input event (input, EY Kav, button->c0de, (0) f 
412 input Syne (input); 

413 goto out; 

414 } 

415 

416 bdata-»key pressed = true; 

417 } 

418 

419 if (bdata-»release delay) 

420 mod timer(&bdata-»release timer, 

421 Jitiies > mecs to Jilliies(edste--weleese deley) )) e 
n MENS 

423 spin unlock irqrestore(&bdata-»lock, flags); 

424 return IRQ HANDLED; 

425 ) 








gpio keys irq isr 是 按键 中 断 处 理 函数 ， 第 407 fT IH Linux 系统 上 报 EV KEY 事件 ， 表 示 
按键 按 下 。 第 408 行使 用 input sync KA RAER EV_REP 同步 事件 。 
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综 上 所 述 ，Linux 内 核 自 带 的 gpio_keys.c 驱动 文件 思路 和 我 们 前 面 编写 的 keyinput.c 驱动 
文件 基本 一 致 。 都 是 申请 和 初始 化 input dev， 设 置 事件 ， 向 Linux 内 核 注 册 input dev。 最 终 在 
按键 中 断 服 务 函数 或 者 消 拌 定时 器 中 断 服务 函数 中 上 报 事件 和 按键 值 。 


























58.52. 自 带 按键 驱动 程序 的 使 用 


要 使 用 Linx 内 核 自 带 的 按键 驱动 程序 很 简单 ， 只 需要 根据 
Documentation/devicetree/bindings/input/gpio-keys.txt 这 个 文件 在 设备 树 中 添加 指定 的 设备 节点 
即 可 ， 节 点 要 求 如 下 : 

QD、 节 点 名 字 为 “gpio-keys”。 

®©, gpio-keys 节点 的 compatible 属性 值 一 定 要 设置 为 “gpio-keys”。 

©, MAHI KEY 都 是 gpio-keys 的 子 节点 ， 每 个 子 节点 可 以 用 如 下 属性 描述 自己 : 

gpios: KEY 所 连接 的 GPIO 信息 。 

interrupts: KEY 所 使 用 GPIO 中 断 信 息 ， 不 是 必须 的 ， 可 以 不 写 。 

label: KEY 名 字 

linuxcode: KEY 要 模拟 的 按键 ， 也 就 是 示例 代码 58.1.2.4 中 的 这 些 按键 。 

(、 如 果 按 键 要 支持 连 按 的 话 要 加 入 autorepeat。 

打开 imx6ull-alientek-emmec.dts， 根 据 上 面 的 要 求 创建 对 应 的 设备 节点 ， 设 备 节 点 内 容 如 下 














































































































示例 代码 58.5.2.1 gpio-keys 节点 内 容 




















1 gpio-keys ( 

2 compatible = "gpio-keys"; 

3 #address-cells = <1>; 

4 #size-cells = <0>; 

5 autorepeat; 

6 keyO ( 

y label = "GPIO Key Enter"; 
8 linux,code - «KEY ENTER»; 
9 gpios = «&gpiol le GPIO ACTIVE LOW»; 
10 } 

Li pg 





第 5 1T, autorepeat 表示 按键 支持 连 按 。 

第 6~10 fT, ALPHA 开发 板 KEY 按键 信息 ， 名 字 设 置 为 “GPIO Key Enter”， 这 里 我 们 将 
开发 板 上 的 KEY 按键 设置 为 “EKY _ ENTER” 这 个 按键 ， 也 就 是 回 车 键 ， 效 果 和 键盘 上 的 回 车 
键 一 样 。 后 面 学 习 LCD 驱动 的 时 候 需 要 用 到 此 按键 ， 因 为 Linux 内 核 设 计 的 10 分 钟 以 后 LCD 
关闭 ， 也 就 是 黑屏 ， 就 跟 我 们 用 电脑 或 者 手机 一 样 ， 一 定时 间 以 后 关闭 屏幕 。 这 里 将 开发 板 上 
的 KEY 按键 注册 为 回 车 键 ， 当 LCD 黑屏 以 后 直接 按 一 下 KEY 按键 即 可 唤醒 屏幕 ， 就 跟 当 电 
脑 熄 屏 以 后 按 下 回 车 键 即 可 重新 打开 屏幕 一 样 。 

最 后 设置 KEY 所 使 用 的 IO 为 GPIO1 IO18， 一 定 要 检查 一 下 设备 树 看 看 此 GPIO 有 没有 
被 用 到 其 他 外 设 上 ， 如 果 有 的 话 要 删除 掉 相关 代码 ! 
重新 编译 设备 树 ， 然 后 用 新 编译 出 来 的 imx6ull-alientek-emmc.dtb 启动 Linux 系统 ， 系 统 启 
动 以 后 查看 /dev/input 目录 ， 看 看 都 有 哪些 文件 ， 结 果 如 图 58.5.2.1 所 示 : 
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/ # 1s /dev/input/ -1 

total 0 

crw-rw---- 1:0 0 13, 64 Jan 1 00:00 eventO 
crw-rw---- 10 0 13, 65 Jan 1 00:00 eventi 
Ccrw-rw---- i9 0 13. 63 Jan 1 00:00 mice 





图 58.5.2.1 /dev/input 目录 文件 

从 图 58.5.2.1 可 以 看 出 存在 eventl 这 个 文件 ， 这 个 文件 就 是 KEY 对 应 的 设备 文件 ， 使 用 
hexdump 命令 来 查看 /dev/input/eventl 文件 ， 输 入 如 下 命令 : 

hexdump /dev/input/event1 

然后 按 下 ALPHA 开发 板 上 的 按键 ， 终 端 输 出 图 58.5.2.2 所 示 内 容 : 


/ # hexdump d rear 
0000000 03/1 0000 a452 0002 0001 001c 0001 0000 
0000010 0371 O000 a452 0002 0000 0000 0000 0000 
0000020 0371 0000 8a8f 0005 0001 001c 0000 0000 
0000030 0371 0000 8a8f 0005 0000 0000 0000 0000 
0000040 0371 0000 4528 000a 0001 001c 0001 0000 
0000050 0371 0000 4528 000a 0000 0000 0000 0000 
0000060 0371 0000 6844 000c 0001 001c 0000 0000 
0000070 0371 0000 6844 000c 0000 0000 0000 0000 
图 58.5.2.2 按键 信息 
如 果 按 下 KEY 按键 以 后 会 在 终端 上 输出 图 58.5.2.2 所 示 的 信息 de 就 表示 Linux 内 核 的 按 
键 驱动 工作 正常 。 至 于 图 58.5.22 中 内 容 的 含义 大 家 就 自行 分 析 ， 这 个 已 经 在 58.4.2 小 节 详 细 
的 分 析 过 了 ， 这 里 就 不 再 讲解 了 。 
大 家 如 果 发 现 按 下 KEY 按键 以 后 没有 反应 ， 那 么 请 检查 一 下 三 方面 : 
Q)、 是 否 使 能 Linux 内 核 KEY 驱动 。 
Q. RAPP gpio-keys 节点 是 否 创建 成 功 。 
@、 在 设备 树 中 是 否 有 其 他 外 设 也 使 用 了 KEY 按键 对 应 的 GPIO， 但 是 我 们 并 没有 删除 掉 
这 些 外 设 信息 。 检 查 Linux 启动 log 信息 ， 看 看 是 否 有 类 似 下 面 这 条 信息 
gpio-keys gpio keys: Failed to request GPIO 18, error -16 
述 信 息 表示 GPIO 18 申请 失败 ， 失 败 的 原因 就 是 有 其 他 的 外 设 正在 使 用 此 GPIO. 
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第 五 十 九 章 Linux LCD 驱动 实验 


LCD 是 很 常用 的 一 个 外 设 ， 在 裸 机 篇 中 我 们 讲解 了 如 何 编写 LCD 裸 机 驱动 ， 在 Linux 下 
LCD 的 使 用 更 加 广泛 ， 在 搭配 QT 这 样 的 GUI 库 下 可 以 制作 出 非常 精美 的 UI 界面 。 本 章 我 们 
就 来 学 习 一 下 如 何在 Linux 下 驱动 LCD 屏幕 。 
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59.1 Linux F LCD 驱动 简 析 


59.1.1 Framebuffer 设备 


先 来 回顾 一 下 裸 机 的 时 候 LCD 驱动 是 怎么 编写 的 ， 裸 机 LCD 驱动 编写 流程 如 下 : 

Q@、 初 始 化 LMX6U 的 eLCDIF 控制 器 ， 重 点 是 LCD 屏幕 宽 (width)、 高 (height)、hspw、 
hbp. hfp. vspw. vbp 和 vfp 等 信息 。 

@、 初 始 化 LCD 像素 时 钟 。 

图 、 设 置 RGBLCD 显存 。 

人 由、 应 用 程序 直接 通过 操作 显存 来 操作 LCD， 实 现在 LCD 上 显示 字符 、 图 片 等 信息 。 
在 Linux 中 应 用 程序 最 终 也 是 通过 操作 RGB LCD 的 显存 来 实现 在 LCD 上 显示 字符 、 图 片 
等 信息 。 在 裸 机 中 我 们 可 以 随意 的 分 配 显存 ， 但 是 在 Linux 系统 中 内 存 的 管理 很 严格 ， 显 存 是 
不 需要 申请 的 ， 不 是 你 想 用 就 能 用 的 。 而 且 因 为 虚拟 内 存 的 存在 ， 驱 动 程序 设置 的 显存 和 应 用 
程序 访问 的 显存 要 是 同一 片 物理 内 存 。 

为 了 解决 上 述 问题 ，Framebuffer WE^E f, Framebuffer 翻译 过 来 就 是 帧 缓冲 ， 简 称 fb. D 
此 大 家 在 以 后 的 Linux 学 习 中 见 到 “Framebuffer” 或 者 “fp” 的 话 第 一 反应 应 该 想到 RGBLCD 
或 者 显示 设备 。fb 是 一 种 机 制 ， 将 系统 中 所 有 跟 显示 有 关 的 硬件 以 及 软件 集合 起 来 ， 虚 拟 出 
个 fo 设备 ， 当 我 们 编写 好 LCD 驱动 以 后 会 生成 一 个 名 为 /dev/fbX(X=0~n) 的 设备 ， 应 用 程序 通 
过 访问 /dewfbX 这 个 设备 就 可 以 访问 LCD .NXP 官方 的 Linux 内 核 默认 已 经 开启 了 LCD 驱动 ， 
因此 我 们 是 可 以 看 到 /dev/fb0 这 样 一 个 设备 ， 如 图 59.1.1.1 所 示 : 
/#1s /dev/fb* -1 

10 


crw-rw---- 
/ # 
































































































































































































































0 29, 0 Jan 1 00:00 /dev/fbO 


图 59.1.1.1 /dev/fb0 设备 文件 
图 59.1.1.1 中 的 /dew/fb0 就 是 LCD 对 应 的 设备 文件 ，/dev/fb0 是 个 字符 设备 ， 因 此 肯定 有 
file operations 操作 集 ，fb 的 file operations 操作 集 定 义 在 drivers/video/fbdev/core/fbmem.c 文件 
中 ， 如 下 所 示 : 

















示例 代码 59.1.1.1 fb 设备 的 操作 集 


J29)5 gueule Const strut Lle Gpsrations ilo tops = l 





1496 .owner — THIS MODULE, 

1497 .read = fb read, 

1498 .write = fb write, 

1499 sunblock = io 106tl, 

1500 #ifdef CONFIG COMPAT 

sO COSS i oe = to compar octl, 
1502 #endif 

1503 . mmap = fb _ mmap, 

1504 . open = fb open, 

d 55 macies cM = mo release, 




















1506 #ifdef HAVE ARCH FB UNMAPPED AREA 

3) 7 .get unmapped area —- get fb unmapped area, 
1508 fendif 

1509 #ifdef CONFIG FB DEFERRED IO 

















TSO ode => io dererrec! i0 nC 
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1511 #endif 

TESTA .llseek = default llseek, 

i5 S) EE 








T 





关于 fo 的 详细 处 理 过 程 就 不 去 深究 了 ， 本 章 我 们 的 重点 是 驱动 起 来 ALPHA 开发 板 上 的 
LCD. 























59.1.2 LCD 驱动 简 析 


LCD 裸 机 例 程 主要 分 两 部 分 : 

(D. 3kH LCD 的 屏幕 参数 。 

@、 根 据 屏幕 参数 信息 来 初始 化 eaLCDIF 接口 控制 器 。 

不 同 分 辩 率 的 LCD 屏幕 其 eaLCDIF 控制 器 驱动 代码 都 是 一 样 的 ， 只 需要 修改 好 对 应 的 屏 
幕 参 数 即 可 。 屏 幕 参数 信息 属于 屏幕 设备 信息 内 容 ， 这 些 肯定 是 要 放 到 设备 树 中 的 ， 因 此 我 们 
本 章 实验 的 主要 工作 就 是 修改 设备 树 ，NXP 官方 的 设备 树 已 经 添加 了 LCD 设备 节点 ， 只 是 此 
节点 的 LCD 屏幕 信息 是 针对 NXP 官方 EVK 开发 板 所 使 用 的 4.3 寸 480*272 编写 的 ， 我 们 需 
要 将 其 改 为 我 们 所 使 用 的 屏幕 参数 。 

我 们 简单 看 一 下 NXP 官方 编写 的 Linux 下 的 LCD 驱动 ， 打 开 imx6ull.dtsi， 然 后 找到 lcdif 
节点 内 容 ， 如 下 所 示 : 

示例 代码 59.1.2.1 imx6ull.dtsi 文件 中 lcdif 节点 内 容 
leonee Looee02Lea000 












































jl 

2 (CouSecalslLer 2 summon ect Musee 2e er 
3 reg = «0x021c8000 0x4000»; 

4 interrupts = «GIC SPI 5 IRQ TYPE LEVEL HIGH»; 

5 clocks = «&clks IMX6UL CLK LCDIF PIX», 
6 

7) 

8 

9 

il 























<&clks IMX6UL CLK LCDIF APB>， 
<&clks IMX6UL CLK DUMMY»; 











elock-nemes c "uox", VUeoxu", Vols esip 





Status = "disabled"; 
0 y 
示例 代码 59.1.2.1 中 的 ledif 节点 信息 是 所 有 使 用 LMX6ULL 蔚 片 的 板子 所 共有 的 ， 并 不 是 
完整 的 lcdif 节点 信息 。 像 屏幕 参数 这 些 需要 根据 不 同 的 硬件 平台 去 添加 , 比如 imx6ull-alientek- 
emmc.dts 文件 中 会 想 lcdif 节点 添加 其 他 的 属性 信息 。 从 示例 代码 59.1.2.1 可 以 看 出 lcdif 节点 
的 compatible 属性 值 为 “fsl,imx6ul-lcdif” 和 “fsl,imx28-lcdi”， 因此 在 Linux 源码 中 搜索 这 两 个 
字符 串 即 可 找到 IMX6ULL 的 LCD 驱动 文件 ， 这 个 文件 为 drivers/video/fbdev/mxsfb.c, mxsfb.c 
就 是 IMX6ULL 的 LCD 驱动 文件 ， 在 此 文件 中 找到 如 下 内 容 : 
示例 代码 59.1.2.2 platform 下 的 LCD 驱动 
1.9/$22 tae Const struct ot device id rss = i 



























































36S T Compatible Mte ste imos cll rer Mec S mkato elevato d ORT ym 
1364 { .compatible = "fsl,imx28-1cdif", .data = &mxsfb devtype[!], }, 
T365 { /* sentinel */ } 

35, De 

1625 tatie Sheen Pletiorn driver meto Criver = q 

1626 .probe = mxsfb probe, 
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2 .remove = mxsfb remove, 

1628 .shutdown = mxsfb shutdown, 

i629 .id table = mxsfb devtype, 

1630 .driver = ( 

ISS .name = DRIVER_NAME, 

1632 .of match table = mxsfb dt ids, 
21 5:59] .pm = &mxsfb pm ops, 

1634 o 

TESS Ei? 

1636 


1637 module platform driver(mxsfb driver); 

从 示例 代码 59.1.2.2 可 以 看 出 ， 这 是 一 个 标准 的 platform. 驱动 ， 当 驱动 和 设备 匹配 以 后 
mxsfb probe 函数 就 会 执行 。 在 看 mxsfb probe 函数 之 前 我 们 先 简单 了 解 一 下 Linux F 
Framebuffer 驱动 的 编写 流程 ，Linux 内 核 将 所 有 的 Framebuffer 抽象 为 一 个 叫做 fb info 的 结构 
体 ，fb_info 结构 体 包含 了 Framebuffer 设备 的 完整 属性 和 操作 集合 ， 因 此 每 一 个 Framebuffer 设 
备 都 必须 有 一 个 fb info。 换 言 之 就 是 ，LCD 的 驱动 就 是 构建 tbp_info， 并 且 向 系统 注册 fb info 
的 过 程 。fb_info 结构 体 定义 在 include/linux/fb.h 文件 里 面 ， 内 容 如 下 (省 略 掉 条 件 编译 ): 

示例 代码 59.1.2.3 fb. info 结构 体 
























































neeruet io Laro 














449 atomie © Clo 

450 int node; 

451 sang lagas 

452 struct mutex lock; /* 互 斥 锁 ar 
255 struct mutex mm lock; /* 互 斥 锁 ， 用 于 fb mmap 和 smem * 域 */ 
454 struct fb var screeninfo var;  /* 当前 可 变 参 数 5. 
455 struct fb fix screeninfo fix;  /* 当前 固定 参数 a 
456 struct fb monspecs monspecs; /* 当前 显示 器 特性 m 
ASi struct work struct queue; /* 帧 缓冲 事件 队列 
458 struct fb pixmap pixmap; /* 图 像 硬件 映射 wi 
459 struct fb pixmap sprite; /* 光标 硬件 映射 Et 
460 struct fb cmap cmap; /* 当前 调 色 板 i 
461 struct list head modelist; /* 当前 模式 列表 5 
462 struct fb videomode *mode; /* 当前 视频 模式 sy 
463 

464 #ifdef CONFIG FB BACKLIGHT /* WIE LCD STBFBOGHU */ 
465 /* assigned backlight device */ 

466 /* set before framebuffer registration, 

467 remove after unregister */ 

468 struct backlight device *bl dev; * 背光 设备 
469 

470 /* Backlight level curve */ 

< 如 struct nme bil cüurye mutes? 

472 u8 bl curve[FB BACKLIGHT LEVELS]; 
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473 #endif 

479 struct fb ops *fbops; /* 帧 缓冲 操作 函数 集 */ 

480 struct device *device; /* 父 设备 A 

481 struct device *dev; /* 当前 fb 设备 S 

482 iat elass flag? /* 私有 sysfs m */ 

486 char _ iomem *screen base; /* 虚拟 内 存 基 地 址 (屏幕 显存 ) 
487 unsigned long screen size; /* 虚拟 内 存 大 小 (屏幕 显存 大 小 ) Rn 
488 void *pseudo palette; /* 伪 16 位 调 色 板 m 
SOn AB 





fb info 结构 体 的 成 员 变 量 很 多 ， 我 们 重点 关注 var. fix. fbops. screen base. screen size 
和 pseudo palette. mxsfb probe 函数 的 主要 工作 内 容 为 : 

CD. Hii fb info. 

@、 初 始 化 tb info 结构 体 中 的 各 个 成 员 变 量 。 

©, HRE eLCDIF 控制 器 。 

(4), ft F] register framebuffer 函数 向 Linux 内 核 注 册 初 始 化 好 的 fo. info.register framebuffer 
函数 原型 如 下 : 

int register framebuffer(struct fb info *fb info) 

函数 参数 和 返回 值 含义 如 下 : 

fb info: 需要 上 报 的 fb_info。 

返回 值 ，0， 成 功 ， 负 值 ， 失 败 。 

接 下 来 我 们 简单 看 一 下 mxsfb_probe 函数 ， 函 数 内 容 如 下 (有 缩减 ): 

示例 代码 59.1.2.4 mxsfb_probe 函数 

1369 static int mxsfb probe(struct platform device *pdev) 














1L S90) 

18 T1 Const ue ot devica id vot ic = 

WITZ of match device(mxsfb dt ids, &pdev-»dev); 
L373 StCPUCE TESO "eS 


1374 struct mxsfb_info *host; 

ISWED SEEUCE to inio wio iato; 

WSE grruet piner tpe s 

SELT int irg = platiormm get sep (geelew, O)? 
STE ibit, Golo Jeep 


1395 res — platform get resource(pdev, IORESOURCE MEM, 0); 
T396 if (!res) { 














ESO dev err(&pdev-»dev, "Cannot get memory IO resource Wn"); 
1398 return -ENODEV; 
1499/9 } 
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1400 
1401 host = devm kzalloc(&pdev-»2dev, sizeof(struct mxsfb info), 


GFP KERNEL); 
1402 if (!host) ( 

















1403 Glew err ((Cyerelew-easlewzo eres to allocate ou wp 
1404 return -ENOMEM; 

1405 } 

1406 


1407 fb info = framebuffer_alloc (sizeof (struct fb info), &pdev-»dev); 
1408 sus (Uio imito) q 














1409 eevee(e o> cev eoa eE) 
1410 devm kfree(&pdev-»dev, host); 

1411 return -ENOMEM; 

1412 } 


1413 host->fb_info = fb info; 
1414 fb_info->par = host; 

















1415 

1416 ret = devm request irq(&pdev->dev, irq, mxsfb irq handler, 0, 
1417 dev name(&pdev-»dev), host); 

1418 if (ret) ( 

1419 devkerri(spdevs > E (ee) aE 
1420 erron ranna oe ESE); 

1421 ret = -ENODEV; 

1422 goto fb release; 

1423 } 

1424 

1425 host->base = devm ioremap resource(&pdev-»dev, res); 





1426 if (IS ERR(host-»base)) d 




















1427 cicli (fe devolver eM GN )N 

1428 ret © PIR ERR(host-»base); 

1079, goto fb release; 

1430 } 

1461 

1462 fb_info->pseudo_palette = devm_kzalloc (&pdev->dev, sizeof (u32) * 
1463 16, GFP_KERNEL) ; 
1464 sus (Uia imio-psrevdo palette) d 

1465 ret = -ENOMEM; 

1466 goto fb release; 

1467 } 

1468 

1469 . INIT LIST HEAD(&fb info-»modelist); 

1470 
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1471 pm runtime enable(&host-»pdev-»dev); 
1472 

1473 ret = mxsfb init fbinfo (host); 








1474 if (ret !- 0) 

1475 goto fb pm runtime disable; 

1476 

1477 mxsfb dispdrv init(pdev, fb info); 

1478 

1479 if (!host-»dispdrv) ( 

1480 pinctrl 5 devm pinctrl get select default > 
1481 da (LS MRAR (pimetrilh) qd 

1482 ret © PIR ERR(PiNCEEL) P 

1483 goto fb pm runtime disable; 

1484 } 

1485 } 

1486 

1487 if (!host-»enabled) { 

1488 writel(0, host-»base r LEDC CTRL); 
1489 mxsfb set par(fb info); 

1490 mxsfb enable controller(fb info); 

1491 pm runtime get sync(&host-»pdev-»dev); 
1492 } 

1493 


1494 ret = register framebuffer(fb info); 
195 if (ret = 0) { 


1496 devkerri(sodevs 2 dey EEO E E e aE OEE N) p 
WAST goto fb destroy; 

1498 ) 

185215 return ret; 

526} 


第 1374 ÍT, host 结构 体 指 针 变 量 ， 表 示 LMX6ULL 的 LCD 的 主 控 接口 ，mxsfb_info 结构 





体 是 NXP 定义 的 针对 LMX 系列 SOC 的 Framebuffer 设备 结构 体 。 也 就 是 我 们 前 











用 一 直 说 的 设 






































c 


空 制 器 寄存 器 基地 址 、fb info 等 。 


第 1395 行 ， 从 设备 树 中 获取 eLCDIF 接口 控制 器 的 寄存 器 首 地 址 ， 设 备 树 中 lcdif 节点 已 








经 设置 了 eLCDIF 寄存 器 首 地 址 为 0X021C8000， 因 此 res=0X021C8000。 
第 1401 行 ， 给 host 申请 内 存 ，host 为 mxsfb info 类 型 结构 体 指针 。 
第 1407 fT, 25 fb info 申请 内 存 ， 也 就 是 申请 fb_info。 

















备 结构 体 ， 此 结构 体 包 含 了 I.MX 系列 SOC 的 Framebuffer 设备 详细 信息 ， 比 如 时 钟 、eLCDIF 








第 1413-1414 ÍT, WE host 的 fb. info 成 员 变 量 为 fp_info， 设 置 fp_info 的 par 成 员 变 量 为 





host。 通 过 这 一 步 就 将 前 面 申 请 的 host 和 fb. info 联系 在 了 一 起 。 
第 1416 行 ， 申 请 中 断 ， 中 断 服务 函数 为 mxsfb_irq_handler。 
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第 1425 行 ， 对 从 设备 树 中 获取 到 的 寄存 器 首 地 址 Ges) 进 行内 存 映射 ， 得 到 虚拟 地 址 ， 并 保 
存 到 host 的 base 成 员 变 量 。 因 此 通过 访问 host 的 base 成 员 即 可 访问 IMX6ULL 的 整个 eLCDIF 
寄存 器 。 其 实在 mxsfb.c 中 已 经 定义 了 eLCDIF 各 个 寄存 器 相 比 于 基地 址 的 偏 移 值 ， 如 下 所 示 : 
示例 代码 59.1.2.4 eLCDIF 各 个 寄存 器 偏 移 值 



































67 $define LEDC CTRL 0x00 
68 $define LCDC CTRL1 0x10 
69 $define LEDE V4 CTRL2 0x20 
70 #define LCDC V3 TRANSFER COUNT 0x20 
71 #define LCDC V4 TRANSFER COUNT 0x30 
89 $define LCDC V4 DEBUGO 0x1d0 
90 4$define LCDC V3 DEBUGO 0x1f0 


大 家 可 以 对 比 着 《LMX6ULL 参考 手册 》 中 的 eLCDIF 章节 检 查 一 下 示例 代码 59.1.24 中 
的 这 些 寄 存 器 有 没有 错误 。 

继续 回 到 示例 代码 59.1.2.5 中 的 mxsfb_probe 函数 ,第 1462 íT, £3 fb. info FP IT] pseudo. palette 
申请 内 存 。 

第 1473 íT, 调用 mxsfb init fbinfo 函数 初始 化 fb. info, 重点 是 fb info 的 var、fix、fbops， 
screen base 和 screen size。 其 中 fbops 是 Framebuffer 设备 的 操作 集 ，NXP 提供 的 fbops 为 
mxsfb ops, AAU F: 





























示例 代码 59.1.2.5 mxsfb. ops 操作 集合 
DST statie Eve io ops mero opg = q 





988 .owner — THIS MODULE, 

989 .fb check var = mxsfb check var, 
990 silo set par = mesto Set Par, 

DIS Succ ec resilire ise c 
992 oio LOCEL c3 mesio TOCEL; 

99s .fb blank = mxsfb blank, 

994 .fb pan display = mxsfb pan display, 
995 .fb mmap = mxsfb mmap, 

996 oio Flee S Gib rLililrecty 

Som .fb copyarea = cfb copyarea, 

998 .fb imageblit = cfb imageblit, 
999; Tg 























关于 mxsfb ops 里 面 的 各 个 操作 函数 这 里 就 不 去 详解 的 介绍 了 。mxsfb_init_ fbinfo 函数 通过 
调用 mxsfb init fbinfo dt 函数 从 设备 树 中 获取 到 LCD. 的 各 个 参数 信息 。 最 后 , mxsfb_init fbinfo 
函数 会 调用 mxsfb_map_videomem 函数 申请 LCD 的 帧 缓冲 内 存 (也 就 是 显存 )。 

第 1489-1490 ÍF, V ELeLCDIF 控制 器 的 相应 寄存 器 。 

第 1494 行 ， 最 后 调用 register framebuffer 函数 向 Linux 内 核 注册 fb. info. 

mxsfb.c 文件 很 大 ， 还 有 一 些 其 他 的 重要 函数 ， 比 如 mxsfb remove. mxsfb shutdown 等 ， 
这 里 我 们 就 简单 的 介绍 了 一 下 mxsfb probe 函数 ， 至 于 其 他 的 函数 大 家 自行 查阅 。 


59.2 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 24.2 小 节 即 可 。 
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59.3 LCD 驱动 程序 编写 











前 面 已 经 说 了 ，6ULL 的 eLCDIF 接口 驱动 程序 NXP 已经 编写 好 了 ， 因 此 LCD 驱动 部 分 








我 们 不 需要 去 修改 。 我 们 需要 做 的 就 是 按照 所 使 用 的 LCD 来 修改 设备 树 。 重 点 要 注意 三 个 地 


JH: 





(QD. LCD 所 使 用 的 IO 配置 。 

(QD. LCD 屏幕 节点 修改 ， 修 改 相 应 的 属性 值 ， 换 成 我 们 所 使 用 的 LCD 屏幕 参数 。 

Q. LCD 背光 节点 信息 修改 ， 要 根据 实际 所 使 用 的 背光 IO 来 修改 相应 的 设备 节点 信息 。 
接 下 来 我 们 依次 来 看 一 下 上 面 这 两 个 节点 改 如 何 去 修 改 : 

1、LCD 屏幕 IO 配置 
首先 要 检查 一 下 设备 树 中 LCD 所 使 用 的 IO 配置 ， 这 个 其 实 NXP 都 已 经 给 我 们 写 好 了 ， 


















































不 需要 修改 ， 不 过 我 们 还 是 要 看 一 下 。 打 开 imx6ull-alientek-emmc.dts 文件 ， 在 iomuxc 节点 中 
找到 如 下 内 容 : 


il 
2 
3 
4 
5 
6 
3) 
8 


9 

10 
11 
32 
TS 
14 
15 
IS 
ly 
18 
1.8 
20 
zu 
22 
23 
24 
25 
26 
AN 
28 
29 





示例 代码 59.3.1 设备 树 LCD IO 配置 
pneri Lee cles eee 
fsl,pins =< 


























































































































MX6UL PAD LCD DATAO0  LCDIF DATAO0 0x79 
MX6UL PAD LCD DATAO1  LCDIF DATAOl1 0x79 
MX6UL PAD LCD DATA02  LCDIF DATAO2 0x79 
MX6UL PAD LCD DATA03  LCDIF DATAO3 0x79 
MX6UL PAD LCD DATA04  LCDIF DATAO4 0x79 
MX6UL PAD LCD DATA05  LCDIF DATAO5 0x79 
MX6UL PAD LCD DATA06  LCDIF DATAO6 0x79 
MX6UL PAD LCD DATA07  LCDIF DATAO7 0x79 
MX6UL PAD LCD DATAO8  LCDIF DATAO8 0x79 
MX6UL PAD LCD DATA09  LCDIF DATAO9 0x79 
MX6UL PAD LCD DATA10  LCDIF DATA10 0x79 
MX6UL PAD LCD DATA11  LCDIF DATA11 0x79 
MX6UL PAD LCD DATA12  LCDIF DATA12 0x79 
MX6UL PAD LCD DATA13  LCDIF DATA13 0x79 
MX6UL PAD LCD DATA14  LCDIF DATA14 0x79 
MX6UL PAD LCD DATA15  LCDIF DATA15 0x79 
MX6UL PAD LCD DATA16  LCDIF DATA16 0x79 
MX6UL PAD LCD DATA17  LCDIF DATA17 0x79 
MX6UL PAD LCD DATA18  LCDIF DATA18 0x79 
MX6UL PAD LCD DATA19  LCDIF DATA19 0x79 
MX6UL PAD LCD DATA20 LCDIF DATA20 0x79 
MX6UL PAD LCD DATA21  LCDIF DATA21 0x79 
MX6UL PAD LCD DATA22  LCDIF DATA22 0x79 
MX6UL PAD LCD DATA23  LCDIF DATA23 0x79 
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30 pinetri ledir quels lieghuteuwilenmwo 4 

Sal fsl,pins = « 

32 MX6UL PAD LCD CLK  LCDIF CLK 0x79 

33 MX6UL PAD LCD ENABLE  LCDIF ENABLE 0x79 

34 MX6UL PAD LCD HSYNC LCDIF HSYNC 0x79 

35 MX6UL PAD LCD VSYNC LCDIF VSYNC 0x79 

36 2 

21 qgugmenil. qxwls qwwclguso ii 

3 fsl,pins = < 

39 MX6UL PAD GPIO1 IO08 PWM1 OUT 0x110b0 
40 D 

aiL De 


第 2-27 行 ， 子 节点 pinctrl lcdif dat, J3 RGB LCD 的 24 根 数据 线 配置 项 。 

第 30-36 行 ， 子 节点 pinctrl ledif ctrl, RGB LCD 的 4 根 控制 线 配置 项 ， 包 括 CLK, 
ENABLE、VSYNC fil HSYNC. 

第 37-40 行 ， 子 节点 pinctl pwml, LCD 背光 PWM 引 脚 配置 项 。 这 个 引 脚 要 根据 实际 
情况 设置 ， 这 里 我 们 建议 大 家 在 以 后 的 学 习 或 工作 中 ，LCD 的 背光 IO 尽量 和 半导体 厂商 的 官 
方 开发 板 一 致 。 

2、LCD 屏幕 参数 节点 信息 修改 


继续 在 imx6ull-alientek-emmc.dts 文件 中 找到 lcdif 节点 ， 节 点 内 容 如 下 所 示 : 
示例 代码 59.3.2 lcdif 节点 默认 信息 
































1 &lcdif ( 

2 pinctrl-names = "default"; 

3 pinctrl-0 = «&pinctrl lcdif dat /* TERISIRI 1o */ 
4 Goinetrl lelit esl 

5 Ciganecirl ledit resets} 

6 display = <&display0>; 

7 Status - "okay"; 

8 

9 display0: display ( /* LCD 属性 信息 a 
10 bits-per-pixel 2 «16»; /* -MHAR HILA bit */ 
iil bus-width = «24»; /* 总 线 宽 度 m 
112 

ilis display-timings i 

14 native-mode = <&timing0>; /* 时 序 信息 n 
35; timing0: timingO ( 

16 clock-frequency = «9200000»; /* LCD 像素 时 钟 ， 单 位 Hz */ 
17 hactive = «480»; /* LCD X 轴 像 素 个 数 nA 
18 vactive = <272>; /* LCD Y 轴 像 素 个 数 wi 
19 hfront-porch - «8»; /* LCD hfp 参数 my 
20 hback-porch = «4»; /* LCD hbp 参数 */ 
2al hsync-len = <41>; /* LCD hspw 参数 ay 
29 vback-porch = «2»; /* LCD vbp 参数 */ 
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25 vfront-porch - «4»; /* LCD vfp 参数 wy 
24 vsync-len = «10»; /* LCD vspw 参数 Sf 
25 

26 hsync-active = «0»; /* hsync 数据 线 极 性 2 
27 vsync-active = «0»; /* vsync 数据 线 极 性 ur 
28 de-active = «1»; /* de 数据 线 极 性 */ 
219 pixelclk-active = «0»; /* clk 数据 线 先 极 性 A 
30 }; 

zi }; 

92 }; 

SES ER 


示例 代码 59.3.2 就 是 向 imx6ull.dtsi 文件 中 的 lcdif 节点 追加 的 内 容 ， 我 们 依次 来 看 一 下 示 


例 代 码 59.3.2 中 的 这 些 属性 都 是 写 什么 含义 。 

















第 3 行 ,pinctrl-0 属性 ,LCD 所 使 用 的 IO 信息 ,这 里 月 


和 pinctrl ledif reset 这 三 个 IO 相关 的 节点 ， 前 两 个 在 示例 代码 59.3.1 中 已 经 计 
E 点 原子 的 IMX6U-ALPHA F 





pinctrl lcdif reset 是 LCD 复位 IO 信息 节点 ，] 
用 到 复位 ID， 因此 pinctrl lcdif reset 可 以 删除 掉 。 

第 6 fT, display 属性 , 指定 LCD 属性 
子 节点 内 容 。 




















县 所 在 的 子 节点 ,这 上 


月 到 了 pinctrl lcdif dat.pinctrl lcdif ctrl 
HET. 
F 发 板 的 LCD 没有 




















EJ display0, F 





Miz display0 








第 9-32 行 ，display0 子 节点 ， 描 述 LCD 的 参数 信息 ， 第 10 行 的 bits-per-pixel 属性 用 于 指 





明 一 个 像素 占 月 





素 点 占用 24bit, bits-per-pixel 属性 要 改 为 24。 第 11 行 的 bus-width 属性 月 
因为 要 配置 为 RGB888 模式 ， 因 此 bus-width 也 要 设置 为 24。 





的 bit 数 ， 默 认为 16bit。 本 教程 我 们 将 LCD 配置 为 RGB888 模式 ， 因 此 一 个 像 


日 于 设置 数据 线 宽 度 ， 





第 13~30 fT, 这 几 行 非常 重要 ! 因为 这 几 行 设置 了 LCD 的 时 序 参数 信息 , NXP 官方 的 EVK 





开发 板 使 用 了 一 个 4.3 寸 的 480*272 屏幕 ， 因 此 这 中 














默认 是 按照 NXP 官方 的 那个 屏幕 参数 设置 








的 。 每 一 个 属性 的 含义 后 面 的 注释 已 经 写 的 很 
是 我 们 重点 要 修改 的 ， 需 要 根据 上 

















F 细 了 ， 大 家 自己 去 看 就 行 了 ， 这 些 时 序 参数 就 
己 所 使 用 的 屏幕 去 修改 。 





这 里 以 正点 原子 的 ATK7016(7 寸 1024*600) 屏 幕 为 例 ， 将 imx6ull-alientek-emmce.dts 文件 中 


的 lcdif 节点 改 为 如 下 内 容 : 


示例 代码 59.3.3 针对 ATK7016 LCD 修改 后 的 lcdif 节点 信息 


1. heel i 

2 pinctrl-names = "default"; 

3 pinctrl-0 = «&pinctrl lcdif dat /* 使 用 到 的 10 */ 
4 &pinctrl lcdif ctrl»; 

5 display = «&display0»; 

6 status = "okay"; 

7 

8 display0: display ( /* LCD 属性 信息 iA 
9 bits-per-pixel = «24»; /* 一 个 像素 占用 24bit  */ 
10 bus-width = «24»; /* 总 线 宽度 E 
ail 

112 display-timings ( 

13 native-mode = «&timing0»; /* 时 序 信 息 */ 
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14 timing0: timingO ( 

15 clock-frequency = «51200000»;/* LCD 像素 时 钟 ， 单 位 Hz */ 
16 hactive = «1024»; /* LCD X 轴 像 素 个 数 */ 
I7 vactive = <600>; /* LCD Y 轴 像 素 个 数 */ 
18 hfront-porch - «160»; /* LCD hfp 参数 */ 
19 hback-porch = <140>; /* LCD hbp 参数 */ 
20 hsync-len - «20»; /* LCD hspw 参数 */ 
23! vback-porch - «20»; /* LCD vbp 参数 */ 
22 vfront-porch = <12>; /* LCD vfp 参数 */ 
23 vsync-len = <3>; /* LCD vspw 参数 */ 
24 

25 hsync-active = <0>; /* hsync 数据 线 极 性 */ 
26 vsync-active = «0»; /* vsync 数据 线 极 性 wy 
2:7] de-active = «1»; /* de 数据 线 极 性 iA 
28 pixelclk-active = «0»; /* clk 数据 线 先 极 性 m 
29 }; 

30 ); 

Sd Dg 

SA E 


第 3 行 ， 设置 LCD 屏幕 所 使 用 的 IO， 删 除 掉 原来 的 pinctrl lcdif reset， 因 为 没有 用 到 屏 
ALIO, Rh IO 不 变 。 

第 9 行 ， 使 用 RGB888 模式 ， 所 以 一 个 像素 点 是 24bit。 

第 15-23 行 ，ATK7016 屏幕 时 序 参数 ， 根 据 自己 所 使 用 的 屏幕 修改 即 可 。 


3、LCD 屏幕 背光 节点 信息 


正点 原子 的 LCD 接口 背光 控制 IO 连接 到 了 LMX6U 的 GPIO1 IO08 引 脚 上 ，GPIO1 IO08 
复 用 为 PWM1_ OUT， 通 过 PWM 信和 号 来 控制 LCD 屏幕 背光 的 亮度 ， 这 个 我 们 已 经 在 第 二 十 九 
章 详 细 的 讲解 过 了 。 正 点 原子 ILMX6U-ALPHA 开发 板 的 LCD 背光 引 脚 和 NXP 官方 EVK 开发 
板 的 背光 引 脚 一 样 ， 因 此 背光 的 设备 树 节 点 是 不 需要 修改 的 ， 但 是 考虑 到 其 他 同学 可 能 使 用 别 
的 开发 板 或 者 屏幕 ，LCD 背光 引 脚 和 NXP 官方 EVK 开发 板 可 能 不 同 ， 因 此 我 们 还 是 来 看 一 下 
如 何在 设备 树 中 添加 背光 节点 信息 。 
首先 是 GPIOI IO08 这 个 IO 的 配置 ， 在 imx6ull-alientek-emmc.dts 中 找到 如 下 内 容 : 

示例 代码 59.3.4 GPIO1_IO08 引 脚 配置 

1 pinctrl pwml: pwmlgrp ( 





































































































2 fsl,pins = « 
MX6UL PAD GPIO1 IO08 PWM1 OUT  Ox110b0 


pinctrl pwml 市 点 就 是 GPIO1 IOO08 的 配置 节点 ， 从 第 3 行 可 以 看 出 ， 设 置 GPIO1 IO08 
这 个 IO 复 用 为 PWM1_OUT， 并 且 设 置 电气 属性 值 为 0x110b0。 
LCD 背光 要 用 到 PWM1， 因 此 也 要 设置 PWMI1 节点 ， 在 imx6ull.dtsi 文件 中 找到 如 下 内 








X 


示例 代码 59.3.5 imx6ull.dtsi 文件 中 的 pwml 节点 
1 pwml: pwm@02080000 ( 
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compatible - "fsl,imx6ul-pwm", 
reg = «0x02080000 0x4000»; 
interrupto c3 “Cl SEI "33 LRO WV 


«oO 0 -) Oo O! 4 € hM 


bg 


imx6ull.dtsi 文件 中 的 pwml 节点 信 
imx6ull-alientek-emmc.dts 文件 


值 即 可 找到 imx6ull 的 pwm 驱动 文件 


论坛 :www.opendev.com 


ASIP abr 2. 1 (9X E 











LEVEL HIGH»; 











clocks = «&clks IMX6UL CLK PWMI», 


X&clks IMX6UL CLK PWM1>; 
clock-nanmes = Tipon, mper, 
#pwm-cells = <2>; 











息 大 家 不 要 修改 ， 如 果 要 修改 pwml 节点 内 容 的 话 请 在 
中 修改 。 在 整个 Linux 源码 文件 中 搜索 compatible 属性 的 这 两 个 
，imx6ull 的 PWM 驱动 文件 为 drivers/pwm/pwm-imx.c， 





这 里 我 们 就 不 详细 的 去 分 析 这 个 文件 了 。 继 续 在 imx6ull-alientek-emmc.dts 文件 中 找到 向 pwml 
追加 的 内 容 ， 如 下 所 示 : 


ili 
2 
3 
& 
5 


hg 


第 3 行 ， 设 置 pwml 所 使 有 








示例 代码 59.3.6 向 pwml 节点 追加 的 内 容 


&pwml { 


pinctrl-names = "default"; 
pinctrl-0 = «&pinctrl pwml»; 


Saws = reise e 





GPIOI IO08 这 个 IO. 
第 4 行 ， 将 status 设置 为 okay。 


如 果 背 光 月 














的 IO 为 pinctrl pwml， 也 就 是 示例 代码 59.3.4 所 定义 的 


的 路 其 他 pwm, 比如 pwm2, 那么 就 需要 仿照 示例 代码 59.3.6 的 内 容 , 向 pwm2 








点 追加 相应 的 内 容 。pwm 和 相关 的 IO 已 经 准备 好 了 , 但 是 Linux 系统 怎么 知道 PWMI OUT 
就 是 控制 LCD 背光 的 呢 ? 因此 我 们 还 需要 一 个 节点 来 将 LCD 背光 和 PWMI OUT 连接 起 来 。 














这 个 节 点 就 是 backlight ， 


backlight 节点 该 如 何 去 创 建 ， 








QD、 节 点 名 称 要 为 “backlight”。 
©, TAK compatible 属性 值 要 为 “pwm-backlight”， 因 此 可 以 通过 在 Linux 内 核 中 搜索 
* pwm-backlight ”来 查找 PWM F6} i 


drivers/video/backlight/pwm bl.c， 
(S).pwms 属性 














pwm 频率 设置 为 SKHz(NXP 官方 推荐 设置 )。 


由、brightness-levels 属性 描述 亮度 级 别 ， 
是 亮度 最 低 ，255 表示 1009617 
此 属性 

®©, default-brightness-level 属性 为 

根据 上 述 5 点 设置 backlight 节点 ， 








emmc. 

















backlight 节 点 W 38 可 以 参考 
soon eu mue txt 这 个 文档 ， 此 文档 详细 讲解 了 


这 里 大 概 总 结 一 下 


























制 驱 动 程序 ， 这 个 驱动 程序 文件 为 











感 兴趣 的 可 以 去 看 一 下 这 个 驱动 程序 。 
用 于 描述 背光 所 使 用 的 PWM 以 及 PWM 频率 , 比如 本 章 我 们 要 使 用 的 pwml， 








范围 为 0~255，0 表示 PWM 占 空 比 为 0%， 也 就 


























o 





dts 文件 中 找到 如 下 内 容 : 





空 比 ， 也 就 是 亮度 最 高 。 至 于 设置 几 级 亮度 ， 大 家 可 以 自行 填写 


RUER 
这 个 NXP 已 经 给 我 们 设置 好 了 , 大 家 在 imx6ull-alientek- 


示例 代码 59.3.7 backlight 节点 内 容 


1 backlight ( 


2 


compatible = "pwm-backlight"; 
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3 pwms = «&pwml 0 5000000»; 

4 brightness-levels = <0 4 8 16 32 64 128 255»; 

5 default-brightness-level = <6>; 

6 status = "okay"; 

7 »$ 





第 3 行 ， 设置 背光 使 用 pwml，PWM 频率 为 SKHz. 

第 4 行 ， 设 置 背 8 级 背光 (0~7)， 分 别 为 0、4、8、16、32、64、128、255， 对 应 占 空 比 为 
0%、1.57%、3.13%、6.27%、12.55%、25.1%、50.19%、100%， 如 果 嫌 少 的 话 可 以 自行 添加 一 
些 其 他 的 背光 等 级 值 。 

第 5 行 ， 设 置 默认 背光 等 级 为 6， 也 就 是 50.19% 的 亮度 。 

关于 背光 的 设备 树 节点 信息 就 讲 到 这 里 ,整个 的 LCD 设备 树 节点 内 容 我 们 就 讲 完了 , 按照 
这 些 节 点 内 容 配置 自己 的 开发 板 即 可 。 





























59.4 运行 测试 
59.4.1 LCD 屏幕 基本 测试 


1、 编 译 新 的 设备 树 

上 一 小 节 我 们 已 经 配置 好 了 设备 树 ， 所 以 需要 输入 如 下 命令 重新 编译 一 下 设备 树 : 

make dtbs 

等 待 编译 生成 新 的 imx6ull-alientek-emmc.dtb 设备 树 文 件 ， 一 会 要 使 用 新 的 设备 树 启 动 
Linux 内 核 。 





























2、 使 能 Linux logo 显示 

Linux 内 核 启 动 的 时 候 可 以 选择 显示 小 企鹅 logo， 只 要 这 个 小 企鹅 logo 显示 没 问题 那么 我 
们 的 LCD 驱动 基本 就 工作 正常 了 。 这 个 logo 显示 是 要 配置 的 ， 不 过 Linux 内 核 一 般 都 会 默认 
开启 logo 显示 , 但 是 奔 着 学 习 的 目的 , 我 们 还 是 来 看 一 下 如 何 使 能 Linux logo 显示 。 打开 Linux 
内 核 图 形 化 配置 界面 ， 按 下 路 径 找到 对 应 的 配置 项 : 


-> Device Drivers 



































-> Graphics support 
-> Bootup logo (LOGO [=y]) 
-> Standard black and white Linux logo 
-> Standard 16-color Linux logo 
-> Standard 224-color Linux logo 
如 图 59.4.1.1 所 示 : 
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zuozhongkai@ubuntu: ~/linux/IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 


Bootup Logo 
Arrow keys navigate the menu. «Enter» selects submenus ---> (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes 
features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in 
[ ] excluded «M» module < > module capable 


- Bootup logo 
ps1 Standard black and white Linux logo 
[*] Standard 16-color Linux logo 


[ii tandard 224-color Linux Logo 


« Exit » < Help > < Save > < Load > 





图 59.4.1.1 logo 配置 项 
图 59.4.1.1 中 这 三 个 选项 分 别 对 应 黑白 、16 位 、24 位 色彩 格式 的 logo， 我 们 把 这 三 个 都 选 
中 ， 都 编译 进 Linux 内 核 里 面 。 设 置 好 以 后 保存 退出 ， 重 新 编译 Linux 内 核 ， 编 译 完成 以 后 使 
用 新 编译 出 来 的 imx6ull-alientek-emmc.dtb 和 zImage 镜像 启动 系统 , 如 果 LCD 驱动 工作 正常 的 
话 就 会 在 LCD 屏幕 左上 角 出 现 一 个 彩色 的 小 企鹅 logo， 屏 幕 背景 色 为 黑色 ， 如 图 59.4.1.2 所 


ZN: 


























ini 






























































图 59.4.1.2 Linux 启动 logo 显示 





59.4.2 设置 LCD 作为 终端 控制 台 


我 们 一 直 使 用 SecureCRT 作为 Linux 开发 板 终端 ,开发 板 通过 串口 和 SecureCRT 进行 通信 。 
现在 我 们 已 经 驱动 起 来 LCD 了 ， 所 以 可 以 设置 LCD 作为 终端 ， 也 就 是 开发 板 使 用 自己 的 显示 
设备 作为 自己 的 终端 , 然后 接 上 键盘 就 可 以 直接 在 开发 板 上 裔 命令 了 , 将 LCD 设置 为 终端 控制 
台 的 方法 如 下 : 

1、 设 置 uboot 中 的 bootargs 

重启 开发 板 ， 进 入 Linux 命令 行 ， 重 新 设置 bootargs 参数 的 console 内 容 ， 命 令 如 下 所 示 : 

setenv bootargs 'console-ttyl console-ttymxc0,115200 root=/dev/nfs rw nfsroot-192.168.1.250: 
/home/zuozhongkai/linux/nfs/rootfs 1p-192.168.1.251:192.168.1.250:192.168.1.1:255.255.255.0::eth0: 
off 

注意 红色 字体 部 分 设置 console， 这 里 我 们 设置 了 两 遍 console， 第 一 次 设置 console-ttyl, 
也 就 是 设置 LCD 屏幕 为 控制 台 ， 第 二 遍 又 设置 console=ttymxc0,115200， 也 就 是 设置 串口 也 作 
为 控制 台 。 相 当 于 我 们 打开 了 两 个 console, 一 个 是 LCD, 一 个 是 串口 ， 大 家 重启 开发 板 就 会 发 
现 LCD 和 串口 都 会 显示 Linux 启动 log 信息 。 但 是 此 时 我 们 还 不 能 使 用 LCD 作为 终端 进行 交 
互 ， 因 为 我 们 的 设置 还 未 完成 。 

2、 修 改 /etc/inittab 文件 


打开 开发 板 根 文件 系统 中 的 /etc/inittab 文件 ， 在 里 面 加 入 下 面 这 一 行 : 
ttyl::askfirst:-/bin/sh 
添加 完成 以 后 的 /etc/inittab 文件 内 容 如 图 59.4.2.1 Bras: 
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打开 tty1， 也 即 是 设 
置 LCD 作 为 终端 







IE OO 
: : shutdown: /bin/umount -a -r 
: : shutdown: /sbin/swapoff -a 
图 59.4.2.1 修改 后 的 /etc/inittab 文件 

修改 完成 以 后 保存 /etc/inittab 并 退出 ， 然 后 重启 开发 板 ， 重 启 以 后 开发 板 LCD 屏幕 最 后 一 
J 会 显示 下 面 一 行 语句 : 

Please press Enter to activate this console. 

上 述 提示 语句 说 的 是 : 按 下 回 车 键 使 能 当前 终端 ， 我 们 在 第 五 十 八 章 已 经 将 LMX6U- 
ALPHA 开发 板 上 的 KEY 按键 注册 为 了 回 车 键 ， 因 此 按 下 开发 板 上 的 KEY 按键 即 可 使 能 LCD 

这 个 终端 。 当然 了 ， 大 家 也 可 以 接 上 一 个 USB 8t, Linux 内 核 默认 已 经 使 能 了 USB 键盘 驱动 

了 ， 因 此 可 以 直接 使 用 USB 键盘 。 

至 此 , 我 们 就 拥有 了 两 套 终端 , 一 个 是 基于 串口 的 SecureCRT, 一 个 就 是 我 们 开发 板 的 LCD 
屏幕 ， 但 是 为 了 方便 调试 ， 我 们 以 后 还 是 以 SecureCRT 为 主 。 我 们 可 以 通过 下 面 这 一 行 命令 向 
LCD 屏幕 输出 “hello linux ! " 
echo hello linux > /dev/ttyl 














































































































59.4.3 LCD 背光 调节 


593 小 节 已 经 讲 过 了 ， 背 光 设 备 树 节 点 设置 了 8 个 等 级 的 背光 调节 ， 可 以 设置 为 0~7， 我 
们 可 以 通过 设置 背光 等 级 来 实现 LCD 背光 亮度 的 调节 ， 进 入 如 下 目录 : 
/sys/devices/platform/backlight/backlight/backlight 
此 目录 下 的 文件 如 图 59.4.3.1 所 示 : 
/sys/devices/platform/backlight/backlight/backlight # 1s 








actual_brightness device subsystem 
b1_power — pe iai 
brightness 


/sys/devices/pl EN iy ET ight/back1i aht/backii ight £ 
图 59.4.3.1 目录 下 的 文件 和 子 目录 
图 59.4.3.1 中 的 brightness 表示 当前 亮度 等 级 ，max_bgigntness 表示 最 大 亮度 等 级 。 当 前 这 


两 个 文件 内 容 如 图 59.4.3.2 所 示 : 
dk ces/platform/backlight/backlight/backlight # cat max_brightness 














/sys/devices/platform/backlight/backlight/backlight # cat brightness 
Javafdavtcus/pdatfonu/buciiidht/bacic ahi bec trol *u 
图 59.4.3.2 brightness 和 max. brightness 文件 内 容 
从 图 59.4.3.2 可 以 看 出 ， 当 前 屏幕 亮度 等 级 为 6， 根据 前 面 的 分 析 可 以 ， 这 个 是 50% 亮 度 。 
屏幕 最 大 亮度 等 级 为 7。 如 果 我 们 要 修改 屏幕 亮度 ， 只 需要 向 brightness 写 入 需要 设置 的 屏幕 亮 
度 等 级 即 可 。 比 如 设置 屏幕 亮度 等 级 为 7， 那 么 可 以 使 用 如 下 命令 : 
echo 7 > brightness 
输入 上 述 命令 以 后 就 会 发 现 屏 幕 亮度 增 大 了 ， 如 果 设 置 brightness 为 0 的 话 就 会 关闭 LCD 
背光 ， 屏 幕 就 会 烛 灭 。 



































1390 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


59.4.4 LCD 自动 关闭 解决 方法 

默认 情况 下 10 分 钟 以 后 LCD 就 会 熄 屏 , 这 个 并 不 是 代码 有 问题 , 而 是 Linux 内 核 设 置 的 ， 
就 和 我 们 用 手机 或 者 电脑 一 样 ， 一 段 时 间 不 操作 的 话 屏幕 就 会 熄灭 ， 以 节省 电能 。 解 决 这 个 问 
题 有 多 种 方法 ， 我 们 依次 来 看 一 下 : 

1、 按 键盘 唤醒 

最 简单 的 就 是 按 下 回 车 键 唤 醒 屏 幕 ， 我 们 在 第 58 章 将 LMX6U-ALPHA 开发 板 上 的 KEY 
按键 注册 为 了 回 车 键 , 因此 按 下 开发 板 上 的 KEY 按键 即 可 唤醒 屏幕 。 如 果 开 发 板 上 没有 按键 的 
舌 可 以 外 接 USB 键盘 ， 然 后 按 下 USB 键盘 上 的 回 车 键 唤醒 屏幕 。 

2、 关 闭 10 分 钟 熄 屏 功能 


在 Linux 源码 中 找到 drivers/tty/vt/vt.c 这 个 文件 ， 在 此 文件 中 找到 blankinterval 变量 ， 如 下 
所 示 : 
























































H 






























































zi 
































示例 代码 59.4.4.1 blankinterval 变量 

175) statie imt vesa blank node; 
1540) gteatie int yesa oti interval; 
181 static int blankinterval = 10*60; 

blankinterval 变量 控制 着 LCD 关闭 时 间 ， 默 认 是 10*60， 也 就 是 10 分 钟 。 将 blankinterval 
的 值 改 为 0 即 可 关闭 10 分 钟 烛 屏 的 功能 ， 修 改 完成 以 后 需要 重新 编译 Linux 内 核 ， 得 到 新 的 
zImage， 然 后 用 新 的 zImage 启动 开发 板 。 

3、 编 写 一 个 APP 来 关闭 熄 屏 功能 


在 ubuntu 中 新 建 一 个 名 为 led always on.c 的 文件 ， 然 后 在 里 面 输 入 如 下 所 示 内 容 : 
示例 代码 59.4.4.2 lcd_always_on.c 文件 代码 段 













































































1 d*include «fcntl.h» 

2 #include <stdio.h> 

3 £include Xsys/ioctl.h» 

4 

5 

S gane imesbmr((abse arge, ne [a] 
Pox 

8 ioe KEE 

9 fd = open("/dev/ttyl", O RDWR); 
10 vaere luen AOSS ON 
iil close(fd); 

3L) return 0; 

JL 


使 用 如 下 命令 编译 led always on.c 这 个 文件 : 

arm-linux-gnueabihf-gcc lcd always on.c -o led always on 

编译 生成 led always on 以 后 将 此 可 执行 文件 拷贝 到 开发 板 根 文 件 系 统 的 /usr/bin 目录 中 ， 
然后 给 予 可 执行 权限 。 设 置 lcd_always_on 这 个 软件 为 开机 自 启动 ， 打 开 /etc/init.d/rceS$， 在 此 文 
件 最 后 面 加 入 如 下 内 容 : 














示例 代码 59.4.4.3 lcd. always on 自 启动 代码 
1 cd /usr/bin 
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2 ./lcd always on 
SGH 

修改 完成 以 后 保存 /etc/init.d/reS 文件 ， 然 后 重启 开发 板 即 可 。 关 于 Linux 下 的 LCD 驱动 
我 们 就 讲 到 这 里 。 


1392 


LMX6U AR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


第 六 十 章 Linux RTC 驱动 实验 


RTC 也 就 是 实时 时 钟 ， 用 于 记录 当前 系统 时 间 ， 对 于 Linux 系统 而 言 时 间 是 非常 重要 的 ， 














就 和 我 们 使 用 Windows 电脑 或 手机 查看 时 间 一 样 , 我们 在 使 用 Linux 设备 的 时 候 也 需要 查看 时 
间 。 本 章 我 们 就 来 学 习 一 下 如 何 编写 Linux 下 的 RTC 驱动 程序 。 
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60.1 Linux 内 核 RTC 驱动 简介 





RTC 设备 驱动 是 一 个 标准 的 字符 设备 驱动 , 应 用 程序 通过 open. release. read. write 和 ioctl 
等 函数 完成 对 RTC 设备 的 操作 ， 关 于 RTC 硬件 原理 部 分 我 们 已 经 在 裸 机 篇 中 的 第 二 十 五 章 进 
行 了 详细 的 讲解 ， 这 里 就 不 再 废话 了 。 

Linux 内 核 将 RTC 设备 抽象 为 rtc device 结构 体 ， 因 此 RTC 设备 驱动 就 是 申请 并 初始 化 
rtc_device， 最 后 将 rtc. device 注册 到 Linux 内 核 里 面 ， 这 样 Linux 内 核 就 有 一 个 RTC 设备 的 。 
至 于 RTC 设备 的 操作 肯定 是 用 一 个 操作 集合 (结构 体 ) 来 表示 的 ， 我 们 先 来 看 一 下 rtc device Zi 
构 体 ， 此 结构 体 定义 在 include/linux/rtc.h 文件 中 ， 结 构 体 内 容 如 下 (删除 条 件 编译 ): 

示例 代码 60.1.1 rtc_device 结构 体 

































































TOL struct rte evee 























los d 

106 struct device dev; /* 设备 a 
107 struct module *owner; 

108 

109 ioe iep J TD E 
110 char name[RTC DEVICE NAME SIZE]; /* 名 字 a 
waa 

IET Gems ue iege Gleis OS OS /* RTC 设备 底层 操作 函数 */ 
2L 3159] Sleeueeemu oe moe, 

114 

1305] struct QGolew char dew; /* 字符 设备 B 
116 unsigned long flags; 

1,309) 

118 unsigned long irq data; 

WALS Spamo kE moe 

120 wait queue head t irq queue; 

2A SENbICIE ye ue 

1120) 

12:8] ptrue rte task bre] cask? 

124 Spinleoek i iueep Eke 

JL 2755 int irg treg} 

126 ime mex User freg? 

152 

128 struct timerqueue head timerqueue; 

125 Struct rte timer aie timar, 

130 struct rte timer ule rtetimerg 

Sil struct hrtimer pie timer; /* sub second exp, sc needs briimer “/ 
2 int ple enablecly 

T38 SEEUGE Worl BEEUGE LEGNO US, 

134 /* Some hardware can't support UIE mode */ 

1S) int uie unsupported; 
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TII Ve 
我 们 需要 重点 关注 的 是 ops 成 员 变 量 , 这 是 一 个 rtc_class_ops 类 型 的 指针 变量 ,rtc_class_ops 
为 RTC 设备 的 最 底层 操作 函数 集合 ， 包 括 从 RTC 设备 中 读 取 时 间 、 向 RTC 设备 写 入 新 的 时 间 
值 等 。 因 此 ，rtc_class_ops 是 需要 用 户 根 据 所 使 用 的 RTC 设备 编写 的 ， 此 结构 体 定义 在 
include/linux/rtc.h 文件 中 ， 内 容 如 下 : 
示例 代码 60.1.2 rtc_class_ops 结构 体 


Ti ue xe elass Ops d 





























72 int (*open) (struct device *); 

73 void (*release) (struct device *); 

me aowe (rOet (er tee Ole. ts, buo eee! me ee Lene? 
75 ime (reac time) (sucruci device t, suiwC rte tima =) 

1$. mme (eet tims) (Struct device S, SEueE EEC time 0) 8 

77 ime (reac alarm) (struct device 7, struct TEE wkalzm v5 

Va int (Feet alarm) (struct Ceyice w, Struct rte wkaklem w) p 

79 ime (pee (Struct devices 'v, Struct seg ale w)? 


00 int ms (struct device V, timet 't secs); 





el dnt (Feet mmes) (struct devica w, unsigned! long Sees) 





$2 dat (vreac!) callback) (struct device w, is data) p 
$9. dmt (valarm irg enable) (struct devices v, unsigned int enabled) z 
Si pg 

看 名 字 就 知道 rtc class ops. 操作 集合 中 的 这 些 函 数 是 做 什么 的 了 ， 但 是 我 们 要 注意 ， 
rtc class ops 中 的 这 些 函 数 只 是 最 底层 的 RTC 设备 操作 函数 ， 并 不 是 提供 给 应 用 层 的 
file operations 函数 操作 集 。RTC 是 个 字符 设备 ， 那 么 肯定 有 字符 设备 的 file operations 函数 操 
ER, Linux 内 核 提供 了 一 个 RTC 通用 字符 设备 驱动 文件 ， 文 件 名 为 drivers/rte/rte-dev.c, rtc- 
dev.c 文件 提供 了 所 有 RTC 设备 共用 的 file operations 函数 操作 集 ， 如 下 所 示 : 

示例 代码 60.1.3 RTC 通用 file operations 操作 集 





















































J statie Gongst struct iile operations rte dey ios = i 
449 . owner = THIS MODULE, 

450 .llseek = no llseek, 

Gl .read = ete dey reac, 

452 POLL = rtc dev poll, 

453 uele le iocil c zie GE i0O€1l, 

d mdi .open = rtc dev open, 

255 otelease = rte dey release, 

456 .fasync = rtc dev fasync, 

Ay; 








看 到 示例 代码 60.1.3 是 不 是 很 熟悉 了 ， 标 准 的 字符 设备 操作 集 。 应 用 程序 可 以 通过 ioctl PR 
数 来 设置 / 读 取 时 间 、 设 置 / 读 取 闹钟 的 操作 ， 那 么 对 应 的 rte dev ioctl 函数 就 会 执行 ， 
rtc dev ioctl 最 终 会 通过 操作 rtc. class ops 中 的 read time. set time 等 函数 来 对 具体 RTC 设备 
的 读 写 操作 。 我 们 简单 来 看 一 下 rte dev ioctl 函数 ， 函 数 内 容 如 下 (有 省 略 ); 
示例 代码 60.1.4 rtc. dev. ioctl 函数 代码 段 
21/8 gratie lonc rce Cey iocti (struct tile wiile, 






































ZAS unsigned int cmd, unsigned long arg) 
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2230 4 

2g int err = 0; 

222 stuet rte devices rte = files private Carag 
223 const seruct iC Cless OS VOS = PTE- > 0 
224 ShEGBIENE rte cima tmy 

22215 struct rtc wkalrm alarm; 

226 void ^ user vuarg = (voio vser w) arce 

2AN 

228 err = mutex lock interruptible(&rtc-»ops lock); 
22 if (err) 

230 return err; 

269 switch (cmd) ( 

333 case RTC RD TIME: /* 读 取 时 间 */ 
334 mutex unlock(&rtc-»ops lock); 

3 

336 err = rtc read time(rtc, &tm); 

S if (err < 0) 

338 return err; 

SS 

340 if (copy to user(uarg, &tm, sizeof (tm))) 
341 (exse = PEAU 

342 return err; 

343 

344 case RTC SET TIME: /* 设置 时 间 */ 

345 mutex unlock(&rtc-»ops lock); 

346 

347 if (copy from user(&tm, uarg, sizeof(tm))) 
348 return -EFAULT; 

349 

250 returnga-omc imeem 

401 default: 

402 /* Finally try the driver's ioctl interface */ 
403 if (ops-»ioctl) ( 

404 err — ops-»ioctl(rtc-»dev.parent, cmd, arg); 
405 if (err == -ENOIOCTLCMD) 

406 err —- -ENOTTY; 

407 ) else 

408 err = -ENOTTY; 

409 break; 

410 } 
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411 

412 done: 

413 mutex unlock(&rtc-»ops lock); 

414 return err; 

415 } 


第 333 ÍT, RTC RD TIME 为 时 间 读 取 命 令 。 

第 336 行 ， 如 果 是 读 取 时 间 命 令 的 话 就 调用 rte read time 函数 获取 当前 RTC 时 钟 ， 
rtc read time PAZ, rtc read time 会 调用 rtc read time 函数 ，_ rtc read time 函数 内 容 如 下 : 
示例 代码 60.1.5. rtc read time 函数 代码 段 

25 tatic dimi: _ rte reed tine(struct rce device "itg, 


Struct ifie time wtu) 














24 { 

25 int err; 

26 Ee > 

2 err - -ENODEV; 

28 else if (!rtc-»ops-»read time) 

29 err = -EINVAL; 

30 else { 

Sal memset(tm, 0, sizeof(struct rtc time)); 

32 err = rtc-»ops-»read time(rtc-»dev.parent, tm); 
53 If (ere <0) 4 

34 dev dbg (&rto->dev, “read time: fail to read: sdin”, 
D (SETS) B 

36 return err; 

n } 

38 

359 err SS rte valie tm(tm) P 

40 if (err < 0) 

41 dew ciger te= oey; Vrea tima] rG tima legati ve) 
42 } 

43 return err; 

44 } 








从 示例 代码 60.1.5 中 的 32 行 可 以 看 出 ，_rtc read time 函数 会 通过 调用 rtc. class ops 中 的 
read time 来 从 RTC 设备 中 获取 当前 时 间 。rtc_dev ioctl 函数 对 其 他 的 命令 处 理 都 是 类 似 的 ， 比 
lil RTC ALM READ 命令 会 通过 rtc_read_alarm 函数 获取 到 闹钟 值 , 而 rtc_ read. alarm 函数 经 过 
层 层 调 用 ， 最 终 会 调用 rtc class ops 中 的 read alarm 函数 来 获取 闹钟 值 。 

至 此 ，Linux 内 核 中 RTC 驱动 调用 流程 就 很 清晰 了 ， 如 图 60.1.1 所 示 : 
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内 核 层 rtc dev read() rtc dev ioctlO 
ttc-dev.c 


三 A^ ` 
lice 
rtc class ops 


图 60.1.1 Linux RTC 驱动 调用 流程 
当 rtc class ops 准备 好 以 后 需要 将 其 注册 到 Linux 内 核 中 ， 这 里 我 们 可 以 使 用 
rtc device register 函数 完成 注册 工作 。 此 函数 会 申请 一 个 rtc_device 并 且 初 始 化 这 个 rtc_device， 
最 后 向 调用 者 返回 这 个 rtc_device， 此 函数 原型 如 下 : 
struct rtc device *rtc device register(const char *name, 
struct device *dev, 


const struct rtc class ops "ops, 










































































struct module *owner) 

函数 参数 和 返回 值 含 义 如 下 : 

name: 设备 名 字 。 

dev: 设备 。 

ops: RTC 底层 驱动 函数 集 。 

owner: 驱动 模块 拥有 者 。 

返回 值 ， 注 册 成 功 的 话 就 返回 rte device, 错误 的 话 会 返回 一 个 负 值 。 

HEE RTC 驱动 的 时 候 需 要 调用 rtc_device_unregister 函数 来 注销 注册 的 rtc. device, PAŽI 
原型 如 下 : 

void rtc device unregister(struct rtc device — *rtc) 

函数 参数 和 返回 值 含 义 如 下 : 

rtc: 要 删除 的 rtc device. 

返回 值 : 无 。 
还 有 另外 一 对 rte device 注册 函数 devm rtc. device register 和 devm rtc device unregister, 
分 别 为 注册 和 注销 rtc_device。 


60.2 I.MX6U 内 部 RTC 驱动 分 析 


先 直接 告诉 大 家 ，LMX6U 的 RTC 驱动 我 们 不 用 自己 编写 , 因为 NXP 已 经 写 好 了 。 其 实 对 
于 大 多 数 的 SOC 来 讲 ， 内 部 RTC 驱动 都 不 需要 我 们 去 编号， 半导体 厂商 会 编写 好 。 但 是 这 不 
代表 我 们 就 偷懒 了 ， 虽 然 不 用 编写 RTC 驱动 ， 但 是 我 们 得 看 一 下 这 些 原 厂 是 怎么 编写 RTC IK 
动 的 。 

分 析 驱 动 ， 先 从 设备 树 入 手 ， 打 开 imx6ull.dtsi， 在 里 面 找 到 如 下 snvs rtc 设备 节点 ， 节 点 
内 容 如 下 所 示 : 



































F 








































































































示例 代码 60.2.1 imx6ull.dtsi 文件 rtc 设备 节点 


JL enye rts sn te-lo d 


2 compatible = "fsl,sec-v4.0-mon-rtc-lp"; 
3 regmap = <&snvs>; 
4 offset = <0x34>; 
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5 interrupts = «GIC SPI 19 IRQ TYPE LEVEL HIGH», «GIC SPI 20 


IRQ TYPE LEVEL HIGH»; 





























emi: 

第 2 行 设置 兼容 属性 compatible 的 值 为 “fsl,sec-v4.0-mon-rtc-lp”， 因此 在 Linux 内 核 源 码 
中 搜索 此 字符 串 即 可 找到 对 应 的 驱动 文件 ， 此 文件 为 drivers/rtc/rtc-snvs.c， 在 rtc-snvs.c 文件 中 
找到 如 下 所 示 内 容 : 


i 








示例 代码 60.2.2 rtc 设备 platform 驱动 框架 























JEO racie Const struct ot device ic moos ex 4 
381 compatible e tfs sce v0 mom Ee PE o. der 
E ( /* sentinel */ } 

233 Jy 

384 MODULE DEVICE TABLE(of, snvs dt ids); 

385 

Seo tatie struct plarciorm river snye rte QGheswese = d 
So .driver = ( 

388 aame = sn EI 

389 .pm = SNVS RTC PM OPS, 

390 .of match table => snvs dt ids, 

So m 

392 .probe -0snvsertceprobe, 

899p; 


394 module platform driver(snvs rtc driver); 
第 380-383 行 ， 设 备 树 ID 表 ， 有 一 条 compatible 属性 ， 值 为 “fsl,sec-v4.0-mon-rtc-lp”， 因 
此 imx6ull.dtsi 中 的 snvs rtc 设备 节点 会 和 此 驱动 匹配 。 
第 386-393 行 ， 标 准 的 platform 驱动 框架 ， 当 设备 和 驱动 匹配 成 功 以 后 snvs rtc probe PE 
数 就 会 执行 。 我 们 来 看 一 下 snvs rtc probe 函数 ， 函 数 内 容 如 下 (有 省 略 ): 
示例 代码 60.2.3 snvs_rtc_probe 函数 代码 段 


256 pTtaTIE int enys rte probelstruct platciorm device “oev) 








~ 


















































Z2 
240 SEwwICIE enys rte data «dara; 
241 struct TeSouUreS Vres; 
242 int ret; 
243 void . iomem *mmio; 
244 
245 data = devm kzalloc(&pdev-»dev, sizeof(*data), GFP KERNEL); 
246 if (!data) 
247 return -ENOMEM; 
248 
249 data->regmap = 
syscon regmap lookup by phandle(pdev-»dev.of node, "regmap"); 
250 
29 if (IS ERR(data->regmap)) ( 
S devliwammt&pdeveodeuvr a Vanya CEs VOU Uss Ole drs Tile, 
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please update itn"); 
res = platform get resource (pdev, IORESOURCE MEM, 0); 


mmio = devm ioremap resource(&pdev-»dev, res); 


if (IS ERR(mmio)) 








return PTR ERR (mmio); 


data-»regmap = devm regmap init mmio(&pdev-^dev, mmio, 
&snvs rtc config); 
) else ( 
data-»offset = SNVS LPREGISTER OFFSET; 

















Ot property reac > ot occ Meta 
&data->offset); 


if (!data-»regmap) { 
eevee > "Ceu" E grin] Guys. Supe yum p 


return -ENODEV; 














data-»irq = platform get irq(pdev, 0); 
seis (Cata=zz < 


return data-»irg; 
platform set drvdata(pdev, data); 
/* Initialize glitch detect */ 
regmap write(data-»regmap, data-»offset + SNVS LPPGDR, 
SNVS LPPGDR INIT); 
/* Clear interrupt status */ 
regmap write(data-»regmap, data-^»offset + SNVS LPSR, 


OÜxftfftffff) 


2 mao le INC 3 





snvs_rtc enable(data, true); 

device init wakeup(&pdev-»dev, true); 

ret = devm request irq(&pdev-»dev, data-»irq, 
snvs rtc irq handler, 


IRQF SHARED, "rtc alarm", &pdev-»dev); 
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301 
302 
508 
304 
305 
306 
307 
308 
309 
SAko 
Suit 
Syl 
SS 
314 
SIL 
316 
Sub y) 
318 
Sul) 
320 
SZ 
922 


地 址 对 应 的 虚拟 地 址 。 
第 259 行 ，Linux3.1 引入 了 一 个 全 新 的 regmap 机 制 ，regmap 用 于 提供 


IESE) 
dev err(&pdev-»dev, "failed to request irq $d: 


data-»irq, ret); 





gotogensodEnscNevitcea egisse 


论坛 :www.opendev.com 


Sd An", 


data-»rtc = devm rtc device register(&pdev-»dev, pdev-»name, 


&snvs rtc ops, THIS MODULE); 
if (IS ERR(data-»rtc)) ( 
ret o PIR ERR(data-»rtc); 








dew creed => ev ie os Eerme ES lb Mrs e) NT 





gotogernson elici cete MT CIE Ee 


return 0; 


enm cacc secl s STE 


if (data-»clk) 





elk disable unprepare (data-»clk); 


return ret; 


} 


第 253 行 ， 调 用 platform get resource 函数 从 设备 树 中 获取 到 RTC 外 设 寄存 器 基地 址 。 
第 255 行 ， 调 用 函数 devm ioremap resource 完成 内 存 映射 ， 得 到 RTC 外 设 寄存 器 物理 基 


T 





























一 套 方便 的 API K 





数 去 操作 底层 硬件 寄存 器 ， 以 提高 代码 的 可 重用 性 。snvs-rtc.c 文件 会 采用 regmap 机 制 来 读 写 
RTC 底层 硬件 寄存 器 。 这 里 使 用 devm regmap init mmio 函数 将 RTC 的 硬件 寄存 器 转化 为 


regmap 形式 ， 这 样 regmap 机 






































第 270 行 ， 从 设备 树 中 获取 RTC 的 中 断 号 。 








BI] regmap write, regmap read 等 API 函数 才能 操作 寄存 器 。 











第 289 行 , 设置 RTC_LPPGDR 寄存 器 值 为 SNVS_LPPGDR INIT- 0x41736166， 这 里 就 是 





用 的 regmap 机 制 的 regmap_write 函数 完成 对 寄存 器 进行 写 操作 。 

















第 292 行 , 设置 RTC LPSR 寄存 器 , 写 入 Oxffffffff, LPSR 是 RTC 状态 寄存 器 , 写 1 清 零 ， 





因此 这 一 步 就 是 清除 LPSR 寄存 器 。 











第 295 行 ， 调 用 snvs rtc enable 函数 使 能 RIC， 此 函数 会 设置 RTC_LPCR 寄存 器 。 
第 299 行 ,调用 devm request irq 函数 请 求 RTC 中 断 , 中 断 服 务 函 数 为 snvs_ rte irq handler; 





用 于 RTC 闹钟 中 断 。 








第 307 行 ， 调 用 devm rtc device register 函数 向 系统 注册 rtc_devcie，RTC 底层 驱动 集 为 











snvs rtc ops.snvs rtc ops 操 作 集 包含 了 读 取 /设置 RIC 时 间 , 读 取 / 设 置 闹钟 等 函数 snvs rtc ops 














内 容 如 下 : 

示例 代码 60.2.4 snvs_rtc_ops 操作 集 
200 gracie Congt se rte Class ops Suv; ic GS C 
AURI creac times — enys zte read tine, 
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202 .Set time = nys rte Set tine, 

203 otea allarm = snye rte nee 

204 ceert elem = enys rE Ser alenn, 

205 oalarm irg enable = snye rte alarm irg enable, 

206 Mg 


我 们 就 以 第 201 行 的 snvs rtc read time 函数 为 例 讲 解 一 下 rtc class ops 的 各 个 RTC 底层 
操作 函数 该 如 何 去 编写 。snvs rtc read time 函数 用 于 读 取 RTC 时 间 值 ， 此 函数 内 容 如 下 所 示 : 
示例 代码 60.2.5 snvs_rtc_read_time 函数 代码 段 


126 statie imt nys rte read) timelstruct Glewice wder, 











Struct pte time tma) 


EET 

128 struct snvs rtc data *data = dev get drvdata (dev); 
129 unsigned long time — rtc read lp counter (data); 
130 

T3T rtc time to tm(time, tm); 

92 

133 return 0; 

134 } 


第 129 行 ， 调 用 rtc read Ip counter 获取 RTC 计数 值 ， 这 个 时 间 值 是 秒 数 。 
第 131 行 ,调用 rtc_time to tm 函数 将 获取 到 的 秒 数 转换 为 时 间 值 , 也 就 是 rte time 结构 体 
XAL, rtc time 结构 体 定义 如 下 : 
示例 代码 60.2.6 rtc_time 结构 体 类 型 











20 Strut rre time i 
2 ium tm Sec 
2 iE tm mine 
23 ine Em noues 
24 int tm mday; 
25 ot tm mony 
26 iat dE» year, 
2 int tm wday; 
28 ine em Yolaye 
29 int tm LaasE 
20m); 


最 后 我 们 来 看 一 下 rte read Ip counter 函数 ， 此 函数 用 于 读 取 RTC 计数 值 ， 函 数 内 容 如 下 
(ARIK): 





示例 代码 60.2.7 rtc. read. Ip. counter 函数 代码 段 
30! static 10192 ice read lp counter lotr uct enys rte deta veles) 
ST 


52 u64 readl, read2; 

53 u52 val; 

54 

55 do { 

56 regmap read(data-»regmap, data->offset + SNVS_LPSRTCMR, 
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&val); 

57 readl - val; 

58 readl <<= 32; 

59 regmap read(data-»regmap, data-»offset + SNVS LPSRICLR, 
&val); 

60 readl |= val; 

61 

62 regmap read(data-»regmap, data-»offset «* SNVS LPSRTCMR, 

&val); 

63 read2 = val; 

64 read2 <<= 32; 

65 regmap read(data-»regmap, data-»offset * SNVS LPSRTCLR, 
&val); 

66 read2 |= val; 

67 Js 

68 * when CPU/BUS are running at low speed, there is chance that 

69 * we never get same value during two consecutive read, so here 

70 * we only compare the second value. 

qnit ur 

I2 } while ((readl >> CNTR TO SECS SH) != (read2 >> 

CNTR TO SECS E 

YS 

74 /* Convert 47-bit counter to 32-bit raw second count */ 

75 return (u32) (readl >> CNTR TO SECS SH); 

qe 

第 56-72 fT, 读 取 RTC_LPSRTCMR 和 RTC. LPSRTCLR 这 两 个 寄存 器 ， 得 到 RTC 的 计数 
E, 单位 为 秒 , 这 个 秒 数 就 是 当前 时 间 。 这 里 读 取 了 两 次 RTC 计数 值 , 因为 要 读 取 两 个 寄存 器 ， 





次 ， 
































因此 可 能 存在 读 取 第 二 个 寄存 器 的 时 候 时 间 数 据 更 新 了 ， 导 致 时 间 不 匹配 ， 因 此 这 里 连续 读 两 





如 果 两 次 的 时 间 值 相等 那么 就 表示 时 间 数 据 有 效 。 
第 75 行 ， 返 回 时 间 值 ， 注 意 这 里 将 前 面 读 取 到 的 RTC 计数 值 右 移 了 15 位 。 
这 个 就 是 snvs rtc read time 函数 读 取 RTC 时 间 值 的 过 程 ， 至 于 其 他 的 底层 操作 函数 大 家 























自行 分 析 即 可 ， 都 是 大 同 小 异 的 ， 这 里 就 不 再 分 析 了 。 关 于 LMXGU 内 部 RTC 驱动 源码 就 讲解 


到 这 里 。 
60.3 RTC 时 间 查 看 与 设置 


1、 时 间 RTC 查看 


RTC 是 用 来 计时 的 ， 因 此 最 基本 的 就 是 查看 时 间 ，Linux 内 核 启动 的 时 候 可 以 看 到 系统 时 
钟 设置 信息 ， 如 图 603.1 所 示 : 


snvs rtc 20cc000.snvs:snvs-rtc-lp: rtc core: registered 20cc000.snvs:snvs-r as rtcO 




















IR NEC protocol handler initialized -rtc-Ipi. rtc0 
IR RC5(x/sz) protocol handler initialized Tenvs-rte- pst te 


图 60.3.1 Linux 启动 log 信息 
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从 图 60.3.1 中 可 以 看 出 ，Linux 内 核 在 启动 的 时 候 将 snvs rtc 设置 为 rtc0， 大 家 的 启动 信息 
可 能 会 和 图 60.3.1 中 的 不 同 ， 但 是 内 容 基 本 上 都 是 一 样 的 。 

如 果 要 查看 时 间 的 话 输入 “date” 命 令 即 可 ， 结 果 如 图 60.3.2 所 示 : 




















/ # date 
Thu Jan 1 00:06:11 UTC 1970 


/ # 





图 60.3.2. 当前 时 间 值 

从 图 60.3.2 可 以 看 出 ， 当 前 时 间 为 1970 年 1 月 1 日 00:06:11, 很 明显 是 时 间 不 对 , 我 们 需 
要 重新 设置 RTC 时 间 。 

2、 设 置 RTC 时 间 

RTC 时 间 设 置 也 是 使 用 的 date 命令 ， 输 入 “date --help” 命 令 即 可 查看 date 命令 如 何 设置 
系统 时 间 ， 结 果 如 图 60.3.3 所 示 : 


/ # date --help 
BusyBox v1.29.0 (2019-06-13 11:08:2B CST) multi-call binary. 








Usage: date [OPTIONS] [+FMT] [TIME] 
Display time (using +FMT), or set time 


[-s,--set] TIME Set time to TIME 


-u,--utc Work in UTC (don't convert to local time) 

-R,--rfc-2822 Output RFC-2822 compliant date string 

-I[sPEC] Output ISO-8601 compliant date string 
SPEC-'date' (default) for date only, 
'hours', 'minutes', or 'seconds' for date and 
time to the indicated precision 

-r,--reference FILE Display last modification time of FILE 

-d,--date TIME Display TIME, not 'now' 

-D FMT Use FMT for -d TIME conversion 

Recognized TIME formats: 

hh:mm[:ss] 

[YYYY. ]MM.DD-hh: mm[: ss] 

YYYY -MM-DD : 


hh:mm[:ss] 
EEEEEYYT YY]MM]DD]hh]mm[. ss] 
'date TIME' form accepts MMDDhhmm[ [YY]YY][.ss] instead 
图 60.3.3 date 命令 帮助 信息 
现在 我 要 设置 当前 时 间 为 2019 年 8 月 31 日 18:13:00， 因 此 输入 如 下 命令 : 
date -s "2019-08-31 18:13:00" 
设置 完成 以 后 再 次 使 用 date 命令 查看 一 下 当前 时 间 就 会 发 现时 间 改 过 来 了 ， 如 图 60.3.4 所 

















示 : 
/ € date 
Sat Aug 31 18:13:01 UTC 2019 


/*W 
图 60.3.4 当前 时 间 
大 家 注意 我 们 使 用 “date -s” 命 令 仅仅 是 将 当前 系统 时 间 设 置 了 ， 此 时 间 还 没有 写 入 到 
LMX6U 内 部 RTC 里 面 或 其 他 的 RTC 忆 瞩 里面， 因此 系统 重启 以 后 时 间 又 会 丢失 。 我 们 需要 将 
当前 的 时 间 写 入 到 RTC 里 面 , 这 里 要 用 到 hwclock 命令 , 输入 如 下 命令 将 系统 时 间 写 入 到 RTC 
里 面 : 
hwclock -w /将 当前 系统 时 间 写 入 到 RTC 里 面 
时 间 写 入 到 RTC 里 面 以 后 就 不 怕 系 统 重启 以 后 时 间 丢 失 了 ， 如 果 IMX6U-ALPHA 开发 板 
底板 接 了 纽扣 电池 ， 那 么 开发 板 即 使 断 电 了 时 间 也 不 会 丢失 。 大 家 可 以 尝试 一 下 不 断 电 重启 和 


1404 































































































LMX6U BEA st Linux 驱动 开发 指南 e21ESIBT 





原子 哥 在 线 教学 ，www.yuanzige.com 
断 电 重启 这 两 种 情况 下 开发 板 时 间 会 不 会 丢失 。 


论坛 :Www.opendev.com 
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第 六 十 一 章 Linux I2C 驱动 实验 


DC 是 很 常用 的 一 个 串 行 通信 接口 ， 用 于 连接 各 种 外 设 、 传 感 器 等 器 件 ， 在 裸 机 篇 已 经 对 
LMX6U 的 DC 接口 做 了 详细 的 讲解 。 本 章 我 们 来 学 习 一 下 如 何在 Linux 下 开发 DC 接口 器 件 
驱动 ， 重 点 是 学 习 Linux 下 的 DC 驱动 框架 ， 按 照 指定 的 框架 去 编写 DC 设备 驱动 。 本 章 同样 
以 LMX6U-ALPHA 开发 板 上 的 AP3216C 这 个 三 合 一 环境 光 传 感 器 为 例 ， 通 过 AP3216C 讲解 
一 下 如 何 编写 Linux 下 的 DC 设备 驱动 程序 。 
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61.1 Linux I2C 驱动 框架 简介 


回想 一 下 我 们 在 裸 机 篇 中 是 怎么 编写 AP3216C 驱动 的 ， 我 们 编写 了 四 个 文件 : bsp_i2c.c、 
bsp i2c.h. bsp ap3216c.c 和 bsp_ap3216c.h。 其 中 前 两 个 是 IMX6U 的 IC 接口 驱动 ， 后 两 个 文 
件 是 AP3216C 这 个 I2C 设备 驱动 文件 。 相 当 于 有 两 部 分 驱动 : 

(D. DC 主机 驱动 。 

©, RC 设备 驱动 。 

对 于 DC 主机 了 驱动， 一 旦 编写 完 JUS 要 再 做 修改 ， 其 他 的 DC 设备 直接 调用 主机 驱动 
提供 的 API 函数 完成 读 ar. 有 可。 这 个 正好 符合 Linux 的 驱动 分 离 与 分 层 的 思想 , 因此 Linux 
内 核 也 将 DC 驱动 分 为 两 部 分 : 

O, RC 总 线 驱 动 ，I2C 总 线 驱 动 就 是 SOC 的 PC 控制 器 驱动 ， 也 叫做 PC 适配器 驱动 。 

©, RC 设备 驱动 ，I2C 设备 驱动 就 是 针对 具体 的 DC 设备 而 编写 的 驱动 。 


































































































61.1.1 DC 总 线 驱动 


首先 来 看 一 下 I2C 总 线 ， 在 讲 platform 的 时 候 就 说 过 ，platform 是 虚拟 出 来 的 一 条 总 线 ， 
目的 是 为 了 实现 总 线 、 设 备 、 驱 动 框架 。 对 于 DC 而 言 , 不 需要 虚拟 出 一 条 总 线 ， 直 接 使 用 I2C 
总 线 即 可 。I2C 总 线 驱 动 重点 是 DC 适配器 (也 就 是 SOC 的 C 接口 控制 器 ) 驱 动 ， 这 里 要 用 到 
两 个 重要 的 数据 结构 : i2c adapter 和 i2c algorithm, Linux 内 核 将 SOC 的 PC 适配器 (控制 器 ) 
抽象 成 i2c adapter, i2c adapter 结构 体 定义 在 include/linux/i2c.h 文件 中 ， 结 构 体 内 容 如 下 : 

示例 代码 61.1.1.1 i2c_adaptet 结构 体 
AO Struer L2 eceprer il 































































































499 struct module *owner; 

500 uitenee ne glass, "classes: cNalbewNDEOb mci on/ 
501 const struct i2c algorithm *algo; /* 总 线 访问 算法 */ 
502 voie valed daEa7 

503 

504 /* data fields that are valid for all devices A 
505 struct EE mutex bus Locky 

506 

507 ine eimeout, M soy ees 

508 int retries; 

509 struct device dev; /* the adapter device */ 
S10 

al aique ey 

L2 char name[48]; 

513 struct completion dev released; 

514 

ils] struct mutex userspace clients lock; 

516 struct list heat userspace eliemits; 

Sq 

518 strut 12e bus recovery inio wous recovery intop 
519 Const struct 12e adapter quirks es 

SA0) 
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第 501 fT, i2c algorithm 类 型 的 指针 变量 algo， 对 于 一 个 PC 适配器 ， 肯 定 要 对 外 提供 读 
写 API 函数 ， 设 备 驱 动 程序 可 以 使 用 这 些 API 函数 来 完成 读 写 操作 。i2c_ algorithm 就 是 I2C 适 

















配器 与 IC 设备 进行 通信 的 方法 。 
i2c_algorithm 结构 体 定义 在 include/linux/i2c.h 文件 中 ， 内 容 如 下 (删除 条 件 编译 ): 
示例 代码 61.1.1.2 i2c_algotithm 结构 体 
SOil scire, i26 algorit i 











398 int (mester xier) (struct i112 í alapter vade, 


Eee 126 meg vasge, 


399 int num); 

400 ime (vemos zier) (struct i2e€ alapter eos, ule ader, 

401 uasigoet! short flags, Char reac writer 

402 u8 command, int size, union 126 smbus data *data); 
403 

404 /* To determine what the adapter supports */ 

405 UES ne emma (struct 12e adaBEsE w)? 

A 











第 398 行 ，master_xfer 就 是 I2C 适配器 的 传输 函数 ， 可 以 通过 此 函数 来 完成 与 TIC 设备 之 
间 的 通信 。 

第 400 行 ，smbus_xfer 就 是 SMBUS 总 线 的 传输 函数 。 

综 上 所 述 ，I2C 总 线 驱 动 ， 或 者 说 DC 适配器 驱动 的 主要 工作 就 是 初始 化 i2c_adapter 结构 
体 变 量 , 然后 设置 2c_algorithm 中 的 master_xfer 函数 。 完 成 以 后 通过 i2c add numbered adapter 
BK i2c add adapter 这 两 个 函数 向 系统 注册 设置 好 的 ic_adapter， 这 两 个 函数 的 原型 如 下 ; 

inti2c add adapter(struct i2c adapter *adapter) 





























inti2c add numbered adapter(struct i2c adapter *adap) 

这 两 个 函数 的 区 别 在 于 i2c add adapter 使 用 动态 的 总 线 号 ， 而 i2c add numbered adapter 
使 用 静态 总 线 号 。 函 数 参数 和 返回 值 含义 如 下 : 

adapter 或 adap: 要 添加 到 Linux 内 核 中 的 ic_adapter， 也 就 是 DC 适配器 。 

返回 值 : 0， 成 功 ， 负 值 ， 失 败 。 

如 果 要 删除 PC 适配器 的 话 使 用 i2c_del adapter 函数 即 可 ， 函 数 原 型 如 下 : 

void i2c del adapter(struct i2c adapter * adap) 

函数 参数 和 返回 值 含义 如 下 : 

adap: 要 删除 的 PC 适配器 。 

BE: 无 。 

关于 Dc 的 总 线 (控制 器 或 适配器 ) 驱 动 就 讲解 到 这 里 ， 一 般 SOC 的 PC 总 线 驱 动 都 是 由 半 
导体 厂商 编写 的 ， 比 如 LMX6U 的 DC 适配器 驱动 NXP 已 经 编写 好 了 ， 这 个 不 需要 用 户 去 编 
写 。 因 此 DC 总 线 驱 动 其 实 跟 我 们 这 些 SOC. 使 用 者 来 说 是 被 屏蔽 掉 的 ,我 们 只 要 专注 于 DC 设 
备 驱动 即 可 。 除 非 你 是 在 半导体 公司 上 班 ， 工 作 内 容 就 是 写 DC 适配器 驱动 。 


























H 




































































61.1.2 IC 设备 驱动 


DC 设备 驱动 重点 关注 两 个 数据 结构 : ic client 和 i2e. driver, 根据 总 线 、 设 备 和 驱动 模型 ， 
IC 总 线 上 一 小 节 已 经 讲 了 。 还 剩 下 设备 和 驱动 ，i2c_client 就 是 描述 设备 信息 的 ，i2c_driver 描 
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述 驱 动 内 容 ， 类 似 于 platform driver. 
1、i2c_client 结构 体 


i2c_client 结构 体 定义 在 include/linux/i2c.h 文件 中 ， 内 容 如 下 : 
示例 代码 61.1.2.1 i2c_client 结构 体 





Zi se 120 Clismt i 














218 unsigned short flags; /* 标志 "i 
219 unsigned short addr; /* ASH, 7 位 ， 存 在 低 7 位 */ 
297) char name[I2C NAME SIZE]; Jes mua wf 
223 struct i2c adapter *adapter; /* 对 应 的 I2C 适配器 */ 
224 struct device dev; /* 设备 结构 体 "m 
225 iE Aea /* 中 断 ay 
226 struct list head! detectec; 

ASO E 


一 个 设备 对 应 一 个 i2c_client， 每 检测 到 一 个 DC 设备 就 会 给 这 个 PC 设备 分 配 一 个 
i2c client. 
2. i2c driver 结构 体 
i2c driver 类 似 platform. driver， 是 我 们 编写 I2C 设备 驱动 重点 要 处 理 的 内 容 ，i2c_driver 结 
构 体 定义 在 include/linux/i2c.h 文件 中 ， 内 容 如 下 : 
示例 代码 61.1.2.2 i2c. driver 结构 体 

















el Sue menl 








152 unsigned int class; 

16S 

164 /* Notifies the driver that a new bus has appeared. You should 
165 * avoid using this, it will be removed in a near future. 

166 BA 

167 sumi (vattech edeptsar) (ue i26 adeprter w) _ deprecated 

168 

LES /* Standard driver model interfaces */ 

170 int (*probe) (struct i2c client *, const struct i2c device id *); 
1E 730 ius (renove) (struct 12€ client *")g 

102) 

dS] /* driver model interfaces that don't relate to enumeration */ 
174 vorc) (0 sine ele mm) (struct 12€ elient =) p 

175 

176 /* Alert callback, for example for the SMBus alert protocol. 

TE 0g * The format and meaning of the data value depends on the 

qua > protocol Eon ehe SMBUS alert PErococol there isa smile nts 
TOTAS * of data passed as the alert response's low bit ("event 

180 sleagha 9 

181 vorc (edle) (struct i26 elim v, qwusiienwxeg! ime dawra) p 
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182 

183 /* a ioctl like command that can be used to perform specific 
184 * functions with the device. 

185 x 

186 e om (see ee e E E 


void *arg); 


187 

188 struct device driver driver; 

189 const struct i2c device id *id table; 

190 

JL Sl /* Device detection callback for automatic device creation */ 
192 inat  (Celeuwect) (struct i20 Client w, struct 20 Doar imtoo 2 7 
193 Glos ns ome non Elelss lois 

194 struct list head!) clients, 

JS. Pe 


第 170 行 ， 当 DC 设备 和 驱动 匹配 成 功 以 后 probe 函数 就 会 执行 ， 和 platform 驱动 一 样 。 

第 188 行 ，device_driver 驱动 结构 体 ， 如 果 使 用 设备 树 的 话 ， 需 要 设置 device driver 的 
of match table 成 员 变 量 ， 也 就 是 驱动 的 兼容 (compatible) 属 性 。 

第 189 行 ，id_table 是 传统 的 、 未 使 用 设备 树 的 设备 匹配 ID 表 。 

对 于 我 们 IC 设备 驱动 编写 人 来 说 ， 重 点 工作 就 是 构建 2c_driver， 构 建 完成 以 后 需要 向 
Linux 内 核 注 册 这 个 i2c driver. i2c driver 注册 函数 为 int i2c register driver， 此 函数 原型 如 下 : 




































































inti2c register driver(struct module *owner, 
struct i2c driver *driver) 
函数 参数 和 返回 值 含 义 如 下 : 


owner: 一 般 为 THIS MODULE。 

driver: 要 注册 的 ic driver. 

返回 值 ，0， 成 功 ， 负 值 ， 失 败 。 

另外 i2c_ add driver 也 常常 用 于 注册 i2c driver, i2c add driver 是 一 个 宏 ， 定 义 如 下 : 

示例 代码 61.1.2.3 i2c_add_driver Æ 

587 aefine 12c add driver(driver) \ 
588 12€ register driver (THIS MODULE, Criver) 

i2c add driver 就 是 对 i2c_register_driver 做 了 一 个 简单 的 封装 ， 只 有 一 个 参数 , 就 是 要 注册 
的 i2c driver. 

注销 DC 设备 驱动 的 时 候 需 要 将 前 面 注册 的 i2c driver 从 Linux 内 核 中 注销 掉 ， 需 要 用 到 
i2c del driver 函数 ， 此 函数 原型 如 下 : 

void i2c del driver(struct i2c driver —*driver) 

函数 参数 和 返回 值 含义 如 下 : 

driver: 要 注销 的 i2c_driver。 

BE: 无 。 

i2c_driver 的 注册 示例 代码 如 下 : 

示例 代码 61.1.2.4 i2c_driver 注册 流程 

1 /* i2c 驱动 的 probe 函数 */ 


2. Gratie int zzz Probel(struct i20 Client teli, 
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Const Eue 126 ceyvica abel wic) 


S 

4 /* 函数 具体 程序 */ 

5 return 0; 

6 ] 

7 

8 /* i2c 驱动 的 remove IRA. */ 


2 gnuacic ibmc ep3216c€ iwewwowe(situci i29 eliemut veliemty 
ig) 4 
T3 /* 函数 具体 程序 */ 





32 return 0; 

is 

14 

15 /* 传统 匹配 方式 ID 列表 */ 

l(& qgnEeNEILG eonse SUE 326) Glewabere ibel sex E 
qu uxo m. 

18 ü 

1» jg 

20 

21 /* 设备 树 匹 配 列表 */ 

272 Statio Const struct ot deyice id wx Oi matchi = q 
29 e onpa ti le 0 

24 /Sentinel /A 

25 yz 

26 

27 /* i2c 驱动 结构 体 */ 

20 tatie grruet 312 (8. dniver xox qghesbwues c d 
2 .probe = xxx probe, 

30 .remove = xxx remove, 

SHl .driver = ( 

S12 .owner — THIS MODULE, 

9 .name = "xxx", 

34 .of match table = xxx of match, 
35 }, 

36 .id table S xxx id, 

37 ] 

38 

39 /* 驱动 入 口 函 数 */ 

4/0. Stee ve dme me sexes male) 

41 { 

42 int ret = 0; 

43 


44 ret © i2c add driver(&xxx driver); 
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45 return ret; 

don) 

27 





48 /* WB DEAE */ 

4/9) geata voici ^ (exi ex Go (weno 

SE 

Sal i2c del driver(&xxx driver); 

521} 

SS 

54 module init(xxx init); 

55 module exit(xxx exit); 
第 16-19 fT, i2c device id， 无 设备 树 的 时 候 匹 配 ID 表 。 
第 22~25 行 ，of device id， 设 备 树 所 使 用 的 匹配 表 。 
第 28-37 fT, i2c driver, ^4 DC 设备 和 I2C 驱动 匹配 成 功 以 后 probe 函数 就 会 执行 ， 这 些 

和 platform 驱动 一 样 ，probe 函数 里 面 基本 就 是 标准 的 字符 设备 驱动 那 一 套 了 。 


















































61.1.3 DC 设备 和 驱动 匹配 过 程 


DC 设备 和 驱动 的 匹配 过 程 是 由 DC 核心 来 完成 的 ，drivers/i2c/i2c-core.c 就 是 DC 的 核心 
WS DC 核心 提供 了 一 些 与 具体 硬件 无 关 的 API 函数 ， 比 如 前 面 讲 过 的 : 

1、i2c_adapter 注册 /注销 函数 

inti2c add adapter(struct i2c adapter *adapter) 























inti2c add numbered adapter(struct i2c. adapter *adap) 

void i2c del adapter(struct i2c adapter * adap) 

2, i2c driver 注册 /注销 函数 

inti2c register driver(struct module *owner, struct i2c driver *driver) 

inti2c add driver (struct i2c driver *driver) 

void i2c del driver(struct i2c. driver *driver) 

设备 和 驱动 的 匹配 过 程 也 是 由 DC 总 线 完成 的 ，ZC 总 线 的 数据 结构 为 2c_bus_type， 定 义 
在 drivers/i2c/i2c-core.c 文件 ，i2c_bus type 内 容 如 下 : 

示例 代码 61.1.2.5 i2c_bus_type 总 线 

T56 struct bus typos 12e bus type < i 








28 . name Iq cU 


7.308 .match = i2c device match, 
T39 .probe = i2c device probe, 
740 .remove = i2c device remove, 
TIE .shutdown = i2c device shutdown, 
quam de 





match 就 是 DC 总 线 的 设备 和 驱动 匹配 函数 ， 在 这 里 就 是 i2c device match 这 个 函数 ， 此 
函数 内 容 如 下 : 





示例 代码 61.1.2.6 i2c_device_match 函数 
A57 Statie em (ue devica le struct 


device driver *drv) 
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458 { 

459 struct i26) Client velicnt = 12e verity lm (el 
460 SEE 126 GE EYE 

461 

462 aus (Ullum) 

463 return 0; 

464 

465 /* Attempt an OF style match */ 

466 if (of driver match device(dev, drv)) 

467 return |; 

468 

469 ESSET eme PES trema ces 

470 if (acpi driver match device(dev, drv)) 

471 return |; 

472 

473 driver S to i2c driver (drv); 

474 /* match on an id table if there is one */ 

475 a tag (deiyer->ic! table) 

476 return i2c match id(driver-»id table, client) !- NULL; 
477 

478 return 0; 

479 ) 





第 466 ÍT, of driver match device 函数 用 于 完成 设备 树 设 备 和 驱动 匹配 。 比 较 DC 设备 节 








点 的 compatible 属性 和 of device id 中 的 compatible 属性 是 否 相 等 ， 如 果 相 当 
设备 和 驱动 匹配 。 
第 470 行 ，acpi_driver match device 函数 用 于 ACPI 形式 的 匹配 。 











的 话 就 表示 DC 


第 476 ÍT, i2c_match id 函数 用 于 传统 的 、 无 设备 树 的 DC 设备 和 驱动 匹配 过 程 。 比 较 ZC 











设备 名 字 和 i2c_device_id 的 name 字段 是 否 相 等 ， 相 等 的 话 就 说 明 DC 设备 和 引 





61.2 I.MX6U 的 I2C 适配器 驱动 分 析 
上 一 小 节 我 们 讲解 了 Linux 下 的 12C 驱动 框架 , 重点 分 为 DC 适配器 驱动 和 





K 动 匹配 。 


DC 设备 驱动 ， 


其 中 IC 适配器 驱动 就 是 SOC 的 I2C 控制 器 驱动 。I2C 设备 驱动 是 需要 用 户 根据 不 同 的 DC 设 
备 去 编写 ， 而 I2C 适配器 驱动 一 般 都 是 SOC 厂商 去 编写 的 ， 比 如 NXP 就 编写 好 了 LMX6U 的 
I2C 适配器 驱动 。 在 imx6ull.dtsi 文件 中 找到 LMX6U 的 DC1 控制 器 节点 ， 节 点 内 容 如 下 所 示 : 









































示例 代码 61.2.1 I2C1 控制 器 节点 

















1 a2els i2e0021e0000 í 

2  d*address-cells = «1»; 

3  dsize-cells = «0»; 

4 compatible = "fsl,imx6ul-i2c", "fsl,imx21-i2c"; 
5 reg = <0x021a0000 0x4000>; 

6 Bin eee “ole SPL 3 TRO TER LOVEL HGE? 
3) clocks = «&clks IMX6UL CLK I2Cl»; 

8 status = "disabled"; 
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Sup 





重点 关注 cl 节点 的 compatible 属性 值 ， 因 为 通过 compatible 属性 值 可 以 在 Linux 源码 里 
面 找到 对 应 的 驱动 文件 .这 里 icl 节点 的 compatible 属 性 值 有 两 个 :“fsl,imx6ul-i2c” 和 “fsl,imx21- 
i2c” 在 Linux 源码 中 搜索 这 两 个 字符 串 即 可 找到 对 应 的 驱动 文件 。LMX6U 的 PC 适配器 驱动 
驱动 文件 为 drivers/i2c/busses/i2c-imx.c， 在 此 文件 中 有 如 下 内 容 : 

示例 代码 61.2.2 i2c-imx.c 文件 代码 段 
ese lnm el icl imz 126 Glewiewppxe| = d 
245 { 






























































246 :ame = "imxl-i2c", 

247 .driver data = (kernel ulong t)&imxl i2c hwdata, 

248 ha i 

249 ‘name = "imx21-i2c", 

250 .driver data = (kernel ulong t)&imx21 i2c hwdata, 

251 ees 

DE /* sentinel */ 

258 } 

254 ); 

255 MODULE DEVICE TABLE(platform, imx i2c devtype); 

256 

251 pratile gongt Struct Ot device ic i126 im: che esl S q 

259 d oGGumusenbiiole = Vzel, imzl=-1264, acara = Cubsbxll 126 meeer Iy 
259 { .compatible = "fsl,imx21-i2c", .data = &imx21 i2c hwdata, }, 
260 com = Viel wrGlI0-:26", Cetea = AVEO 12e we 
Ziani /nn 

262); 





263 MODULE DEVICE TABLE(of, i2c imx dt ids); 



































ILLIS, grtartie geriet plactorm oiva 126 iw: clever — | 
1120 .probe = i2c imx probe, 

2 .remove = i2c imx remove, 

3E) .driver = ( 

13D] .name = DRIVER NAME, 

1124 .owner — THIS MODULE, 

1125 Oi matcha table c3 i26 im: At 1de, 

1126 .pm = IMX I2C PM, 

1115277] m 

1128 .id table = imz i2c devtype, 

HZS Jp 

1130 

11L5/L aee sent —— 3Bgsbts 3,26. sxelego Ea) 

HB2 

HBS return platform driver register(&i2c imx driver); 
1134 } 
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1:11.55 gubsys inircceall(ize adei Tn LMLE) p 

1S6 

WSI gtatie void exit 126 adao iws Ex evoe) 

ISS 

SYS platform driver unregister(&i2c imx driver); 

1140 } 


1141 module exit(i2c edep mx exit); 

从 示例 代码 61.2.2 可 以 看 出 ，I.MX6U 的 DC 适配器 驱动 是 个 标准 的 platform 驱动 ， 由 此 
可 以 看 出 ， 虽 然 PC 总 线 为 别 的 设备 提供 了 一 种 总 线 驱 动 框架 ， 但 是 DC 适配器 却 是 platform 
驱动 。 就 像 你 的 部 门 老 大 是 你 的 领导 ， 你 是 他 的 下 属 ， 但 是 放 到 整个 公司 ， 你 的 部 门 老 大 却 也 
是 老板 的 下 属 。 

第 259 行 ,，“fsl,imx21-i2c” 属 性 值 ， 设 备 树 中 i2cl 节点 的 compatible 属性 值 就 是 与 此 匹配 
上 的 。 因 此 i2c-imx.e 文件 就 是 LIMX6U 的 IC 适配器 驱动 文件 。 

第 1120 行 ， 当 设备 和 驱动 匹配 成 功 以 后 i2c_imx probe 函数 就 会 执行 ，i2c_imx probe 函数 
就 会 完成 DC 适配器 初始 化 工作 。 

i2c imx probe 函数 内 容 如 下 所 示 ( 有 省 略 ): 

示例 代码 61.2.3 i2c_imx_probe 函数 代码 段 


9L nem: int 312) imz probe(struct platiorm device poles) 


























































































































om 
973 Const struct (OX Glewicge ic vot id e 
974 of match device(i2c imx dt ids, &pdev-»dev); 
215 Secut me Ue viZ Miey 
976 Struct TSOU vres; 
97r] struct imxi2c platform data *pdata - 
dev get platdata (&pdev-»dev); 
ITS: voici omen Se 
DNI ssh abre Ray 
980 dma addr t phy addr; 
orsa 
982 dev dbg(&pdev->dev, "<%s>\n", _ func_); 
983 
984 irq — platform get irq(pdev, 0); 
990 res = platform get resource (pdev, IORESOURCE MEM, 0); 
991 base = devm ioremap resource(&pdev-»dev, res); 
992 if (IS ERR(base)) 
993 return PTR ERR(base); 
994 
995 phy addr = (cma addr t)res-»start; 
996 i2c imx = devm kzalloc(&pdev-»dev, sizeof(*i2c imx), 
GFP KERNEL); 
SO es (Ua busy) 
998 return -ENOMEM; 
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91919 

1000 if (of id) 

WOO i2c imx-»hwdata = of id-»data; 

1002 else 

1003 i2c imx-»hwdata = (struct imx i2c hwdata *) 

1004 platform get device id(pdev)-»driver data; 

1005 

1006 yeu enim (olcibwtews serue t une 

1007 strlcpy(i2c imx-»adapter.name, pdev-»name, 


sizeof(i2c imx-»adapter.name)); 


1008 i2c imx-»adapter.owner — THIS MODULE; 

1009 i2c imx-»adapter.algo — &i2c imx algo; 

1010 i2c imx-»adapter.dev.parent = &pdev-»dev; 

1011 i2c imx-»adapter.nr = pdev-»id; 

1012 i2c imx-»adapter.dev.of node = pdev-»dev.of node; 
1013 i2c imx-»base = base; 

1014 


TOTS f= Gare X20 loek 9/ 
1016 i2c imx-»clk = devm Clk get(&pdev-»dev, NULL); 





1022 ret = Elk prepare enable(i2c imx-»clk); 

MOAT /* Request IRQ */ 

1028 ret = devm request irq(&pdev-»dev, irq, i2c imx isr, 
1029 IRQF NO SUSPEND, pdev-»name, i2c imx); 
OBS 人 


1036 init waitqueue head(&i2c imx-»queue); 


1038 /* Set up adapter data */ 
NOSS i2c set adapdata(&i2c imx-»adapter, i2c imx); 


1041 M= Ser wo elo eevee 2 
1042  i2c imx-»bitrate = IMX I2C BIT RATE; 
1043 ret = of property read u32(pdev-»dev.of node, 


1044 "clock-frequency", &i2c imx-»bitrate); 
1045 if (ret < 0 && pdata && pdata-»bitrate) 

1046 L2G abuss-odoabwdéeuete = > 

1047 


1048 /* Set up chip registers to defaults */ 
1049 imx i2c write reg(i2c imx-»hwdata-»i2cr ien opcode ^ I2CR IEN, 
1050 i2c imx, IMX I2C I2CR); 


T0531: imx i2c write reg(i2c imx-»hwdata-»i2sr clr opcode, i2c imx, 
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IMX I2C I2SR); 


1052 

1053 M= Aee T26 eoero "7/ 

1054 ret = i2c add numbered adapter (&i2c_imx->adapter) ; 
1055 ass (ew < 0» (qi 


1056 dev err (&pdev->dev, "registration failed\n"); 
OSY goto clk_disable; 

1058 ) 

1059 


1060 VES eet up platrorm driver data S/ 

1061 plattform set Crydete(pdev, i26 dix) g 
1062 clk disable unprepare(i2c imx-»clk); 
1070 /* Init DMA config if supported */ 
1071 i2c imx dma request(i2c imx, phy addr); 


BITES return 0; /* Return OK */ 


311075 ey ebiselolcs 
1076 clk disable unprepare(i2c imx-»clk); 
MOTY return ret; 


OY 
第 984 行 ， 调 用 platform get irq 函数 获取 中 断 号 。 








m 


第 990-991 行 ， 调 用 platform get resource 函数 从 设备 树 中 获取 DPC1 控制 器 寄存 器 物理 基 





地 址 ， 也 就 是 0X021A0000。 获 取 到 寄存 器 基地 址 以 后 使 用 devm_ioremap_resourc 
行内 存 映 射 ， 得 到 可 以 在 Linux 内 核 中 使 用 的 虚拟 地 址 。 
第 996 ÍT, NXP 使 用 imx_i2c_struct 结构 体 来 表示 LMX 系列 SOC 的 DC f 



































e 函数 对 其 进 


出 器 ， 这 里 使 








用 devm kzalloc 函数 来 申请 内 存 。 
第 1008-1013 ÍT, imx i2c struct 结构 体 要 有 个 叫做 adapter 的 成 员 变 量 ， 























adapter 就 是 


i2c adapter, 这 里 初始 化 i2c_adapter。 第 1009 行 设置 2c_adapter 的 algo 成 员 变 量 为 i2c_imx_algo， 





也 就 是 设置 i2c algorithm. 
第 1028-1029 行 ， 注 册 DC 控制 嚣 中断 ， 中 断 服务 函数 为 i2c_imx isro 





第 1042-1044 47, WEE. DC 频率 默认 为 IMX DC BIT RATE=100KHz， 如 果 设 备 树 节点 设 











置 了 “clock-frequency” 属 性 的 话 D2C 频率 就 使 用 clock-frequency 属性 值 。 
第 1049~1051 行 ， 设 置 12C1 控制 的 12CR 和 DSR 寄存 器 。 








第 1054 行 ， 调 用 i2c_add numbered adapter 函数 向 Linux 内 核 注 册 i2c_adapter。 








第 1071 行 ， 申 请 DMA， 看 来 LMX 的 DC 适配器 驱动 采用 了 DMA 方式 。 

i2c imx probe 函数 主要 的 工作 就 是 一 下 两 点 : 

QD、 初 始 化 i2c adapter， 设 置 i2c algorithm 为 i2c imx algo， 最 后 向 Lin 
i2c adapter. 

名 、 初 始 化 PC1 控制 器 的 相关 寄存 器 。 











ux 内 核 注 册 


i2c imx algo 包含 I2C1 适配器 与 DC 设备 的 通信 函数 master xfer, i2c imx algo 结构 体 定 





义 如 下 : 
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示例 代码 61.2.4i2c_imx algo 结构 体 

O5 Statie BüciwCIE ib2:€ algorithm 312 im: algo = q 

967 omae KESE —- i2c imx xfer, 

968 -Uneelonality  — i2e imez TUNGE, 

9G 





我 们 先 来 看 一 下 . functionality, functionality 用 于 返回 此 I2C 适 配器 支持 什么 样 的 通信 协议 ， 
在 这 里 functionality 就 是 i2c imx func 函数 ，i2c imx func 函数 内 容 如 下 : 
示例 代码 61.2.5 i2c. imx. func 函数 
Statie v32 126 imz iwume (Sue 126 adapter Jasper 


{ 





return I2C FUNC I2C | I2C FUNC SMBUS EMUL 
| I2C FUNC SMBUS READ BLOCK DATA; 





























重点 来 看 一 下 i2e imx xfer 函数 ， 因 为 最 终 就 是 通过 此 函数 来 完成 与 DC 设备 通信 的 ， 此 
函数 内 容 如 下 (有 省 略 ): 




















示例 代码 61.2.6 i2c_imx_xfer 函数 


S88 Statie imt 126 ims xiter (struct i260 adapter la 


889 Struct 12e meg mSS, Lmt TT) 

890 ( 

Sel unsigned int i, temp; 

892 int result; 

893 bool is lastmsg = false; 

894 struct imz 126 Struet i20 imz = 126 gert adepcarta(acapter) e 
895 

896 dey elieep((Culgie aimax-eaelegite.olew, "-csoum"yo — due Dp 
897 

898 人 

899 result = i2c imx start(i2c imx) 

900 if (result) 

901 goto fail0; 

902 

903 /* read/write data */ 

904 for (x —- 07 1 < num; 3**) f 

90/5 if (i --2 num - 1) 

906 is lastmsg = true; 

907 

908 if (i) { 

909 dev dbg(&i2c imx-»adapter.dev, 

910 E Tea c MT NN 

SLE temo = imz i20 reel reg(L26 Lm, IM IZG 12) P 
912 Eemeal= I2(CEt ENS 

Sur ime 12e write reg(temo, 126 imz, IMK T2C_ I2XCE p 
914 ie c2 3:28 imz bus busy(i2e imz, d» 
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915 if (result) 

916 goto fail0; 

917 ) 

918 dev dbg(&i2c imx-»adapter.dev, 

SS SEEEWSESSaOSEE ON ENG ^5 3)$ 

920 /* write/read data */ 

938 Pus (megsti - tlags C: I2(C M RD) 

939 result = i2c imx read(i2c imx, &msgs[i], is lastmsg); 
940 else ( 

941 if (i2c imx-»dma && msgs[i].len >= DMA THRESHOLD) 
942 result = i2c imx dma write(i2c imx, &msgs[i]):; 
943 else 

944 result = i2c imx write(i2c imx, &msgs[i]):; 

945 ) 

946 if (result) 

947 goto fail0; 

948 } 

949 

950 fail0: 

951 I= Stroo TE tms OTI HS CTS 

952 i2c imx stop(i2c imx); 

953 

954 dev dbg(&i2c imx-»-adapter.dev, "«$s» exit with: $s: SENAN, 
| EUR y 

DOE (se sut «Precio te Successamsg 

956 (result « 0) ? result : num); 

S5 return (result « 0) ? result : num; 

958} 





第 899 行 ， 调 用 i2c_imx start 函数 开启 DC 通信 。 

第 939 行 ， 如 果 是 从 DC 设备 读数 据 的 话 就 调用 ic_imx read 函数 。 

第 941-945 行 ,向 I2C 设备 写 数据 ， 如果 要 用 DMA 的 话 就 使 用 i2c_imx dma write 函数 来 
完成 写 数据 。 如 果 不 使 用 DMA 的 话 就 使 用 ic_imx_write 函数 完成 写 数据 。 

第 9521], D2C 通信 完成 以 后 调用 i2c_imx _stop 函数 停止 DC 通信 。 

i2c imx start, i2c imx read、i2c imx write 和 i2c imx stop 这 些 函 数 就 是 DC 寄存 器 的 有 具 
体操 作 函 数 ， 函 数 内 容 基 本 和 我 们 裸 机 篇 中 讲 的 PC 驱动 一 样 ， 这 里 我 们 就 不 详细 的 分 析 了 ， 
大 家 可 以 对 照 着 第 二 十 六 章 实验 自行 分 析 。 


61.3 RC 设备 驱动 编写 流程 


DC 适配器 驱动 SOC 厂商 已 经 营 我 们 编写 好 了 ， 我 们 需要 做 的 就 是 编写 具体 的 设备 驱动 ， 
本 小 节 我 们 就 来 学 习 一 下 DC 设备 驱动 的 详细 编写 流程 。 
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61.3.1 2C 设备 信息 描述 


1、 未 使 用 设备 树 的 时 候 
首先 肯定 要 描述 2C 设备 节点 信息 , 先 来 看 一 下 没有 使 用 设备 树 的 时 候 是 如 何在 BSP Hirn 
描述 DC 设备 信息 的 ， 在 未 使 用 设备 树 的 时 候 需 要 在 BSP 里 面 使 用 i2c_board_info 结构 体 来 描 
述 一 个 具体 的 PC 设备 。i2c_board_info 结构 体 如 下 : 

示例 代码 61.3.1.1 i2c_board_info 结构 体 
29/5 struct eo abeo d 






















































































296 char type[I2C NAME SIZE]; /* I2C 设备 名 字 */ 
297 unsigned short flags; /* 标志 */ 
298 unsigned short addr; /* I2C $&THMABE */ 
29D void *platform data; 

300 struct Qey archdarce en 

301 struct devices node oi mole 

302 struct fwnode handle *fwnode; 

303 abis ic, EG 

304 }; 


type 和 addr 这 两 个 成 员 变 量 是 必须 要 设置 的 ， 一 个 是 DC 设备 的 名 字 ， 一 个 是 DC 设备 的 
器 件 地 址 。 打 开 arch/arm/mach-imx/mach-mx27 3ds.c 文件 ， 此 文件 中 关于 OV2640 的 DC 设备 
信息 描述 如 下 : 








示例 代码 61.3.1.2 OV2640 的 I2C 设备 信息 


39/2 Statie struct 12E board inio nr27 30e 126 Cemera = i 
393 I2C BOARD INFO("ov2640", 0x30), 
39d ys 








示例 代码 61.3.1.2 中 使 用 I2C BOARD INFO 来 完成 mx27 3ds i2c camera 的 初始 化 工作 ， 

I2C BOARD INFO 是 一 个 宏 ， 定 义 如 下 : 

示例 代码 61.3.1.3 I2C. BOARD. INFO X 
316 derine I2C BOARD INFO(dev type, dev addr) i 
yug .type = dev type, .addr = (dev addr) 

可 以 看 出 ，I2C_BOARD INFO 宏 其 实 就 是 设置 2c_board info 的 type 和 addr 这 两 个 成 员 
变量 ， 因 此 示例 代码 61.3.1.2 的 主要 工作 就 是 设置 DC 设备 名 字 为 ov2640，ov2640 的 器 件 地 
址 为 0X30。 

大 家 可 以 在 Linux 源码 里 面 全 局 搜索 i2c_board info， 会 找到 大 量 以 i2c board info 定义 的 
I2C 设备 信息 ， 这 些 就 是 未 使 用 设备 树 的 时 候 I2C 设备 的 描述 方式 ， 当 采用 了 设备 树 以 后 就 不 
会 再 使 用 i2c_board_info 来 描述 PC 设备 了 。 

2、 使 用 设备 树 的 时 候 

使 用 设备 树 的 时 候 I2C 设备 信息 通过 创建 相应 的 节点 就 行 了 ， 比 如 NXP 官方 的 EVK 开发 
板 在 DCI 上 接 了 mag3110 NANTE, 因此 必须 在 i2cl 节点 下 创建 mag3110 子 节点 ， 然 
后 在 这 个 子 节点 内 描述 mag3110 这 个 蕊 片 的 相关 信息 。 打 开 imx6ull-14x14-evk.dts 这 个 设备 树 
文件 ， 然 后 找到 如 下 内 容 : 

















































































































示例 代码 61.3.1.4 mag3110 子 节点 
eT 
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2 clock-frequency = «100000»; 

S pinctrl-names = "default"; 

4 pinctrl-0 2 «&pinctrl i2c1»; 

5 status = "okay"; 

6 

qi mag311000e ( 

8 compatible = "fsl,mag3110"; 
9 reg = «0x0e»; 

10 position - «2»; 

11 D8 

200) 


第 7-11 行 ， 向 i2cl 添加 mag3110 子 节点 ， 第 7 行 “mag3110@0e” 是 子 节 点 名 字 ,“@” 




















后 面 的 “0e” 就 是 mag3110 的 PC 器 件 地 址 。 第 8 行 设置 compatible 


A^ 
第 


是 compatible 属性 和 reg 属性 的 设置 ， 一 个 用 于 匹配 驱动 ， 
































个 用 于 设置 器 件 地 址 。 




















61.3.2 DC 设备 数据 收发 处 理 流程 
在 61.1.2 小 节 已 经 说 过 了 , DC 设备 驱动 首先 要 做 的 就 是 初始 化 i2c_driver 并 


























属性 值 为 “fsl,mag3110”。 
9 行 的 reg 属性 也 是 设置 mag3110 的 器 件 地 址 的 ， 因 此 值 为 0x0e。I2C 设备 节点 的 创建 重点 





向 Linux 内 核 














注册 。 当 设备 和 驱动 匹配 以 后 i2c driver 里 








面 的 probe 函数 就 会 执行 ，probe 函数 里 

















用 所 做 的 就 



































是 字符 设备 驱动 那 一 套 了 。 一 般 需 要 在 probe 函数 里 























1 面 初始 化 PC 设备 ， 要 初始 化 PC 设备 就 


必须 能 够 对 I2C 设备 寄存 器 进行 读 写 操作 ， 这 里 就 要 用 到 i2c_transfer 函数 了 。i2c transfer 函数 


























最 终 会 调用 
i2c imx xfer 这 个 函数 。i2c_transfer 函数 原型 如 下 : 














int i2c transfer(struct i2c adapter *adap, 
struct i2c msg *msgs, 
int num) 
函数 参数 和 返回 值 含 义 如 下 : 








adap: 所 使 用 的 PC 适配器 ，i2c_client 会 保存 其 对 应 的 i2c_adapter。 
msgs: DC 要 发 送 的 一 个 或 多 个 消息 。 

num: 消息 数量 ， 也 就 是 msgs 的 数量 。 

返回 值 ， 负 值 ， 失 败 ， 其 他 非 负 值 ， 发 送 的 msgs 数量 。 

















DC 适配器 中 i2c_algorithm 里 面 的 master. xfer 函数 ， 对 于 LIMX6U 而 言 就 是 


我 们 重点 来 看 一 下 msgs 这 个 参数 ， 这 是 一 个 i2c_msg 类 型 的 指针 参数 ，I2C 进行 数据 收发 














说 E 
在 include/uapi/linux/i2c.h 文件 中 ， 结 构 体 内 容 如 下 : 
示例 代码 61.3.2.1 i2c_msg 结构 体 














sem ue E 3:2 megj i 








69 . ul6 addr; /* 从 机 地 址 mg 
70 . ule flage; /* 标志 s 
pt $define I2C M TEN 0x0010 
72 *define I2C M RD 0x0001 
EE *define I2C M STOP 0x8000 
74 *define I2C M NOSTART 0x4000 
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75 &define I2C M REV DIR ADDR 0x2000 
76 &define I2C M IGNORE NAK 0x1000 
73) *define I2C M NO RD ACK 0x0800 
78 $define I2C M RECV LEN 0x0400 
79 Tute Len; /* 消息 (本 msg) KE */ 
80 LH *buf; /* 消息 数据 xf 
81 b; 
使 用 i2c. transfer 函数 发 送 数据 之 前 要 先 构建 好 (2c msg. 4E 2c transfer 进行 2C 数据 收 
发 的 示例 代码 如 下 : 
示例 代码 61.3.2.2 I2C 设备 多 寄存 器 数据 读 写 
1 /* 设备 结构 体 */ 
2 SEEUEE mex dew d 
EL m 
4 void *private data; /* 私有 数据 ， 一 般 会 设置 为 12c_client */ 
5 HH 
6 
gg 
8  * Qdescription : 读 取 I2C 设备 多 个 寄存 器 数据 
9  * Qparam - dev : I2C 设备 
10 * (param - reg : 要 读 取 的 寄存 器 首 地 址 
JE. param eval : 读 取 到 的 数据 
12 * Qparam - len : 要 读 取 的 数据 长 度 
由 : 操作 结果 
14 7y 
15 gtatie int xx read regs (struct zxz Oev dey, ue reg; void wwe 
int len) 
16 { 
Ly HoE SEA 
18 Si ue Ee meg ssexer[L7 1] s 
19 Struct i12 Client en c (struct 12e Client wy 
dev-»private data; 
20 
n /* msg[0]， 第 一 条 写 消 息 ， 发 送 要 读 取 的 寄存 器 首 地 址 */ 
Q9 msg[0].addr = client-»addr; /* I2C 器 件 地 址 */ 
23 msg[0].flags = 0; /* 标记 为 发 送 数据 */ 
24 msg[0].buf = &reg; /* 读 取 的 首 地 址 s 
25 而 gl len = ils M reg RE an 
26 
2 /* msg[1]， 第 三 条 读 消 息 ， 读 取 寄 存 器 数据 */ 
28 msg[i].addr = client-»addr; /* I2C 器 件 地 址 */ 
29 msg[1].flags = I2C M RD; /* 标记 为 读 取 数据 */ 
30 msg[1].buf < val; /* 读 取 数据 缓冲 区  */ 
ET üunegl.lem 三 lem /* 要 读 取 的 数据 长 度 */ 
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32 

33 ret c3 12€ transiter(Client-Sadapter, weg. 295 
34 if(ret == 2) ( 

95 ret = 0; 

36 ) else ( 

S, ret = -EREMOTEIO; 

38 ) 

39 return ret; 

40 } 

41 

42 /* 


43 * Qdescription : 向 I2C 设备 多 个 寄存 器 写 入 数据 
44 * Qparam - dev : 要 写 入 的 设备 结构 体 

45 * (param - reg : 要 写 入 的 寄存 器 首 地 址 

46 * Qparam - val : 要 写 入 的 数据 缓冲 区 

47 * (param - len : 要 写 入 的 数据 长 度 


48 * QGreturn : 操作 结果 
人 号 
2 statie S32 xzxzxz WrLtS Tegs (struct zzz dey ev, ve reg, ve out, 

u8 len) 
SE 
52 us 256l 
ES SEruEet 12E meg meg? 
54 Struct 312€ Client en c (struct 126 Client 9) 

deyv- private dete, 

55 
56 biol e rege /* 寄存 器 首 地 址 */ 
59 memcpy (&b[1] ,buf, len); /* 将 要 发 送 的 数据 拷贝 到 数组 I my 
58 
59 msg.addr 2 client-»addr; /* I2C 器 件 地 址 n 
60 mego ilage e (Up /* 标记 为 写 数据 a 
61 
62 msg.buf — b; /* 要 发 送 的 数据 缓冲 区 s 
63 msg-len =s len + 1; /* 要 发 送 的 数据 长 度 A 
64 
65 returni eie eano (ene aprenen 
oe. n 








第 2~5 行 ,设备 结构 体 ,在 设备 结构 体 里 面 添加 一 个 执行 void 的 指针 成 员 变 量 private_data， 
此 成 员 变 量 用 于 保存 设备 的 私有 数据 。 在 DC 设备 驱动 中 我 们 一 般 将 其 指向 DC 设备 对 应 的 
i2c client. 

第 15-40 ÍT, xxx read regs 函数 用 于 读 取 I2C 设备 多 个 寄存 器 数据 。 第 18 行 定 义 了 一 个 
ic msg 数组 ，2 个 数组 元 素 ， 因 为 PC 读 取 数据 的 时 候 要 先 发 送 要 读 取 的 寄存 器 地 址 ， 然 后 再 
读 取 数 据 ， 所 以 需要 准备 两 个 i2c_msg。 一 个 用 于 发 送 寄 存 器 地 址 , 一 个 用 于 读 取 寄存 器 值 。 对 
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于 msg[0], 将 flags 设置 为 0, 表示 写 数据 。msg[0] 的 addr 是 I2C 设备 的 器 件 地 址 ，msg[0] 的 buf 

















成 员 变 量 就 是 要 读 取 的 寄存 器 地 址 。 对 于 msg[1], 将 flags LAX DC M RD. 表示 读 取 数 据 。 
msg[1] 的 buf 成 员 变 量 用 于 保存 读 取 到 的 数据 ，len 成 员 变量 就 是 要 读 取 的 数据 长 度 。 调 用 
i2c transfer 函数 完成 DC 数据 读 操作 。 
第 50~66 行 ，xxx_write_regs 函数 用 于 向 DIC 设备 多 个 寄存 器 写 数 据 ，I2C 写 操 作 要 比 读 操 

作 简 单一 点 ， 因 此 一 个 i2c_msg 即 可 。 数 组 b 用 于 存放 寄存 器 首 地 址 和 要 发 送 的 数据 ， 第 59 fT 
设置 msg 的 addr 为 DC 器 件 地 址 。 第 60 行 设置 msg 的 flags 为 0， 也 就 是 写 数据 。 第 62 行 设 
置 要 发 送 的 数据 ， 也 就 是 数组 b。 第 63 行 设置 msg 的 len 为 len+1， 因 为 要 加 上 一 个 字 节 的 寄 
存 器 地 址 。 最 后 通过 2c transfer 函数 完成 向 I2C 设备 的 写 操作 。 

另外 还 有 两 个 API 函 数 分 别 用 于 I2C 数据 的 收发 操作 , 这 两 个 函数 最 终 都 会 调用 i2c_transfer。 
首先 来 看 一 下 DC 数据 发 送 函 数 ic master send， 函 数 原型 如 下 : 


inti2c master send(const struct i2c_client "client, 













































































const char *buf, 
int count) 
函数 参数 和 返回 值 含 义 如 下 : 


client: I2C 设备 对 应 的 i2c_client。 

buf: 要 发 送 的 数据 。 

count: 要 发 送 的 数据 字 节 数 ， 要 小 于 64KB， 以 为 2c_msg 的 len 成 员 变 量 是 一 个 ul16( 无 
符号 16 位 ) 类 型 的 数据 。 

返回 值 : 负 值 ， 失 败 ， 其 他 非 负 值 ， 发 送 的 字 节 数 。 

DC 数据 接收 函数 为 2c_master recv， 函 数 原型 如 下 : 


inti2c master recv(conststructi2c client *client, 











char *buf, 
int count) 
函数 参数 和 返回 值 含义 如 下 : 


client: I2C 设备 对 应 的 i2c_client。 

buf: 要 接收 的 数据 。 

count: 要 接收 的 数据 字 节 数 ， 要 小 于 64KB， 以 为 2c_msg 的 len 成 员 变 量 是 一 个 ul16( 无 
符号 16 位 ) 类 型 的 数据 。 

返回 值 : 负 值 ， 失 败 ， 其 他 非 负 值 ， 发 送 的 字 节 数 。 

关于 Linux 下 DC 设备 驱动 的 编写 流程 就 讲解 到 这 里 ， 重 点 就 是 i2c_ msg 的 构建 和 
i2c_transfer 函数 的 调用 ， 接 下 来 我 们 就 编写 AP3216C 这 个 PC 设备 的 Linux 驱动 。 


61.4 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 26.2 小 节 即 可 。 


61.5 实验 程序 编写 
本 实验 对 应 的 例 程 路 径 为 : 开发 板 光盘 -> 2、Linux 驱动 例 程 -> 21 iic. 












































61.5.1 修改 设备 树 
1. IO 修改 或 添加 
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首先 肯定 是 要 修改 IO，AP3216C 用 到 了 I2C1 接口 ，LMX6U-ALPHA 开发 板 上 的 I2C1 接 
口 使 用 到 了 UARTA TXD 和 UART4 RXD, 因此 肯定 要 在 设备 树 里 面 设 置 这 两 个 IO。 如 果 要 用 
到 AP3216C 的 中 断 功能 的 话 还 需要 初始 化 AP_ INT 对 应 的 GIOI IO01 这 个 ID， 本 章 实验 我 们 
不 使 用 中 断 功 能 。 因 此 只 需要 设置 UART4 TXD 和 UART4 RXD 这 两 个 IO，NXP 其 实 已 经 将 
他 这 两 个 IO 设置 好 了 ， 打 开 imx6ull-alientek-emmc.dts， 然 后 找到 如 下 内 容 : 

示例 代码 61.5.1.1 pincttl_i2c1 子 节点 


c 













































































l jpabeweuesel T1261 i2eles 1 

2 fsl,pins - « 

3 MX6UL PAD UART4 TX DATA I2C1 SCL 0x4001b8b0 
4 MX6UL PAD UART4 RX DATA I2C1 SDA 0x4001b8b0 
5 2; 

ends 


pinctrl i2cl 就 是 12C1 的 IO 节点 ， 这 里 将 UART4 TXD 和 UART4 RXD 这 两 个 IO 分 别 
复 用 为 DZC1_SCL 和 I2C1_SDA， 电 气 属性 都 设置 为 0x4001b8b0。 

2、 在 i2c1 节点 追加 ap3216c 子 节点 

AP3216C 是 连接 到 DPC1 上 的 ， 因 此 需要 在 icl 节点 下 添加 ap3216c 的 设备 子 节点 ， 在 


imx6ull-alientek-emmc.dts 文件 中 找到 i2c1l 节点 ， 此 节点 默认 内 容 如 下 : 
示例 代码 61.5.1.2 i2c1 子 节点 默认 内 容 




















— 

















1 &i2cl ( 

2 clock-frequency = <100000>; 

B pinctrl-names = "default"; 

4 pinctrl-0 2 «&pinctrl i2c1»; 

5 status = "okay"; 

6 

7 mag3110@0e { 

8 compatible = "fsl,mag3110"; 
9 reg = «0x0e»; 

10 position = «2»; 

ils }; 

12 

13 fxls847101e ( 

14 compatible - "fsl,fxls8471"; 
155 reg = «0Oxle»; 

16 position = «0»; 

iy, interrupt-parent = <&gpio5>; 
18 interrupts = «0 8»; 

19 ] 

2007 


第 2 1T, clock-frequency 属性 为 PC 频率 ， 这 里 设置 为 100KHz。 
第 4 行 ，pinctrl-0 属性 指定 DC 所 使 用 的 IO 为 示例 代码 61.5.1.1 中 的 pinctrl. i201 子 节 
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第 7~11 行 ，mag3110 是 个 磁力 计 ，NXP 官方 的 EVK 开发 板 上 接 了 mag3110， 因 此 NXP 
在 i2cl 节点 下 添加 了 mag3110 这 个 子 节点 。 正 点 原子 的 LIMX6U-ALPHA 开发 板 上 没有 用 到 
mag3110， 因 此 需要 将 此 节点 删除 掉 。 

第 13~19 行 ，NXP 官方 EVK 开发 板 也 接 了 一 个 fxls8471,. IE UBL T] LMX6U-ALPHA 
开发 板 同样 没有 此 器 件 ， 所 以 也 要 将 其 删除 掉 。 









































将 i2cl 节点 里 面 原 有 的 mag3110 和 fx188471 这 两 个 2C 子 节点 删除 ， 然 后 添加 ap3216c 
子 节点 信息 ， 完 成 以 后 的 i2cl 节点 内 容 如 下 所 示 : 
示例 代码 61.5.1.3 添加 ap3216c 子 节点 以 后 的 i2cl 节点 



































1 R33 2c 

2 clock-frequency = «100000»; 
3 pinctrl-names = "default"; 

4 er 0 着 三 是 <Somimie ree 
5 status - "okay"; 

6 

7 ap3216c81le ( 

8 compatible = "alientek,ap3216c"; 
9 reg = «0xie»; 

10 2 

DIS 








78 711, ap3216c 子 节 点 ，@ 后 面 的 “le” 是 ap3216c 的 器 件 地 址 。 

第 8 行 ， 设 置 compatible 值 为 “alientek,ap3216c”。 

第 9 行 ，reg 属性 也 是 设置 ap3216c 器 件 地 址 的 ， 因 此 reg 设置 为 0xle。 

设备 树 修改 完成 以 后 使 用 “make dtbs” 重 新 编译 一 下 ， 然 后 使 用 新 的 设备 树 启 动 Linux 内 
核 。/sys/bus/i2c/devices 目录 下 存放 着 所 有 DC 设备 ， 如 果 设 备 树 修改 正确 的 话 ， 会 在 
/sys/bus/i2c/devices 目录 下 看 到 一 个 名 为 “0-001e” 的 子 目录 ， 如 图 61.5.1.1 所 示 : 

/sys/bus/i2c/devices # ls 

0-001e 1-001a 1-003c i2c-0  i2c-1 
图 61.5.1.1 当前 系统 DC 设备 

图 61.5.1.1 中 的 “0-001e” 就 是 ap3216c 的 设备 目录 ,“1le” 就 是 ap3216c 器 件 地 址 。 进 入 
0-001e 目录 , 可 以 看 到 “name” 文 件 , name 问 价 就 保存 着 此 设备 名 字 , 在 这 里 就 是 “ap3216c”， 
如 图 61.5.1.2 所 示 : 


/sys/bus/i2c/devices # cat 0-001e/name 
ap3216c 
/sys/bus/i2c/devices £ lg 


图 61.5.1.2 ap3216c 器 件 名 字 













































































61.5.2 AP3216C 驱动 编写 


新 建 名 为 “21 iic” 的 文件 夹 ， 然 后 在 21 iic 文件 夹 里 面 创 建 vscode 工程 ， 工 作 区 命名 为 

“iic”。 工 程 创 建 好 以 后 新 建 ap3216c.c 和 ap3216creg.h 这 两 个 文件 ，ap3216c.c 为 AP3216C 的 
驱动 代码 , ap3216creg.h 是 AP3216C 寄存 器 头 文件 。 先 在 ap3216creg.h 中 定义 好 AP3216C 的 寄 
存 器 ， 输 入 如 下 内 容 ， 





























示例 代码 61.5.2.1 ap3216creg.h. 文件 代码 段 
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#ifndef AP3216C H 
$define AP3216C H 


/汪汪 业 大 火炎 类 大 火炎 类 大 火炎 类 大 类 类 类 大 类 类 类 大 类 类 类 大 类 类 类 大 类 类 类 大 类 类 大 大 大大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 


ND CO OY Vv ?9 


BEEFPEPPPP pp FF 
0 GE CHE HS GONE SOS ERI C 


FS N D 
w wU o = 


e a I NY SCIES CR ES 


Mo 


e nBoH HH HdBHd Hd 
os 


Copyright © AILIENIEE CO. SIEG 


XE 
作者 
版 本 
描述 
其 他 
论坛 


日 志 











大 大 大 类 火炎 火炎 火炎 火炎 类 类 火炎 火炎 火炎 类 大火 类 火炎 火炎 类 类 类 类 大大 类 类 大大 类 类 火炎 炎炎 火炎 大大 大大 大 大 大 大 大 类 大大 类 大 大 类 类/ 














ap3216creg.h 
s Jc pu al 
E Wb O 


: AP3216C 寄存 器 地 址 描述 头 文件 


i 


www .openedv.com 


使 正点 原子 


论坛 :www.opendev.com 


: 初版 V1.0 2019/9/2 左 忠 凯 创 建 


/* AP3316C AES */ 

#define AP3216C SYSTEMCONG 
*define AP3216C INTSTATUS 
*define AP3216C INTCLEAR 
*define AP3216C IRDATALOW 
ddefine AP3216C IRDATAHIGH 
#define AP3216C_ALSDATALOW 
#define AP3216C ALSDATAHIGH 
*define AP3216C PSDATALOW 
ddefine ABEI2LOC PSDATARILIGH 


fendif 


ap3216creg.h 没什么 好 讲 的 ， 就 是 一 些 寄存 器 宏 定 义 。 然 后 在 ap3216c.c 输入 如 下 内 容 : 


#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 























0x00 
0X01 
0x02 
0x0A 
O0x0B 
0x0C 
0X0D 
OXOE 
OXOF 


ys 
/ * 
/ * 
/ * 
/ * 
/* 
Js 
/ * 
/ * 


配置 寄存 器 

中 断 状 态 寄存 器 
中 断 清 除 寄存 器 
IR 数据 低 字 区 

IR 数据 高 字 节 

ALS 数据 低 字 节 
ALS 数据 高 字 节 
PS 数据 低 字 节 

PS 数据 高 字 节 


示例 代码 61.5.2.2 ap3216c.c 文件 代码 段 


<linux/types.h> 
<linux/kernel.h> 
<linux/delay.h> 
<linux/ide.h> 
«linux/init.h» 
<linux/module.h> 
X«linux/errno.h» 
«linux/gpio.h» 
«linux/cdev.h» 


«linux/device.h» 








«linux/of gpio.h» 
Xlinux/semaphore.h» 
X«linux/timer.h» 
«linux/i2c.h» 
«asm/mach/map.h» 
«asm/uaccess.h» 


«asm/io.h» 
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18 4include "ap3216creg.h" 


19 /大 大 大 大 炎炎 炎炎 炎炎 炎炎 火炎 炎炎 炎炎 炎炎 火炎 大 火炎 大 大 火炎 炎炎 大 炎炎 大 大 大 大 大 大 大大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 


20 Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 








2i GS ee 

22 Tp : 左 忠 凯 

23 版 本 TO 

24 描述 : AP3216C 驱动 程序 

25 其 他 E 

26 TAZ : www.openedv.com 

EE : 初版 V1.0 2019/9/2 左 忠 凯 创建 

28 类 类 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 火炎 类 大 火炎 火炎 类 大 类 大 火炎 类 大 类 大 类 类 类 大 大 大 类 大 大 大 大 大 类 大 类 大 类/ 
25) jetine AMPSZIGC CNT il 

30 4define AP3216C NAME Up" 

nl 

32, gnasolcE Sp32166 Cev | 

33 dev t devid; /* 设备 号 S 
34 struct Golew colew a edev wf 
35 struct class *class; /* 3& */ 
36 struct device *device; /* 设备 */ 
E struct device node *nd; /* 设备 节点 d 
38 int major; /* 主 设备 号 n 
39 void *private data; /* 私有 数据 X 
40 unsigned short ir, als, ps; /* —^OJtf&ERAE */ 
Aq ys 

42 

45, oetatic struct eps2lee tev ep321Gcokewp 

44 

45 人 

46  * Qdescription  : 从 ap3216c 读 取 多 个 寄存 器 数据 

47  * Qparam - dev : ap3216c 设备 


48 * (üiparam - reg : “要 读 取 的 寄存 器 首 地 址 

49 * (üiparam - val : ” 读 取 到 的 数据 

50 * Qparam - len  : 要 读 取 的 数据 长 度 

sA * (uireturn : 操作 结果 

GA cu 

55 ptatie em iegs(stuct eap32l6ce deyr voew, UB reg, 


vordi Avom ibm Jie) 


EP E. 

55 Ine tety 

56 otruce 12e msg meghal? 

97 struct 126 llent welient = (struct i26 Client =) 
dev-»private data; 

58 
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59 /* msg[0] 为 发 送 要 读 取 的 首 地 址 */ 

60 msg[0].addr = client-»adàr; /* ap3216c 地 址 */ 
61 msg[0].flags = 0; /* 标记 为 发 送 数据 a 
62 msg[0].buf = &reg; /* 读 取 的 首 地 址 */ 
63 msg[0].len = 1; e reg RÈ S 
64 

65 /* msg[1] 读 取 数 据 */ 

66 msg[1] .addr = client->addr; /* ap3216c Jh */ 
67 msg[1].flags = I2C M RD; /* 标记 为 读 取 数 据 */ 
68 msg[1].buf = val; /* 读 取 数据 缓冲 区  */ 
69 megi -icn = lenp /* 要 读 取 的 数据 长 度 */ 
70 

qal rekt = i12 transier(elient->adeapter, meg, 2) p 

TA if (ret == 2) { 

TS ret = 0; 

74 ) else ( 

T5 printk("i2c rd failed-$d reg-$06x len-$dWMn",ret, reg, len); 
76 JE 

T } 

78 return ret; 

"ye -3 

80 

Bi Je 

82 * Qdescription : 向 ap3216c 多 个 寄存 器 写 入 数据 

83  * @param - dev : ap3216c 设备 


84  * (iparam - reg : ”要 写 入 的 寄存 器 首 地 址 

85 * @param - val  : 要 写 入 的 数据 缓冲 区 

86 * @param - len : 要 写 入 的 数据 长 度 

87 * Qreturn 3 操作 结果 

Se = 

99 etaric S32 sp32l6óe write regs(str uct sp3216e dev elew, vue reg, 
u8 *buf, u8 len) 


90 ( 

eu ue ies 

92 Struct 126 meg mege 

93 prruet 26 client weliesnt S (Struct i20 Client s) 
dev-»private data; 

94 

95 biol = reg; /* 寄存 器 首 地 址 w 

96 memcpy (&b [1] ,buf, len) ; /* 将 要 写 入 的 数据 拷贝 到 数组 p E —*/ 

9 

98 msg.addr 2 client-»addr; /* ap3216c 地 址 8 

99 meg ilags e Ug /* 标记 为 写 数据 A 
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100 

101 moo Dur = b; /* 要 写 入 的 数据 缓冲 区 

102 msg.len = len + 1; /* 要 写 入 的 数据 长 度 d 

103 

104 return eier oneen (en eaae ap MT c MNT 

ios i 

106 

WON 

108 * @description : WW ap3216c 指定 寄存 器 值 ， 读 取 一 个 寄存 器 

109 * Qparam - dev : ap3216c 设备 

110 * Qparam - reg o EH 

Wa e Ee : 读 取 到 的 寄存 器 值 

dbz my 

ils gteatie ulinmee ena Stes eae (muvee "elew, 

u8 reg) 

114 { 

iBS u8 data = 0; 

116 

33,7) ep32166 reac. regs (dev, reg, cesa, ip 

118 return data; 

3S) 

12/0) FIE (0) 

TZ struct 32: lient ein = (struct 126 Client ) 
dev-»private data; 

11272 return i2c smbus read byte data(client, reg); 

123 #endif 

124 ) 

125 

Lg. ss 

127 * QGdescription  : [Hap3216c THESES E AÍJEXEBUMH. 5S —^ 3 4:8 

128 * Qparam - dev : ap3216c 设备 

129 * (param reg : €'5Sm ES 

JESX0). aran datak: 要 写 入 的 值 

131 * GQGreturn : Jii 

dS wy 

1553 tetic vorc! eqp32160 write ireg(struct sps216c0 dey “eev, US ie, 

u8 data) 

134 ( 

SS u8 buf = 0; 

BS buf = data; 

3517) ep321Ge write zes(ew, ie, Clo, 1)? 

138 ) 

1 SIS 
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lO oss 

141 * Qdescription  : 读 取 AP3216C 的 数据 ， 读 取 原 始 数据 ， 包 括 ALS,PS WIR, 

142 * :同时 打开 ALS, IR+PS 的 话 两 次 数据 读 取 的 间隔 要 大 于 112. 5ms 

jL43)  *« R param — abun : ir 数据 

144 * (param - ps PENIS 数据 

145 * @param - ps : als 数据 

146 * Qreturn 8 bs 

MaE S 

148 void ap3216c readdata(struct ap3216c dev *dev) 

149 ( 

150 unsigned char i =0; 

apal unsigned char buf[6]; 

T52 

153 /* 循环 读 取 所 有 传感器 数据 */ 

154 for(i = 0; i < 6; i++) 

155 { 

156 buf[i] = ap3216c read reg(dev, AP3216C IRDATALOW t i); 

do } 

158 

159 if(buf[0] & 0x80) /* IR OF 位 为 1, 则 数据 无 效 m 

160 dev-»ir = 0; 

161 else /* 读 取 IR 传感器 的 数据 E 

162 dev-»ir = ((unsigned short)buf[1] << 2) | (buf[0] & 0x03); 

163 

164 dev-»als = ((unsigned short)buf[3] << 8) | buf[2];/* ALS An */ 

GS 

166 if(buf[4] & 0x40) /* IR OF 位 为 1, 则 数据 无 效 */ 

E) dev-»ps = 0; 

168 else /* 读 取 PS 传感器 的 数据 z 

169 dev-»ps = ((unsigned short) (buf[5] & OX3F) << 4) | 
(buf[4] & OXOF); 

3038) 

ITE 

JE. pue 

173 * Qdescription  : 打开 设备 

174 * Qparam - inode: 传递 给 驱动 的 inode 

175 * Qparam - filp : 设备 文件 ，file 结构 体 有 个 叫做 Private data 的 成 员 变 量 

176 * 一 般 在 open 的 时 候 将 private data 指向 设备 结构 体 。 

177 * Qreturn : 0 成 功 ;其 他 失败 

je. Sx 

175) statie imt Guo3216€ cpxeuw((sticwieE inode vaumoele, struct tile arbe 

180 ( 

181 filp-»private data 三 &ap3216cdev; 
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182 

183 /* 初始 化 AP3216C */ 

184 ap3216c write reg(&ap3216cdev, AP3216C SYSTEMCONG, 0x04); 
185 mdelay(50);  /* AP3216C 复位 最 少 10ms */ 

186 ap3216c write reg(&ap3216cdev, AP3216C SYSTEMCONG, 0X03); 
LET return 0; 

188 ] 

189 

L9 se 

191 * Qdescription : 从 设备 读 取 数据 

192 * Qparam - filp : 要 打开 的 设备 文件 (文件 描述 符 ) 

193 * @param - buf  : 返回 给 用 户 空间 的 数据 缓冲 区 

EE parami em : 要 读 取 的 数据 长 度 

195 * Qparam - offt : 相对 于 文件 首 地 址 的 偏 移 

196 * Qreturn : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 

de y 


198 statie Seule t egp3210€ readl(strne iile virile, Char VSer Agui, 


TOS i 
200 
207 
202 
20S 


204 
205 
206 
20N 
208 
209 
210 
uli 
2152 jj 
2ug 


QUIAE 


2:415 
216 
zd 
Ze 


* 


* 


rA 


gire t Gu, loti © voti) 


short data[3]; 


long err = 0; 


struct eoS2I6e dew vdey = (struct aps32i66€ cw %) 
filp-»private data; 


ap3216c readdata (dev); 


data[9] 
data[:] 
data[2] = dev-»ps; 


dev-»ir; 


dev-»als; 


err = copy to user(buf, data, sizeof(data)); 


return 0; 


QGdescription  : 关闭 /释放 设备 
(param - filp : 要 关闭 的 设备 文件 (文件 描述 符 ) 
@return : 0 成 功 ;其 他 失败 


Zk ee zelesse(sitruct inode mele) 


220 ( 
201 
222] 


return 0; 
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2S 
224 
225 
225 
22) 
265 
DD 
230 
2 3l 
232 
233 
234 
295 
290 
2S 
238 
DESID 


240 
241 
242 
243 
244 


245 
246 


247] 
248 
249 
250 
ZION 
25 
2199 
254 
255 
256 
2:9 
258 
259) 
260 
Zl 


论坛 :www.opendev.com 


/* AP3216C 操作 函数 */ 





statie Const Siue ille gperations ep3216€ ope = d 
.owner — THIS MODULE, 
.open — ap3216c open, 
.read = ap3216c read, 
acecsee = See release, 
}; 
/ * 
* Qdescription : i2c 驱动 的 probe 函数 ， 当 驱动 与 
* 设备 匹配 以 后 此 函数 就 会 执行 
* (param - client : i2c 设备 
* Qparam - id : i2c 设备 ID 
* Qreturn : 0， 成 功 ;其 他 负 值 , 失败 
a 
statie imt egs32106 probe lstruct 126 Client telae, 


COn Struct 2€ elewuice wol wiel) 





/* 1、 构 建设 备 号 */ 
if (ap3216cdev.major) { 
ap3216cdev.devid = MKDEV(ap3216cdev.major, 0); 
regiegter chrdey region laps2leccdeyv Cevi, AP3216C CNT, 
AP3216C NAME); 








) else { 
alloc chrdev region(&ap3216cdev.devid, 0, AP3216C CNT, 
AP3216C NAME); 
ap3216cdev.major = MAJOR(ap3216cdev.devid); 





/* 2. Ba y */ 
cdev init(&ap3216cdev.cdev, &ap3216c ops); 
cdev add(&ap3216cdev.cdev, ap3216cdev.devid, AP3216C CNT); 





/* 3. 创建 类 */ 
ap3216cdev.class 5 class create(THIS MODULE, AP3216C NAME); 
if (IS ERR(ap3216cdev.class)) ( 

return PTR ERR(ap3216cdev.class); 

















/* 4. 创建 设备 */ 
ap3216cdev.device = device create(ap3216cdev.class, NULL, 
ap3216cdev.devid, NULL, AP3216C NAM 
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262 eus (lS muswet(euo3216ceesw.okaee)) E 

263 return PTR ERR(ap3216cdev.device); 

264 } 

265 

266 ap3216cdev.private data = client; 

267 

268 return 0; 

21698) 

270 

2 45 

272 = GQdescription : i2c 驱动 的 remove 函数 ， 移 除 i2c 驱动 此 函数 会 执行 
ArI na lnm : i2c RA 

274 * @return : 0, RJ; REFE, 失败 

gym wp 


25 tarie lnt ene (sue i2 delis vueliemy 
ou 
278 /* 删除 设备 */ 


279 cdev del(&ap3216cdev.cdev); 

280 unregister Chrdey reglon oO lle 
2o 

282 /* 注销 掉 类 和 设备 */ 

283 device destroy(ap3216cdev.class, ap3216cdev.devid); 

284 Elass destroy (eps21G6celew class) ? 

20b return 0; 

286} 

287 


288 /* fESLEEUI X ID PAR */ 
28/9 oratie Const otru i20 evices i0 ejp3216e icd = q 


290 ("alientek,ap3216c", 0], 
ZO {} 

2927 TR 

299 


294 /* 设备 树 匹 配 列表 */ 
29/5 een Shu (Gub device sel eps2166€ ot match = 4 


296 ( .compatible = "alientek,ap3216c" }, 
297 ( /* Sentinel */ ) 

290 

299 

300 /* i2c 驱动 结构 体 */ 

SOIL WEenEie struct i2 river sgs2i6e river = i 
B02 .probe - ap3216c probe, 

303 .remove = ap3216c remove, 


304 .driver 


{ 
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305 .owner — THIS MODULE 
306 .name = "ap3216c", 
307 .of match table = ap3216c of match, 
308 Ip 

309 aiel telle = eos216e abel, 





~ 


313 * @description : 驱动 入 口 函数 

314 * Qparam ES 

Suis 3 (üheetwsEm 8 E 

Suo 3 

SHLy stratie inr _ imit sues e aLe (voc) 
saga 


SEA ret = i2c add driver(&ap3216c driver); 


322 return ret; 


326 * @description : 驱动 出 口 函 数 

327 = Qparam s JE 

328 * Qreturn 3 下 

SO my 

5/510) orarie volel exit Scere (wes 
SS 

SO i2c del driver(&ap3216c driver); 


335 //* module i2 cheiwew (esie hex) */ 
SG 
3317 module (ee 
338 module exit(ap3216c exit); 
339 MODULE LICENSE("GPL"); 
340 MODULE AUTHOR ("zuozhongkai"); 

第 32-41 fT. ap3216c 设备 结构 体 ， 第 39 行 的 private data 成 员 变 量 用 于 存放 ap3216c 对 
应 的 i2c_client。 第 40 4TH] ir. als 和 ps 分 别 存储 AP3216C HY IR, ALS 和 PS 数据 。 

第 43 行 ,定义 一 个 ap3216c_dev 类 型 的 设备 结构 体 变 量 ap3216cdev。 

第 53~79 行 , ap3216c_read_regs 函数 实现 多 字 节 读 取 , 但 是 AP3216C 好 像 不 文 持 连续 多 字 
节 读 取 , 此 函数 在 测试 其 他 PC 设备 的 时 候 可 以 实现 多 给 字 节 连续 读 取 , 但 是 在 AP3216C 上 不 
能 连续 读 取 多 个 字 节 。 不 过 读 取 一 个 字 节 没有 问题 的 。 

第 89~105 行 ，ap3216c_write_regs 函数 实现 连续 多 字 节 写 操作 。 
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第 113-124 行 ，ap3216c_read_reg 函数 用 于 读 取 AP3216C 的 指定 寄存 器 数据 ， 用 于 一 个 寄 


存 器 的 数据 读 取 。 

第 133-138 fT, ap3216c write reg 函数 用 于 向 AP3216C 的 指定 寄存 器 写 入 数据 ,用 于 一 个 
寄存 器 的 数据 写 操作 。 

第 148~170 行 ， 读 取 AP3216C 的 PS、ALS 和 IR 等 传感器 原始 数据 值 。 

第 179~230 行 ， 标 准 的 支付 设备 驱动 框架 。 

第 239-269 1T, ap3216c probe 函数 ， 当 PC 设备 和 驱动 匹配 成 功 以 后 此 函数 就 会 执行 ， 和 
platform 驱动 框架 一 样 。 此 函数 前 面 都 是 标准 的 字符 设备 注册 代码 ， 最 后 面 会 将 此 函数 的 第 一 
个 参数 client 传递 给 ap3216cdev 的 private data 成 员 变 量 。 

第 289-292 行 ，ap3216c id LEX, i2c device id 类 型 。 用 于 传统 的 设备 和 驱动 匹配 ， 也 
就 是 没有 使 用 设备 树 的 时 候 。 

第 295~298 ÍF, ap3216c of match 匹配 表 ，of device id 类 型 ， 用 于 设备 树 设 备 和 驱动 匹 
配 。 这 里 只 写 了 一 个 compatible 属性 ， 值 为 “alientek,ap3216c”。 

第 301-310 fT. ap3216c driver 结构 体 变量 ，i2c driver 类 型 。 

第 317-323 行 ， 驱 动 入 口 函 数 ap3216c init， 此 函数 通过 调用 i2c add driver 来 向 Linux 内 
核 注 册 i2c_driver， 也 就 是 ap3216c_driver。 

第 330-333 行 ， 驱 动 出 口 函数 ap3216c_exit， 此 函数 通过 调用 i2c_del driver 来 注销 掉 前 
注册 的 ap3216c driver. 
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61.5.3. 编写 测试 APP 


新 建 ap3216cApp.c 文件 ， 然 后 在 里 面 输入 如 下 所 示 内 容 : 
示例 代码 61.5.3.1 ap3216cApp.c 文件 代码 段 


























Te el eo 

2 lude ms Ee 

3 #include "sys/types.h" 

4 dinclude "sys/stat.h" 

S me lude SyS ote IL cla" 

6 include "fcntl.h" 

mne ludens eonna 

8 4include "string.h" 

9 include Xpoll.h» 

10 finclude Xsys/select.h» 

11 £include «sys/time.h» 

12 #include «€signal.h» 

13 £$include «fcentl.h» 

IA J[ KCRCKCKCk kk kCkckCk kk kk ck kckckckckckckckckckckck ckck ckck ck ck ckck ckckckck ck ck ck ck ck ck ckck ck ck ck ck ck ck ck ck ck ck ck ck kk 
15 Copyright O ALIENTEK Co., Ltd. 1998-2029. All rights reserved. 
16 文件 名 : ap3216cApp.c 

I] E pst 

18 版 本 3 VL 

19 描述 : ap3216c 设备 测试 APP。 

20 其 他 TE 

21 HDA Ge 














1436 


LMX6U RAR Linux 驱动 开发 指南 O ERAF 











原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
207 MESES : www.openedv.com 

25 卓志 : 初版 V1.0 2019/9/20 左 忠 凯 创建 

24 KCKCKCKCKCkCkCk kk kCkckCkckCk ck k ck k ck k ck k kc k Ck k kck kck ck k kc k kc k k kck ck kckckckckckckckckckckckckckckckok X ke x kf 
25 

2. ffe 

A = Geeser ioraa : main 主 程序 

28 * Qparam - arge  : argv 数组 元 素 个 数 

29 * Qparam - argv  : 上 有 具体 参数 

30 * Greturn : 0 成 功 ;其 他 失败 

SA E 

SA dwe marane arge, (meus sercem hil) 

EIS 

34 INEA 

35 char *filename; 

36 unsigned short databuf[3]; 

m unsigned short ir, als, ps; 

38 int ret = 0; 

3239 

40 if (argc != 2) { 

41 printf("Error Usage! re 

42 return -l; 

43 } 

44 

45 filename = argv[!]: 

46 fd = open(filename, O RDWR); 

47 BEEN EEG EID NET 

48 printf("can't open file $sNrWMn", filename); 
49 return l; 

50 } 

si 

52 while (1) { 

53 ret = read(fd, databuf, sizeof(databuf)); 

54 sese = n 4 /* 数据 读 取 成 功 
55 iz Ss actaouslll; /* ir 传感器 数据 */ 
56 als e datelu | L] z} /* als 传感器 数据 */ 
57 ps = detalbut [i>i]; /* ps 传感器 数据 E 
58 prine Cin = oeil. EN es cols TOS oe Na s. Sire ale pa). 
59 } 

60 usleep (200000); /*100ms a 
61 } 

62 eclose lol); /* 关闭 文件 ul 
63 return 0; 

64 ] 
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ap3216cApp.c 文件 内 容 很 简单 ， 就 是 在 while 循环 中 不 断 的 读 取 AP3216C 的 设备 文件 ， 从 
而 得 到 ir. als 和 ps 这 三 个 数据 值 ， 然 后 将 其 输出 到 终端 上 。 








61.6 运行 测试 
61.6.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 
编写 Makefile 文件 ， 本 章 实验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 “ap3216c.o” Makefile 内 容 如 下 所 示 : 
示例 代码 61.6.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
Tel imz 4515159 2.15.0 dee alientelk 























4 obj-m :- ap3216c.o 

11 clean: 

12 S$(MAKE) -C S(KERNELDIR) Mz$ (CURRENT PATH) clean 
第 4 行 ， 设 置 obj-m 变量 的 值 为 “ap3216c.o”。 

输入 如 下 命令 编译 出 驱动 模块 文件 : 

make -j32 

编译 成 功 以 后 就 会 生成 一 个 名 为 “ap3216c.ko” 的 驱动 模块 文件 。 

、 编 译 测试 APP 

输入 如 下 命令 编译 ap3216cApp.c 这 个 测试 程序 : 

arm-linux-gnueabihf-gcc ap3216cApp.c -o ap3216cApp 

编译 成 功 以 后 就 会 生成 ap3216cA pp 这 个 应 用 程序 。 























N 





61.6.2 运行 测试 


将 上 一 小 节 编 译 出 来 ap3216c.ko 和 ap3216cApp 这 两 个 文件 拷贝 到 rootfs/lib/modules/4. 1.15 
目录 中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 。 输 入 如 下 命令 加 载 ap3216c.ko 这 个 驱 
动 模块 。 

depmod // 第 一 次 加 载 驱 动 的 时 候 需 要 运行 此 命令 

modprobe ap3216c.ko /加 载 驱动 模块 

当 驱 动 模块 加 载 成 功 以 后 使 用 ap3216cApp 来 测试 ， 输 入 如 下 命令 

Jap3216cApp /dev/ap3216c 

测试 APP 会 不 断 的 从 AP3216C 中 读 取 数据 ， 然 后 输出 到 终端 上 ， 如 图 61.6.2.1 所 示 : 




















/lib/modules/4.1.15 # ./ap3216cApp /dev/ap3216c 
ir = 0, als 30, pss 0 
ir = 0, als = 22, ps 3 0 
ir = 0, als = 18, ps = 0 
ir = 4, als = 21, ps = 0 
ir = 3, als = 20, ps = 0 
ir = 0, als = 22, ps 3 0 
ir = 3, als = 19, ps = 0 
ir = 0 als = 22; ps = D 
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图 61.6.2.1 获取 到 的 AP3216C 数据 
大 家 可 以 用 手电 简 照 一 下 AP3216C， 或 者 手指 靠近 AP3216C 来 观察 传感器 数据 有 没有 变 


化 。 
第 六 十 二 章 Linux SPI 驱动 实验 


上 一 章 我 们 讲解 了 如 何 编 写 Linux 下 的 I2C 设备 驱动 ，SPI 也 是 很 常用 的 一 个 串 行 通信 协 
议 ， 本 章 我 们 就 来 学 习 一 下 如 何在 Linux 下 编写 SPI 设备 驱动 。 本 章 实验 的 最 终 目的 就 是 驱动 
LMX6U-ALPHA 开发 板 上 的 ICM-20608 这 个 SPI 接口 的 六 轴 传 感 器 ， 可 以 在 应 用 程序 中 读 取 
ICM-20608 的 原始 传感器 数据 。 
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62.1 Linux 下 SPI 驱动 框架 简介 
SPI 驱动 框架 和 I2C 很 类 似 , 都 分 为 主机 控制 器 驱动 和 设备 驱动 , 主机 控制 器 也 就 是 发 SOC 


的 SPI 控 











制 器 接口 .比如 在 裸 机 篇 中 的 《第 二 十 七 章 SPI 实验 》, 我 们 编写 了 bsp_spi.c 和 bsp_spi.h 








这 两 个 文件 ， 这 两 个 文件 是 LMX6U 的 SPI 控制 器 驱动 ， 我 们 编写 好 SPI 控制 器 驱动 以 后 就 可 
以 直接 使 用 了 ， 不 管 是 什么 SPI 设备 ，SPI 控制 器 部 分 的 驱动 都 是 一 样 ， 我 们 的 重点 就 落 在 了 
种 类 繁多 的 SPI 设备 驱动 。 








"n 








62.1.1 SPI 主机 驱动 
SPI 主机 驱动 就 是 SOC 的 SPI 控制 器 驱动 ， 类 似 PC 驱动 里 面 的 适配器 驱动 。Linux 内 核 























使 用 spi master 表示 SPI 主机 驱动 ，spi_master 是 个 结构 体 ， 定 义 在 include/linux/spi/spi.h 文件 


中 ， 内 容 如 下 (有 缩减 ): 


示例 代码 62.1.1.1 spi master 结构 体 


wellmaisie= nm 


316 


struct device dev; 


struct ligt head l3 


s16 bus num; 


/* chipselects will be integral to many controllers; some others 
Pompe Se boere eee CELOS. 
P 


ul6 mu clm:isselect; 


/* some SPI controllers pose alignment requirements on DMAable 
* buffers; let protocol drivers know about these requirements. 
uy 


ule dma alignment; 


/* spi device.mode flags understood by this controller driver */ 


ul6 mode bite; 


(+ pitmask of supported bits per vord for transters "sf 


u32 bits per word mask; 
Ms meet S On TS Im Sr e TESI S OC 
u32 min Speet hz, 


u32 mex Speed nap 


/* other constraints relevant to this driver */ 
ul6 flags; 
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259 Ma oek anc mires cor SEIT iois loecikimne =/ 

360 spinlock t bus LloCk SpPimLlocky 

Cl struct mutex bus Lock ee 

Sd 


363 /* flag indicating that the SPI bus is locked for exclusive use */ 
3/64 bool bus lock flag; 


322 INE ("seus (struct spi device "spi 

S 

393 int (*transfer) (struct spi device *spi, 

394 struct spi message *mesg); 

434 int (*transfer one message) (struct spi master *master, 
435 struct spi message *mesg); 

462 ); 





第 393 ÍT, transfer 函数 ， 和 i2c algorithm 中 的 master xfer 函数 一 样 ， 控 制 器 数据 传输 函 

第 434 行 ，transfer one message 函数 ， 也 用 于 SPI 数据 发 送 ， 用 于 发 送 一 个 spi message; 
SPI 的 数据 会 打包 成 spi message， 然 后 以 队列 方式 发 送出 去 。 
也 就 是 SPI 主机 端 最 终 会 通过 transfer 函数 与 SPI 设备 进行 通信 , 因此 对 于 SPI 主机 控制 器 的 驱 
动 编写 者 而 言 transfer 函数 是 需要 实现 的 ， 因 为 不 同 的 SOC 其 SPI 控制 器 不 同 ， 寄 存 器 都 不 一 
FÉ. RI DC 适配器 驱动 一 样 ，SPI 主机 驱动 一 般 都 是 SOC 厂商 去 编写 的 ， 所 以 我 们 作为 SOC 的 
使 用 者 ， 这 一 部 分 的 驱动 就 不 用 操心 了 ， 除 非 你 是 在 SOC 原 广 工作 ， 内 容 就 是 写 SPI 主机 驱 
动 。 

SPI 主机 驱动 的 核心 就 是 申请 spi master， 然 后 初始 化 spi_master， 最 后 向 Linux 内 核 注 册 


spi master. 


1, spi master 申请 与 释放 


spi alloc master 函数 用 于 申请 spi master， 函 数 原型 如 下 : 
struct spi master *spi alloc master(struct device *dev, 





























= 







































































unsigned size) 
函数 参数 和 返回 值 含 义 如 下 : 
dev: 设备 ， 一 般 是 e 中 的 dev 成 员 变量 。 
size: 私有 数据 大 小 ， 可 以 通过 spi master get devdata 函数 获取 到 这 些 私 有 数据 。 
返回 值 ， 申 请 到 的 spi master. 
spi master 的 释放 通过 spi master put 函数 来 完成 ， 当 我 们 删除 一 个 SPI 主机 驱动 的 时 候 就 
需要 释放 掉 前 面 申请 的 spi master, spi master put 函数 原型 如 下 : 
void spi master put(struct spi master *master) 
函数 参数 和 返回 值 含 义 如 下 : 
master: 要 释放 的 spi master- 


返回 值 ; 无 。 
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2、spi master 的 注册 与 注销 

当 spi master 初始 化 完成 以 后 就 需要 将 其 注册 到 Linux 内 核 ，spi master 注册 函数 为 
spi register master， 函 数 原型 如 下 : 

intspi register master(struct spi master *master) 

函数 参数 和 返回 值 含 义 如 下 : 

master: 要 注册 的 spi master. 

返回 值 ，0， 成 功 ; 负 值 ， 失 败 。 

LMXS6U 的 SPI 主机 驱动 会 采用 spi_bitbang_start 这 个 API 函数 来 完成 spi_master 的 注册 ， 
spi bitbang start 函数 内 部 其 实 也 是 通过 调用 spi register master 函数 来 完成 spi master 的 注册 。 

如 果 要 注销 spi master 的 话 可 以 使 用 spi unregister master 函数 ， 此 函数 原型 为 

void spi unregister master(struct spi master *master) 

函数 参数 和 返回 值 含 义 如 下 : 

master: 要 注销 的 spi_master。 

BEE: 无。 

如 果 使 用 spi bitbang start 注册 spi master 的 话 就 要 使 用 spi bitbang stop 来 注销 掉 


spi master. 









































62.1.2 SPI 设备 驱动 


spi 设备 驱动 也 和 i2c 设备 驱动 也 很 类 似 ，Linux 内 核 使 用 spi. driver 结构 体 来 表示 spi 设备 
了 驱动， 我 们 在 编写 SPI 设备 驱动 的 时 候 需 要 实现 spi driver. spi driver 结构 体 定义 在 
include/linux/spi/spi.h 文件 中 ， 结 构 体 内 容 如 下 : 

示例 代码 62.1.1.2 spi. driver 结构 体 















































ien grruet prl criver i 


180 Const Struct spi device id vie table 

180 ASE (prabe) (struct spi device mpi) 

180 INE (remove) (struct Spl devices wS)? 

180 void (*shutdown) (struct spi device *spi); 
180 struct devica driver driver; 

1S0) he 


可 以 看 出 ，spi_ driver 和 i2c driver. platform driver 基本 一 样 ， 当 SPI 设备 和 驱动 匹配 成 功 
以 后 probe 函数 就 会 执行 。 

同样 的 ，spi_ driver 初始 化 完成 以 后 需要 向 Linux 内 核 注 册 ，spi driver. 注册 函数 为 
spi register driver， 函 数 原 型 如 下 : 

intspi register driver(struct spi driver *sdrv) 

函数 参数 和 返回 值 含 义 如 下 : 

sdrv: 要 注册 的 spi_driver。 

返回 值 : 0， 注 册 成 功 ; 赋值 ， 注 册 失 败 。 

注销 SPI 设备 驱动 以 后 也 需要 注销 掉 前 面 注 册 的 spi_driver， 使 用 spi unregister driver Fi 
数 完成 spi_driver 的 注销 ， 函 数 原型 如 下 : 

void spi unregister driver(struct spi driver *sdrv) 

函数 参数 和 返回 值 含 义 如 下 : 

sdrv: 要 注销 的 spi_driver。 
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返回 值 ， 无 。 
spi_driver 注册 示例 程序 如 下 : 
示例 代码 62.1.1.3 spi. driver 注册 示例 程序 














1 /* probe 图 数 */ 

2 en ei sy 
Sl 

4 /* 具体 函数 内 容 */ 

5 return 0; 

6 ] 

7 

8 /* remove Kt */ 

9 tatic int EROR d5eWwuüowe(üsitrrwet epi devices "ego 
LO 4 

ial /* 具体 函数 内 容 */ 

I2 return 0; 

Ta) 

14 /* FERIA ID j */ 

i5 otatic const Struct gpl devices id æ< abel) e» 4 
16 a O 

im ü 

18 y; 

T9 

20 /* 设备 树 匹 配 列表 */ 

2l Static Com struct ot Ceyice ic sex gie matea e d 
22 { .compatible = "xxx" }, 

23 ( /* Sentinel */ ] 

24 }; 

2:5 

26 /* SPI 驱动 结构 体 */ 

Be reese en 

28 .probe - xxx probe, 

29 .remove = xxx remove, 

30 .driver - ( 

Su .owner — THIS MODULE, 

22 .name = "xxx" 

33 .of match table - xxx of match, 

34 }, 

35 .id table - xxx id, 

36 p; 

37 

38 /* 驱动 入 口 函数 */ 

S6 otatie Ame _ imle (oe) 

40 { 
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41 return spi register driver(&xxx driver); 

42 ] 

43 





44 /* 驱动 出 口 函数 */ 
45 tee voel exit xe Gru (weno, 
46 ( 
47 Spi unregister river (Cez diver)? 
48 } 
49 
50 module init(xxx init); 
>i module exit (xz exit), 
第 1-36 ÍT, spi driver 结构 体 ， 需 要 SPI 设备 驱动 人 员 编写 ， 包 括 匹 配 表 、probe 函数 等 。 
和 i2c driver. platform driver 一 样 ， 就 不 详细 讲解 了 。 
第 39~42 行 ， 在 驱动 入 口 函 数 中 调用 spi register driver 来 注册 spi driver. 
第 45~48 行 ， 在 驱动 出 口 函 数 中 调用 spi unregister driver 来 注销 spi. driver. 



































62.1.3 SPI 设备 和 驱动 匹配 过 程 


SPI 设备 和 驱动 的 匹配 过 程 是 由 SPI 总 线 来 完成 的 , 这 点 和 platform. I2C 等 驱动 一 样 ，SPI 
总 线 为 spi_bus_type， 定 义 在 drivers/spi/spi.c 文件 中 ， 内 容 如 下 : 
示例 代码 62.1.3.1 spi_bus_type 结构 体 
isi SEEUSE bus type spi bus type = d 








i2 . name EJ eren 

1L 5:9; .dev groups = spi dev groups, 
134 .match = Spi match Qevice, 
T3 .uevent —- spi uevent, 

ISS 3g 





可 以 看 出 ，SPI 设备 和 驱动 的 匹配 函数 为 spi_match_device， 函 数 内 容 如 下 : 
示例 代码 62.1.3.2 spi_match_device 函数 
De gpi match deyvice(otruct Ceyvice Cey; 


struct deyics driver wekew) 


100 ( 

101 Const Strut Spi device vsp > to spi device (dev)? 
102 const Site Spi Gheiweus vecey > to spi driver(cdry)) p 
LOS 

104 /* Attempt an OF style match */ 

105 if (of driver match device(dev, drv)) 

106 return |; 

ROT 

108 ET 

109 if (acpi driver match device(dev, drv)) 

TO return |; 

UR UE 

ATE ii (SCEvV=>16 edle) 
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113 return !!spi match id(sdrv-»id table, spi); 

114 

115 return strcmp(spi-»modalias, drv-»name) == 0; 

13058. 


spi match device 函数 和 i2c. match. device 函数 的 对 于 设备 和 驱动 的 匹配 过 程 基本 一 样 。 

第 105 ÍF, of driver match device 函数 用 于 完成 设备 树 设备 和 驱动 匹配 。 比 较 SPI 设备 节 
点 的 compatible 属性 和 of device id 中 的 compatible 属性 是 否 相等 ,如 果 相 当 的 话 就 表示 SPI 设 
备 和 驱动 匹配 。 

第 109 行 ，acpi_driver_match_device 函数 用 于 ACPI 形式 的 匹配 。 

第 113 fT, i2c match id 函数 用 于 传统 的 、 无 设备 树 的 I2C 设备 和 驱动 匹配 过 程 。 比 较 DC 
设备 名 字 和 ic_device id 的 name 字段 是 否 相 等 ， 相 等 的 话 就 说 明 I2C 设备 和 驱动 匹配 。 

第 115 fT, LG spi device 中 modalias 成 员 变量 和 device driver 中 的 name 成 员 变 量 是 否 
相等 。 


62.2 L.MX6U SPI 主机 驱动 分 析 


和 I2C 的 适配器 驱动 一 样 ，SPI 主机 驱动 一 般 都 由 SOC 厂商 编写 好 了 ， 打 开 imx6ull.dtsi 
文件 ， 找 到 如 下 所 示 内 容 : 
示例 代码 62.2.1 imx6ull.dtsi 文件 中 的 ecspi3 节点 内 容 





































































































1 ecspi3: ecspi@02010000 ( 

2 faddress-cells = «1»; 

3 #size-cells = «0»; 

4 compatible = "fsl,imx6ul-ecspi", "fsl,imx5l-ecspi"; 
5 reg = <0x02010000 0x4000>; 

6 LS = IC SPI 55) TRO VEE DIVO s(nl>28 
E clocks = «&clks IMX6UL CLK EE > 

8 X&clks IMX6UL CLK ECSPI3»; 

9 clock-names = "ipg", "per"; 

10 dmas = «&sdma / 7 1>, «&sdma 8 7 2»; 

TI dma-names - "rx", "tx"; 

T2 status = "disabled"; 

I3 }; 





重点 来 看 一 下 第 4 行 的 compatible JE TEIH, compatible 属性 有 两 个 值 “fslimx6ul-ecspi” 和 

" fslimx51-ecspi ”, Æ Linux 内 核 源码 中 搜索 这 两 个 属性 值 即 可 找到 IMX6U 对 应 的 ECSPI(SPI) 

主机 驱动 。LMX6U 的 ECSPI 主机 驱动 文件 为 drivers/spi/spi-imx.c， 在 此 文件 中 找到 如 下 内 容 : 
示例 代码 62.2.2 spi_imx_driver 结构 体 

694 Statie gtruct plattozm devices ied cpi ims Cevtypelil = i 

595 { 
































696 .name = "imxl-cspi", 

697 .driver data = (kernel ulong t) &imxl cspi devtype data, 
698 bo d 

(999) -name = "imx21-cspi", 

700 .driver data = (kernel ulong t) &imx21 cspi devtype data, 
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713 Pr d 

714 .name = "imx6ul-ecspi", 

TANS .driver data = (kernel ulong t) &imxóul ecspi devtype data, 
mG be 4 

a /* sentinel */ 

TALS: } 

AS 

720 

TZ statice const struct of davice Td epi im: che icsi = d 

Z ( .compatible - "fsl,imxl-cspi", .data - 


Cimzil Cspi SEOS data, Iy 


728 ( .compatible = "fsl,imx6ul-ecspi", .data = 
&imx6ul ecspi devtype data, ], 

729 (xs emet esie Y 

TLSXO S 








731 MODULE DEVICE TABLE(of, spi imx dt ids); 


























15:98] Stere SCULE placon QOhesbweie SoL caps Criyer = i 
1 S) SI; .driver = ( 

1340 .name = DRIVER NAME, 

1341 .of match table = spi im: dt ids, 

1342 .pm = IMX SPI PM, 

1343 m 

1344 .id table = spi imx devtype, 

1345 .probe S spi imx probe, 

1346 .remove = spi imx remove, 

L347 F; 


1348 module platform driver(spi imx driver); 


第 714 fT. spi imx devtype 为 SPI 无 设备 树 匹 配 表 。 

第 721 行 ，spi imx dt ids 为 SPI 设备 树 匹 配 表 。 

第 728 行 ,“fLimx6ul-ecspi” 匹 配 项 ， 因 此 可 知 LMX6U 的 ECSPI 驱动 就 是 spi-imx.c 这 个 
文件 。 

第 1338-1347 ÍT, platform driver 驱动 框架 ， 和 I2C 的 适配器 驱动 一 行 ，SPI 主机 驱动 器 采 
用 了 platfom 驱动 框架 。 当 设备 和 驱动 匹配 成 功 以 后 spi imx probe 函数 就 会 执行 。 

spi imx probe 函数 会 从 设备 树 中 读 取 相应 的 节点 属性 值 ， 申 请 并 初始 化 spi master， 最 后 
调用 spi bitbang start 函数 (spi_bitbang start 会 调用 spi register master 函数 ) 向 Linux 内 核 注册 
spi master. 

对 于 LMX6U RY, SPI 主机 的 最 终 数据 收发 函数 为 spi_imx_transfer， 此 函数 通过 如 下 层 
层 调 用 最 终 实现 SPI 数据 发 送 : 


spi imx transfer 

































































-> spi imx pio transfer 


-> spi imx push 
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-> spl imx-^tx 

spi imx 是 个 spi imx data 类 型 的 机 构 指针 变量 ， 
数据 发 送 和 接收 函数 。LMX6U SPI 主机 驱动 会 维护 一 个 spi_imx_data 类 型 的 变量 spi imx, Jf 
且 使 用 spi_imx_setupxfer 函数 来 设置 spi imx BJ tx AI rx 函数 。 根 据 要 发 送 的 数据 数据 位 宽 的 不 


























同 ， 分 别 有 8 位 、16 位 和 32 位 的 发 送 函 数 ， 如 下 所 示 : 
spi imx buf tx u8 





spi imx buf tx ul6 


spi imx buf tx u32 


同班 














spi imx buf rx u$ 


spi imx buf rx ul6 


spi imx buf rx u32 
我 们 就 以 spi imx buf tx u8 这 个 函数 为 例 ， 看 看 ， 一 个 自 
spi-imx.c 文件 中 找到 如 下 所 示 内 容 : 


论坛 :www.opendev.com 


其 中 tx 和 rx 这 两 个 成 员 变 量 分 别 为 SPI 











EE， 也 有 8 位 、16 位 和 32 位 的 数据 接收 函数 ， 如 下 所 示 ; 











示例 代码 62.2.3 spi imx buf tx u8 xfj 


152 #define MXC SPI BUF TX(type) 


己 的 数据 发 送 是 怎么 完成 的 ， 在 





数 
\ 


15,9 static void spi im Dul tr TI 7STuct pi im ota fopi m) — Y 


154 ( 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 } 
166 





type val = 0; 
sus (SDL ime- E 4i 


val o (type *)spi imx-»tx buf; 
spi imx-»tx buf += sizeof(type); 


Spi imx-»count -= sizeof (type); 


writel(val, spi imx-»base + MXC CSPITXDATA); 


167 MXC SPI BUF RX(u8) 
168 MXC SPI BUF TX(u8) 





解 到 这 


其 他 的 tx 和 rx 函数 都 是 这 样 实现 的 ， 这 
里 ， 基 本 套路 和 I2C 的 适配器 驱动 程序 类 似 。 


























62.3 SPI 设备 驱动 编写 流程 


62.3.1 SPI 设备 信息 描述 
1, IO 的 pinctrl 子 节点 创建 与 修改 




















首先 肯定 是 根据 所 使 用 的 IO 来 创建 或 修改 pinctrl 子 节点 ， 











E) 
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b 
\ 
\ 
\ 
Y 
\ 


从 示例 代码 62.2.3 可 以 看 出 ，spi imx buf tx u8 函数 是 通过 MXC_ SPI BUF TX 宏 来 实现 


的 。 第 164 行 就 是 将 要 发 送 的 数据 值 写 入 至 














| ECSPI 的 TXDATA 寄存 器 里 面 去 , 这 和 我 们 SPI 裸 
机 实验 的 方法 一 样 。 将 第 168 行 的 MXC. SPI BUF_TX(u8) 展 开 就 是 spi imx buf tx u8 函数 。 
里 就 不 做 介绍 了 。 关 于 I.MX6U 的 主机 驱动 程序 就 讲 





这 个 没什么 好 说 的 ， 唯 独 要 注 
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意 的 就 是 检查 相应 的 IO 有 没有 被 其 他 的 设备 所 使 用 ， 如 果 有 的 话 需要 将 其 删除 掉 ! 
2、SPI 设备 节点 的 创建 与 修改 
采用 设备 树 的 情况 下 ，SPI 设备 信息 描述 就 通过 创建 相应 的 设备 子 节点 来 完成 ， 我 们 可 以 
































打开 imx6qdl-sabresd.dtsi 这 个 设备 树 头 文件 ， 在 此 文件 里 面 找到 如 下 所 示 内 容 : 
示例 代码 62.3.1.1 m25p80 设备 节点 














308 &ecspil ( 


309 fsl,spi-num-chipselects = «X1»; 
CUN) cs-gpios = «&gpio4 9 0»; 

Spb pinctrl-names = "default"; 

Sub pinctrl-0 = «&pinctrl ecspil»; 
SARS status = "okay"; 

314 

Ss flash: m25p80Q0 ( 

316 faddress-cells = «1»; 

E fsize-cells = «1»; 

SMS compatible = "st,m25p32"; 
S19 Spi-max-frequency = «20000000»; 
320 reg = <0>; 

EN ) 

SE a 





示例 代码 62.3.1.1 是 LMX6Q 的 一 款 板 子 上 的 一 个 SPI 设备 节点 ， 在 这 个 板子 的 ECSPI 接 
口上 接 了 一 个 m25p80， 这 是 一 个 SPI 接口 的 设备 。 

第 309 行 ， 设置 “fsl,spi-num-chipselects” 属 性 为 1， 表 示 只 有 一 个 设备 。 

第 310 行 ， 设置 “cs-gpios” 属 性 ， 也 就 是 片 选 信号 为 GPIO4 1009. 

第 311 íT, 设置 “pinctrl-names” 属 性 ， 也 就 是 SPI 设备 所 使 用 的 IO 名 字 。 

第 312 行 ， 设置 “pinctrl-0” 属 性 ， 也 就 是 所 使 用 的 IO 对 应 的 pinctrl 节点 。 

第 313 行 ， 将 ecspil 节点 的 “status” 属 性 改 为 “okay”。 

第 315~320 行 ，ecspil 下 的 m25p80 设备 信息 ， 每 一 个 SPI 设备 都 采用 一 个 子 节点 来 描述 
其 设备 信息 。 第 315 行 的 “m25p80@0” 后 面 的 “0” 表 示 m25p80 的 接 到 了 ECSPI 的 通道 0 
上 。 这 个 要 根据 自己 的 具体 硬件 来 设置 。 

第 318 行 ，SPI 设备 的 compatible 属性 值 ， 用 于 匹配 设备 驱动 。 

第 319 行 ,“spi-max-frequency” 属 性 设置 SPI 控制 器 的 最 高 频率 ， 这 个 要 根据 所 使 用 的 
SPI 设备 来 设置 ， 比 如 在 这 里 将 SPI 控制 器 最 高 频率 设置 为 20MHz。 

第 320 fT. reg 属性 设置 m25p80 这 个 设备 所 使 用 的 ECSPI 通道 ， 和 “m25p80@0” 后 面 的 
“0” 一 样 。 

我 们 一 会 在 编写 ICM20608 的 设备 树 节 点 信息 的 时 候 就 参考 示例 代码 62.3.1.1 中 的 内 容 即 
Hf. 













































































































































































62.3.2 SPI 设备 数据 收发 处 理 流程 

SPI 设备 驱动 的 核心 是 spi driver， 这 个 我 们 已 经 在 62.1.2 小 节 讲 过 了 。 当 我 们 向 Linux 内 
核 注 册 成 功 spi driver 以 后 就 可 以 使 用 SPI 核心 层 提供 的 API 函数 来 对 设备 进行 读 写 操作 了 。 
首先 是 spi transfer 结构 体 ， 此 结构 体 用 于 描述 SPI 传输 信息 ， 结 构 体 内 容 如 下 : 
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示例 代码 62.3.2.1 spi. transfer 结构 体 


GOS truce epl transter i 








604 / it's ok abr tx buf == sex buf (ighi?) 

605 * for MicroWire, one buffer must be null 

606 ^ louriers miget work wta (uns) mep siaglel) calls, euis 
607 Š spi message.is dma mapped reports a pre-existing mapping 
608 ks 

609 const void *tx buf; 

610 void *rx buf; 

611 unsigned len; 

612 

613 dma addr t tx dma; 

(91,44 dma addr t rx dma; 

Gils SEEUCE SG table t SG? 

616 Se SG teble rx 60? 

on 

618 unsigned come honge ii 

619 unsigned tx moitsg =? 

620 unsigned el 

621 pdetine SPI NBITS SINGLE («0L s oe EsanS tite/ 
622 4$define SPI NBITS DUAL (0550700252082 siete Ste ams fie 1 
623 detine SPI NBITS QUAD 0x04 /* A4bits transfer */ 
624 u8 bits per word; 

[9:215] ul6 delay usecs; 

626 u32 Ee cM 

621 

628 struct ligt head trenster list, 

929. DE 


第 609 ÍF, tx buf 保存 着 要 发 送 的 数据 。 
第 610 íF, rx buf 用 于 保存 接收 到 的 数据 。 
第 611 fT. len 是 要 进行 传输 的 数据 长 度 ，SPI 是 全 双 工 通信 ， 因 此 在 一 次 通信 中 发 送 和 
接收 的 字 节 数 都 是 一 样 的 ， 所 以 spi transfer 中 也 就 没有 发 送 长 度 和 接收 长 度 之 分 。 
spi transfer 需要 组 织 成 spi message, spi message 也 是 一 个 结构 体 ， 内 容 如 下 : 
示例 代码 62.3.2.2 spi_message 结构 体 


SO struct gpl message q 















































661 SEEUGE list neac transfers; 

662 

663 struct spi deyics  'UepL; 

664 

665 unsigned is dma mapped:!; 

678 /* completion is reported through a callback */ 
679 void (*complete) (void *context); 
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680 void *context; 
681 unsigned frame length; 
682 unsigned SGEua densin p 
683 int Gites P 
684 
685 /* for optional use by whatever driver currently owns the 
686 -spamessage aca OSWA Calla co SIS meom eller ettam 
687 = (ueonuelkeee(); that's the ejos. meser on en 
688 ai 
689 SEEUGE list neac queue; 
690 void VBIESHEG P 
(oou NB 
TE EHI spi. message 之 前 需要 对 其 进行 初始 化 ,spi_ message 初始 化 函数 为 spi message init, 
函数 原型 如 下 : 
void spi message init(struct spi message *m) 
函数 参数 和 返回 值 含义 如 下 : 
m: 要 初始 化 的 spi message. 
返回 值 : 无 。 


spi message 初始 化 完成 以 后 需要 将 spi transfer 添加 到 spi. message 队列 中 ， 这 里 我 们 要 月 























到 spi message add tail 函数 ， 此 函数 原型 如 下 ; 

void spi message add tail(struct spi transfer *t, struct spi. message *m) 

函数 参数 和 返回 值 含 义 如 下 : 

t: 要 添加 到 队列 中 的 spi_ transfer。 

m: spi_transfer 要 加 入 的 spi_message。 

返回 值 : 无。 

spi message 准备 好 以 后 既 可 以 进行 数据 传输 了 ， 数 据 传 输 分 为 同步 传输 和 异步 传输 ， 同 步 
传输 会 阻塞 的 等 待 SPI 数据 传输 完成 ， 同 步 传输 函数 为 spi_sync， 函 数 原型 如 下 : 


int spi sync(struct spi device *spi, struct spl. message *message) 


























函数 参数 和 返回 值 含 义 如 下 : 
spi: 要 进行 数据 传输 的 spi device. 











message: 要 传输 的 spi_message。 

返回 值 : 无 。 

异步 传输 不 会 阻塞 的 等 到 SPI 数据 传输 完成 , 异步 传输 需要 设置 spi_ message 中 的 complete 
成 员 变 量 ，complete 是 一 个 回调 函数 ， 当 SPI 异步 传输 完成 以 后 此 函数 就 会 被 调用 。SPI 异步 传 
输 函 数 为 spi_async， 函 数 原型 如 下 : 

int spi async(struct spi device *spi, struct spi message *message) 


函数 参数 和 返回 值 含义 如 下 : 





spi: 


















































要 进行 数据 传输 的 spi_device。 


message: 要 传输 的 spi_message。 


返回 值 : 无 。 





在 本 章 实验 中 , 我 们 采用 同步 传输 方式 来 完成 SPI 数据 的 传输 工作 , 也 就 是 spi_sync 函数 。 


综 上 所 述 ，SPI 数据 传输 步骤 如 下 : 
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(D、 申 请 并 初始 化 spi transfer， 设 置 sSpi transfer 的 tx buf 成 员 变 量 ，tx_buf 为 要 发 送 的 数 
据 。 然 后 设置 x buf 成 员 变 量 ，rx_buf 保存 着 接收 到 的 数据 。 最 后 设置 len 成 员 变量 ， 也 就 是 























要 进行 数据 通信 的 长 度 。 
C. fH] spi message init 函数 初始 化 spi_message。 
(S), fii Hl spi message add tail 函数 将 前 面 设置 好 的 spi transfer 添加 到 spi. message 队列 中 。 
QD. fH] spi sync 函数 完成 SPI 数据 同步 传输 。 
通过 SPI 进行 n 个 字 节 的 数据 发 送 和 接收 的 示例 代码 如 下 所 示 : 
示例 代码 62.3.2.3 SPI 数据 读 写 操作 

















M> SET SE i 
gtatic int Spil send(otruct Spi deyice wepi, We wout, ine len) 
{ 

int ret; 


Exe MES Pi messege ns 


stuet gpi rrenster t = d 
oE lowuE = OE, 


.len = len, 
}; 
spi message init(&m); [5 初始 化 spi message */ 
spi message add tail(t, &m);/* 将 spi transfer 添加 到 spi message 队列 */ 
ret = spi sync(spi, &m); /* 同步 传输 */ 


return ret; 


(t OPI SET 
statie int gpi ieeceuwe(sitrur spl device vespi, uS woui, imie Lem) 
{ 

IE LSE? 


Struct gpi messege m? 


struct gpi transter č 5 d 
.rx_buf = buf, 


.len = len, 
bg 
spi message init(&m); M 初始 化 spi message S 
spi message add tail(t, &m);/* 将 spi transfer 添加 到 spi message 队列 */ 
ret = spi sync(spi, &m); /* 同步 传输 */ 


return ret; 
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62.4 硬件 原理 图 分 析 
本 章 实验 硬件 原理 图 参考 26.2 小 节 即 可 。 


62.5 试验 程序 编写 
本 实验 对 应 的 例 程 路 径 为 : 开发 板 光 盘 -> 2. Linux 驱动 例 程 -> 22 spi. 




















62.5.1 修改 设备 树 


1、 添 加 ICM20608 所 使 用 的 IO 

首先 在 imx6ull-alientek-emmc.dts 文件 中 添加 ICM20608 所 使 用 的 IO 信息 , 在 iomuxc 节点 
中 添加 一 个 新 的 子 节点 来 描述 ICM20608 所 使 用 的 SPI 引 脚 ， 子 节点 名 字 为 pinctrl ecspi3, i5 
点 内 容 如 下 所 示 : 















































示例 代码 62.5.1.1 icm20608 IO 节点 信息 

















l. pinetrl ecspilss icm20608 i 

2 fsl,pins = « 

3 MX6UL PAD UART2 TX DATA GPIO1 1020 QT1050 FE 
4 MX6UL PAD UART2 RX DATA ECSPI3 SCLK wol ye SC EA 
5 MX6UL PAD UART2 RTS B ECSPI3 MISO [S001 /3 UNES OUO 
6 MX6UL PAD UART2 CTS B ECSPI3 MOSI QxT0b1 y= MOST =y 
q >; 

8 }; 





UART2 TX DATA 这 个 IO 是 ICM20608 的 片 选 信号 , 这 里 我 们 并 没有 将 其 复 用 为 ECSPI3 
的 sso 信和 号， 而 是 将 其 复 用 为 了 普通 的 GPIO。 因 为 我 们 需要 自己 控制 片 选 信号 ， 所 以 将 其 复 
用 为 普通 的 GPIO。 

2、 在 ecspi3 节点 追加 icm20608 子 节点 
在 imx6ull-alientek-emmc.dts 文件 中 并 没有 任何 向 ecspi3 节点 追加 内 容 的 代码 ， 这 是 因为 
NXP 官方 的 6ULL EVK 开发 板 上 没有 连接 SPI 设备 。 在 imx6ull-alientek-emmc.dts 文件 最 后 面 
加 入 如 下 所 示 内 容 : 






































示例 代码 62.5.1.2 向 ecspi3 节点 加 入 icm20608 信息 





1 &ecspi3 ( 

2 fsl,spi-num-chipselects = <1>; 

3 cs-gpio = <égpiol 20 CPTO ACTIVE LON>; /* cant't use cs-gpios! */ 
4 pinctrl-names = "default"; 

5 pinctrl-0 2 «&pinctrl ecspi3»; 

6 Status = "okay"; 

3) 

8 Spidev: icm2060800 ( 

9 compatible - "alientek,icm20608"; 
10 spi-max-frequency = «8000000»; 

qI reg = <0>; 

12 }; 

159g 
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第 2 行 ， 设 置 当前 片 选 数 量 为 1， 因 为 就 只 接 了 一 个 ICM20608。 





第 3 行 ， 注 意 ! 这 里 并 没有 用 到 “cs-gpios” 属 物 
出 片 选 引 脚 。 如 果 使 用 “cs-gpios” 








引 脚 。 


性 ， 因 为 我 们 要 自己 控 


























E ， 而 是 用 了 一 个 自己 定义 的 “cs-gpio” 属 
属性 的 话 SPI 主机 驱动 就 会 控制 片 选 


论坛 :Www.opendev.com 





第 5 f, WE IO 要 使 用 的 pinctrl 子 节 点 ， 也 就 是 我 们 在 示例 代码 62.5.1.1 中 新 建 的 


pinctrl ecspi3. 





第 6 fT, imx6ull.dtsi 文件 中 默认 将 ecspi3 节点 状态 (status) 设 置 为 “disable”， 这 里 我 们 要 将 


其 改 为 “okay 


第 8~12 行 ，icm20608 设备 子 节点 ， 


» 
o 




















因为 icm20608 连接 在 ECSPI3 的 第 0 个 通道 上 ， 因 此 


@ 后 面 为 0。 第 9 行 设 置 节点 属性 兼容 值 为 “alientek,icm20608”， 第 10 行 设置 SPI 最 大 时 钟 频 
率 为 8MHz， 这 是 ICM20608 的 SPI 接口 所 能 支持 的 最 大 的 时 钟 频 率 。 第 11 fT, icm20608 连接 


在 通道 E, 


imx6ull-alientek-emmc.dts 文件 修改 完成 以 后 重新 编译 一 下 ， 得 至 














因此 reg 为 0。 


的 dtb 启动 Linux 系统 。 


62.5.2 编写 ICM20608 驱动 























ae 

















r1 


“22_spi” 的 文件 夹 ， 然 后 在 22_spi 文件 夹 里 面 创建 vscode TH 








新 的 dtb 文件 ， 并 使 用 新 





o 工作 区 命名 为 








“spi”。 工 程 创建 好 以 后 新 建 icm20608.c 和 icm20608reg.h 这 两 个 文件 ,icm20608.c 为 ICM20608 
的 驱动 代码 ,icm20608reg.h 是 ICM20608 寄存 器 头 文件 。 先 在 icm20608reg.h 中 定义 好 ICM20608 





的 寄存 器 ， 输 入 如 下 内 容 ( 有 和 省略， 完成 的 内 容 请 参考 例 程 ): 


#ifndef 
rerne 


Copyrigh 
XE A 
作者 

版 本 

描述 

其 他 

论坛 


sis 


CORSI GV AE CO 


«o 





ere re 
Nee o 


HS 
ES 


*Regist 
*Regist 
wi 


Ne PEPE PP 
So ea ST SS G S 


N N 
Y mB 


ddefine 














示例 代码 62.5.2.1 icm20608reg.h. 文件 内 容 


ICM20608 H 
ICM20608 H 


t O ALIENTEK 





P 左 忠 凯 
& VA O 


/汪汪 类 大 类 类 类 大 火炎 大大 火炎 类 大 火炎 大大 炎炎 类 大 类 类 类 大 类 类 类 大 类 大 类 大 大大 类 大 大大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 大 类 大 大 


Gomme 09 enon me ey 
: icm20608reg.h 


: ICM20608 寄存 器 地 址 描述 头 文件 


证 无 


: www.Oopenedv.com 


: 初版 V1.0 


ICM20608G ID 
ICM20608D ID 


/* ICM20608 寄存 器 
* 复 位 后 所 有 寄存 器 地 址 都 为 0， 除了 








er 107(0X6B) 
er OPI (CU S) 


2019/9/2 IL 


OXAF /* IDÍH */ 
OXAE /* IDÍH */ 


Power Management 1 = 0x40 


OxAF Bk OxAE 





WHO AM I 











/* 陀螺 仪 和 加 速度 自 测 (出 产 时 设置 ， 用 于 与 用 户 的 自 检 和 输出 值 比较 ) */ 











ICM20 SELF T 








EST X GYRO 0x00 
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23 #define ICM20 SELF TEST Y GYRO 0x01 
24 $define ICM20 SELF TEST Z GYRO 0x02 
25 &define ICM20 SELF TEST X ACCEL  0x0D 
26 #define ICM20 SELF TEST Y ACCEL Ox0E 
27 $define ICM20 SELF TEST Z ACCEL OxO0F 


80 /* 加 速度 静态 偏 移 */ 























81 #define ICM20 XA OFFSET H 0x77 
82 #define ICM20 XA OFFSET L 0x78 
83 #define ICM20 YA OFFSET H 0x7A 
84 $define ICM20 YA OFFSET L 0x7B 
85 4define INNO ZA (QUIS dl O77 
86 #define ICM20 ZA OFFSET L 0x7E 
87 

88 #endif 





接 下 来 继续 编写 icm20608.c 文件 ， 因 为 icm20608.c 文件 内 容 比 较 长 ， 因 此 这 里 就 将 其 分 开 
来 讲解 。 

1, icm20608 设备 结构 体 创建 

首先 创建 一 个 icm20608 设备 机 构 体 ， 如 下 所 示 : 

示例 代码 62.5.2.2 icm20608 设备 结构 体 创建 

1 #include <linux/types.h> 
2 4include «linux/kernel.h» 
3 4include «linux/delay.h» 














22 $include «asm/io.h» 
23 #include "icm20608reg.h" 


24 Jf[ FCKCKCKCKCk KCkCk kCkCk kCkCk kk kk KCkCk kCkCK KOC Ck kCkCk Ck k ck k kc k Ck kc k Ck kc kc k kc kc k kck ck kck ck ckckck kc ko 





25 S OT Vesti ne aN eo SC 200 ies se ee 
26 XT : icm20608.c 








27 dE : ZR 

28 版 本 s VLO 

29 描述 : ICM20608 SPI 驱动 程序 

30 其 他 2795 

Sql : www.openedv.com 

Sous : 初版 V1.0 2019/9/2 左 忠 凯 创建 


RR 大 大大 大大 类 大 类 大火 大 类 大火 大 类 大火 大大 类 大大 大业 类 大 类 类 类 大 类 类 类 大 大业 类 大 类 类 类 大 类 大 类 大 类 类 类 大 大 类 类 大 大 大 大 大 大 大 大大/ 


34 $define ICM20608 CNT 1 





35 define ICM20608 NAME "icm20608" 

36 

Sl struct iem20608 dev i 

38 dev t devid; /* 设备 号 un 
29 struct Q)lew ee /* cdev ^ 
40 Gite Class velas: Je mE 2 
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41 struct device *device; /* 设备 vA 
42 struct device node *nd; /* 设备 节点 yis 
43 inr major? /* 主 设备 号 A 
44 void *private data; /* 私有 数据 an 
45 iae GS Oo /* 片 选 所 使 用 的 GPIO 编号 */ 
46 signed int gyro x adc; /* 陀螺 仪 X 轴 原 始 值 5 
47 signed int gyro y adc; /* 陀螺 仪 Y 轴 原 始 值 Ry 
48 signed int gyro z adc; /* PEIRIN z 轴 原 始 值 a 
49 signed int accel x adc; /* 加 速度 计 X 轴 原始 值  */ 
50 signed int accel y adc; /* 加 速度 计 Y 轴 原 始 值 */ 
Sal signed int accel_z_adc; /* 加 速度 计 z 轴 原 始 值 */ 
52 Signed int temp adc; /* 温度 原始 值 wt 
SS 

54 


55 tatie struct em 0 dev em el 

icm20608 的 设备 结构 体 icm20608_dev 没什么 好 讲 的 ， 重 点 看 一 下 第 44 行 的 private_data， 
对 于 SPI 设备 驱动 来 讲 最 核心 的 就 是 spi device. probe 函数 会 问 驱 动 提供 当前 SPI 设备 对 应 的 
spi_device， 因 此 在 probe 函数 中 设置 private_data 为 probe 函数 传递 进来 的 spi. device 参数 。 

2. icm20608 的 spi driver 注册 与 注销 

对 于 SPI 设备 驱动 ， 首 先 就 是 要 初始 化 并 向 系统 注册 spi driver，icm20608 的 spi driver 初 
台 化 、 注 册 与 注销 代码 如 下 : 

示例 代码 62.5.2.3 icm20608 的 spi. driver 初始 化 、 注 册 与 注销 

/* 传统 匹配 方式 ID 列表 */ 


limi 























statie Const struct Sol devices icd icm20608 shell) = q 
("alientek,icm20608", 0), 
il 


il 
2 
3 
4 
5 Hn 
6 
7 /* 设备 树 匹 配 列表 */ 
8 





statie Const Struct ot device io ibew02000000) (xt mettemi = d 
9 ( .compatible = "alientek,icm20608" ), 
10 ( /* Sentinel */ ) 
ddp. 
12 
13 /* SPI 驱动 结构 体 */ 
I static struct gpi driver Ton060e river = d 
15 .probe = icm20608 probe, 
16 .remove = icm20608 remove, 
151 .driver - ( 
18 .owner = THIS MODULE, 
lS .name = "icm20608", 
20 .of match table = icm20608 of match, 
21 }, 
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22 .id table = icm20608 id, 

25 pg 

24 

sy oes 

26 * Qdescription : 驱动 入 口 函 数 

27 * Qparam 8 ZB 

28 * Qreturn s JE 

AS UA 

3X0) atarie int _ init icm20606 Lmt (veic) 

34 

32 return spi register driver(&icm20608 driver); 
SS) 

34 

SN E 

36 * Qdescription : UK ED ER C 

37 * Qparam 3 JE 

38 * Greturn 8 JE 

OON 

40 static void exit icm20608 exit (void) 

41 ( 

42 spi unregister driver(&icm20608 driver); 
43 ) 

44 

N5 module imit (en 1mLT)) p 


46 
47 
48 


第 


EE 





spi register driver 向 Linux 系统 注册 上 面 定义 的 icm20608 driver. 


as CoN E 


module exit(icm20608 exit); 

MODULE LICENSE("GPL"); 

MODULE AUTHOR ("zuozhongkai"); 

第 2-5 行 ， 传 统 的 设备 和 驱动 匹配 表 。 

第 8~11 行 ， 设 备 树 的 设备 与 驱动 匹配 表 ， 这 里 只 有 一 个 匹配 项 :“alientelksicm20608”。 























第 14-23 ÍT, icm20608 的 spi driver 结构 体 变 量 ， 当 icm20608 设备 和 此 驱动 匹配 成 功 以 后 











15 行 的 icm20608 probe 函数 就 会 执行 。 同 样 的 ， 当 注销 此 驱动 的 时 候 icm20608 remove FR 
数 会 执行 。 





第 30~33 行 ，icm20608 init 函数 为 icm20608 的 驱动 入 口 函 数 ， 在 此 函数 中 使 用 

















第 40-43 fT, icm20608 exit 函数 为 icm20608 的 驱动 出 口 函数 ， 在 此 函数 中 使 用 
spi unregister driver 注销 掉 前 面 注 册 的 icm20608. driver. 





3. probe/remove 函数 
icm20608 driver 中 的 probe 和 remove 函数 内 容 如 下 所 示 : 
示例 代码 62.5.2.4 probe 和 remove 函数 


/* 
* Qdescription : spi 驱动 的 probe 函数 ， 当 驱动 与 
* 设备 匹配 以 后 此 函数 就 会 执行 

* @param - client : spi 设备 
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* Qparam - id : spi Kø ID 

6 * 

7 e 

$ tatic int icm20609 nen oe (ue spi devices spp) 

PE 

10 int ret = 0; 

ENT 

12 /* 1、 构 建设 备 写 */ 

iS if (icm20608dev.major) { 

14 icm20608dev.devid = MKDEV (icm20608dev.major, 0); 

iiS register chrdev region(icm20608dev.devid, ICM20608 CNT, 
ICM20608 NAME); 

16 ) else ( 

dy alloc chrdev region(&icm20608dev.devid, 0, ICM20608 CNT, 
ICM20608 NAME); 

18 icm20608dev.major = MAJOR(icm20608dev.devid); 

IS } 

20 

Zl /* 2. timare */ 

2 cdev init(&icm20608dev.cdev, &icm20608 ops); 

275 cdev add(&icm20608dev.cdev, icm20608dev.devid, ICM20608 CNT); 

24 

Db /* 3、 创 建 类 */ 

26 icm20608dev.class = class create(THIS MODULE, ICM20608 NAME); 

27 if (IS ERR(icm20608dev.class)) d 

28 return PTR ERR(icm20608dev.class); 

29 } 

30 

31 /* 4. GERE */ 

B2 icm20608dev.device - device create(icm20608dev.class, NULL, 

icm20608dev.devid, NULL, ICM20608 NAME); 

233 if (IS ERR(icm20608dev.device)) i 

34 return PTR ERR(icm20608dev.device); 

35 } 

36 

37 /* 获取 设备 树 中 cs 片 选 信号 */ 

38 icm20608dev.nd = of find node by path("/soc/aips-buse02000000/ 

spba-bus802000000/ecspiQ02010000"); 

39 if(icm20608dev.nd == NULL) { 

40 Primek( cose node nor Eamon NENA) 

41 return -EINVAL; 

42 } 

43 
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44 /* 2. 获取 设备 树 中 的 gpio 属性 ， 得 到 BEEP 所 使 用 的 BEEP 编号 */ 

45 icm20608dev.cs gpio - of get named gpio(icm20608dev.nd, 
Tes- gpr on qp 

46 if(icm20608dev.cs gpio « 0) i 

47] printk("can't get cs-gpio"); 

48 return -EINVAL; 

49 } 

50 

Si /* 3. WE GPIO1_I020 为 输出 ， 并 且 输 出 高 电 平 */ 

52 ret © gpio direction output(icm20608dev.cs gpio, 1); 

59 T(ret <0) 1 

54 princk Ceant setr Gest) vie Nus) E 

55 } 

56 

57 /* 初 始 化 spi device */ 

58 spi-»mode = SE MO /*MODEO, CPOL=0, CPHA=0 */ 

59 Sol setup (se 

60 icm20608dev.private_data = spi; /* 设置 私有 数据 */ 

61 

62 /* 初始 化 ICM20608 内 部 寄存 器 */ 

63 icm20608 reginit(); 

64 return 0; 

SS i 

66 

p gne 


68 * Qdescription : spi 驱动 的 remove 函数 ， 移 除 spi 驱动 的 时 候 此 函数 会 执行 
69 * @param - client: spi 设备 


70 * Qreturn : 0， 成 功 ;其 他 负 值 , 失败 

Wl s 

Ure Mere eMe mercem M spi deyice “spili 

qi 

74 /* 删除 设备 */ 

15 cdev del(&icm20608dev.cdev); 

76 unregister chrdev region(icm20608dev.devid, ICM20608 CNT); 
pu 

78 /* 注销 掉 类 和 设备 */ 

TS) device destroy(icm20608dev.class, icm20608dev.devid); 
80 class destroy (icm20608dev.class); 

81 return 0; 

82 } 


第 8-65 ÍT, probe 函数 ， 当 设备 与 驱动 匹配 成 功 以 后 此 函数 就 会 执行 ， 第 13~55 行 都 是 标 
准 的 注册 字符 设备 驱动 。 其 中 在 第 38-49 行 获取 设备 节点 中 的 “cs-gpio” 属 性 ， 也 就 是 获取 到 
设备 的 片 选 IO。 
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第 58 行 ， 设 置 SPI 为 模式 0， 也 就 是 CPOL=0，CPHA=0。 
第 59 行 ， 设 置 好 spi device 以 后 需要 使 用 spi. setup 配置 一 下 。 




















第 60 行 ， 设 置 icm20608dev 的 private data 成 员 变 量 为 spi_ device. 

第 63 行 ， 调 用 icm20608 reginit 函数 初始 化 ICM20608， 主 要 是 初始 化 ICM20608 指定 寄 
存 器 。 

第 72~81 ÍT, icm20608_remove 函数 ， 注 销 驱 动 的 时 候 此 函数 就 会 执行 。 

4、icm20608 寄存 器 读 写 与 初始 化 

SPI 驱动 的 最 终 目的 就 是 为 了 读 写 icm20608 的 寄存 器 ， 因 此 需要 编写 相应 的 寄存 器 读 写 函 
数 ， 并 且 使 用 这 些 读 写 函数 来 完成 对 icm20608 的 初始 化 。icm20608 的 寄存 器 读 写 以 及 初始 化 
代码 如 下 : 











示例 代码 62.5.2.5 icm20608 寄存 器 读 写 以 及 出 初始 化 

















dL oye 

g * Qdescription : 从 icm20608 读 取 多 个 寄存 器 数据 

8 * (param - dev  : icm20608 设备 

4 * (üiparam - reg : “要 读 取 的 寄存 器 首 地 址 

5 * Qparam - val  : 读 取 到 的 数据 

6 * (param - len : “要 读 取 的 数据 长 度 

3j * Qreturn : 操作 结果 

8 A 

9 statie imt abewaZ G6 reac) regs (ortruct icm20606 dev velew; 18 reg, 
Vowel wouy one lem) 

10 ( 

aal int ret; 

12 unsigned char txdata[len]; 

TS struct goi message my 

14 struct goi transient wep 

15 otru goi device wepi c (struct epi elewiee lv > ivan 

16 

ay gpio set value(dev=->cs_gpio, 0); /* 片 选 拉 低 ， 选 中 ICM20608 */ 

18 t - kzalloc(sizeof(struct spi transfer), GFP KERNEL); 

19 

20 /* 第 1 次 ,发 送 要 读 取 的 寄存 地 址 */ 

21 txdata[0] = reg | 0x80; /* 写 数据 的 时 候 寄存 器 地 址 bit8 要 置 1 */ 

22 t-»tx buf 2 txdata; /* 要 发 送 的 数据 2 

29 t-»len = 1; [F5 3 4 5E i 

24 Spi message init(&m); /* 初始 化 spi message Ww 

25 spi message add tail(t, &m);/* 将 spi transfer 添加 到 spi message */ 

26 ret = spi sync(spi, &m); /* 同步 发 送 o 

AN 

28 /* 第 2 次 ， 读 取 数 据 */ 

29 txdata[0] = Oxff; /* 随便 一 个 值 ， 此 处 无 意义 Ef 

30 t->rx_buf = buf; /* 读 取 到 的 数据 E 

31 t-»len 5 len; /* 要 读 取 的 数据 长 度 i 
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29 spi message init(&m); f^ 初始 化 spi message yl 
83 spi message add tail(t, &m);/* 将 spi transfer 添加 到 spi message*/ 
34 ret = spi sync(spi, &m); /* 同步 发 送 */ 
S 

36 kfree(t); /* 释放 内 存 wh 
2 gpio set value(dev-»cs gpio, 1); /* 片 选 拉 高 ， 释 放 ICM20608 */ 
38 

39 return ret; 

40 } 

41 

a2 AK 

43  * Qdescription : 向 icm20608 多 个 寄存 器 写 入 数据 

44  * Qparam - dev  : icm20608 设备 


45 * (üiparam - reg : 要 写 入 的 寄存 器 首 地 址 

46 * @param - val  : 要 写 入 的 数据 缓冲 区 

47 * (üiparam - len : 要 写 入 的 数据 长 度 

Ae En : 操作 结果 

49. yr 

S0 taric S32 icm206068 write regs (struct icwm20608 dev 'olew;, Ue ize; 
u8 *buf, u8 len) 














Sak wi 

S int fet, 

ES 

54 unsigned char txdata[len]; 

55 struct gpi message me 

56 struct goi transter wtp 

57 struct gpl device epu = (struct spi deyice v)dev--private data, 
58 

59 t = kzalloc(sizeof(struct spi transfer), GFP KERNEL); 
60 gpio set value(dev-»cs gpio, 0); /* 片 选 拉 低 */ 

61 


62 /* 第 1 次 ， 发送 要 读 取 的 寄存 地 址 */ 


63 txdata[0] = reg & «40x80; /* 写 数据 的 时 候 寄存 器 地 址 bits 要 清 零 */ 
64 t-»tx buf 2 txdata; /* 要 发 送 的 数据 e 
65 t-»len = 1; 全 P 
66 spi message init(&m); (E 初始 化 spi message my 
67 spi measoge odd CEN No MES) S 将 spi transfer 添加 到 spi message Sy 
68 ret = spi sync(spi, &m); /* 同步 发 送 E 
69 

70 /* 第 2 次 ， 发 送 要 写 入 的 数据 */ 

pill C-Stz but = buit; /* 要 写 入 的 数据 MÀ 
72 t-»len = len; /* 写 入 的 字 节 数 E 
ps spi message init(&m); /* 初始 化 spi message Rl 
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74 Spi message add tail(t, &m);/* 将 spi transfer 添加 到 spi message*/ 

15 ret = spi sync(spi, &m); /* 同步 发 送 E 

76 

77 kfree (t); /* 释放 内 存 x 

78 gpio set value(dev-»cs gpio, 1);/* 片 选 拉 高 ， 释 放 ICM20608 */ 

WS return ret; 

80 ] 

81 

e — qe 

83  * QGdescription  : 读 取 icm20608 指定 寄存 器 值 ， 读 取 一 个 寄存 器 

84  * Qparam - dev  : icm20608 设备 

85 * (param - reg : 要 读 取 的 寄存 器 

95  * [Been : 读 取 到 的 寄存 器 值 

ey mgr 

88 static unsigned char icm20608 read onereg(struct icm20608 dev *dev, 

u8 reg) 

89 { 

90 u8 data = 0; 

gii icm20608 read regs(dev, reg, &data, 1); 

92 return data; 

SER A) 

94 

Su a 

96  * Qdescription : F] icm20608 指定 寄存 器 写 入 指定 的 值 ， 写 一 个 寄存 器 

97  * @param - dev  : icm20608 设备 

98 = (param = reg  : 5e ES 

99 * Qparam - data : X5 AGB 

100 * Qreturn 8 JE 

IOM sey 

102 

10S statie void alewu20G09 nn ue ibem200009 dey vdev, US Teg, 
u8 value) 

104 { 

1O05 u8 buf = value; 

106 iem20606 write regs (dev, reg, Houk, Ip 

ior 

108 

109. Je 

110 * Q(description  : 读 取 ICM20608 的 数据 ， 读 取 原 始 数据 ， 包 括 三 轴 陀 螺 仪 、 

111 * : 三 轴 加 速度 计 和 内 部 温度 。 

112 * Qparam - dev  : ICM20608 设备 

113 * Greturn B Z5 

je 


1461 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 









































原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
115 void icm20608 readdata(struct icm20608 dev *dev) 
i 4 
BTE unsigned char darca M] 
118 icm20608 read regs(dev, ICM20 ACCEL XOUT H, data, 14); 
ly 
120 dev-»-accel x adc -2 (signed short) ((data[0] «« 8) | data[1]); 
TA dev-»accel y adc = (signed short) ((data[2] «« 8) | data[31); 
122 dev-»accel z adc - (signed short)((data[4] a 
152063 dev-»temp adc = (signed short)((data[6] << 8) | data[7]):; 
TA dev-»gyro x adc - (signed shorti (Caral «« 8) | data[91); 
1525 dev-»gyro y adc = (signed short) ((data[10] «« 8) | data[11]); 
126 dev-»gyro z adc - (signed short)((data[12] «« 8) | data[13]); 
L27 
gg. ge 
129 * ICM20608 内 部 寄存 器 初始 化 函数 
130 è G8param B AE 
131 * Greturn 8 35 
192 €f 
133 void icm20608 reginit (void) 
134 ( 
LSS u8 value = 0; 
T36 
S icm20608 write onereg(&icm20608dev, ICM20 PWR MGMT 1, 0x80); 
138 mdelay (50); 
139 icm20608 write onereg(&icm20608dev, ICM20 PWR MGMT 1, 0x01); 
140 mdelay (50); 
141 
ED value - icm20608 read onereg(&icm20608dev, ICM20 WHO AM I); 
143 printk("ICM20608 ID — $$XNrNn", value); 
144 
JEANS icm20608 write onereg(&icm20608dev, ICM20 SMPLRT DIV, 0x00); 
146 icm20608 write onereg(&icm20608dev, ICM20 GYRO CONFIG, 0x18); 
AT icm20608 write onereg(&icm20608dev, ICM20 ACCEL CONFIG, 0x18); 
148 icm20608 write onereg(&icm20608dev, ICM20 CONFIG, 0x04); 
149 icm20608 write onereg(&icm20608dev, ICM20 ACCEL CONFIG2, 0x04); 
150 icm20608 write onereg(&icm20608dev, ICM20 PWR MGMT 2, 0x00); 
gesal icm20608 write onereg(&icm20608dev, ICM20 LP MODE CFG, 0x00); 
152 icm20608 write onereg(&icm20608dev, ICM20 FIFO EN, 0x00); 
59) 

第 9~40 1T, icm20608 read regs 函数 ， 从 icm20608 中 读 取 连续 多 个 寄存 器 数据 。 








第 50-80 fT, icm20608 write regs 函数 ， 向 icm20608 连续 写 入 多 个 寄存 器 数据 。 
第 88-83 ÍT, icm20608_read_onereg 函数 ， 读 取 icm20608 指定 寄存 器 数据 。 
第 103~107 fT, icm20608 write onereg 函数 ， 向 icm20608 指定 寄存 器 写 入 数据 。 
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第 115-126 ÍT, icm20608 readdata 函数 ， 读 取 icm20608 六 轴 传 感 器 和 温度 传感器 原始 数 
据 值 ， 应 用 程序 读 取 icm20608 的 时 候 这 些 传 感 器 原始 数据 就 会 上 报 给 应 用 程序 。 

第 133~153 íT, icm20608 reginit 函数 ， 初 始 化 icm20608， 和 我 们 spi 裸 机 实验 里 面 的 初始 
化 过 程 一 样 。 








5、 字 符 设备 驱动 框架 


icm20608 的 字符 设备 驱动 框架 如 下 : 
示例 代码 62.5.2.6 icm20608 字符 设备 驱动 








d gne 

2  * Qdescription : 打开 设备 

3  * Qparam - inode : 传递 给 驱动 的 inode 

4  * QGparam - filp :设备 文件 file 结构 体 有 个 叫做 pr 似 有 ate data 的 成 员 变 量 
B s 一 般 在 open 的 时 候 将 private data 似 有 向 设备 结构 体 。 

& xw (esee : 0 成 功 ;其 他 失败 

Te 

© static int icm206068 open(srtruce inode wvinode, struct Tile wiil) 


10 filp->private data = &icm20608dev; /* 设置 私有 数据 */ 
dl return 0; 

1205 

13 

ia f 


50 aesen pE LON : 从 设备 读 取 数 据 

16 * @param - filp  : 要 打开 的 设备 文件 (文件 描述 符 ) 

17 * Qparam = buf : 返回 给 用 户 空 间 的 数据 缓冲 区 

le = (üoxeueemn — ee : 要 读 取 的 数据 长 度 

19 * Qparam - offt  : 相对 于 文件 首 地 址 的 偏 移 

20 * Greturn : 读 取 的 字 节 数 ， 如 果 为 负 值 ， 表 示 读 取 失 败 

2. s 

22, tatic Sexe t icw20608 :ieme(sitiuet iile virili, Char _ Wee our, 
size t Ent, loii t vou) 




















| 

24 signed int data[7]; 

29 long err = 0; 

26 Struct em 0 evy vdey = (struct icm20608 dey w 
iilo p priyate datar 

2] 

28 icm20608 readdata (dev); 

29) data[0] 2 dev-»gyro x adc; 

30 data[1] = dev-»gyro y adc; 

31 data[2] = dev-»gyro z adc; 

32 data[3] = dev-»accel x adc; 

99 data[4] = dev-»accel y adc; 

24 data[5] 2 dev-»accel z adc; 
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= copy to user(buf, data, sizeof(data)); 


35 data[6] = dev-»temp 
36 err 

SYI return 0; 

Sue 

EIS 

40 /* 


41 * Qdescription 
42 * Qparam = filp 


43 * (return 


44 */ 


| euer 


: 关闭 /释放 设备 
: 要 关闭 的 设备 文件 (文件 描述 符 ) 
0 成 功 ;其 他 失败 


论坛 :Www.opendev.com 


A5 tatie int Iem20606 releaselstruct inode vinode, le) 


46 ( 


47 return 0; 


48 } 
49 
SO emo 


Sl tatie const struct file operatione ena es 


608 操作 函数 */ 





52 .owner = THIS MODULE, 

559 .open = icm20608 open, 

54 .read - icm20608 read, 

55 .release = icm20608 release, 
56 ); 


{ 


字符 设备 驱动 框架 没什么 好 说 的 ， 重 点 是 第 22-38 行 的 icm20608 read 函数 ， 当 应 用 程序 


调用 read 函数 读 取 icm20608 设备 文人 
icm20608 readdata 函数 读 取 icm20608 的 原始 数据 并 将 其 上 报 给 应 用 程 





























的 时 候 此 函数 就 会 执行 。 此 函数 调用 上 面 编写 好 的 








序 。 大 家 注意 ， 在 内 核 





中 尽量 不 要 使 用 浮 点 运算 , 所 以 不 要 在 驱动 将 icm20608 的 原始 值 转换 为 对 应 的 实际 值 ， 因 为 会 
涉及 到 浮 点 计算 。 





62.5.3 编写 测试 APP 





#include 
#include 
#include 
#include 
#include 
#include 


#include 


e a e S E S S n] s 


#include 
9 #include 
10 #include 
11 #include 
12 #include 





"sere bo cdi 

村 本 

"Ssys/types.h" 
VENIS tty 
Wiese p abrexene dl cnr 
A dL odere 
Sol 





Slee er 
X«poll.h» 
€«sys/select.h» 
€«sys/time.h» 
Xsignal.h» 





新 建 itm20608App.c 文件 ， 然 后 在 里 面 输入 如 下 所 示 内 容 : 
示例 代码 62.5.3.1 icm20608App.c 文件 代码 
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13 £$include «fcntl.h» 


14 /类 类 类 火炎 火炎 火炎 火炎 火炎 火炎 类 火炎 类 类 火炎 炎炎 炎炎 类 类 类 类 火炎 类 类 类 类 大大 火炎 类 类 类 类 类 类 大 大 大 类 类 大 大 类 大大 大 类 大 类 大 大 


T 5 ONE et OMAETENTER m scd 9992029 7 RI I ets ser 




















16 文件 名 : icm20608App.c 

17 fEXE : AE 

18 版 本 201 

19 描述 : icm20608 设备 测试 APP。 

20 其 他 TE 

21 使 用 方法 : ./icm20608App /dev/icm20608 

29 Wiss : www.openedv.com 

25 Ba : 初版 V1.0 2019/9/20 左 忠 凯 创建 

24 Ck ok Kok K KC ok Rok KICK ok KC KCKCK Ok ok R KICK KO ok Rok KK KK ook Kok Kk kool Kok / 
25 

ZO s 

27 * Qdescription : main 主 程序 

28 * Qparam - argo  : argv 数组 元 素 个 数 

29 * Qparam - argv : 具体 参数 

30 * @return : 0 成 功 ;其 他 失败 

Sb. eA 

32 int main(int argc, char *argv[]) 

S391 

34 me EEE 

E char *filename; 

36 signed int databuf[7]; 

Dy unsigned char data[14]; 

38 Sube! ime gyro x ace, gyro y ade, gyro z ade} 
39 signed int accel x ade, accel y ade, accel z adep 
40 signee! ime temp ade} 

41 

42 kloert Gyro x act, Gyro Y act, Gyro z aCe; 

43 ilosu accel x ec, accel y scu, accel z act; 
44 illo temp act, 

45 

46 int ret = 0; 

47 

48 if (arge !2 2) ( 

49 printi (nn Usage se Wa) e 

50 return -1; 

Exit } 

52 

59 filename = argv[1]; 

54 fd = open(filename, O RDWR); 

55 TE(E «€ 10 i 
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56 printf("can't open file $sNrMn", filename); 

7) return -i|; 

58 ) 

59 

60 while (1) { 

Gal ret = read(fd, databuf, sizeof(databuf)); 

62 if(xet = 0) ( /* 数据 读 取 成 功 */ 

63 gyro x adc = databuf[0]; 

64 gyro y adc = databuf[i]; 

65 gyro z adc = databuf[?2]; 

66 accel x adc = databuf[3]: 

67 eeel y mee - au 

68 accel z adc = databuf[5]: 

69 temp adc = databuf[6]; 

70 

71 /* 计算 实际 值 */ 

TI gyro x act — (float) (gyro x adc) / 16.4; 

NUS gyro y act = (float) (gyro y adc) / 16.4; 

"74 gyro z act = (float) (gyro z adc) / 16.4; 

75 accel x act = (float) (accel x adc) / 2048; 

76 accel y act = (float) (accel y adc) / 2048; 

ary accel z act = (float) (accel z adc) / 2048; 

ES temp act = ((float) (temp adc) - 25 ) / 326.8 * 25; 

79 

80 printf("NrNn BGB :NrNn") ; 

81 [owesbanesr ("gps — elo quy c d de = rm ovo ss cole 
gyro y ade, gyro z ec)? 

82 和 
accel y ade, accel z ade)? 

83 priatf ("tenp = ehe war qeu adc); 

84 printf("SEbWMB:"); 

85 人 
CN 
gyro z act)? 

86 printf("act ax = $.2fg, act ay = $.2fg, 
act eus = tor accel x act, accel y act, 
accel z act)? 

87 站 

88 ) 

89 usleep(100000); /*100ms */ 

90 } 

91 close (fd); /* 关闭 文件 */ 

92 return 0; 
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Ode 

第 60-91 F, Æ while 循环 中 每 隔 100ms 从 icm20608 中 读 取 一 次 数据 ， 读 取 到 iem20608 
原始 数据 以 后 将 其 转换 为 实际 值 ， 比 如 陀螺 仪 就 是 角速度 、 加 速度 计 就 是 g 值 。 注 意 ， 我 们 在 
icm20608 驱动 中 将 陀螺 仪 和 加 速度 计 的 测量 范围 全 部 设置 到 了 最 大 ， 分 别 为 土 2000 和 土 16g。 
























































因此 ， 在 计算 实际 值 的 时 候 陀 螺 仪 使 用 16.4， 加 速度 计 使 用 2048。 最 终 将 传感器 原始 数据 和 得 
到 的 实际 值 显示 在 终端 上 。 





62.6 运行 测试 
62.6.1 编译 驱动 程序 和 测试 APP 


1、 编 译 驱动 程序 
编写 Makefile 文件 ， 本 章 实 验 的 Makefile 文件 和 第 四 十 章 实验 基本 一 样 ， 只 是 将 obj-m 变 
量 的 值 改 为 “icm20608.o”，Makefile 内 容 如 下 所 示 : 
示例 代码 62.6.1.1 Makefile 文件 
1 KERNELDIR := /home/zuozhongkai/linux/IMX6ULL/linux/temp/linux-imx- 
Tel ime 4515159 2-1-0 ga elsemuek 






































4 obj-m := icm20608.o 
11 clean: 
12 $ (MAKE) -C S$(KERNELDIR) M=$ (CURRENT PATH) clean 

第 4 行 ， 设 置 obj-m 变量 的 值 为 “icm20608.0”。 

输入 如 下 命令 编译 出 驱动 模块 文件 : 

make -j32 

编译 成 功 以 后 就 会 生成 一 个 名 为 “icm20608.ko” 的 驱动 模块 文件 。 

2、 编 译 测试 APP 
在 icm20608App.c 这 个 测试 APP 中 我 们 用 到 了 浮 点 计算 ， 而 LMX6U 是 支持 硬件 浮 点 的 ， 
因此 我 们 在 编译 icm20608App.c 的 时 候 就 可 以 使 能 硬件 浮 点 ， 这 样 可 以 加 速 浮 点 计算 。 使 能 硬 
件 浮 点 很 简单 ， 在 编译 的 时 候 加 入 如 下 参数 即 可 : 

-march-armv7-a -mfpu-neon -mfloat-hard 

输入 如 下 命令 使 能 硬件 浮 点 编译 icm20608App.c 这 个 测试 程序 : 

arm-linux-gnueabihf-gcc -march=armv7-a -mfpu-neon -mfloat-abi=hard icm20608App.c -o 
icm20608App 

编译 成 功 以 后 就 会 生成 icm20608App 这 个 应 用 程序 , 那么 究 竞 有 没有 使 用 硬件 浮 点 呢 ? 使 
用 arm-linux-gnueabihf-readelf 查看 一 下 编译 出 来 的 icm20608App 就 知道 了 ， 输 入 如 下 命令 : 

arm-linux-gnueabihf-readelf -A icm20608App 
结果 如 图 62.6.1.1 所 示 : 
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: $ arm-linux-gnueabihf-readelf -A icm20608App 
Attribute Section: aeabi 
File Attributes 
Tag CPU name: "7-A" 
Tag CPU arch: v7 
Tag CPU arch profile: Application 
Tag ARM ISA use: Yes 
Tag THUMB TSAN use: Thumb-2 
Tag_FP arch: VFPv3 
Tag Advanced SIMD arch: NEONv1 
Tag ABI PCS wchar t: 4 
Tag _ ABI FP ' rounding: Needed 
Tag ABI FP denormal: Needed 
Tag ABI FP exceptions: Needed 
Tag ABI FP number model: IEEE 754 
Tag _ABI_ align needed: 8-byte 
Tag ABI align preserved: 8-byte, except leaf SP 
Tag ABI enum size: int 
Tag ， ABI _HardFP | use: SP and DP 
Tag_ABI_VFP_args: VFP registers 
Tag CPU unaligned access: v6 





图 62.6.1.1 icm20608A pp 文件 信息 
从 图 62.6.1.1 可 以 看 出 FPU 架构 为 VFPv3, SIMD 使 用 了 NEON， 并 且 使 用 了 SP 和 DP, 
说 明 icm20608App 这 个 应 用 程序 使 用 了 硬件 浮 点 。 





























62.6.2 运行 测试 


将 上 一 小 节 编 译 出 来 icm20608.ko 和 icm20608App 这 两 个 文件 拷贝 到 
rootfs/lib/modules/4. l 15 目录 中 ， 重 启 开发 板 ， 进 入 到 目录 lib/modules/4.1.15 中 。 输 入 如 下 命令 
加 载 icm20608.ko 这 个 驱动 模块 。 

depmod /第 一 次 加 载 驱动 的 时 候 需 要 运行 此 命 如 

modprobe icm20608.ko /加 载 驱动 模块 

当 驱 动 模块 加 载 成 功 以 后 使 用 icm20608App 来 测试 ， 输 入 如 下 命令 

./icm20608App /dev/icm20608 

测试 APP 会 不 断 的 从 ICM20608 中 读 取 数据 ， 然 后 输出 到 终端 上 ， 如 图 62.6.2.1 所 示 : 





























n 











页 始 值 : 

gx = 14, gy = 9, gz=2 

ax = 46, = 41, az = 2020 
temp = 3908 


实际 值 :act gx = 0.85'/S, act gy = 0.55"/S, act gz = 0.12'/s 
act ax = 0.02g, act ay = 0.02g, act az = 0.99g 
act temp - 33.82'C 
图 62.6.2.1 获取 到 的 ICM20608 数据 
可 以 看 出 ， 开 发 板 静 止 状 态 下 ，Z 轴 方 向 的 加 速度 在 1g 左右 ， 这 个 就 是 重力 加 速度 。 对 于 
陀螺 仪 来 讲 , 静止 状态 下 三 轴 的 角速度 应 该 在 0^ /S 左右 。 ICM20608 内 温度 传感器 采集 到 的 温 
度 在 30 多 度 左右 ， 大 家 可 以 晃动 一 下 开发 板 ， 这 个 时 候 陀螺 仪 和 加 速度 计 的 值 就 会 有 变化 。 







































































1468 


LMX6U RAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


第 六 十 三 章 Linux RS232/48S/GPS 驱动 实验 

















串口 是 很 常用 的 一 个 外 设 ， 在 Linux 下 通常 通过 串口 和 其 他 设备 或 传感器 进行 通信 ， 根 据 




















电 平 的 不 同 ， 串 口 分 为 TTL 和 RS232。 不 管 是 什么 样 的 接口 电 平 ， 其 驱动 程序 都 是 一 样 的 ， 通 
过 外 接 RS485 这 样 的 芯片 就 可 以 将 串口 转换 为 RS485 信号 ， 正 点 原子 的 LIMX6U-ALPHA 开发 
板 就 是 这 么 做 的 。 对 于 正点 原子 的 LMX6U-ALPHA 开发 板 而 言 ， RS232、RS485 以 及 GPS 模 
块 接口 通通 连接 到 了 LMX6U 的 UART3 接口 上 , 因此 这 些 外 设 最 终 都 归结 为 UART3 的 串口 驱 





动 . 本 章 我 们 就 来 学 习 一 下 如 何 驱 动 LIMX6U-ALPHA 开发 板 上 的 UART3 串 
RS485 以 及 GSP 驱动 。 
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63.1 Linux F UART 驱动 框架 


1. uart driver 注册 与 注销 

同 DC. SPI 一 样 ，Linux 也 提供 了 串口 驱动 框架 ， 我 们 只 需要 按照 相应 的 串口 框架 编写 驱 
动 程序 即 可 。 串 口 驱 动 没有 什么 主机 端 和 设备 端 之 分 ， 就 只 有 一 个 串口 驱动 ， 而 且 这 个 驱动 也 
已 经 由 NXP 官方 已 经 编写 好 了 ， 我 们 真正 要 做 的 就 是 在 设备 树 中 添加 所 要 使 用 的 串口 节点 信 
息 。 当 系统 启动 以 后 串口 驱动 和 设备 匹配 成 功 ， 相 应 的 串口 就 会 被 驱动 起 来 ， 生 成 
/dev/ttymxcX(X=0....n) 文 件 。 
虽然 串口 驱动 不 需要 我 们 去 写 ， 但 是 串口 驱动 框架 我 们 还 是 需要 了 解 的 ，uart_driver 结构 
体 表示 UART 驱动 ，uart_driver 定义 在 include/linux/serial_core.h 文件 中 ， 内 容 如 下 : 

示例 代码 63.1.1 uatt_dtivet 结构 体 














































































































295 Struct vart driver 1 


296 struct module *owner; /* 模块 所 属 者  */ 
2o const char *driver name; /* 驱动 名 字 i 
298 const char *dev name; /* 设备 名 字 gus 
299 int major; /* 主 设备 号 */ 
300 AE minor; /* 次 设备 号 A 
301 int inue p /* 设备 数 DA 
302 Sume onse V eO p /* 控制 台 n, 
303 

304 js 

305 * these are private; the low level driver should not 
306 * touch these; they should be initialised to NULL 
307 a 

308 struct Uart State “startey? 

309 Sex IGuE gey Civet ey (Chee 

SM: 





每 个 串口 驱动 都 需要 定义 一 个 uart_driver， 加 载 驱动 的 时 候 通过 uart register driver 函数 向 
系统 注册 这 个 uart driver， 此 函数 原型 如 下 : 

int uart register driver(struct uart driver *drv) 

函数 参数 和 返回 值 含 义 如 下 : 

drv: 要 注册 的 uart_driver。 

返回 值 ，0， 成 功 ， 负 值 ， 失 败 。 

注销 驱动 的 时 候 也 需要 注销 掉 前 面 注 册 的 uart_driver, 需要 用 到 uart_unregister_driver 函数 ， 
函数 原型 如 下 : 

void uart unregister driver(struct uart driver *drv) 

函数 参数 和 返回 值 含 义 如 下 : 

drv: 要 注销 的 uart_ driver. 

返回 值 : 无 。 

2、uart_port 的 添加 与 移 除 


uart_port 表示 一 个 具体 的 port，uart_port 定义 在 include/linux/serial_core.h 文件 ， 内 容 如 下 
CH IR): 
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示例 代码 63.1.2 uart. port 


SEE tert port i 


118 
1139; 
3250) 


250 





spinlock t ock 

unsigned long iobase; 

unsigned char _— iomem  *membase; 
const struct uart ops *ops; 
unsigned int custom CIHSVe SOT 
unsigned int line; 

unsigned int minor; 

resource Sue © mapbase; 
resource size t mapsize; 
struct device *dev; 


Ig 


论坛 :www.opendev.com 


结构 体 
1a pore oek 


/* in/out[bwl] 
/* read/write [bwl] 


M= pore Tacie 


/* for ioremap 


/* parent device 


uart port 中 最 主要 的 就 是 第 235 fT IJ ops. ops 包含 了 串口 的 具体 驱动 函数 ， 





再 看 。 每 个 UART 都 有 一 个 uart_port， 那 么 uart port 是 怎么 


要 用 到 uart add one port 函数 ， 函 数 原 型 如 下 : 
intuart add one port(struct uart driver *drv, 


对 UART H 


struct uart port *uport) 


函数 参数 和 返回 值 含 义 如 下 : 
drv: 此 port 对 应 的 uart. driver. 
uport: 要 添加 到 uart driver 中 的 port. 


返回 值 : 0， 成 功 ; 


负 值 ， 失 败 。 








2 
iA 


y 


r4 


eA 








人 人 











和 uart driver 结合 起 来 的 呢 ? 


E UART 驱动 的 时 候 也 需要 将 uart port. 从 相应 的 uart driver 中 移 除 ， 需 要 用 到 
uart remove one port 函数 ， 函 数 原型 如 下 : 
intuart remove one port(struct uart driver *drv, struct uart port *uport) 
函数 参数 和 返回 值 含义 如 下 : 

drv: ERHI port 所 对 应 的 uart_driver。 





uport: 要 


返回 值 : 0， 成 功 ; 


3. uart ops 实现 











印 载 的 uart port. 
负 值 ， 失 败 。 


在 上 面 讲 解 uart port 的 时 候 说 过 ，uart_port 中 的 ops 成 员 变 量 很 重要 ， 因 
L 体 的 驱动 函数 ，Linux 系统 收发 数据 最 终 











冬 调用 的 都 是 ops 中 的 函数 。 


为 ops 包含 了 针 


ops 是 uart ops 


类 型 的 结构 体 指针 变量 ，uart ops 定义 在 include/linux/serial core.h 文件 中 ， 内 容 如 下 : 


49 
50 
5 
52 
3$ 
54 
55 





示例 代码 63.1.3 uart_ops 


struct tart pS i 


unsigned 
void 
unsigned 
void 
void 


void 


ESTE 


结构 体 


("Ex emoty) (Struct vert Port w)? 


("Ge metrli (struct uart port w, unsigned int metrl) z 


E 


(Gget metri) (struct vart POrt 9) 5 


(Jeto tz) (struct uart port =)? 


(Seen (Struct vert DOrE w) e 


(本 scale (struct uart port =)? 
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Sea woel (Cumncarortile) (struct vert POTE w) 

S VOLE (pend zehar) (sr vart port wy Onar Cm)? 

Se volel (BLED rz) (orruct uart Port w) p 

59 void (venable ms) (Struct uart port =)? 

60 void Coleone dul) (ue wigurit jOxouElG Vp cows Que P 

Gal ne (suman ) (ue uart port UP 

62 void (Gehurccdora) (Struct tert pore w) p 

S30 vond (Elusa butter) (struct Vart port =)? 

64 void (eert termiosh (Struct vart port ©, struct kteErmios vnen, 
65 SEUee lebeuumuos olo) sg 

GE VOLE (eer ldisg) (struct uart Josie wp Suo ktermilos Up 
oU void (emp) (Struct vart port wp unsignet ime State, 

68 unsigned int oldstate); 

69 

qo quee 

giat * Return a string describing the type of the port 

qa. wm 

1$. (eoe Char (epe) (Siue vart port v)? 

74 

TSZ 


76 * Release IO and memory resources used by the port. 


71 * This includes iounmap if necessary. 


o, 

oom (release exi) Cue 
80 

UNE 


82 * Request IO and memory resources used by the port. 


83 * This includes iomapping the port if necessary. 





Spo Se 

So. hg ("meceues wort) (struc: Were joue v» p 

86 void (Geontig port) (eS ue uart port wp 10E)? 

SI ne (ee ry port) (Struct uart porre w, SCTuUCE Serial struct w) p 
88 int (loeti) (struct vart port w, unsigned) ibant; TaSigneE Long) 
89 #ifdef CONFIG CONSOLE POLL 

IE (poll initi (Struct uart port w)? 

Ji ol (poll put char) (struct uart port wp unsignec! Char) p 
97 Matre (poll gert char) (struct vart Port vp 

93 #endif 

SAn 





UART 驱动 编写 人 员 需 要 实现 uart ops， 因 为 uart ops 是 最 底层 的 UART 驱动 接口 ， 是 实 
实在 在 的 和 UART 寄存 器 打交道 的 。 关 于 uart ops 结构 体 中 的 这 些 函 数 的 具体 含义 请 参考 
Documentation/serial/driver 这 个 文档 。 

UART 驱动 框架 大 概 就 是 这 些 ， 接 下 来 我 们 理论 联系 实际 ， 看 一 下 NXP 官方 的 UART 3 



































[< 
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动 文 件 是 如 何 编写 的 。 

















63.2 LMX6U UART 驱动 分 析 


1. UART 的 platform 驱动 框架 


打开 imx6ull.dtsi 文件 ， 找 到 UART3 对 应 的 子 节 点 ， 子 节点 内 容 如 下 所 示 : 
示例 代码 63.2.1 uatt3 设备 节点 
uart3: serialQ021ec000 ( 





il 
2 compatible = "fsl,imxó6ul-uart", 

3 "fsl,imx6q-uart", "fsl,imx21-uart"; 
4 reg = «0x021ec000 0x4000»; 

5 interrupts = LOIC SBE 26 TRO TSR LEVEL BG 
6 

qj 

8 

9 

















clocks = «&clks IMX6UL CLK UART3 IPG», 
X«&clks IMX6UL CLK UART3 SERIAL»; 





clock-names = "ipg", "per"; 


dmas = «&sdma 29 4 0», «&sdma 30 4 0»; 


10 dma-names - "rx", "tx"; 
alt status - "disabled"; 
12 Ng 





重点 看 一 下 第 2, 3 行 的 compatible 属性 , 这 里 一 共有 三 个 值 :“fsl,imx6ul-uart”、“fsl,imx6q- 
uar" JU ^fslimx21-uart". 在 uboot 源码 中 搜索 这 三 个 值 即 可 找到 对 应 的 UART 驱动 文件 ， 此 文 
件 为 drivers/tty/serial/imx.c， 在 此 文件 中 可 以 找到 如 下 内 容 : 
示例 代码 63.2.2 UART platform 驱动 框架 
251 eae struct plattorm device ic ime: ane 
268 { 





























269 .name = "imxl-uart", 
EG) .driver data = (kernel ulong t) &imx uart devdata[IMX1 UART], 
2g Jet 
22 .name = "imx21l-uart", 
2E .driver data = (kernel ulong t) 
&imx uart devdata[IMX21 UART], 

274 |t 
2m5 .name = "imxóq-uart", 
276 .driver data = (kernel ulong t) 

&imx uart devdata[IMX6Q UART], 
2m Icd 
278 /* sentinel */ 
209 } 
2S0! MR 
281 MODULE DEVICE TABLE(platform, imx uart devtype); 
282 
ese sa ke GenSESEEUEE Ot Glewibere ic iw: vart (he toel = q 
284 { .compatible = "fsl,imx6q-uart", .data = 
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&imx uart devdata[IMX6Q UART], ], 





285 ( .compatible - "fsl,imxl-uart", .data - 

&imx vart devdata[IMX1 VARTI; ], 
286 ( .compatible —- "fsl,imx21-uart", .data - 

&imx uart devdata[IMX21 UART], ], 

287 { /* sentinel */ } 
QS JE 
ZU TL statie struct plattform driver serial im: gheiswese = q 
2072 .probe = serial imx probe, 
2E . remove = serial imx remove, 
2074 
20m5 .suspend = serial imx suspend, 
206 .resume = serial imz resume, 
2077 .id table - imx uart devtype, 
2078 .driver = { 
2079 .name = "imx-uart", 
2080 (9E matcha table c3 im: vart olit 106, 
2081 Yor 
2082 Ng 
2083 
2084 static int X init imx serial init (void) 
2085 ( 
2086 int ret — uart register driver(&imx reg); 
2087 
2088 If (ret) 
2089 return ret; 
ZION 
210871 ret = platform driver register(&serial imz driver); 


2092 if (ret != 0) 





2093 uart unregister Criver (eim: Teg); 
2094 

2095 return ret; 

2096 ) 

2097 

2096 tatic voici ^^ eirt im: Serial exit (vorc) 
ZI 

2100 platform driver unregister(&serial imx driver); 
2101 uart unregister driver(&imx reg); 
210248) 

21103 


2104 module init(imx serial init); 


2105 waoohule esiir(Gumss serial exit); 
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可 以 看 出 I.MX6U 的 UART 本 质 上 是 一 个 platform 驱动 ， 第 267-280 17, imx uart devtype 
为 传统 匹配 表 。 

第 283-288 ÍT, 设备 树 所 使 用 的 匹配 表 , 第 284 行 的 compatible 属性 值 为 “fsl,imx6q-uart”。 

第 2071-2082 行 ，platform 驱动 框架 结构 体 serial imx driver. 

第 2084-2096 行 ， 驱 动 入 口 函 数 ， 第 2086 行 调用 uart register driver 函数 向 Linux 内 核 注 
册 uart_driver， 在 这 里 就 是 imx_reg。 
第 2098-2102 行 ， 驱 动 出口 函 数 ， 第 2101 行 调用 uart_unregister_driver 函数 注销 掉 前 面 注 
册 的 uart_driver， 也 就 是 imx reg. 

2、uart_driver 初始 化 

在 imx serial init 函数 中 向 Linux 内 核 注 册 了 imx reg，imx reg 就 是 uart driver 类 型 的 结 
构 体 变量 ，imx_reg 定义 如 下 : 

示例 代码 63.2.3 imx reg 结构 体 变量 






























































igisa ptatic se ene — qi 

Sy .owner = THIS MODULE, 

1838 .driver name = DRIVER NAME, 

d 999 .dev name = DEV NAME, 

1840 .major — SERIAL IMX MAJOR, 

1841 .minor = MINOR START, 

1842 a foe — ARRAY SIZE(imx ports), 
1843 a COS = IMX CONSOLE, 

1844 ); 


3. uart port 初始 化 与 添加 
当 UART 设备 和 驱动 匹配 成 功 以 后 serial imx probe 函数 就 会 执行 ， 此 函数 的 重点 工作 就 
是 初始 化 uart_port， 然 后 将 其 添加 到 对 应 的 uart_driver 中 。 在 看 serial imx_probe 函数 之 前 先 来 
看 一 下 imx port 结构 体 ，imx port 是 NXP 为 IMX 系列 SOC 定义 的 一 个 设备 结构 体 ， 此 结构 
体内 部 就 包含 了 uart port 成 员 变 量 ，imx_port 结构 体内 容 如 下 所 示 ( 有 缩减 ): 
示例 代码 63.2.4 imx_pott 结构 体 




















2 euee me 


217 struct uart port port; 

28 struct timar list timer; 

ZI unsigned int ollel Streits, 

220 unsigned Int haye ics i? 

zs unsigned int dre modes? 

22D unsigned int irode imaw Ta 

223 unsigned int Cle tmy tsil 

224 unsigned short grov delay; / iiewosswee delay */ 
243 unsigned long irl eee 

209507 


第 217 fT, uart port 成 员 变量 porto 
接 下 来 看 一 下 serial imx probe 函数 ， 函 数 内 容 如 下 : 
示例 代码 63.2.5 serial imx probe 函数 
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1999, tatie int serial ims probeletruct plattorm device eel) 
ALS d 

797 struct imx port *sport; 


dL. void . iomem *base; 

JS int ret = 0; 

1974 STPrUCE TESOUTCE "eS 

TESTS amu griep le CTs le STN el 

TONG 

1977 sport = devm kzalloc(&pdev-»dev, sizeof(*sport), GFP KERNEL); 
19778 if (!sport) 

119/78, return -ENOMEM; 

1980 
1981 rek = serial imz Probs Ct (sport, I9xelew7) p 
1982 ïf (ret > 0) 




















198S serial imx probe pdata(sport, pdev); 

1984 else if (ret « 0) 

1935 return ret; 

1986 

1987 res — platform get resource(pdev, IORESOURCE MEM, 0); 
1988 base = devm ioremap resource(&pdev-»dev, res); 

1989 if (IS ERR(base)) 

1990 return PTR_ERR (base); 

TH 


1992 rxirq = platform get_irq(pdev, 0); 
1993 txirq = platform get irq(pdev, 1); 
1994 rtsirq — platform get irq(pdev, 2); 
JL 

1996 Sport-»port.dev = &pdev-»dev; 

BOE Sport-»port.mapbase = res-»start; 
1998 Sport-»port.membase = base; 

1999 Sport-»port.type - PORT IMX, 

2000 Sport-»port.iotype = UPIO MEM; 





2001 Sport- (eT on =o 

2002 Sport-»port.fifosize - 32; 

2003 sport-»port.ops = &imx pops; 

2004 sport-»port.rs485 config - imx rs485 config; 

2005 Sport-»port.rs485.flags = 

2006 SER RS485 RTS ON SEND | SER RS485 RX DURING TX; 
2007 sport-»port.flags —- UPF BOOT AUTOCONF; 














2008 init timer(&sport-»timer); 





2009 sport-»timer.function = imx timeout; 
2010 sport-»timer.data = (unsigned long)sport; 
AOA 
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200:2 
AOS 
2014 
ZONE 
2016 
2017 
2018 
AES 
2020 
2021 
2022 
2023 
2024 
2025 
2026 
2/027 
2028 
2029 
2030 
2081 
2092 
2099 
2034 
2085 
2036 
210/577] 
2038 
2039 
2040 
2041 
2042 
2043 
2044 
2045 
2046 
2047 
2048 
2049 
2050 
205i 
2052 
2059 
2054 
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Sport-»clk ipg = devn Clk get(&pdev-»dev, "ipg"); 


If 


(IS ERR(sport-»clk ipg)) ( 
ret MA MEETS Eo er >elk cn) 








dev err(&pdev->dev, "failed to get ipg clk: ehm" s ret); 


return ret; 


sport-»clk per - devm clk get(&pdev-»dev, "per"); 


if 





(AS Meere erae cera) S) MET 
ret —- PTR ERR(sport-»clk per); 








eel cese deccm cM Mc MN EE cb E) 


return ret; 


Sport> port vertelk = elk get issue (n> 


if 


} 


(sport-»port.uartclk » IMX MODULE MAX CLK RATE) ( 
ret = lk get ratelsport >elk per, TMX MODULE MAX CLK RAT 














if (ret < 0) { 
Glew Gsexw(cyselesw-eelew, "eu ee 


return ret; 


Sport> port un Ee = elk get rate(sport Clk per)? 


Ts 


* Allocate the IRQ(s) 


* chips only have one interrupt. 


SY 
IE 


(zima EO MET 





ret = devm request irq(&pdev-»2dev, rxirq, imx rxint, 0, 





dev name(&pdev-»dev), sport); 
if (ret) 


return ret; 


ret = devm request irq(&pdev-»2dev, txirq, imx txint, 0, 





dev name(&pdev-»dev), sport); 











IE (et) 
return ret; 
) else ( 
ret 5 devm request irq(&pdev-»dev, rxirq, imx int, 0, 
dev name(&pdev-»dev), sport); 
if (ret) 


return ret; 
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2055 } 

2056 

2057 imz pOrtslsport=port linell = sport? 

2058 

2059 platform set drvdata(pdev, sport); 

2060 


2061 return uart add one port(&imx reg, &sport-»port); 
2062 ]) 

第 1971 fT, XE X — imx port 类 型 的 结构 体 指针 变量 sporto 

第 1977 ÍT, X sport 申请 内 存 。 

第 1987-1988 行 ， 从 设备 树 中 获取 LMX 系列 SOC UART 外 设 寄存 器 首 地 址 ， 对 于 
LMX6ULL 的 UART3 来 说 就 是 0X021EC000。 得 到 寄存 器 首 地 址 以 后 对 其 进行 内 存 映 射 ， 得 到 
对 应 的 虚拟 地 址 。 

第 1992~1994 行 ， 获 取 中 断 信息 。 

第 1996-2034 行 ， 初 始 化 sport, 我 们 重点 关注 的 就 是 第 2003 行 初始 化 sport 的 port 成 员 变 
量 ， 也 就 是 设置 uart ops 为 imx pops, imx pops 就 是 LMX6ULL 最 底层 的 驱动 函数 集合 ， 稍 后 
再 来 看 。 

第 2040-2055 行 ， 申 请 中 断 。 

第 2061 行 ， 使 用 uart add one port 癌 uart driver 添加 uart port， 在 这 里 就 是 向 imx reg 添 
加 sport-»port. 


4. imx pops 结构 体 变量 


imx pops 就 是 uart ops 类 型 的 结构 体 变 量 ， 保 存 了 LMX6ULL 串口 最 底层 的 操作 函数 ， 
imx pops 定义 如 下 : 



























































示例 代码 63.2.6 imx_pops 结构 体 











ieii ptatic gerwe vart oos im POS — qi 
dll os Ew (WOES = imx tx empty, 
1613 Set METEL c3 imz eet metil, 
1614 Get merri = imx_get_mctrl, 
LeS SEO Ex = imx stop tx, 

1616 See Ex = imx start tx, 
EON STOD ER = imx_stop rx, 

1618 .enable ms = imx enable ms, 
1:619 sleek ctl —- imx break ctl, 
1620 .Startup = imx startup, 

G2 . shutdown = imx_shutdown, 
G22 a EuS oE ee = imx flush buffer, 
1623 -BEE Cermios o imx set termios, 
1624 .type = imx type, 

1625 EGG oort = imx config port, 
1626 GE port = imx verify port, 
1627 $if defined(CONFIG CONSOLE POLL) 

1628 Poll Imit = imx poll init, 
1629 POLL get clueur c3 imk POLUL get char, 
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1630 POLL pur Cher = imx_poll_put_char, 

1631 #endif 

i555 



































imx pops 中 的 函数 基本 都 是 和 LMX6ULL 的 UART 寄存 器 打交道 的 ， 这 里 就 不 去 详细 的 
分 析 了 。 人 简单 的 了 解 了 LMX6U 的 UART 驱动 以 后 我 们 再 来 学 习 一 下 ， 如 何 驱动 正点 原子 
LMX6U-ALPHA 开发 板 上 的 UART3 接口 。 


63.3 硬件 原理 图 分 析 


本 实验 要 用 到 的 LMX6U 的 UART3 接口 ,LMX6U-ALPHA 开发 板 上 RS232. RS485 和 GPS 
这 三 个 接口 都 连接 到 了 UART3 上 ， 我 们 依次 来 看 一 下 这 三 个 模块 的 原理 图 。 


1. RS232 原理 图 
RS232 原理 图 如 图 63.3.1 所 示 : 


R35232 penc và 


Cl 
16 104 
15 
14 







































|i GND 






DOUT2 DIN2 
RIN2 ROUT2 


SP3232 ! 
325 — USART F( 母 头 ) 
PI D 

















38 J2 38 UART3 TXD 
37 J2 37 UART3 RXD 





图 63.3.1 RS232 原理 图 
从 图 63.3.1 可 以 看 出 ，RS232 电 平 通过 SP3232 这 个 芯片 来 实现 ，RS232 连接 到 了 LMX6U 
的 UART3 接口 上 , 但 是 要 通过 JP1 这 个 跳 线 帽 设 置 。 把 JP1 的 1-3 和 2-4 连接 起 来 以 后 SP3232 
就 和 UART3 连接 到 了 一 起 。 
2、RS485 原理 图 
RS485 原理 图 如 图 63.3.2 所 示 : 
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RS485 DCDC 3V3 









RS485 7 i RO 7 


B31 
RS485 RX4| DE 







U3 RX U3 TX 


UARI3 TXD 3 4 UARI3 RXD 
RS485 RX 5 6 RS485 TX 


一 
N 








图 63.3.2 RS485 原理 图 

RS485 采用 SP3485 这 颗 世 片 来 实现 ，RO 为 数据 输出 端 ，RI 为 数据 输入 端 ，RE 是 接收 使 
能 信号 ( 低 电 平 有 效 )，DE 是 发 送 使 能 信号 (高 电 平 有 效 )。 在 图 63.3.2 中 RE 和 DE 经 过 一 系列 
的 电路 ， 最 终 通 过 RS485_RX 来 控制 ， 这 样 我 们 可 以 省 掉 一 个 RS485 收发 控制 ID， 将 RS485 
完全 当 作 一 个 串口 来 使 用 ， 方 便 我 们 写 驱 动 。 

3、GPS 原理 图 

正点 原子 有 一 款 GPS+ 北 斗 定位 模块 ， 型 号 为 ATK1218-BD, IMX6U-ALPHA 开发 板 留 出 
了 这 款 GPS 定位 模块 的 接口 ， 接 口 原 理 图 如 图 63.3.3 所 示 : 


ATK MODULE 


JP2 ATK MODULE 






























































onnoo-n 
HF 
DCDC 5V 9S6É 2g 
NO 办 | 不 cm 和 1 一 
C89 = 
za 
104 EM v 
EL 
zm 
—— aaj faa 
Sls5lolo 


GND 
图 63.3.3 ATK MODULE 模块 。 
从 图 63.3.3 可 以 看 出 ，GPS 模块 用 的 也 是 UART3， 因 此 UART3 驱动 成 功 以 后 就 可 以 直接 
读 取 GPS 模块 数据 了 。 
63.4 RS232 驱动 编写 


前 面 我 们 已 经 说 过 了 ，IMX6U 的 UART 驱动 NXP 己 经 编写 好 了 ， 所 以 不 需要 我 们 编写 。 
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我 们 要 做 的 就 是 在 设备 树 中 添加 UART3 对 应 的 设备 节点 即 可 。 打 开 imx6ull-alientek-emmc.dts 























文件 ， 在 此 文件 中 只 有 UARTI 对 应 的 uartl 节点 ， 并 没有 UART3 对 应 的 节点 ， 因 此 我 们 可 以 
参考 uartl 节点 创建 uart3 节点 。 

1、UART3 IO 节点 创建 

UART3 用 到 了 UART3 TXD fI UART3 RXD 这 两 个 IO , 因此 要 先 在 iomuxc 中 创建 UART3 


对 应 的 pinctrl 子 节 点 ， 在 iomuxc 中 添加 如 下 内 容 : 
示例 代码 63.4.1 UART3 引 脚 pinctrl 节点 





























JeanieilDsieE We Nene d 

2 fsl,pins - « 

ES MX6UL PAD UART3 TX DATA  UART3 DCE TX O0X1b0b1 
4 MX6UL PAD UART3 RX DATA UART3 DCE RX 0X1b0b1 
5 22g 

6 }; 


最 后 检查 一 下 UART3_TX 和 UART3 RX 这 两 个 引 脚 有 没有 被 用 作 其 他 功能 ， 如 果 有 的 话 
要 将 其 屏蔽 掉 ， 保 证 这 两 个 IO 只 用 作 UART3， 切 记 !1!! 


2、 添 加 uart3 节点 
默认 情况 下 imx6ull-alientek-emmc.dts 中 只 有 uartl 和 uart2 这 两 个 节点 ， 如 图 63.4.1 所 示 : 
{ 


pinctrl-names 
pinctrl-0 = 
status - 






































( 


pinctrl-names - 


pinctrl-0 = 
fsl,uart-has-rtscts; 


status = 








图 63.4.1 uartl 和 uart2 节点 

uartl 是 UARTI1 的 ,在 正点 原子 的 LMX6U-ALPHA 开发 板 上 没有 用 到 UART2, 而 且 UART2 
默认 用 到 了 UART3 的 IO， 因此 需要 将 uart2 这 个 节点 删除 掉 ， 然 后 加 上 UART3 对 应 的 uart3， 
uart3 节点 内 容 如 下 : 


















































示例 代码 63.4.2 UART3 对 应 的 uatt3 节点 

1 &uart3 { 
2 pinctrl-names = "default"; 
3 pinctrl-0 2 «&pinctrl uart3»; 
4 status = "okay"; 
2 E 

完成 以 后 重新 编译 设备 树 并 使 用 新 的 设备 树 启 动 Linux， 如 果 设 备 树 修改 成 功 的 话 ， 系 统 
启动 以 后 就 会 生成 一 个 名 为 “/dev/ttymxc2” 的 设备 文件 ，ttymxc2 就 是 UART3 对 应 的 设备 文 
件 ， 应 用 程序 可 以 通过 访问 ttymxc2 来 实现 对 UART3 的 操作 。 
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63.5 移植 minicom 























minicom 类 似 我们 常用 的 串口 调试 助手 ， 是 Linux 下 很 常用 的 一 个 串口 工具 ， 将 minicom 
移植 到 我 们 的 开发 板 中 ， 这 样 我 们 就 可 以 借助 minicom 对 串口 进行 读 写 操作 。 
1、 移 植 ncurses 


minicom 需要 用 到 ncurses， 依 次 需要 先 移植 ncurses， 如 果 前 面 已 经 移植 好 了 ncurses, WA 
这 里 就 不 需要 再 次 移植 了 ， 只 需要 在 编译 minicom 的 时 候 指 定 ncurses 库 和 头 文件 目录 即 可 。 
首先 在 ubuntu 中 创建 一 个 目录 来 存放 我 们 要 移植 的 文件 ， 比 如 我 在 
/home/zuozhongkai/linu/IMX6ULL 目录 下 创建 了 一 个 名 为 “tool” 的 目录 来 存放 所 有 的 移植 文 
件 。 然 后 下 载 ncurses 源码 ， 我 们 已 经 将 ncurses 源码 放 到 了 开发 板 光盘 中 ， 路 径 为 : 1、 例 程 源 
人 码 -》7、 第 三 方 库 源码 -》ncurses-6.0.tar.gz， 将 ncurses-6.0.tar.gz 拷贝 到 Ubuntu 中 创建 的 tool H 
录 下 ， 然 后 进行 解压 ， 解 压 命令 如 下 : 

tar -vxzf ncurses-6.0.tar.gz 

解压 完成 以 后 就 会 生成 一 个 名 为 “ncurses-6.0” 的 文件 夹 ， 此 文件 夹 就 是 ncureses 的 源码 文 
IFR. 在 tool 目录 下 新 建 名 为 “ncurses” 目 录 ， 用 于 保存 ncurses 编译 结果 ,一切 准 备 就 绪 以 后 
可 以 编译 ncureses 库 了 。 进 入 到 ncureses 源码 目录 下 ， 也 就 是 刚刚 解压 出 来 的 ncurses-6.0 H 
录 中 ， 首 先是 配置 ncureses， 输 入 如 下 命令 : 

./configure --prefix-/home/zuozhongkai/linux/IM X 6ULL/tool/ncurses --host-arm-linux- 


















































































































































auk 



































gnueabihf --with-shared 

configure 就 是 配置 脚本 ，--prefix 用 于 指定 编译 结果 的 保存 目录 ,这 里 肯定 将 编译 结果 保存 
到 我 们 前 面 创建 的 “ncurses” 目 录 中 。--hsot 用 于 指定 编译 器 前 级 ， 这 里 设置 为 “arm-linux- 
gnueabihf”。 配 置 命令 写 好 以 后 点 击 回 车 键 ， 等 待 配置 完成 ， 配 置 成 功 以 后 如 图 63.5.1 所 示 ; 


** Configuration summary for NCURSES 6.0 20150808: 



































extended funcs: yes 
xterm terminfo: xterm-new 


bin directory: /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/bin 


lib directory: /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/lib 
include directory: /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/include/ncurses 
man directory: /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/share/man 
terminfo directory: /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/share/terminfo 


** Include-directory is not in a standard location 





$ ls 
图 63.5.1. 配置 成 功 
配置 成 功 以 后 输入 “make” 命 令 开 始 编译 ， 编 译 成 功 以 后 如 图 63.5.2 所 示 : 


make[1]: Leaving directory '/home/zuozhongkai/linux/IMX6ULL/tool/ncurses-6.0/test' 

cd misc && make DESTDIR="" RPATH_LIST="/home/zuozhongkai/linux/IMX6ULL/tool/ncurses/lib" all 
make[1]: Entering directory '/home/zuozhongkai/linux/IMX6ULL/tool/ncurses-6.0/misc' 

make[1]: Nothing to be done for 'all'. 

make[1]: Leaving directory '/home/zuozhongkai/linux/IMX6ULL/tool/ncurses-6.0/misc' 

cd c++ && make DESTDIR="" RPATH_LIST="/home/zuozhongkai/linux/IMX6ULL/tool/ncurses/lib" all 



































make[1]: Entering directory '/home/zuozhongkai/linux/IMX6ULL/tool/ncurses-6.0/c++' 
arm-linux-gnueabihf-g++ -o demo ../obj s/demo.o -L../lib -Lncurses++ -L../lib -lform -lmenu -lpanel 
-lncurses -lutil -Wl,-rpath,/home/zuozhongkai/linux/IMX6ULL/tool/ncurses-6.0/lib -Lstdc++ -DHAVE 
CONFIG H -I. -I../include -D GNU SOURCE -D FILE OFFSET BITS=64 -DNDEBUG -02 -fPIC 

make[1]: Leaving directory '/home/zuozhongkai/linux/IMX6ULL/tool/ncurses-6.0/c++' 








图 63.5.2. 编译 成 功 
编译 成 功 以 后 输入 “make install” 命 令 安装 ， 安 装 的 意思 就 是 将 编译 出 来 的 结果 拷贝 到 -- 
pfefix 指定 的 目录 里 面 去 。 安 装 成 功 以 后 如 图 63.5.3 所 示 : 
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arm- linux-gnueabihf-ranlib /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/lib/libncurses++ g.a 
i ./cursesapp. h in /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/include/ncurses 
./cursesf.h /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/include/ncurses 
./cursesm.h in /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/include/ncurses 
./cursesp.h in /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/include/ncurses 


./cursesw.h in /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/include/ncurses 
./cursslk.h in /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/include/ncurses 
etip.h in /home/zuozhongkai/linux/IMX6ULL/tool/ncurses/include/ncurses 





图 63.5.3. 安装 成 功 
安装 成 功 以 后 查看 一 下 前 面 创 建 的 *ncurses” 文 件 夹 , 会 发 现 里 面 多 了 一 些 东 西 ,如 图 63.5.4 















































$ ls 





图 63.5.4 编译 出 来 的 结果 
我 们 需要 将 图 63.5.4 中 include. lib 和 share 这 三 个 目录 中 存放 的 文件 分 别 拷贝 到 开发 板 根 
文件 系统 中 的 /usr/include、/usr/lib 和 /usr/share 这 三 个 目录 中 ， 如 果 哪 个 目录 不 存在 的 话 请 自行 
创建 !! PEU m WT: 
sudo cp lib/* /home/zuozhongkai/linux/nfs/rootfs/usr/lib/ -rfa 








sudo cp share/* /home/zuozhongkai/linux/nfs/rootfs/usr/share/ -rfa 

sudo cp include/* /home/zuozhongkai/linux/nfs/rootfs/usr/include/ -rfa 

然后 在 开发 板 根 目录 的 /etc/profile( 没 有 的 话 自己 创建 一 个 ) 文 件 中 添加 如 下 所 示 内 容 : 
示例 代码 63.5.1 /etc/provile 文件 



































#!/bin/sh 
LD LIBRARY_PATH=/lib:/usr/lib:$LD_LIBRARY_PATH 
export LD LIBRARY PATH 


export TERM-vt100 


NT 








export TERMINFO=/usr/share/terminfo 
2、 移 植 minicom 


继续 移植 minicom， 获 取 minicom 源码 ， 我 们 已 经 放 到 了 开发 板 光盘 中 了 ， 路 径 为 : 1、 例 
程 源 码 -》7、 第 三 方 库 源码 -》minicom-2.7.1.tar.gz。 将 minicom-2.7.1.tar.gz 拷贝 到 ubuntu 中 的 
/home/zuozhongkai/linux/IMX6ULL/tool HK F, 然后 在 tool 目录 下 新 建 一 个 名 为 “minicom” 的 
子 目录 ,用 于 存放 minicom 编译 结果 ,一 切 准 备 好 以 后 就 可 以 编译 minicom 了 , 先 解压 minicom， 
命令 如 下 : 

tar -vxzf minicom-2.7.1.tar.gz 

解压 完成 以 后 会 生成 一 个 叫做 minicom-2.7.1 的 文件 夹 ， 这 个 就 是 minicom 的 源码 , 进入 到 
此 目录 中 ， 然 后 配置 minicom， 配 置 命令 如 下 : 

cd minicom-2.7.1/ /进入 minicom 源码 目录 

Jconfigure CC=arm-linux-gnueabihf-gcc --prefix—/home/zuozhongkai/linux/IMX6ULL /tool/ 
minicom --host-arm-linux-gnueabihf CPPFLAGS--I/home/zuozhongkai/linux/IM X6ULL/tool/ 
ncurses/include —  LDFLAGS--L/home/zuozhongkai/linux/IM X6ULL/tool/ncurses/lib -enable-cfg- 
dir—-/etc/minicom /配置 

CC 表示 要 使 用 的 gec 交叉 编译 器 ，--prefix 指定 编译 出 来 的 文件 存放 目录 ， 肯 定 要 存放 到 
我 们 前 面 创建 的 minicom 目录 中 。--host 指定 交叉 编译 器 前 级 ，CPPFLAGS 指定 ncurses 的 头 文 
件 路 径 ，LDFLAGS 指定 ncurses 的 库 路 径 。 
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配置 成 功 的 话 如 图 63.5.5 所 示 : 





ig.status: creating lib/Makefile 
ig.status: creating src/Makefile 
ig.status: creating po/Makefile.in 
ig.status: creating minicom.spec 
ig.status: creating config.h 


ig.status: executing depfiles commands 
ig.status: executing po-directories commands 
ig.status: creating po/POTFILES 

ig.status: creating po/Makefile 





图 63.5.5 配置 成 功 
配置 成 功 以 后 执行 如 下 命令 编译 并 安装 : 

make 

make install 


编译 安装 完成 以 后 ， 前 面 创建 的 minicom 目录 内 容 如 图 63.5.6 所 示 : 


: $ 


图 63.5.6 minicom 安装 编译 结果 

将 minicom 目录 中 bin 子 目录 下 的 所 有 文件 拷贝 到 开发 板 根 目 录 中 的 /usr/bin 目录 下 ， 命 令 
如 下 : 

sudo cp bin/* /home/zuozhongkai/linux/nfs/rootfs/usr/bin/ 

完成 以 后 在 开发 板 中 输入 “minicom -v” 来 查看 minicom 工作 是 否 正 常 , 结果 如 图 63.5.7 所 
T: 
||/etc # minicom -v 


minicom version 2.7.1 (compiled Sep 13 2019) 
Copyright (C) Miquel van Smoorenburg. 















































This program is free software; you can redistribute it and/or 
modify it under the terms of the GNU General Public License 
as nubdiatwd by the Free Software Foundation; either version 
2 of the License, or (at your option) any later version. 


/etc # 








图 63.5.7 minicom 版 本 号 
从 图 63.5.7 可 以 看 出 ， 此 时 minicom 版 本 号 为 2.7.1，minicom 版 本 号 查看 正常 。 输 入 如 下 
命令 打开 minicom 配置 界面 : 
minicom -s 
结果 是 打 不 开 minicom 配置 界面 ， 提 示 如 图 63.5.8 所 示 信 息 : 
/ # minicom -s 
You don't exist. Go away. 


/*W 


























图 63.5.8 minicom 打开 失败 

从 图 63.5.8 可 以 看 出 ，minicom 异常 嚣张 ， 竟 然 让 我 们 “Go away”， 这 能 容忍 ? ! 必须 要 
治 一 下 。 解 决 方法 很 简单 ， 新 建 /etc/passwd 文件 ， 然 后 在 passwd 文件 里 面 输入 如 下 所 示 内 容 : 

示例 代码 63.5.2 /etc/passwd 文件 

1. szeexoi 2x2 0)8 0 od/ od /nn 

完成 以 后 重启 开发 板 ! 

完成 以 后 重启 开发 板 ! 

完成 以 后 重启 开发 板 ! 
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开发 板 重启 以 后 再 执行 “minicom -s” 命 令 ， 此 时 minicom 配置 界面 就 可 以 打开 了 ， 如 图 


63.5.9 所 示 : 
[configuration] 
File transfer protocols 


Serial port setup 
Modem and dialing 
Screen and keyboard 
Save setup as dfl 
Save setup as.. 
Exit 

Exit from Minicom 



































图 63.5.9 mincom 配置 界面 
如 果 能 出 现 图 63.5.9 所 示 界 面 ， 那 么 就 说 明 mincom 工作 正常 了 。 


63.6 RS232 驱动 测试 


63.6.1 RS232 连接 设置 


在 测试 之 前 要 先 将 LMX6U-ALPHA 开发 板 的 RS232 与 电脑 连接 起 来 ， 首 先 设置 JP1 跳 线 
帽 ， 如 图 63.6.1.1 所 示 : 









































ce3 ce2 ca 

Dm ONE Sn 
Sero mm A 
gi FEY EE,Yy MRIS 





图 63.6.1.1 UART3 跳 线 帽 设置 

跳 线 帽 设置 好 以 后 使 用 RS232 线 将 开发 板 与 电脑 连接 起 来 ， 这 里 建议 使 用 USB f 
DB9(RS232) 数 据 线 , 比如 正点 原子 售卖 的 CH340 方案 的 USB 转 公 头 DB9 数据 线 , 如 图 63.6.1.2 
所 示 : 
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e 


正点 原子 





63.6.1.2 USB 转 DB9 数据 线 
图 63.6.1.2 中 所 示 的 数据 线 是 带 有 CH340 芯片 的 ， 因 此 当 连 接 到 电脑 以 后 就 会 出 现 一 个 
COM 口 ,这 个 COM 口 就 是 我 们 要 使 用 的 COM O. .比如 在 我 的 电脑 上 就 是 COM9 在 SecureCRT 
上 新 建 一 个 连接 ， 串 口 为 COM9， 波 特 率 为 115200。 

















63.6.2 minicom 设置 


在 开发 板 中 输入 “minicom -s", 打开 minicom 配置 界面 ， 然 后 选中 “Serial port setup”, 如 
图 63.6.2.1 所 示 : 



















[configuration] 
Filenames and paths 
File transfer protocols 






dem and dialing 
screen and keyboard 
Save setup as dfl 
Save setup as.. 
Exit 
Exit from Minicom 








63.6.2.1 选中 串口 设置 项 
选中 “Serial port setup ”以 后 点 击 回 车 ， 进 入 设置 菜单 ， 如 图 63.6.2.2 所 示 : 





Serial Device : /dev/ttys1 
Lockfile Location : /var/lock 
Callin Program 
Callout Program : 
Bps/Par/Bits : 115200 8N1 
Hardware Flow Control : Yes 
Software Flow Control : No 


Change which setting? B 
图 63.6.2.2 串口 设置 项 
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图 63.6.2.2 中 有 7 个 设置 项 目 ， 分 别 对 应 A、B.……:G， 比 如 第 一 个 是 选中 串口 ，UART3 的 
串口 文件 为 /dev/ttymxc2, 因此 串口 设置 要 设置 为 /dev/ttymxc2。 设 置 方法 就 是 按 下 键盘 上 的 “A”， 
然后 输入 “/dev/ttymxc2” 即 可 ， 如 图 63.6.2.3 所 示 : 


A - Serial Device : /dev/ttymxc2 

B - Lockfile Location : /var/loc UART3 的 串口 设备 文件 
C-  callin Program : 

D - Callout Program : 73/dev/ttymxc2 

E - Bps/Par/Bits : 115200 8N1 

F - Hardware Flow Control : Yes 

G - Software Flow Control : No 









































Change which setting? 


图 63.6.2.3 串口 设备 文件 设置 
设置 完 以 后 按 下 回 车 键 确认 ， 确 认 完 以 后 就 可 以 设置 其 他 的 配置 项 。 比 如 E 设置 波 特 率 、 
数据 位 和 停止 位 的 、F 设置 硬件 流 控 的 ， 设 置 方 法 都 一 样 ， 设 置 完 以 后 如 图 63.6.2.4 所 示 : 
= Serial Device UART3 对 应 的 设备 文件 


- Lockfile Location : 7/var/Toc 
-  Callin Program 


- Callout Program : i 115200，8 位 数据 
- ，Bps/Par/Bjts 115200 SNI 波 特 率 " 


- Hardware Flow Control [^N 位 ，1 位 停止 位 
- Software Flow Control PEE 
Change which setting? B 关闭 硬件 、 软 件 流 控 
































图 63.6.2.4 UART3 设置 
都 设置 完成 以 后 按 下 回 车 键 确 认 并 退出 ， 这 时 候 会 退回 到 如 图 63.6.2.1 所 示 的 界面 ， 按 下 
ESC 键 退 出 图 63.6.2.1 所 示 的 配置 界面 ， 退 出 以 后 如 图 63.6.2.5 所 示 : 





























Welcome to minicom 2.7.1 


OPTIONS: I18n 
Compiled on Sep 13 2019, 22:31:25. 
Port /dev/ttymxc2, 00:00:01 


Press CTRL-A Z for help on special keys 


图 63.6.2.5 minicom 串口 界面 
图 63.6.2.2 就 是 我 们 的 串口 调试 界面 ,可 以 看 出 当前 的 串口 文件 为 /dewttymxc2, 按 下 CTRL- 
A， 然 后 再 按 下 Z 就 可 以 打开 minicom 帮助 信息 界面 ， 如 图 63.6.2.6 所 示 : 
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Minicom Command Summary 
Commands can be called by CTRL-A «key» 
Main Functions Other Functions 


Dialing directory..D run script (Go)....G | Clear Screen 

Send files S Receive files R | configure Minicom. .0 
comm Parameters....P Add linefeed A | Suspend minicom....J 
Capture on/off Hangup H | exit and reset 

send break initialize Modem...M | Quit with no reset.Q 
Terminal settings..T run Kermit K | Cursor key mode....I 
linewrap on/off....w local Echo on/off..E | Help screen 

Paste file Y Timestamp toggle...N | scroll Back 

Add Carriage Ret... 


Select function or press Enter for none.l 


图 63.6.2.6 minicom 帮助 信息 界面 
从 图 63.6.2.6 可 以 看 出 ，minicom 有 很 多 快捷 键 ， 本 实验 我 们 打开 minicom 的 回 显 功能 ， 
回 显 功能 配置 项 为 “local Echo on/o 任 .E”， 因 此 按 下 王 即 可 打开 /关闭 回 显 功能 。 























63.6.3 RS232 收发 测试 


1、 发 送 测试 
首先 测试 开发 板 通过 UART3 向 电脑 发 送 数据 的 功能 ， 需 要 打开 minicom 的 回 显 功能 (不 打 
开 也 可 以 ， 但 是 在 minicom 中 看 不 到 自己 输入 的 内 容 )， 回 显 功能 打开 以 后 输入 “AAAA” 如 
图 63.6.3.1 所 示 : 



































Welcome to minicom 2.7.1 


n 
Compiled on Sep 13 2019, 22:31:25. 
Port /dev/ttymxc2, 00:00:01 


Press CTRL-A Z for help on special keys 
输入 AAAA， 只 有 打开 minicom 回 显 功能 才能 显示 出 来 


图 63.6.3.1 通过 UART3 向 电脑 发 送 “AAAA” 
图 63.6.3.1 中 的 “AAAA” 相 当 于 开发 板 通 过 UART3 向 电脑 发 送 “AAAA”， 那么 COM9 
就 会 接收 到 “AAAA” SecureCRT 中 COMO 收 到 的 数据 如 图 63.6.3.2 所 示 : 


serial-com13 | serial.com9 x 


中 AA — — [—— 电脑 收 到 开发 板 发 送 过 来 的 "AAAA" 数 据 


图 63.6.3.2 电脑 接收 到 开发 板 发 送 过 来 的 数据 
可 以 看 出 ， 开 发 板 通 过 UART3 向 电脑 发 送 数据 正常 ， 那 么 接 下 来 就 测试 开发 板 数据 接收 



































2、 接 收 测试 
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接 下 来 测试 开发 板 的 UART3 接收 功能 ， 同 样 的 ， 要 先 打开 SecureCRT 上 COMO 的 本 地 回 
显 ， 否 则 的 话 你 在 COM9 上 输出 的 内 容 会 看 不 到 ， 但 是 实际 上 是 已 经 发 送 给 了 开发 板 。 选 中 
SecureCRT 的 Options->Session Options->Adavnced, 打开 回话 配置 界面 , 然后 选中 “Local echo”, 











如 图 63.6.3.3 所 示 : 





























Session Options - serial-com9 x | 
Category: 
S- Connection Advanced Emulation 
T Aon Advanced terminal options 
$- Terminal C Answerback: 
Emulation 
Modes [C Terminal type: 
Emacs : 
M Keys [Display tab as: 
Advanced E3 
| -— 打开 本 地 回 显 
ANSI Color Local echo C Strip 8th bit 
Window - - 
Log File Ignore window title change requests 
Printing C Copy translates ANSI line-drawing characters 
XN [zmodem C Copy to dipboard as RTF and plain text 
[C Translate incoming CR to CR/LF 
Send delay options 
Line send delay: 5 $ milliseconds 
Character send delay: 0 $ miliseconds 
Prompt: Max wait (ms): 0 
Ca] i ce 





图 63.6.3.3 打开 SecureCRT 的 本 地 回 显 
SecureCRT 设置 好 以 后 向 开发 板 发 送 一 个 BBBB”, 在 SecureCRT 的 COM9 上 输入 “BBBB”， 
如 图 63.6.3.3 所 示 : 


W serial-com13 |** serial-com9 x 


VAIBBBBM [— i nir) E42 de iE" BBBB" 





图 63.6.3.3. 电脑 向 开发 板 发 送 “BBBB?” 
此 时 开发 板 的 minicom 就 会 接收 到 发 送 过 来 的 “BBBB” 如 图 63.6.3.4 所 示 : 





Welcome to minicom 2.7.1 


OPTIONS: Il8n 
Compiled on Sep 13 2019, 22:31:25. 
Port /dev/ttymxc2, 05:38:19 


Press CTRL-A Z for help on special keys 


开发 板 接收 到 电脑 发 送 过 来 的 “BBBB" 


63.6.3.4 开发 板 接 收 到 发 送 过 来 的 数据 
UART3 收发 测试 都 没有 问题 ， 说 明 我 们 的 UART3 驱动 工作 正常 。 如 果 要 退出 minicom 的 
Wi Œ minicom 通信 界面 按 下 CRTL+A， 然 后 按 下 X 来 关闭 minicom。 关 于 minicom 的 使 用 我 
们 这 里 讲 的 很 简单 ， 大 家 可 以 在 网 上 查找 更 加 详细 的 minicom 使 用 教程 。 
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63.7 RS485 测试 


前 面 已 经 说 过 了 ,I.MX6U-ALPHA 开发 板 上 的 RS485 接口 连接 到 了 UART3 上 ， 因 此 本 质 
上 就 是 个 串口 。RS232 实验 我 们 已 经 将 UART3 的 驱动 编写 好 了 ， 所 以 RS485 实验 就 不 需要 编 
写 任 何 驱动 程序 ， 可 以 直接 使 用 minicom 来 进行 测试 。 





























63.7.1 RS485 连接 设置 
首先 是 设置 JP1 跳 线 帽 ， 将 3-5、4-6 连接 起 来 ， 如 图 63.7.1.1 所 示 : 





(i 


T) 
R19 
Sa 


EaREENNE 


COM3_Rx| E ICOM3 TX 


LEG TT 
485_RX 485_TX 





63.7.1.1 RS485 接口 设置 
个 板子 是 不 能 进行 RS485 通信 测试 的 ,还 需要 另 一 个 RS485 设备 ,比如 另外 一 块 LMX6U- 
ALPHA 开 发 板 。 这 里 推荐 大 家 使 用 正点 原子 出 品 的 USB 三 合 一 串口 转换 器 , 文 持 USB f$ TIL. 
RS232 和 RS485， 如 图 63.7.1.2 所 示 : 























图 63.7.1.2 正点 原子 USB 三 合 口 转换 器 
使 用 杜邦 线 将 USB 串口 转换 器 的 RS485 接口 和 工 MX6U-ALPHA 开发 板 的 RS485 连接 起 
来 , A 接 A，B 接 B， 不 能 接 错 了 ! 连接 完成 以 后 如 图 63.7.1.3 所 示 : 
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器 妊 转 9Smn ss 








图 63.7.1.3 串口 转换 器 和 开发 板 RS485 连接 示意 图 
串口 转换 器 通过 USB 线 连接 到 电脑 上 ， 我 用 的 是 CH340 版 本 的 ， 因 此 就 不 需要 安装 驱动 
的 , 如 果 使 用 的 是 FT232 版 本 的 就 需要 安装 相应 的 驱动 。 连 接 成 功 以 后 电脑 就 会 有 相应 的 COM 
口 ， 比 如 我 的 电脑 上 就 是 COM10， 接 下 来 就 是 测试 。 

















63.7.2 RS485 收发 测试 

RS485 的 测试 和 RS232 一 模 一 样 !USB 多 合 一 转换 器 的 COM 口 为 10, 因 此 使 用 SecureCRT 
创建 一 个 COM10 的 连接 。 开 发 板 使 用 UART3， 对 应 的 串口 设备 文件 为 /dewttymxc2， 因 此 开发 
板 使 用 minicom 创建 一 个 /dev/ttymxc2 的 串口 连接 。 串 口 波 特 率 都 选择 115200, 8 位 数据 位 ，1 
位 停止 位 ， 关 闭 硬件 和 软件 流 控 。 

1. RS485 发 送 测试 

首先 测试 开发 板 通过 RS485 发 送 数 据 , 设置 好 minicom 以 后 ， 同 样 输入 “AAAA” 也 就 是 
通过 RS485 向 电脑 发 送 一 串 “AAAA”。 如 果 RS485 驱动 工作 正常 的 话 ， 那 么 电脑 就 会 介绍 到 
开发 板 发 送 过 来 的 “AAAA” 如 图 63.7.2.1 所 示 : 











*v serial-com13 x 4 b s serial-com10 x 







Welcome to minicom 2.7.1 
电脑 接收 到 开发 板 发 
送 过 来 的 "AAAA" 






OPTIONS: I18n 
Compiled on Sep 13 2019, 22:31:25. 
Port /dev/ttymxc2, 00:10:41 







Press CTRL-A Z for help on special keys 





63.7.2.1 RS485 数据 发 送 测试 
从 图 63.7.2.1 可 以 看 出 开发 板 通 过 RS485 向 电脑 发 送 “AAAA” 成 功 ， 说 明 RS485 数据 数 
据 发 送 正 常 。 
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2. RS485 接收 测试 


接 下 来 测试 一 下 RS485 数据 接收 ， 电 脑 通过 RS485 向 开发 板 发 送 “BBBB”， 然 后 观察 
minicom 是 否 能 接收 到 “BBBB” 结果 如 图 63.7.2.2 Bras: 


| v serial-com13 x 4 b|**serial-cCom10 x 4b 





















Welcome to minicom 2.7.1 


OPTIONS: I18n 
Compiled on Sep 13 2019, 22:31:25. 
Port /dev/ttymxc2, 00:11:37 


Press CTRL-A Z for help on special keys 


AAA 和 86B ”| 一 开发 板 接收 到 "BBBB" 
63.7.2.2 RS485 数据 接收 测试 
从 图 63.7.2.1 可 以 看 出 开发 板 接 收 到 电脑 通过 RS485 发 送 过 来 的 “BBBB” 说 明 RS485 数 

据 接收 也 正常 。 









63.8 GPS 测试 


63.8.1 GPS 连接 设置 


GPS 模块 大 部 分 都 是 串口 输出 的 ， 这 里 以 正点 原子 出 品 的 ATK1218-BD 模块 为 例 ， 这 是 
一 款 GSP+ 北 斗 的 定位 模块 ， 模 块 如 图 63.8.1.1 所 示 : 


登 正 点 原子 





图 63.8.1.1 正点 原子 ATK1218-BD 定位 模块 
首先 要 将 LMX6U-ALPHA 开发 板 上 的 JPI 跳 线 帽 拔 掉 ， 不 能 连接 RS232 或 RS485, AN 
会 干扰 到 GSP 模块 。UART3 TX 和 UART3 RX 已 经 连接 到 了 开发 板 上 的 ATK MODULE E, 
直接 将 ATK1218-BD 模块 插 到 开发 板 上 的 ATK MODULE 接口 即 可 ,开发 板 上 的 ATK MODULE 
接口 是 6 脚 的， 而 ATK1218-BD 模块 是 5 脚 的 ， 因 此 需要 靠 左 插 ! 然后 GPS 需要 接 上 天 线 , 天 
线 的 接收 头 一 定 要 放 到 户外 ， 因 此 室内 一 般 是 没有 GPS 信号 的 。 连 接 完成 以 后 如 图 63.8.1.2 所 
ZN: 
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TEETE F] 
wna unu VUD 


Co Da S 








| ATK1218- = 
He ic Lot:5599053 


63.8.1.2 GPS 模块 连接 示意 图 





63.8.2 GPS 数据 接收 测试 


GPS 我 们 都 是 被 动 接收 定位 数据 的 ， 因 此 打开 minicom， 设 置 /dev/ttymxc2， 串 口 设置 要 求 
如 下 : 

Q@、 波 特 率 设置 为 38400， 因 为 正点 原子 的 ATKI218-BD 模块 默认 波 特 率 就 是 38400。 

@、8 位 数据 位 ，1 位 停止 位 。 

(@@、 关 闭 硬件 和 软件 流 控 。 

设置 好 以 后 如 图 63.8.2.1 所 示 : 






































- Serial Device : /dev/ttymxc2 
- Lockfile Location : /var/lock 

- Callin Program : 

- Callout Program : 

- Bps/Par/Bits : 38400 8N1 


- Hardware Flow Control : Yes 
- Software Flow Control : No 


Change which setting? 





图 63.82.1 串口 设置 
设置 好 以 后 就 可 以 静 静 的 等 待 GPS 数据 输出 ，GPS 模块 第 一 次 启动 可 能 需要 几 分钟 搜 星 ， 
等 搜 到 卫星 以 后 才 会 有 定位 数据 输出 。 搜 到 卫星 以 后 GPS 模块 输出 的 定位 数据 如 图 63.8.2.2 所 
JR: 
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< [welcome to minicom 2.7.1 
OPTIONS: I18n 
Compiled on Sep 13 2019, 22:31:25. 
Port /dev/ttymxc2, 16:27:59 


Press CTRL-A Z for help on special keys 模块 输出 的 GPS 定位 数据 





$GNGGA,034407.000,2318.2291,N,11319.5972,E,1,06,2.6,21.8,M,-5.4,M,,0000*61 
$GNGLL,2318.2291,N,11319.5972,E,034407.000,A,A*41 
$GPGSA,A,3,02,12,06,09,25,05,,,,,,,3.6,2.6,2.4*39 
$GPGSV,3,1,10,19,54,116,01,05,51,249,15,02,44,334,21,06,41,040,28*76 
$GPGSV,3,2,10,17,39,127,08,12,36,280,25, n 25,058,25,13,11,184,06*7F 
$GPGSV, 3,3, 10,25,09,313,22,23,00,038,15*7 

$GNRMC, 034407. 000, A, 2318. 2291, N, 11319. 5972,E,000.0,191.3,140919,,,A*78 
$GNVTG, 191.3,T, ,M,000.0,N,000.0,K,A*19 
$GNZDA,034407.000,14,09,2019,00,00*4A 
$GNGGA,034408.000,2318.2291,N,11319.5972,E,1,06,3.9,21.8,M,-5.4,M,,0000*60 
$GNGLL,2318.2291,N,11319.5972,E,034408.000,A,A*4E 
$GPGSA,A,3,12,06,09,25,05,02,,,5,5555.5,3.9,4.0*30 
$GNRMC,034408.000,A,2318.2291,N,11319.5972,E,000.0,191.3,140919, , , A*77 
$GNVTG,191.3,T,,M,000.0,N,000.0,K,A*19 
BHGNzDA,034410.000,14,09,2019,00,00*4C95972,E,000.0,191.3,140919, , , A*7E0*69 


63.8.2.2 GPS 数据 
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第 六 十 四 章 Linux 多 点 电容 触摸 屏 实 验 
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第 六 十 五 章 Linux 音频 驱动 实验 
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第 六 十 六 章 Linux CAN 驱动 实验 
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第 六 十 七 章 Linux USB 驱动 实验 
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第 六 十 八 章 Linux 块 设备 驱动 实验 
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第 六 十 九 章 Linux. 网 络 驱动 实验 
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第 七 十 章 Linux WIFI 驱动 实验 








WIFI 的 使 用 已 经 很 常见 了 ， 手 机 、 平 板 、 汽 车 等 等 ， 虽 然 可 以 使 用 有 线 网 络 ， 但 是 有 时 候 
很 多 设备 存在 布线 困难 的 情况 ， 此 时 WIFI 就 是 一 个 不 错 的 选择 。 正 点 原子 LMX6U-ALPHA 开 
发 板 支 持 USB 和 SDIO 这 两 种 接口 的 WIFI, 本 章 我 们 就 来 学 习 一 下 如 何在 LIMX6U-ALPHA FF 
发 板 上 使 用 USB 和 SDIO 这 两 种 WIFI。 
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70.1 WIFI 驱动 添加 与 编译 


正点 原子 的 IMX6U-ALPHA 开发 板 目 前 支持 两 种 接口 的 WIFI: USB 和 SDIO， 其 中 USB 


























WIFI 使 用 使 用 的 芯片 为 RTL8188EUS，SDIO 接口 的 WIFI 使 用 芯片 为 RTL8189FS， 也 叫做 
RTL8189FTV。 这 两 个 都 是 realtek 公司 出 品 的 WIFI 芯片 。WIFI 驱动 不 需要 我 们 编写 ， 因 为 
realtek 公司 提供 了 WIFI 驱动 源码 ， 因 此 我 们 只 需要 将 WIFI 驱动 源码 添加 到 Linux 内 核 中 ， 然 
后 通过 图 形 化 界面 配置 ， 选 择 将 其 编译 成 模块 即 可 。 

正点 原子 IMX6U-ALPHA 开发 板 默认 会 赠送 一 个 RTL8188 USB WIFI, RTL8188 USB WIFI 
如 图 70.1.1 所 示 : 





























图 70.1.1 RTL8188 USB WIFI 
另外 ， 正 点 原子 还 有 一 款 采 用 RTL8189FTV 芯片 的 SDIO WIFI, WB 70.1.2 所 示 : 











图 70.1.2 RTL8188 SDIO WIFI 


70.1.1 向 Linux 内 核 添 加 WIFI 驱动 


1. rtl81xx 驱动 文件 浏览 


WIFI 驱动 源码 已 经 放 到 了 开发 板 光盘 中 ， 路 径 为 : 1、 例 程 源 码 ->5、 模 块 驱动 源码 ->1、 
RTL8XXX WIFI 驱动 源码 -> realtek. realtek 目录 下 就 存放 着 RTL8188EUS 和 RTL8189FS 这 两 
个 苑 片 的 驱动 源码 ， 如 图 70.1.1.1 所 示 : - 





T rtl8188EUS 2019-09-14 16:59 文件 夹 
T rtl8189FS 2019-09-14 21:01 cte 
C] Kconfig 2019-09-14 19:13 文件 1 KB 
[C] Makefile 2019-09-14 16:54 文件 1 KB 


图 70.1.1.1 rtlSxxx WIFI 驱动 
其 中 rtl8188EUS 下 存放 着 RTL8188EUS 驱动 , RTL8189FS 存放 着 RTLS189FS/FTV 的 驱动 
文件 。Kconfig 文件 是 WIFI 驱动 的 配置 界面 文档 ， 这 样 可 以 通过 Linux 内 核 图 形 化 配置 界面 来 
选择 是 否 编译 WIFI 驱动 ，Kconfig 文件 内 容 如 下 所 示 : 
示例 代码 70.1.1.1 Kconfig 文件 内 容 
i menuconfig REALTEK WIFI 
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2 tristate "Realtek wifi" 

3 

4 if REALTEK WIFI 

5 

6 choice 

7 prompt "select wifi type" 

8 default RTL9189FS 

9 

JH) contie RILOLGHPS 

ilal depends on REALTEK WIFI 

3 igseabsheehEe: "edle S SESv/ ee 
1,3) 

14 config RTL8188EUS 

155 depends on REALTEK WIFI 

16 tristate "rtl8188eus usb wifi" 

1g 


18 endchoice 
19 endif 
Makefile 文件 内 容 如 下 所 示 
示例 代码 70.1.1.2 Makefile 文件 内 容 
1 obj-$(CONFIG RTL8188EUS) += rt18188EUS/ 
2 obj-$ (CONFIG RTL8189FS) += rt18189FS/ 


2. XE rtl81xx 驱动 添加 到 Linux 内 核 中 


将 realtek 整个 目录 找 贝 到 ubuntu 下 Linux 内 核 源码 中 的 drivers/net/wireless Hx F, e H 
录 下 存放 着 所 有 WIFI 驱动 文件 。 找 贝 完成 以 后 此 目录 如 图 70.1.1.1 所 示 ; 























$ ls 

atmel cs.c Makefile ray cs.h w13501 cs .< 

atmel.h modules.builtin  rayctl.h w13501.h 

atmel pci.c modules.order zd1201.c 
rndis wlan.c zd1201.h 


Kconfig mwl8k.c 


at76c50x-usb.h 
built-in.o | mac80211 hwsim.c 
atmel.c mac80211 hwsim.h ray cs.c 





图 70.1.1.1 拷贝 完成 的 wireless 目录 
图 70.1.1.1 中 框 选 出 来 的 就 是 我 们 刚刚 拷贝 进来 的 realtek 目录 。 
3、 修 改 drivers/net/wireless/Kconfig 
打开 drivers/net/wireless/Kconfig， 在 里 面 加 入 下 面 这 一 行内 容 : 
source "drivers/net/wireless/realtek/K config" 
添加 完 以 后 的 Kconfig 文件 内 容 如 下 所 示 : 

示例 代码 70.1.1.3 drivers/net/wireless/Kconfig 文件 内 容 









































Ue 


2 # Wireless LAN device configuration 
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3 d 
4 


5 menuconfig WLAN 





286 source "drivers/net/wireless/rsi/Kconfig" 
287 source "drivers/net/wireless/realtek/Kconfig" 
286 
289 endif 4 WLAN 
第 287 行 就 是 添加 到 drivers/net/wireless/Kconfig 中 的 内 容 ， 这 样 WIFI 驱动 的 配置 界面 才 
会 出 现在 Linux 内 核 配置 界面 上 。 


3、 修 改 drivers/net/wireless/Makefile 


打开 drivers/net/wireless/Makefile， 在 里 面 加 入 下 面 一 行内 
obj-y += realtek/ 

修改 完 以 后 的 Makefile 文件 内 容 如 下 所 示 : 

示例 代码 70.1.1.4 drivers/net/wireless/Makefile 文件 内 容 














- 


























l # 

2 # Makefile for the Linux Wireless network device drivers. 
3 

4 

5 obj-S(CONFIG IPW2100) += ipw2x00/ 


62 obj-S$(CONFIG CW1200) += cw1200/ 
63 obj-$(CONFIG RSI 91X) += rsi/ 
64 

65 obj-y += realtek/ 


第 65 行 ， 编 译 realtek 中 的 内 容 ， 至 此 ，Linux 内 核 要 修改 的 内 容 就 全 部 完成 了 。 


70.1.2 配置 Linux 内 核 


在 编译 RTL8188 和 RTL8189 驱动 之 前 需要 先 配置 Linux 内 核 。 
1、 配 置 USB 支持 设备 
配置 路 径 如 下 : 


-> Device Drivers 
-> «*» USB support 
-> <*> Support for Host-side USB 

-» «*» EHCI HCD (USB 2.0) support 

-» «*» OHCI HCD (USB 1.1) support 

-> <*> ChipIdea Highspeed Dual Role Controller 
-> [*] ChipIdea device controller 
-> [*] ChipIdea host controller 


2、 配 置 支持 WIFI 设备 
配置 路 径 如 下 : 
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-> Device Drivers 
-> [*] Network device support 
-> [*] Wireless LAN 
-> <*> JEEE 802.11 for Host AP (Prism2/2.5/3 and WEP/TKIP/CCMP) 
-> [*] Support downloading firmware images with Host AP driver 
-> [*] Support for non-volatile firmware download 


配置 完 如 图 70.1.2.1 所 示 : 


zuozhongkai@ubuntu: -/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 


Wireless LAN 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes 
features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in 
[ ] excluded «M» module < > module capable 
t(-) 


[-] Broadcom device tracing 


E* IEEE 802.11 for Host AP (Prism2/2.5/3 and WEP/TKIP/CCMP)| 
[*] Support downloading firmware images with Host AP driver 
[*] Support for non-volatile firmware download 
arvell 8xxx Libertas WLAN driver suppor 
Softmac Prism54 support 
Ralink driver support ---- 


Realtek rtlwifi family of devices ---- 编译 进 Linux 内 核 
TI Wireless LAN support ---- 


< Exit > < Help > < Save > < Load > 





图 70.1.2.1 配置 支持 WIFI 设备 
3、 配 置 支持 IEEE 802.11 


配置 路 径 如 下 : 
-> Networking support 
-> -*- Wireless 
-> [*] cfg80211 wireless extensions compatibility 
-> <#> Generic IEEE 802.11 Networking Stack (mac80211) 
配置 完 如 图 70.1.2.2 所 示 : 


zuozhongkai@ubuntu: -/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 


Wireless 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes 
features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in 
[ ] excluded «M» module < > module capable 


cfg80211 regulatory debugging 
cfg80211 certification onus 
enable powersave by default 


< Exit» «Help» «Save» < Load > 
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图 70.1.2.2 IEE 802.11 配置 项 
配置 好 以 后 重新 编译 一 下 Linux 内 核 , 得 到 新 的 zImage, 后 面 使 用 新 编译 出 来 的 zImage 局 
动 系统 。 



































70.1.3 编译 WIFI 驱动 


执行 “make menuconfig” 命 令 , 打开 Linux 内 核 配 置 界面 , 然后 按照 如 下 路 径 选 择 将 rtl81xx 
驱动 编译 为 模块 : 
-> Device Drivers 
-> Network device support (NETDEVICES [=y]) 
-> Wireless LAN (WLAN [=y]) 
-> Realtek wifi (REALTEK WIFI [=m]) 

-> rtl8189ftv sdio wifi 

-> rtl8188eus usb wifi 
配置 结果 如 图 70.1.3.1 Bran: 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 




















Realtek wifi 
Arrow keys navigate the menu. <Enter> selects submenus ---> (or empty 
submenus ----). Highlighted letters are hotkeys. Pressing <Y> includes, 
<N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for 
Help, </> for Search. Legend: [*] built-in [ ] excluded «M» module < > 


-Ẹ- Realtek wifi 

select wifi type 
<M> rtl8189fs/ftv sdio wifi 
«M» rtl8188eus usb wifi 


< Exit» «Help»  Á «Save» < Load > 





图 70.1.3.1 WIFI 配置 界面 
70.1.3.1 中 的 配置 界面 就 是 我 们 添加 进去 的 WIFI 配置 界面 ,选中 “rt18189fs/ftv sdio wifi" 
和 “rtl8188eus usb wifi”， 将 其 编译 为 模块 。 执 行 如 下 命令 编译 模块 : 
make modules -j12 /编译 驱动 模块 
编译 完成 以 后 就 会 在 rl8188EUS 和 rtl8189FS 文件 夹 下 分 别 生成 8188eu.ko 和 8189fs.ko 这 
两 个 .ko 文件 ， 结 果 如 图 70.1.3.2 所 示 : 
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中 四 ES 
8188eu.ko 8188eu.o Kconfig wlanQdhcp 
8188eu .mod. clean ifcfg-wlanO Makefile 
8188eu .mod . modules.order runwpa 


$C 


$ cd rtl8189FS/ 


$ ls 
8189fs.o Kconfig wWLangdhcp 
clean ifcfg-wlanO Makefile 

modules.order runwpa 


su 
图 70.1.3.2 编译 结果 

图 70.1.3.2 中 的 8188eu.ko 和 8189fs.ko 就 是 我 们 需要 的 RTL8188EUS 和 RTL8189FS 的 驱 
动 模块 文件 ， 将 这 两 个 文件 拷贝 到 rootfs/lib/modules/4.1.15 目录 中 ， 命 令 如 下 ; 

sudo cp 8189fs.ko /home/zuozhongkai/linux/nfs/rootfs/lib/modules/4.1.15/ -rf 

sudo cp 8188eu.ko /home/zuozhongkai/linux/nfs/rootfs/lib/modules/4.1.15/ -rf 

因为 我 们 重新 配置 过 Linux 内 核 , 因此 也 需要 使 用 新 的 zImage 启动 ,将 新 编译 出 来 的 zImage 
镜像 文件 拷贝 到 Ubuntu 中 的 tftpboot 目录 下 ， 命 令 如 下 : 

cp arch/arm/boot/zImage /home/zuozhongkai/linux/tftpboot/ -f 

然后 重启 开发 板 !! 1! 


























70.1.4 驱动 加 载 测试 


1. RTL8188 USB WIFI 驱动 测试 


重启 以 后 我 们 试 着 加 载 一 下 8188eu.ko 和 8189fs.ko 这 两 个 驱动 文件 ， 首 先 测试 一 下 
RTL8188 的 驱动 文件 ， 将 RTL8188 WIFI 模块 插 到 开发 板 的 USB HOST 接口 上 。 进 入 到 目录 
lib/modules/4.1.15 中 ， 输 入 如 下 命令 加 载 8188eu.ko 这 个 驱动 模块 : 

depmod /第 一 次 加 载 驱动 的 时 候 需 要 运行 此 命令 

modprobe 8188eu.ko /加 载 驱动 模块 

如 果 驱 动 加 载 成 功 的 话 如 图 70.1.4.1 所 示 : 


/lib/modules/4.1.15 # modprobe 8188eu.ko 

RTL871X: module init start 

RTL871X: rt18188eu v4.3.0.9 15178.20150907 
RTL871X: build time: Sep 14 2019 21:09:29 

bFwReady == . FALSE call reset 8051... 

RTL871X: rtw, ndev. init(wlanO) 

usbcore: registered new interface driver rt18188eu 
RTL871X: module init ret=0 

/lib/modules/4.1.15 # J 



































图 70.1.4.1 RTL8188 驱动 加 载 成 功 
输入 “ifconfig -a” 命 令 ， 查 看 wlanX(X=0....n) 网 卡 是 否 存 在 ， 一 般 都 是 wlan0， 除 非 板子 
上 有 多 个 WIFI 模块 在 工作 ， 结 果 如 图 70.1.4.2 所 示 : 
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/lib/modules/4.1.15 # ifconfig -a 
eth0 Link encap: ht Hwaddr 00:04:9F:04:D2:35 
inet addr:192.168.1.251 Bcast:192.168.1.255 Mask:255.255.255.0 
inet6 addr: fe80::204:9fff:fe04:d235/64 Scope:Link 
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 
Ex packets:4281 errors:0 dropped:60 overruns:0 frame:0 
aE rrp :1408 errors:0 dropped:0 overruns:0 carrier:0 
on isions:0 txqueuelen:1000 
RX bytes:4498909 (4.2 MiB) TX bytes:225300 (220.0 KiB) 


ethl Link encap:Ethernet Hwaddr 00:04:9F:04:D2:35 
BROADCAST MULTICAST MTU:1500 Metric:1 
RX packets:0 errors:0 dropped:0 overruns:0 frame:0 
xd pcn :0 errors:0 dropped:0 overruns:0 carrier:0 
Ee isions:0 txqueuelen:1000 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 


lo Link encap:Local Loopback 
inet addr:127.0.0.1 Mask:255.0.0.0 
inet6 addr: ::1/128 Scope:Host 
UP LOOPBACK RUNNING MTU:65536 Metric:1 
RX packets:0 errors:0 dropped:0 overruns:0 frame:0 
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 
collisions:0 txqueuelen:O 
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B) 


sit0 Link encap:IPv6-in-IPv4 
NOARP MTU:1480 Metric:1 
RX aen J errors: $i nen: ^ overruns: $i frame:0 ó 
TX packets:0 errors: roppa overruns:0 carrier: 上 
collisions:0 txqueuelen: WIFI 对 应 的 网 卡 
RX bytes:0 (0.0 B) TX 二 0 (0.0 B) 


Link encap:Ethernet Hwaddr 00:13:EF:F1:0A:D7 
BROADCAST MULTICAST MTU:1500 Metric:1 
a packets:0 errors:0 dropped:0 overruns:0 frame:0 


A Bere :0 errors:0 dropped:0 overruns:0 carrier:0 
Es isions:0 txqueuelen:1000 
RX bytes:0 (0.0 B) TX bytes:O (0.0 B) 








图 70.1.4.2 当前 开发 板 所 有 网 卡 
从 图 70.1.4.2 中 可 以 看 出 ， 当 前 开发 板 有 一 个 叫做 “wlan0” 的 网 卡 ， 这 个 就 是 RTL8188 对 
应 的 网 卡 。 
2. RTL8189 SDIO WIFI 驱动 测试 


测试 完 RTL8188 以 后 ， 再 来 测试 一 下 RTL8189 这 个 SDIO WIFI， 因 为 IMX6U-ALPHA Jf 
发 板 的 SDIO WIFI 接口 与 SD 卡 公 用 一 个 SDIO 接口 .因此 SD 卡 和 SDIO WIFI 只 能 二 选 其 一 ， 
一 次 只 能 一 个 工作 ， 所 以 测试 RTL8189 SDIO WIFI 的 时 候 需 要 拔 插 SD F. SDIO WIFI 接口 原 
理 图 如 图 70.1.4.3 所 示 : 


WIFI 


























P4 
DEDE 3V3 1 2 GND 
USDHCI DATAO 3 4 USDHCI DATAI 
USDHCI DATA2 5 6 USDHCI DATA3 
USDHCI CMD 7 8 USDHCI CLK 
WIFI INT 9 10 WIFI REG ON 
USDHCI CD B 11 12 

Header 6X2 
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图 70.1.4.3 SDIO WIFI 接口 


论坛 :www.opendev.com 


测试 开始 之 前 要 先 将 SD 卡 拔 出， 然后 将 RTL8189 SDIO WIFI 模块 插入 到 SDIO WIFI 座 子 
上 ， 如 图 70.1.4.4 所 示 : 


LET 
eei 


Me 


LEE 


- 
2] 
End 
E 
LU 
Ld 
"T 
Ll 
Lad 
~a 
" 


图 70.1.4.4 SDIO WIFI 连接 图 

















SDIO WIFI 与 开发 板 连接 好 以 后 就 可 以 测试 了 ， 输 入 如 下 命令 加 载 8189fs.ko 这 个 驱动 模 


块 : 


depmod /第 一 次 加 载 驱 动 的 时 候 需 要 运 
modprobe 8189eu.ko /加 载 驱动 模块 
如 果 驱 动 加 载 成 功 的 话 如 图 70.1.4.5 所 示 : 


/lib/modules/4.1.15 # modprobe 8189fs.ko 


RTL871x: 
RTL871x: 
RTL871X: 
RTL871x: 
RTL871x: 
rs:0, tr- 
RTL871x: 
RTL871x: 


module init start 

rt18189fs v4.3.24.8 22657.20170607 

HW EFUSE 

hal. com config. channel. plan chplan:0x20 
rtw, regsty. chk target tx power, valid return 
-1 


rtw_ndev_init(wlan0) ifl mac_addr=d4:b7:61:53:8f:e0 


module init ret=0 


/lib/modules/4.1.15 £ 





行 此 命令 


_FALSE for band:0, path:0, 





70.1.4.5 RTL8189 驱动 加 载 成 功 
从 70.1.4.5 可 以 看 出 ，RTL8189 SDIO WIFI 驱动 加 载 成 功 ， 同 样 使 用 “ifconfig -a” 命 令 查 





看 一 下 是 否 有 wlanX(X=0...n) 网 卡 存在 , 如 果 有 的 话 就 说 明 RTL8189 SDIO WIFI 驱动 工作 正常 。 














不 管 是 RTL8188 USB WIFI 还 是 RTL8189 SDIO WIFI， 了 驱动 测试 都 工作 正常 ， 但 是 我 们 得 
能 联网 啊 ， 不 能 联网 的 话 要 他 有 什么 用 呢 ? WIFI 要 想 联网 ， 和 
则 无 法 连接 路 由 器 ， 接 下 来 我 们 就 移植 这 些 第 三 方 组 件 。 
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70.2 wireless tools 工具 移植 与 测试 


70.2.1 wireless tools 移植 














wireless tools 是 操作 WIFI 的 工具 集合 ， 包 括 一 下 工具 : 
(D. iwconfig: 设置 无 线 网 络 相关 参数 。 

Q). iwlist: 扫描 当前 无 线 网 络 信息 ， 获 取 WIFI 热点 。 
(S. iwspy: 获取 每 个 节点 链接 的 质量 。 
@ 
© 





. iwpriv: 操作 WirelessExtensions 特定 驱动 。 
~ ifrename: 基于 各 种 静态 标准 命名 接口 。 

我 们 最 常用 的 就 是 iwlist 和 iwconfig 这 两 个 工具 ， 首 先 获 取 到 相应 的 源码 包 ， 这 里 我 们 已 
经 放 到 了 开发 板 光盘 中 , 路 径 为 :1、 例 程 源 码 -》7、 第 三 方 库 源码 -》wlist for visteon-mastertarbz2。 
将 iwlist for visteon-master.tar.bz2 拷贝 到 Ubuntu 中 前 面 创建 的 tool 目录 下 , 拷贝 完成 以 后 将 其 
解压 ， 生 成 iwlist_for_visteon-master XFX. YEA FI iwlist_for_visteon-master 文件 夹 里 面 , 打开 
Makefile 文件 ， 修 改 Makefile 中 的 CC, AR 和 RANLIB 这 三 个 变量 ， 修 改 后 的 值 如 图 70.2.1.1 
所 示 : 


































































































arm- Linux-gnueabihft-gcc 


arm-linux-gnueabihf-ar 
= arm-linux-gnueabihf-ranlib 





图 70.2.1.1 修改 后 的 CC、AR 和 RANLIB 值 

图 70.2.1.1 F CC, AR 和 RANLIB 这 三 个 变量 为 所 使 用 的 编译 器 工具 ， 将 其 改 为 我 们 所 使 
用 的 arm-linux-gnueabihf-xxx 工具 即 可 。 修 改 完成 以 后 就 可 以 使 用 如 下 命令 编译 ; 

makeclean ”// 先 清理 一 下 工程 

make // 编 译 

编译 完成 以 后 就 会 在 当前 目录 下 生成 iwlist、iwconfig、iwspy、iwpriv、ifrename 这 5 个 工 
具 ， 另 外 还 有 很 重要 的 libiw.so. 29 这 个 库 文件 。 将 这 5 个 工具 找 贝 到 开发 板 根 文件 系统 下 的 
/usrbin 目录 中 ,将 libiw.so.29 这 个 库 文件 拷贝 到 开发 板 根 文件 系统 下 的 /usr/lib 目录 中 ,命令 如 
下 : 






















































































sudo cp iwlist iwconfig iwspy iwpriv ifrename /home/zuozhongkai/linux/nfs/rootfs/usr/bin/ -f 
sudo cp libiw.so.29 /home/zuozhongkai/linux/nfs/rootfs/usr/lib/ -f 
拷贝 完成 以 后 可 以 测试 iwlist 是 否 工 作 正常 。 








70.2.2 wireless tools 工具 测试 


这 里 我 们 主要 测试 一 下 iwlist 工具 ,要 测试 iwlist 工具 , 先 测 试 一 下 iwlist 工具 能 不 能 工作 ， 
输入 iwlist 命令 ， 如 果 输 出 图 70.2.2.1 所 示 信 息 就 表明 iwlist 工具 工作 正常 。 
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/ # iwlist 
Usage: iwlist 


/*W 


d 
interface 
Ds oua, 
[interface 
[interface] 
[interface] 
Led en 
[interface 
[interface] 
[interface] 
[interface] 
[interface] 
[interface] 
[interface] 
[interface] 
[interface] 
[interface] 
[interface] 


论坛 :www.opendev.com 


scanning [essid NNN] [last] 
frequency 
channel 
bitrate 

rate 
encryption 
keys 

power 
txpower 
retry 

AS 
accesspoints 
peers 

event 

auth 

wpakeys 
genie 
modulation 


图 70.2.2.1 iwlist 工具 


正式 测试 iwlist 之 前 得 先 让 WIFI 模块 工作 起 来 。- RTL8188 或 RTL8189 都 可 以 , 以 RTL8188 
USB WIFI 为 例 , 先 将 RTL8188 WIFI 模块 插 到 开发 板 的 USB HOST 接口 上 , 然后 加 载 RTL8188 
驱动 模块 8188eu.ko， 驱 动 加 载 成 功 以 后 在 打开 wlan0 网 卡 ， 命 令 如 下 : 
/加 载 RTL8188 驱动 模块 

ifconfig wlan0 up /打开 wlan0 网 卡 

wlan0 网 卡 打 开 以 后 就 可 以 使 用 iwlist 命令 查找 当前 环境 下 的 WIFI 热点 信息 ， 也 就 是 无 线 
路 由 器 ， 输 入 如 下 命令 : 

iwlist wlan0 scan 

上 述 命令 就 会 搜索 当前 环境 下 的 所 有 WIFI 热点 ， 然 后 将 这 

包括 MAC 地 址 、ESSID(WIFI 名 字 )、 频 率 、 速 率 ， 信号 质量 量 等 等 


里- 村 -证 
/lib/modules/4.1.15 # iwlist wlan0 scan 
wlanO Scan completed : 
Cell 01 - Address: E4:0E:EE:F2:11:15 
ESSID: 
Ed IEEE 802.11bgn 
Mode:Master 
Frequency:2.412 GHz (Channel 1) 
Encryption key:on 
Bit Rates:300 Mb/s 
Extra:rsn, 1e230140100000fac040100000fac040100000fac020000 
IE: IEEE 802.11i/WPA2 Version 1 
Group Cipher : CCMP 
Pairwise Ciphers (1) : CCMP 
Authentication Suites (1) : 
Qualityz51/100 signal Teve1284/100 
Extra: fm-0001 


x] 70.2.22. 13 
EH ume 1 i mUesUDME 
点 上 ， 这 个 WIFI 热点 信息 如 图 70.2.2.3 所 示 : 




















modprobe 8188eu.ko 




















些 热 点 的 信息 信息 答应 
， 如 图 70.2.2.2 所 示 : 


出 来 ， 
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Cell 05 - Address: 88:F8:72:8D:F3:18 
ESSID: "ZZK" 


Protocol:IEEE 802.11bgn 
Mode:Master 
Frequency:2.437 GHz (Channel 6) 
Encryption key:on 
Bit Rates:300 Mb/s 
Extra:rsn, 1e-30140100000fac040100000fac040100000fac020000 
IE: IEEE 802.11i/WPA2 Version 1 
Group Cipher : CCMP 
Pairwise Ciphers (1) : CCMP 
Authentication Suites (1) : PSK 
IE: Unknown: DD880050F204104A00011010440001021038000103104700106304125 3101920 
3728DF31C10210006487561776569102300045753787810240007323031372D31311042000F3132333435363 
i001 OUHIDOONOQONISSUESSAERNSEENLIURLUUUM PSSECOBUA SESSHOR DEO US OTONHELAORUMSSONEBIM 
72A00012 
Qualityz48/100 signal leve12100/100 
Extra: fm=0003 





可 以 看 出 ,“ZZK” 这 个 热 点 信息 已 经 被 扫 ml r, e 要 想 连接 到 指定 的 WIFI 
热点 上 就 需要 用 到 wpa_supplicant 工具 ， 所 以 接 下 来 就 是 移植 此 工具 。 
































70.3 wpa supplicant 移植 


70.3.1 libopenssl 移植 





wpa_supplicant 依赖 于 libopenssl， 因 此 需要 先 移植 libopenssl, libopenssl 源码 已 经 放 到 了 开 
发 板 光盘 中 , 路 径 为 : 1、 例 程 源码 -》7、 第 三 方 库 源 码 -》openssl-1.1.1-stable-SNAP-20190915.targz。 
将 openssl 源码 压缩 包 拷 贝 到 Ubuntu 中 前 面 创建 的 tool 目录 下 ， 然 后 使 用 如 下 命令 将 其 解压 

tar -vxzf openssl-1.1.1-stable-SNAP-20190915.tar.gz 

解压 完成 以 后 就 会 生成 一 个 名 为 openssl-1.1.1-stable-SNAP-20190915 的 目录 ， 然 后 在 新 建 
一 个 名 为 “libopenssl1” 的 文件 夹 ， 用 于 存放 libopenssl 的 编译 结果 。 进 入 到 解压 出 来 的 openssl- 
1.1.1-stable-SNAP-20190915 目录 中 ， 然 后 执行 如 下 命令 进行 配置 : 

./config shared no-asm --prefix=/home/zuozhongkai/linux/IMX6ULL/tool/libopenssl 

配置 成 功 以 后 会 生成 Makefile, HJF Makefile， 找 到 所 有 包含 “-m64” 的 内 容 ， 一 共 两 处 
分 别 为 变量 CNF. CFLAGS 和 CNF_CXXFLAGS， 将 这 两 个 变量 中 的 “-m64” 删 除 掉 ， 删 除 以 
后 如 图 70.3.1.1 所 示 : 






























































=-DNDEBUG 


=-pthread 
--std-c4-11 -pthread 


图 70.3.1.1 删除 掉 “-m64” 














Makefile 修改 好 以 后 使 用 如 下 命令 编译 并 安装 libopenssl: 
make CROSS COMPILE-arm-linux-gnueabihf- -j12 
make install 


编译 安装 完成 以 后 的 libopenssl 目录 内 容 如 图 70.3.1.2 所 示 : 
$ ls 











$ 


图 70.3.1.2 编译 并 安装 成 功 的 libopenssl 目录 
将 图 70.3.1.2 中 的 lib 目录 是 我 们 需要 的 ， 将 lib 目录 下 的 所 有 文件 拷贝 到 开发 板 根 文件 系 
统 中 的 /usr/lib 目录 下 ， 命 令 如 下 : 
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sudo cp lib/* /home/zuozhongkai/linux/nfs/rootfs/usr/lib/ -rf 


70.3.2 libnl 库 移 植 


wpa_supplicant 也 依赖 于 libnl， 因 此 还 需要 移植 一 下 libnl PE, libnl 源码 已 经 放 到 了 开发 板 
光盘 中 ， 路 径 为 : 1、 例 程 源码 -》7、 第 三 方 库 源码 -》libnl-3.2.23.tar.gz。 将 libnl 源码 压缩 包 拷 
贝 到 Ubuntu 中 前 面 创建 的 tool 目录 下 ， 然 后 使 用 如 下 命令 将 其 解压 : 

tar -vxzf libnl-3.2.23.tar.gz 

得 到 解压 完成 以 后 会 得 到 libnl-3.2.23 文件 来 ， 然 后 在 新 建 一 个 名 为 “libn1” 的 文件 来， 用 
于 存放 libnl 的 编译 结果 。 进 入 到 libnl-3.2.23 文件 夹 中 ， 然 后 执行 如 下 命令 进行 配置 : 

./configure --host-arm-linux-gnueabihf --prefix-/home/zuozhongkai/linux/IM X6ULL/tool/libnl/ 

--host 用 于 指定 交叉 编译 器 的 前 级 , 这 里 设置 为 “arm-linux-gnueabihf”，--prefix 用 于 指定 编 
译 结果 存放 目录 ,这 里 肯定 要 设置 为 我 们 刚刚 创建 的 libnl 文件 来。 配置 完成 以 后 就 可 以 执行 如 
下 命令 对 libnl 库 进 行 编译 、 安 装 : 

make -j12 /编译 

make install /安装 

编译 安装 完成 以 后 的 libnl 目录 如 图 70.3.2.1 所 示 : 


: $ ls 
图 70.3.2.1 编译 安装 完成 后 的 libnl 目录 
我 们 需要 图 70.3.2.1 中 lib 目录 下 的 libnl 库 文件 , 将 lib 目录 下 的 所 有 文件 拷贝 到 开发 板 根 
文件 系统 的 /usr/lib 目录 下 ， 命 令 如 下 所 示 ; 
sudo cp lib/* /home/zuozhongkai/linux/nfs/rootfs/usr/lib/ -rf 










































































































































































70.3.3 wpa supplicant 移植 


接 下 来 移植 wpa supplicant, wpa_supplicant 源码 我 们 已 经 放 到 了 开发 板 光盘 中 ， 路 径 为 : 
1、 例 程 源 码 ->7、 第 三 方 库 源 码 ->wpa_supplicant-2.7.targz， 将 wpa supplicant-2.7.tar.gz 拷贝 到 
Ubuntu 中 ， 输 入 如 下 命令 进行 解压 : 

tar -vxzf wpa_supplicant-2.7.tar.gz 

解压 完成 以 后 会 得 到 wpa. supplicant-2.7 文件 夹 ,进入 到 此 文件 夹 中 ，wpa_supplicant-2.7 H 
录 内 容 如 图 70.3.3.1 所 示 : 















































$ cd wpa supplicant-2.7/ 
$ ls 






CONTRIBUTIONS COPYING README 


$ 


图 70.3.3.1 wpa_supplicant-2.7 目录 
进入 到 图 70.3.3.1 中 的 wpa supplicant 目录 下 ， 然 后 进行 配置 ，wpa_supplicant 的 配置 比较 
特殊 ， 需 要 将 wpa supplicant 下 的 defconfig 文件 找 贝 一 份 并 重 命名 为 .conffig， 命 令 如 下 : 
cd wpa supplicant/ 















































cp defconfig .config 
完成 以 后 打开 .config 文件 ， 在 里 面 指定 交叉 编译 器 、openssl、libnl 库 和 头 文件 路 径 ， 设 置 











示例 代码 70.3.3.1 .config 文件 需要 添加 的 内 容 


1 CC = arm-linux-gnueabihf-gcc 
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3 
4 
5 


#openssl 库 和 头 文件 路 径 

CFLAGS += -I/home/zuozhongkai/linux/IMX6ULL/tool/libopenssl/include 

LIBS += -L/home/zuozhongkai/linux/IMX6ULL/tool/libopenssl/lib -lssl 
= Eve 


#1ibnl 库 和 头 文件 路 径 
CFLAGS += -I/home/zuozhongkai/linux/IMX6ULL/tool/libnl/include/libnl3 
LIBS += -L/home/zuozhongkai/linux/IMX6ULL/tool/libnl/lib 


OTO sd CE 






































CC 变量 用 于 指定 交叉 编译 器 ， 这 里 就 是 arm-linux-gnueabihf-gcc，CFLAGS 指定 需要 使 用 
的 库 头 文件 路 径 , LIBS 指定 需要 用 到 的 库 路 径 。 编 译 wap_supplicant 的 时 候 需 要 用 到 openssl 和 
libnl 库 ， 所 以 示例 代码 70.3.3.1 中 指定 了 这 两 个 的 库 路 径 和 头 文件 路 径 。 上 述 内 容 在 .config 中 
的 位 置 见 图 70.3.3.2: 


























CONFIG LIBNL32-y 


CC - arm-linux-gnueabihf-gcc 
CFLAGS += -I/home/zuozhongkai/linux/IMX6ULL/tool/libopenssl/include 


LIBS += -L/home/zuozhongkai/linux/IMX6ULL/tool/libopenssl/lib -lssl -lcrypto 


CFLAGS += -I/home/zuozhongkai/linux/IMX6ULL/tool/libnl/include/libnl3 
LIBS += -L/home/zuozhongkai/linux/IMX6ULL/tool/libnl/lib 








图 70.3.3.2 添加 到 .config 中 的 内 容 

.config 文件 配置 好 以 后 就 可 以 编译 wpa_supplicant 了 ， 使 用 如 下 命令 编译 : 

export PKG CONFIG _ PATH-/home/zuozhongkai/linux/IM X6ULL/tool/libnl/lib/pkgconfig: 
$PKG CONFIG PATH /指定 libnl 库 pkgconfig 包 位 置 

Imake -j12 /编译 

首先 我 们 使 用 export 指定 了 libnl 库 的 pkgconfig 路 径 ， 环 境 变量 PKG CONFIG PATH 保 

存 着 pkgconfig 包 路 径 。 在 tooMlibnVylib/ 下 有 个 名 为 “pkgconfig” 的 目录 ， 如 图 70.3.3.3 所 示 : 


$ ls 
LibnL-idiag-3.a 





































































libnl-3.a 
libnl-route-3.a 
LibnL-genL-3.a 


libnl-nf-3.a 
libnl-cli-3.a 


图 70.3.3.3 libnl 的 pkgconfig 目录 

编译 wpa_supplicant 的 时 候 是 需要 指定 libnl 的 pkgconfig 路 径 ， 否 则 会 提示 “1libnl-3.0” 或 
者 “libnl-3.0.pc” 找 不 到 等 错误 。 编 译 完成 以 后 就 会 在 本 目录 下 生成 wpa_supplicant 和 wpa cli 
这 两 个 软件 ， 如 图 70.3.3.3 所 示 : 
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zuozhongkai@ubuntu: ~/linux/IMX6ULL/tool/wpa_supplicant-2.7/wpa_supplicant 
eapoL test .< notify.h 


bgscan learn.c 
bgscan simple.c 


blacklist.c 


目录 中 ， 命 令 如 下 : 





notify.o 


eap proxy dummy.mak  offchannel. 
eap proxy dummy.mk — offchannel. 
eap register.c op_classes. 
eap_register.d op_classes. 
eap_register.o op_classes. 
eap testing.txt p2p supplic 
events.c p2p supplic 
events .d p2p supplic 
events .0 preauth tes 


README 


gas query.c README -HS20 
gas query.h README - P2P 
hs20 supplicant.c README -Wind 
hs20 supplicant.h README -WPS 
ibss_rsn.c rrm.c 
ibss_rsn.h rrm.d 
interworking.c rrm.o 
interworking.h scan.c 
libwpa test.c scan.d 


图 70.3.3.3 编译 出 来 的 wpa_cli 和 wpa_supplicant 文件 
将 图 70.3.3.3 中 的 wpa_cli 和 wpa_supplicant 这 两 个 文件 拷贝 到 开发 板 根 文件 系统 的 /usr/bin 


论坛 :Www.opendev.com 


wnm sta. 
wnm_sta, 


wpa er 
wpa_cli. 
wpa_cli. 
o 
ant.c 
ant.h wpa_passphrase.c 
ant_sd.c wpa passphrase.d 
t.c wpa_passphrase.o 
wpa_priv.c 
wpas_glue.c 
wpas glue.d 
Oows.txt wpas glue.h 
wpas glue.o 
wpas kay.c 


wpas_kay.h 
wpas module test;. 





wpa Suppticarnt.c 


sudo cp wpa cli wpa_supplicant /home/zuozhongkai/linux/nfs/rootfs/usr/bin/ -f 








拷贝 完成 以 后 重启 开发 板 ! 
如 果 wpa_supplicant 工作 正常 的 话 就 会 打印 出 版 本 号 ， 


/ € wpa_supplicant -v 

wpa_supplicant v2.7 

ra d i t (c) 2003-2018, Jouni Malinen <j@w1.fi> and contributors 
# 


从 图 70.3.3.4 可 以 看 出 ， 




















输入 “wpa_supplicant -v” 命 令 查看 一 下 wpa_supplicant 版 本 号 ， 























如 图 70.3.3.4 所 示 : 


图 70.3.3.4 wpa_supplicant 版 本 号 





wpa supplicant 的 版 本 号 输出 正常 ， 说 明 wpa supplicant 移植 成 


功 ， 接 下 来 就 是 使 用 wpa supplicant 将 开发 板 的 WIFI 链接 到 路 由 器 上 ， 实 现 WIFI 上 网 功能 。 


70.4 WIFI 联网 测试 


不 管 是 USB WIFI 还 是 SDIO WIFI， 联 网 的 操作 步骤 如 下 所 示 : 

CD. dii. E WIFI 模块, 如 果 是 板子 集成 的 就 不 需要 这 一 步 。 如 果 是 SDIO WIFI 的 话 确保 WIFI 
所 使 用 的 SDIO 接口 没有 插 其 他 的 模块 ， 比 如 SD 卡 ， 防 止 其 他 模块 对 SDIO WIFI 造成 影响 。 

@、 加 载 RTL8188 或 者 RTL8189 驱动 模块 。 

©, EH ifconfig 命令 打开 对 应 的 无 线 网 卡 ， 比 如 wlan0 或 wlan1...... 




























































































、 无 线 网 卡 打 开 以 后 使 用 iwlist 命令 扫描 一 下 当前 环境 下 的 WIFI 热点 ， 一 来 测试 一 下 
WIFI 工作 是 否 正常 。 二 来 检查 一 下 自己 要 连接 的 WIFI 热点 能 不 能 扫描 到 ， 扫 描 不 到 的 话 表 定 
就 没 法 连接 了 。 














当 上 述 步骤 确认 无 误 以 后 就 可 以 使 用 wpa_supplicant 来 将 WIFI 连接 到 指定 的 热点 上 , 实现 








联网 功能 。 


70.4.1 RTL8188 USB WIFI 联网 测试 




















首先 测试 一 下 RTL8188 USB WIFI 联网 测试 , 确 























保 RTL8188 能 扫描 出 要 连接 的 WIFI 热点 ， 





比如 我 要 连接 “ZZK” 这 个 WIFL iwlist 扫描 到 的 此 WIFI 热点 信息 如 图 70.4.1.1 所 示 : 














1515 





LMX6U RAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
Cell 02 - Address: 88:F8:72:8D:F3:18 
ESSID: "ZZK" 


Protocol:IEEE 802.11bgn 
Mode:Master 
Frequency:2.437 GHz (Channel 6) 
Encryption key:on 
Bit Rates:300 Mb/s 
Extra:rsn, 1e230140100000fac040100000fac040100000fac020000 
IE: IEEE 802.11i/WPA2 Version 1 
Group Cipher : CCMP 
Pairwise Ciphers (1) : CCMP 
Authentication Suites (1) : PSK 





要 连接 的 WIFI 热点 扫描 到 以 后 就 可 以 连接 了 ， 先 在 开发 板 根 文件 系统 的 /etc 目录 下 创建 一 
个 名 为 “wpa_supplicant.conf” 的 配置 文件 ， 此 文件 用 于 配置 要 连接 的 WIFI 热点 以 及 WIFI 秘 
密 ， 比 如 我 要 连接 到 “ZZK” 这 个 热点 上 ， 因 此 wpa_supplicant.conf 文件 内 容 如 下 所 示 : 
示例 代码 70.4.1.1 wpa_supplicant.conf 文件 内 容 


ctrl interface-/var/run/wpa supplicant 





























ap scan-zi 
network={ 

ssid="ZZK" 

pSk="xxxxxxxx" 
} 

第 4 行 ，ssid 是 要 连接 的 WIFI 热点 名 字 ， 这 里 我 要 连接 的 是 “ZZK” 这 个 WIFI 热点 。 

第 5 行 ，psk 就 是 要 连接 的 WIFI 热点 密码 ， 根 据 自己 的 实际 情况 填写 即 可 。 

注意 ，wpa_supplicant.conf 文件 对 于 格式 要 求 比较 严格 ,“=” 前 后 一 定 不 能 有 空格 ， 也 不 要 
用 TAB 键 来 缩 进 , 比如 第 4 行 和 5 行 的 缩 进 应 该 采用 空格 , 否则 的 话 会 出 现 wpa_supplicant.conf 
文件 解析 错误 ! 最 重要 的 一 点 ! wpa_supplicant.conf 文件 内 容 要 自己 手动 输入 , 不 要 偷懒 复制 粘 
MELL! 

wpa supplicantconf 文件 编写 好 以 后 再 在 开发 板 根 文 件 系统 下 创建 一 个 

“/varrun/wpa_supplicant” 目 录 ，wpa_supplicant 工具 要 用 到 此 目录 ! 命令 如 下 : 
d iMd. TEN -p 


GY Os O NO ES 


















































入 如 下 命令 : 
wpa supplicant -D wext -c /etc/wpa supplicant.conf -1 wlan0 & 


?4 RTL8188 连接 上 WIFI 热点 以 后 会 输出 如 图 70.4.1.2 所 示 的 信息 : 


Ds 
RTL871X: Ftw_ aes _decrypt(wlan0) no. gkey. bc. cnt:4, no. gkey. mc, cnt:0 

RTL871X: recv eapol packet 

RTL871X: send eapol packet 

RTL871X: set pairwise key camid:4, addr:88:f8:72:8d:f3:18, kid:0, type: 

wlan0: WPA: Key negotiation completed with 88:f8:72:8d:f3:18 [PTRRTLB7 1X: "n" group key camid:5, addr: 
88: fe: 72: 8d: f3: 18, kid:1, type:AES 连接 成 功 


|wlan0: CTRL-EVENT-CONNECTED|- Connection to 88:f8:72:8d:f3:18 completed [id=0 id_str=] 


图 70.4.1.2 连接 成 功 
从 图 70.4.1.2 可 以 看 出 , 25 RTL8188 连接 到 WIFI 热点 上 以 后 会 输出 “wlan0: CTRL-EVENT- 
CONNECTED” 字 样 。 接 下 来 就 是 最 后 一 步 了 ， 设 置 wlan0 的 IP 地址， 这 里 使 用 udhepc 命令 
从 路 由 器 申请 卫 地 址 ， 输 入 如 下 命令 
udhcpc -i wlan0 // 从 路 由 器 获取 了 Pp 地址 
卫 地 址 获取 成 功 以 后 会 输出 如 图 70.4.2.2 所 示 信 息 : 
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/lib/modules/4.1.15 # udhcpc -i wlanO 
udhcpc: started, v1.29.0 

Setting IP address 0.0.0.0 on wlanO 
udhcpc: sending discover 

udhcpc: sending select for 192.168.1.126 
udhcpc: lease of 192.168.1.126 obtained, lease time 86400 
Setting IP address 192.168.1.126 on wlanO 
Deleting routers 

route: SIOCDELRT: No such process 

Adding router 192.168.1.1 

Recreating /etc/resolv.conf 

Adding DNS server 114.114.114.114 
/lib/modules/4.1.15 # J 


图 70.4.2.2 wlanO 网 卡 WIFI 地 址 获取 成 功 

从 图 70.4.2.2 可 以 看 出 ，wlan0 的 IP 地 址 获取 成 功 ， 卫 地 址 为 192.168.1.126。 可 以 输入 如 
下 命令 查看 一 下 wlan0 网 卡 的 详细 信息 : 

ifconfig wlan0 
结果 如 图 70.4.2.3 所 示 : 


/lib/modules/4.1.15 # ifconfig wlanO 
wlanO Link encap:Ethernet Hwaddr 00:13:EF:F1:0A:D 
inet addr:192.168.1.126 Bcast:192.168.1. "d Mask:255.255.255.0 
inet6 addr: fe80::213:efff:fefl:ad7/64 Scope:Link 
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 
E packets:2538 errors:0 dropped:127 overruns:O frame:0 
rs micum :11 errors:0 dropped:3 overruns:0 carrier:0 
2 isions:0 txqueuelen:1000 
RX bytes:262646 (256.4 KiB) TX bytes:1783 (1.7 KiB) 


/lib/modules/4.1.15 £ 

















图 70.4.2.3 wlan0 网 卡 详细 信息 
可 以 通过 电脑 ping 一 下 wlan0 的 192.168.1.126 这 个 人 地 址 ,如果 能 ping 通 就 说 明 RTL8188 
USB WIFI 工作 正常 。 也 可 以 直接 在 开发 板 上 使 用 wlan0 来 ping 一 下 百度 网 站 , 输入 如 下 命令 : 
ping -I 192.168.1.126 www.baidu.com 
-I 是 指定 执行 ping 操作 的 网 卡 IP 地址， 我 们 要 使 用 wlan0 去 ping 百度 网 站 ， 因 此 要 通过 
“-I” 指 定 wlan0 的 IP 地 址 。 如 果 WIFI 工作 正常 的 话 就 可 以 ping 通 百 度 网 站 ， 如 图 70.4.2.4 
所 示 : 


/lib/modules/4.1.15 # ping -I 192.168.1.126 www.baidu.com 

PING www.baidu.com (14.215.177.39) from 192.168.1.126: 56 data bytes 
64 bytes from 14.215.177.39: seq=0 ttl-56 time-15.529 ms 

64 bytes from 14.215.177.39: seq=1 ttl-56 time-25.117 ms 

64 bytes from 14.215.177.39: seq=2 ttl-56 time-14.481 ms 

64 bytes from 14.215.177.39: seq=3 tt1=56 time-16.314 ms 

64 bytes from 14.215.177.39: seq-4 tt1=56 time-12.875 ms 


图 70.4.2.4 百度 网 站 ping 成 功 
至 此 RTL8188 USB WIFI 我 们 就 完全 驱动 起 来 了 ， 大 家 就 可 以 使 用 WIFI 来 进行 网 络 通信 
de 







































































70.4.2 RTL8189 SDIO WIFI 联网 测试 





RLT8189 SDIO WIFI 的 测试 和 RTL8188 USB WIFI 的 测试 方法 基本 一 致 ， 如 果 插 了 SD F 
的 话 先 将 SD FA LMX6U-ALPHA 开发 板 上 拔 出 ， 因 为 [MX6U-ALPHA 开发 板 的 SD 卡 和 
SDIO WIFI 公用 一 个 SDIO 接口 。 插 入 RTL8189 SDIO WIFI 模块 ， 然 后 加 载 RTL8189 驱动 ， 并 
且 打 开 对 应 的 wlan0( 如 果 只 有 RTL8189 一 个 WIFI 的 话 ) 网 卡 ， 使 用 iwlist 命令 搜索 要 连接 的 
WIFI 热点 是 否 存 在 ， 如 果 存 在 的 话 就 可 以 连接 了 。 
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RTL8189 SDIO WIFI 同样 使 用 wpa supplicant 来 完成 热点 连接 工作 ， 因 此 同样 需要 创建 
/etc/wpa supplicant.conf 文件 ， 有 具体 过 程 参考 70.4.1 小 节 。 一 切 准 备 就 绪 以 后 输入 如 下 命令 来 完 
成 WIFI 热点 连接 : 

wpa_supplicant -Dnl80211 -c /etc/wpa supplicant.conf -i wlan0 & 

注意 红色 字体 ， 使 用 RTL8189 的 话 应 该 使 用 “-Dnl80211”， 这 里 不 要 填 错 了 ! WIFI 热点 连 



































接 成 功 以 后 会 输出 如 图 70.4.2.1 所 示 信 息 : 


RTL871X: recv eapol packet 

RTL871X: send eapo] packet 

RTL871X: set pairwise key camid:4, addr:88:f8:72:8d:f3:18, kid:0, type 

wlan0: WPA: Key negotiation complRTL871X: set group key camid: 35 adir: 88: fs: 72:8d:f3:18, kid: 
ES 





e ui 88: f8: ;18 [PTK=CCMP GTK=CCMP] 
- Connection to 88:f8:72:8d:f3:18 completed [id=0 id_str=] 


/lib/modules/4.1.15 # J WIFI 连接 成 功 
图 70.4.2.1 RTL8189 SDIO WIFI 连接 成 功 

使 用 udhepc 命令 获取 IP 地 址 ， 命 令 如 下 : 

udhcpc -1 wlan0 

IP 地 址 获取 过 程 如 图 70.4.2.2 Bran: 
/lib/modules/4.1.15 £ * ME -i wlanO 

udhcpc: started, v1.29.0 
Setting IP address 0.0.0.0 on wlanO 
udhcpc: sending discover 
udhcpc: sending select for 192.168.1.118 
udhcpc: lease of 192.168.1.118 obtained, lease time 86400 
Setting IP address 192.168.1.118 on wlanO 
Deleting routers 
route: SIOCDELRT: No such process 
Adding router 192.168.1.1 
Recreating /etc/resolv.conf 
Adding DNS server 114.114.114.114 
/lib/modules/4.1.15 # y 
图 70.4.2.2 udhepc 获取 IP 地 址 过 程 

从 图 70.4.2.2 可 以 看 出 , wlan0 的 IP 地 址 为 192.168.1.118， 大 家 可 以 使 用 “ifeonfig wlan0” 
查看 一 下 wlan0 网 卡 的 详细 信息 。 可 以 通过 电脑 ping 一 下 192.168.1.118 测试 WIFI 是 否 工作 正 
常 ， 或 者 在 开发 板 上 使 用 wlan0 网 卡 ping 一 下 百度 网 址 来 测试 一 下 WIFI 工作 是 否 正常 ， 输 入 
如 下 命令 : 

ping -I 192.168.1.118 www.baidu.com 

如 果 ping 成 功 的 话 结果 如 图 70.4.2.3 所 示 : 
/lib/modules/4.1.15 # ping -I 192.168.1.118 www.baidu.com 
PING www.baidu.com (14.215.177.39) from 192.168.1.118: 56 data bytes 
64 bytes from 14.215.177.39: seq=0 tt1=56 time=11.410 ms 
64 bytes from 14.215.177.39: seq=1 ttl=56 time=15 .643 ms 
64 bytes from 14.215.177.39: seq=2 tt1=56 time-221.756 ms 

图 70.4.2.3 ping 百度 网 站 测试 成 功 

至 此 ， 如 何在 LMX6U-ALPHA 开发 板 上 使 用 WIFI 就 全 部 讲解 完了 ， 包 括 USB WIFI 和 
SDIO WIFI。 其 实 不 管 是 在 IMX6U 上 ， 还 是 在 其 他 的 SOC E, USB WIFI 和 SDIO WIFI 的 驱 
动 都 是 类 似 的 ， 大 家 可 以 参考 本 章 教程 讲 RTL8188、RTL8189 这 两 款 WIFI 的 驱动 移植 到 芯 


或 者 开发 板 上 。 
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第 七 十 一 章 Linux 4G 通信 实验 


前 面 我 们 学 习 了 如 何在 Linux 中 使 用 有 线 网 络 或 者 WIFI， 但 是 使 用 有 线 网 络 或 者 WIFI 有 
很 多 限制 ， 因 为 要 布线 ， 即使 是 WIFI 你 也 得 先 布线 ， 然 后 在 接 个 路 由 器 。 有 很 多 场合 是 不 方便 
布线 的 ， 这 个 时 候 就 是 4G 大 显 身 手 的 时 候 ， 产 品 可 以 直接 通过 4G 连接 到 网 络 ， 实 现 无 人 值 
守 。 本 章 我 们 就 来 学 一 下 如 何在 LMX6U-ALPHA 开发 板 中 使 用 4G 来 实现 联网 功能 。 
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71.1 4G 网 络 连 接 简介 


提起 4G 网 络 连 接 ， 大 家 可 能 会 觉得 是 个 很 难 的 东西 ， 其 实 对 于 艇 入 式 Linux 而 言 ，4G 网 
络 连 接 恰恰 相反 ， 不 难 ! 大 家 可 以 看 一 下 其 他 的 峙 入 式 Linux 或 者 Android 开发 板 ，4G 模块 都 
是 MiniPCIE 接口 的 ， 包 括 很 多 4G 模块 都 是 MiniPCIE 接口 的 。 但 是 大 家 稍微 深入 研究 一 下 就 
会 发 现 ， 这 些 4G 模块 虽然 用 了 MiniPCIE 接口 ， 但 是 实际 上 的 通信 接口 都 是 USB， 所 以 4G 模 
块 的 驱动 就 转换 为 了 USB 驱动 。 而 这 些 AG 模块 厂商 都 提供 了 详细 的 文档 讲解 如 何在 Linux 下 
使 用 AG 模块 ， 以 及 如 何 修改 Linux 内 核 加 入 4G 模块 驱动 。 正 点 原子 的 LMX6U-ALPHA 开发 
板 也 有 一 个 MiniPCIE 形式 的 4G 模块 接口 ， 虽 然 外 形 是 MiniPCIE 的 ， 但 是 内 心 却 是 USB 的 。 
LMX6U-ALPHA 开发 板 的 4G 模块 原理 图 如 图 71.4.1 所 示 : 
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71.4.1 4G 模块 原理 图 
图 71.4.1 中 的 U8 就 是 MiniPCIE 接口 ，MiniPCIE 接口 连接 到 了 GL850 这 个 HUB 芯片 的 
DP2 和 DM2， 也 就 是 GL850 的 USB2 接口 上 。U11 就 是 Nano SIM 接口 ，LMX6U-ALPHA JF 
发 板 使 用 Nano SIM 卡 ， 这 样 大 家 就 可 以 直接 拿 自 己 的 手机 卡 进 行 测试 。LMX6U-ALPHA 开发 
板 的 4G 接口 位 置 如 图 71.1.2 Bras: 
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MA A 





图 71.1.2 ALPHA 开发 板 4G 接口 
在 使 用 之 前 需要 将 AG 模块 插入 到 图 71.1.2 所 示 的 MiniPCIE 接口 上 ， 然 后 上 紧 两 边 的 螺 
丝 ，Nano SIM 卡 插入 到 图 71.1.2 中 的 Nano SIM 座 里 面 ， 注 意 Nano SIM 卡 的 方向 ! 
ano SIM 卡 的 金属 触 点 朝 下 ! 
ano SIM 卡 的 金属 触 点 朝 下 ! 
ano SIM 卡 的 金属 触 点 朝 下 ! 
里 论 上 所 有 的 MiniPCIE 接口 的 4G 模块 都 可 以 连接 到 正点 原子 的 LMX6U-ALPHA 开发 板 
上 ， 因 为 这 些 4G 模块 都 遵循 同样 的 接口 标准 ， 但 是 大 家 在 使 用 的 时 候 还 是 要 详细 的 看 一 下 AG 
模块 的 接口 引 脚 描述 .不 同 的 4G 模块 其 驱动 形式 也 不 同 ,本 章 我 们 讲解 两 款 4G 模块 在 LMX6U- 
ALPHA 开发 板 上 的 使 用 ， 一 个 是 上 海 移 远 公司 的 EC20， 另 外 一 个 是 高 新 兴 物 联 的 ME3630， 
文 两 款 AG 模块 都 有 MiniPCIE 接口 的 ， 这 两 个 4G 模块 如 图 71.4.2 所 示 : 
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CMIITID:2017CP6940 








图 71.4.2 4G 模块 
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图 71.4.2 中 左 侧 的 是 高 新 兴 物 联 的 ME3630-W 4G 模块 ， 右 侧 的 是 上 海 移 远 的 EC20 4G 模 
块 。 本 章 我 们 就 分 别 来 讲解 一 下 如 何在 LIMX6U-ALPHA 开发 板 上 使 用 EC20 和 ME3630 这 两 个 
4G 模块 。 
4G 模块 工作 是 需要 天 线 的 ， 因 此 在 选 购 AG 模块 的 时 候 一 定 要 记得 购买 和 天线， 否则 无 法 进 















































行 测试 。 一 般 MiniPCIE 接口 的 4G 模块 留 出 来 的 天 线 接口 为 IPEX 座 ， 因 此 购买 天 线 的 时 候 也 
要 选择 PEX 接口 的 , 或 者 使 用 IPEX 转 SMA 线 来 转 接 。 推荐 大 家 到 正 电 原 子 官方 店铺 购买 4G 
模块 和 相应 的 天 线 。 


71.2 高 新 兴 ME3630 4G 模块 实验 


71.2.1 ME3630 4G 模块 简介 


ME3630 4G 模块 是 正点 原子 官方 推荐 的 4G 通信 模块 ，ME3630 4G 模块 是 深圳 高 新 兴 物 联 
出 品 的 4G LTE 模块 ， 前 身 是 中 兴 物 联 ， 正 点 原子 是 高 新 兴 物 联 官方 代理 商 ， 因 此 在 模块 质量 
以 及 售后 服务 这 一 块 是 有 保证 的 。 

ME3630 Jé — 3 LTE Cat.4 七 模 全 网 通 4G 模块 ， 在 LTE 模式 下 可 以 提供 SoMbps 上 行 速率 
以 及 150Mbps 的 下 行 速率 ， 并 支持 回 退 到 3G 或 2G 网 络 。 此 模 组 支持 分 集 接 收 、 分 集 接收 是 
终端 产品 支持 双 天 线 以 提高 通信 质量 和 通信 可 靠 性 的 无 线 连接 技术 。ME3630 支持 多 种 网 络 协 
议 ， 比 如 PAP. CHAP. PPP 等 ,拥有 多 种 功能 ， 比 如 GNSS、Remote wakeup、SMS、 文 持 FoTA 
空中 升级 等 。ME3630 4G 模块 广泛 应 用 于 智能 抄 表 、 安 防 信 息 采 集 、 工 业 路 由 器 、 车 载 通信 以 
及 监控 等 等 M2M 领域 。ME3630 4G 模 组 特性 如 下 : 

、 一 路 USB2.0 接口 。 

、 一 路 UART 接口 。 

、SIM 卡 接口 支持 1.8/3.0V。 

、 内 置 TCP、UDP、FTP 和 HTTP 等 协议 。 
、 支 持 RAS/ECM/NDIS。 

、 文 持 AT 指令 。 

ME3630 4G 模块 有 多 种 配置 ， 比 如 纯 数 据 版 本 、 集 成 GNSS 版 本 、 全 网 通 版 本 等 等 ， 本 节 
教程 我 们 主要 使 用 到 ME3630 的 数据 通信 功能 ， 因 此 推荐 大 家 购买 全 网 通 数据 版 ， 如 果 想 要 定 
位 功能 的 话 就 购买 全 网 通 数据 +GNSS 版 本 ， 至 于 其 他 的 版 本 大 家 根据 自己 的 实际 需求 选择 即 
可 。 在 正式 使 用 ME3630 4G 模块 之 前 ， 请 先 将 其 插入 到 开发 板 的 MiniPCIE 座 上 、 上 紧 螺 、 插 
入 Nano SIM 卡 、 接 上 天 线 ， 如 图 71.2.1.1 所 示 : 
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71.2.1.1 ALPHA 开发 板 连 接 ME3630 模块 
一 切 准 备 就 绪 以 后 就 可 以 开始 驱动 ME3630 4G 模块 了 。 


71.2.2 ME3630 4G 模块 驱动 修改 


1、 添 加 USB 设备 信息 
我 们 需要 先 在 Linux 内 核 中 添加 ME3630 的 USB 设备 信息 ， 因 为 我 们 前 面 说 了 ，ME3630 





4G 模块 用 的 USB 接口 。 打 开 Linux 源码 的 drivers/usb/serial/option.c 文件 ， 找 到 options ids 数 
组 ， 然 后 在 里 面 添加 ME3630 的 PID 和 VID, — 要 添加 的 内 容 如 下 : 




















示例 代码 71.2.2.1 ME3630 PID 和 VID 信息 
USB DEVICE(0x19d2, 0x0117) }, /* ME3630*/ 




















Td 
PEU SBD GE (TRO CI MENGE] EOD) MN un 
3t 





USB DEVICE(0x19d2, 0x1476) }, 
完成 以 后 的 options ids 数组 如 图 71.2.2.1 所 示 : 





630Estatic const struct usb device id option ids[] = | 


631 { USB DEVICE(0x19d2, 0x0117) }, /* ME3630*/ 

632 { USB DEVICE(0x19d2, 0x0199) ), E3630 的 PID 和 VID 
633 ( USB DEVICE(0x19d2, 0x1476) ), 信息 

634 V OPTION PRODUCT COLT) ), 








图 71.2.2.1 添加 PID 和 VID 后 的 option ids 数组 
2、 添 加 ECM 支持 程序 
ME3630 支持 ECM 接口 ， 可 以 通过 ECM 接口 轻松 联网 ， 如 果 要 使 用 ECM 接口 的 话 需 要 

















修改 drivers/usb/serial/option.c 文件 里 面 的 option_probe 函数 。 找 到 此 函数 ， 然 后 在 里 面 输 入 如 
下 内 容 : 


il 
2 
E 


4 
5 











示例 代码 71.2.2.2 option. probe 函数 需要 添加 的 内 容 
7 MeO = 
if (serial->dev->descriptor.idVendor == 0x19dq2 && 
serial->dev->descriptor.idProduct == 0x1476 && 
serial-»interface-»cur altsetting-»desc. bInterfaceNumber == 3) 


return -ENODEV; 
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6 
7 if (serial-»dev-»descriptor.idVendor == 0x19d2 && 
8 serial-»dev-»descriptor.idProduct == 0x1476 && 
9 serial-»interface-»cur altsetting-»desc. bInterfaceNumber == 4) 
10 return -ENODEV; 
al 
12 if (serial->dev->descriptor.idVendor == 0x19d2 && 
T3 serial->dev->descriptor.idProduct == 0x1509 && 
14 serial-»interface-»cur altsetting-»desc. bInterfaceNumber = 4) 
15 return -ENODEV; 
16 
17 if (serial-»dev-»5descriptor.idVendor == 0x19d2 && 
18 serial-»dev-»descriptor.idProduct == 0x1509 && 
19 serial-»interface-»cur altsetting-»desc. bInterfaceNumber == 5) 
20 return -ENODEV; 
添加 完成 以 后 的 option probe 函数 如 图 71.2.2.2 所 示 : 
1889-7 if (dev desc-»idVendor == cpu to lel6(SAMSUNG VENDOR ID) && 
1890 dev desc-»idProduct == cpu to lel6(SAMSUNG PRODUCT GT B3730) && 
1891 iface desc--bInterfaceClass !- USB CLASS CDC DATA) 
1892 return -ENODEV; 
1893 需要 添加 的 内 容 
1894 /* EM3630 */ 
1895- if (serial-»2dev-»descriptor.idVendor == 0x19d2 && 
1896 serial-»dev-»descriptor.idProduct == 0x1476 && 
1897 serial-»interface-»cur altsetting-»desc. bInterfaceNumber 
1898 return -ENODEV; 
1899 
1900 - if (serial-»dev-»descriptor.idVendor == 0x19d2 && 
1901 serial-»dev-»descriptor.idProduct == 0x1476 && 
1902 serial-»interface-»cur altsetting-»-desc. bInterfaceNumber 
1903 return -ENODEV; 
1904 
1905- if (serial-»dev-»descriptor.idVendor == 0x19d2 && 
1906 serial-»dev-»descriptor.idProduct == 0x1509 && 
1907 serial-»interface-»cur altsetting-»desc. bInterfaceNumber 
1908 return -ENODEV; 
1909 
1910-7 if (serial-»2dev-»descriptor.idVendor == 0x19d2 && 
1911 serial-»dev-»descriptor.idProduct == 0x1509 && 
1912 serial-»interface-»cur altsetting-»desc. bInterfaceNumber 
1913 return -ENODEV; 





71.2.2.2 向 option probe 添加 的 内 容 


3、 配 置 Linux 内 核 
我 们 需要 配置 Linux 内 核 ， 首 先 使 能 USBNET 功能 ， 路 径 如 下 : 


-> Device Drivers 
-> -*- Network device support 
-» USB Network Adapters 
-> -*- Multi-purpose USB Networking Framework 


配置 如 图 71.2.2.3 所 示 : 
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zuozhongkai@ubuntu: -/linux/IMXG6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 


USB Network Adapters 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes 
features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in 
[ ] excluded «M» module < > module capable 
1(-) 
LAS 3 Miei Dused ethernet device Subpont 


ASIX AX88179/178A USB 3: 9/2. 0 to Gigabit Ethernet 

CDC Ethernet support (smart devices such as cable modems) 
CDC EEM support 

CDC NCM support 

Huawei NCM embedded AT channel support 

CDC MBIM support 


< Exit» «Help» < Save> < Load > 








图 71.2.2.3 使 能 USB 网 络 
接 下 来 我 们 还 需要 使 能 USB 串口 GSM、CDMA 驱动 ， 配 置 路 径 如 下 : 
-> Device Drivers 
-> [*] USB support 
-> <*> USB Serial Converter support 
-> <*> USB driver for GSM and CDMA modems 
配置 如 图 71.2.2.4 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 





USB Serial Converter support 

Arrow keys navigate the menu. <Enter> selects submenus ---> (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in 
[ ] excluded <M> module < > module capable 

1(-) 

CS USB REINER SET sspe p ed com chipcard reader (NEW) 

erial Driver (NEW) 


NEW) 


USB duis Barcode driver uel mode) (NEW) 
Xsens motion tracker serial interface driver (NEW) 
USB-Wishbone adapter interface driver (NEW) 

USB Quatech SSU-100 Single Port Serial Driver (NEW) 
USB Quatech Serial Driver for USB 2 devices (NEW) 
USB Debugging Device (NEW) 


< Exit > «Help» «Save» < Load > 





71.2.2.4 USB GSM fll CDMA 
继续 配置 Linux 内 核 ， 使 能 USB 的 CDC ACM 模式 ， 配 置 路 径 如 下 : 
-> Device Drivers 
-> [*] USB support 
-> <*> Support for Host-side USB 
-> <*> USB Modem (CDC ACM) support 
配置 如 图 71.2.2.5 所 示 : 
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zuozhongkai@ubuntu: -/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 


USB support 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing «Y» includes, «N» excludes, «M» modularizes 
features. Press «Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in 
[ ] excluded «M» module < > module capable 


i.MX21 HCD support 

HCD test mode support 

*** USB Device Class drivers *** 

SB Modem (CDC ACM) supporti 

USB Printer suppor 

USB Wireless Device Management support 

USB Test and Measurement Class support 

*** NOTE: USB_STORAGE depends on SCSI but BLK_DEV_SD may *** 
*** also be needed; see USB STORAGE Help for more info *** 
USB Mass Storage support 


STERIO > < Help > < Save > < Load > 








图 71.2.2.5 使 能 USB 的 CDC ACM 功能 
关于 Linux 内 核 的 配置 就 到 此 为 止 ， 编 译 一 下 Linux 内 核 ， 然 后 使 用 新 的 zImage 启动 开发 
板 。 如 果 ME3630 已 经 插 上 的 话 ， 系 统 启动 以 后 就 会 输出 如 图 71.2.2.6 所 示 的 信息 : 


usb 2-1.2: GSM modem (l-port) converter now attached to ttyUSBO 
option 2-1.2:1.1: GSM modem (1-port) converter detected 
usb 2-1.2: GSM modem (1-port) converter now attached to ttyUSBl 
option 2-1.2:1.2: GSM modem (1-port) converter detected 
usb 2-1.2: GSM modem (1l-port) converter now attached to ttyUSB2 



































71.2.2.6 ME3630 虚拟 USB 信息 
从 图 71.2.2.6 可 以 看 出 ，ME3630 虚拟 出 了 3 个 USB 设备 ， 分 别 为 ttyUSBO-ttyUSB2. Xt 

于 支持 ECM 接口 的 4G 模块 来 讲 ， 比 如 ZM5330/ZM8620/ME3620/ME3630。 如 果 模 块 工作 在 
ECM 模式 下 ， 可 以 通过 运行 “ifeonfig -a” 命 令 查看 对 应 的 网 卡 ， 网 卡 的 名 字 可 能 六 
usbX/ecmX/ethX 等 ，X 是 具体 的 数字 ， 如 果 存 在 的 话 就 说 明 ECM 接口 驱动 加 载 成 功 。 输 入 
“ifconfig -a” 命 令 ， 会 发 现 多 了 一 个 名 为 “usb0” 的 网 卡 ， 图 71.2.2.7 所 示 : 
usb0 Link encap:Ethernet Hwaddr 2A:07:47:62:3F:87 

BROADCAST MULTICAST MTU:1500 Metric:l1 

RX packets:0 errors:0 dropped:0 overruns:0 frame:0 

TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 


collisions:0 txqueuelen:1000 
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B) 


图 71.2.2.7 ME3630 对 应 的 usb0 网 卡 





























71.2.3 ME3630 4G 模块 ppp 联网 测试 


1、 使 能 Linux 内 核 ppp 功能 
ME3630 支持 通过 ppp 拨号 上 网 ， 也 是 支持 使 用 ECM 接口 上 网 , 我 们 先 来 学 习 一 下 如 何 通 
过 ppp 拨号 上 网 。 首先 我 们 需要 配置 Linux 内 核 , 打开 Linux 内 核 的 ppp 功能 , 配置 路 径 如 下 : 
-> Device Drivers 
-> [*] Network device support 
-> «*» PPP (point-to-point protocol) support 





-> «*» PPP BSD-Compress compression 
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-> «*» PPP Deflate compression 
-> [*] PPP filtering 
-» «*» PPP MPPE compression (encryption) 
-> [*] PPP multilink support 
-> <*> PPP over Ethernet 
-> «*» PPP support for async serial ports 
-» «*» PPP support for sync tty ports 

配置 完成 以 后 如 图 71.2.3.1 所 示 : 


zuozhongkai@ubuntu: -/linux/IMX6ULL/linux/temp/linux-imx-rel imx 4.1.15 2.1.0 ga alientek 


Network device support 
Arrow keys navigate the menu. «Enter» selects submenus ---» (or empty submenus ----). Highlighted 
letters are hotkeys. Pressing «Y» includes, <N> excludes, «M» modularizes features. Press 
«Esc»«Esc» to exit, «?» for Help, </> for Search. Legend: [*] built-in [ ] excluded «M» module 
« » module capable 


PHY Device support and infrastructure -- 
Micrel KS8995MA 5-ports 10/100 managed Ethernet switch 
PP (point-to-point protocol) support 

PPP BSD-Compress compression 

PPP Deflate compression 


PPP filtering ` 
PPP MPPE compression (encryption) PPP 相 关 的 全 部 选中 
PPP multilink support 
PPP over Ethernet 
PPP Speo for async SEa ports 

f 


SLIP Cerial line) support 
CSLIP compressed headers (NEW) 


< Exit» «Help» «Save» < Load > 











图 71.2.3.1 Linux 内 核 PPP 使 能 
配置 完成 以 后 重新 编译 一 下 Linux 内 核 , 得 到 新 的 zlmage 镜像 文件 , 然后 使 用 新 的 zImage 
镜像 文件 启动 开发 板 。 


2、 移 植 pppd 软件 


我 们 需要 通过 pppd 这 个 软件 来 实现 ppp 拨号 上 网 ， 这 个 软件 需要 我 们 移植 。 
在 移植 之 前 先 删 除 掉 /usrsbin/chat 这 个 软件 ! 
在 移植 之 前 先 删除 掉 /usrsbin/chat 这 个 软件 ! 
在 移植 之 前 先 删除 掉 /usrsbin/chat 这 个 软件 ! 

我 们 使 用 Busybox 制作 根 文 件 系 统 的 时 候 会 生成 /usr/sbin/chat 这 个 软件 ,我 们 一 会 移植 pppd 
的 时 候 也 会 编译 出 chat 软件 。 因 此 需要 将 根 文件 系统 中 原来 的 /usr/sbin/chat HIRIE, 
的 话 我 们 移植 的 chat 软件 工作 将 会 出 问题 ! 

pppd 源码 已 经 放 到 了 开发 板 光盘 中 ， 路 径 为 : 1、 例 程 源码 ->7、 第 三 方 库 源码 -> ppp- 
2.4.7.targz， 将 ppp-2.4.7.tar.gz 拷贝 到 Ubuntu 下 并 解压 ， 解 压 以 后 会 生成 一 个 名 为 ppp-2.4.7 的 
IFR. EAS] ppp-2.4.7 目录 中 ， 然 后 编译 pppd 源码 ， 命 令 如 下 : 

cd ppp-2.4.7/ 

make CC-arm-linux-gnueabihf-gcc /编译 

编译 完成 以 后 就 会 在 当前 目录 下 生成 chatchat. pppd/pppd. pppdump/pppdump 和 
pppstats/pppstats 这 四 个 文件 , 将 这 个 四 个 文件 拷贝 到 开发 板 根 文件 系统 中 的 /sur/bin 目录 下 ， 命 
令 如 下 : 

sudo cp chat/chat /home/zuozhongkai/linux/nfs/rootfs/usr/bin/ -f 
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sudo cp pppd/pppd /home/zuozhongkai/linux/nfs/rootfs/usr/bin/ -f 


sudo cp pppdump/pppdump /home/zuozhongkai/linux/nfs/rootfs/usr/bin/ -f 

sudo cp pppstats/pppstats /home/zuozhongkai/linux/nfs/rootfs/usr/bin/ -f 

完成 以 后 输入 “pppd -Vv” 查 看 一 下 pppd 的 版 本 号 ， 如 果 pppd 版 本 号 显示 正常 的 话 就 说 明 
pppd 移植 成 功 ， 如 图 71.2.3.2 所 示 : 

















/ # pppd -v 

pppd: unrecognized option '-v' 

pppd version 2.4.7 

Usage: pppd [ options ], where options are: 
«device» Communicate over the named device 
«speed» Set the baud rate to «speed» 
«loc»:«rem» Set the local and/or remote interface IP 

addresses. Either one may be omitted. 

asyncmap «n» Set the desired async map to hex «n» 
auth Require authentication from peer 
connect «p» Invoke shell command «p» to set up the serial line 
crtscts Use hardware RTS/CTS flow control 
defaultroute Add default route through interface 
file «f» Take options from file «f» 
modem Use modem control lines 
mru «n» Set MRU value to «n» for negotiation 

See pppd(8) for more options. 





图 71.2.3.2 pppd 版 本 号 信息 
3、ppp 上 网 测试 
在 使 用 pppd 进行 拨号 上 网 之 前 需要 先 创建 4 个 文件 ， 这 个 4 个 文件 必须 放 到 同一 个 目录 
下 。 在 开发 板 根 文件 系统 下 创建 /etc/gosuncn HR, 进入 到 刚刚 创建 的 /etc/gosuncn 目录 下 ， 然 后 
新 建 一 个 名 为 “ppp-on” 的 shell 脚本 文件 ， 在 ppp-on 文件 里 面 输入 如 下 所 示 内 容 : 
示例 代码 71.2.3.1 ppp-on 文件 内 容 




































































#!/bin/sh 


clear 





OPTION FILE-"gosuncn options" 
DIALER SCRIPT-$ (pwd)/gosuncn ppp dialer 
exec pppd file SOPTION FILE eeonmeeee en V E o SHADES. JSXCISCIEISAE pH 
再 新 建 一 个 名 为 “gosuncn_option” 的 文件 ， 在 文件 里 面 输入 如 下 所 示 内 容 : 
示例 代码 71.2.3.2 gosuncn_option 文件 内 容 


QU Hi UU N E 














/dev/ttyUSB2 
151552010 
GCmesces 
modem 
persist 

lock 

noauth 
noipdefault 
debug 

0 nodetach 


ESOS COD SI OX OI SCOTUS PS 


11 user Anyname 


m 
N 


password Anypassword 


rp 
w 


ipcp-accept-local 


[mx 
心 


ipcp-accept-remote 


1528 


I.MX6U HX Linux 驱动 开发 指南 e» 正点 原 T 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
15 defaultroute 


16 usepeerdns 

oe 

18 nobsdcomp 

SU 

20 dump 
第 1 行 ， 如 果 是 联通 或 移动 的 卡 就 是 用 ttyUSB2， 如 果 是 电信 的 卡 就 是 用 tyUSBO. 
第 11-12 行 ， 这 两 行内 容 和 所 使 用 的 卡 有 关 ， 如 果 是 联通 或 者 移动 的 卡 就 按照 

如 果 是 电信 的 卡 ， 要 改 为 如 下 所 示 内 容 : 


user card 














T 





的 写 ， 

















password card 
再 新 建 一 个 名 为 “gosuncn ppp_dialer” 的 文件 ， 输 入 如 下 所 示 内 容 : 
示例 代码 71.2.3.3 gosuncn. ppp. dialer 文件 内 容 




















1 ABORT MONIO GP ASESIESSTEEN ES 
2. ABORT "ERROR" 

3 TIMEOUT 120 

4 ç n" ATE 

MESZ MERCIER 

6 ECHO ON 

了 OK ATH 

8 OK AIND 

9 OK AT+CGDCONT=1 , \"IP\",\"3GNET\" 
10 OK ATD*99# 

11 CONNECT 











第 9 行 ， 后 面 的 3GNET 是 网 络 的 APN 码 ， 这 个 要 根据 自己 所 使 用 的 手机 卡 来 确定 ， 联 
通 卡 的 APN 为 3GNET， 移 动 卡 的 APN 为 CMNET。 因 为 我 使 用 的 是 联通 卡 进行 测试 的 ， 所 
有 这 里 设置 APN 为 3GNET， 如 果 使 用 的 移动 卡 ， 那 么 要 将 APN 设置 为 CMNET。 如 果 是 电 
信 的 卡 ， 那 么 第 9 行 要 改 为 : 
OK "AT+ZCAPN=card,card" 
第 10 行 ， 如 果 是 联通 或 移动 的 卡 ， 那 么 第 10 行 就 不 变 。 如 果 是 电信 的 卡 ， 那 么 第 10 fT 
































OK ATD#777 
最 后 新 建 一 个 名 为 “disconnect” 的 shell 脚本 ， 输 入 如 下 所 示 内 容 : 
示例 代码 71.2.3.4 disconnect 文件 内 容 
1 $!/bin/sh 
2 killall joel 
这 四 个 文件 编写 完成 以 后 要 给 予 ppp-on 和 disconnect 这 两 个 文件 可 执行 权限 ， 命 令 如 
F: 
chmod 777 ppp-on disconnect 
完成 以 后 输入 如 下 命令 连接 AG 网 络 : 
Jppp-on & 
在 ME3630 连接 4G 网 络 的 过 程 中 ， 可 能 会 出 现 如 图 71.2.3.3 所 示 的 错误 提示 : 
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& (from gosuncn_options) 
# (from gosunen- Cadets 


nobsdadcomp ü nN Qr 
Can't create lock file eT Yi No such file or directory 


图 71.2.3.3 ppp 拨号 上 网 错误 提示 
从 图 71.2.3.3 可 以 看 出 ， 提 示 不 能 创建 “Can't create lock file /var/lock/LCK..ttyUSB2 ", 检查 
根 文 件 系统 是 否 存在 /varrun 和 /var/lock 这 两 个 目录 ， 如 果 没 有 的 话 就 手动 创建 这 两 个 文件 夹 ， 



























命令 如 下 : 
mkdir /var/run /创建 /varrun 文件 夹 
mkdir /var/lock // 创 建 /var/lock 文件 夹 





完成 以 后 重新 输入 “./pppd-on &” MOE AG 网 络 ， 连 接 成 功 以 后 会 输入 如 图 71.2.3.4 
所 示 信 息 
Failed : to create /etc/ppp/resolv.conf: No such file or director 
not renlacina axisting defau] Q ia 


提示 找 不 到 /etc/ppp/resolv conf 这 个 文件 
primary DNS address 116.116.116.116 


Secondary DNS address 116.116.116.116 4G 模 块 P 地 址 已 经 获取 到 了 
图 71.2.3.4 4G 网 络 连接 信息 
从 图 71.2.3.4 可 以 看 出 ， 在 ME3630 4G 模块 联网 过 程 中 ， 需 要 用 到 /etc/ppp/resolv.conf X 
件 ， 但 是 我 们 当前 根 文件 系统 没有 此 文件 ， 所 以 需要 手动 创建 此 文件 。 创 建 完成 以 后 重启 开发 
板 ! 开发 板 重 启 以 后 进入 到 /etc/gosuncn 目录 ， 然 后 输入 如 下 命令 完成 拨号 上 网 : 
./ppp-on & 
ppp 拨号 成 功 以 后 就 会 生成 一 个 名 为 “ppp0” 的 网 卡 ， 如 图 71.2.3.5 所 示 : 


ppp0 Link encap:Point-to-Point Protocol 
inet addr:10.34.161.30 P-t-P:10.34.161.29 Mask:255.255.255.255 
UP POINTOPOINT RUNNING NOARP MULTICAST MTU:1500 Metric:1 
e packets:4 errors:0 dropped:0 overruns:O frame:0 
atri 3 errors:0 ar oppen: 0 overruns:0 carrier:0 
col isions:0 txqueuelen:3 
RX bytes:68 (68.0 B) TX bytes:54 (54.0 B) 


图 71.2.3.5 ppp0 网 卡 信息 
4G 网 络 测试 需要 关闭 其 他 网 卡 , 否则 的 话 网 络 测试 可 能 有 问题 , 但 是 我 们 现在 是 通过 网 络 

启动 的 系统 ， 并 且 通 过 NFS 挂 载 的 根 文件 系统 ， 因 此 我 们 没 法 关闭 其 他 的 网 卡 ， 比 如 eth0。 为 
了 解决 这 个 问题 ， 我 们 只 能 将 uboot、Linux kernel. .dtb 设备 树 和 根 文件 系统 都 烧 写 到 板子 的 
EMMC 或 NAND 上 ， 然 后 直接 启动 EMMC 或 NAND 上 的 系统 即 可 ， 这 样 就 不 需要 其 他 网 卡 
工作 了 。 烧 写 方法 请 参考 我 们 的 《第 二 十 九 章 系统 烧 写 》 这 里 就 不 详细 的 讲解 了 。 系 统 虐 写 
完成 以 后 设置 开发 板 从 EMMC 或 NAND 启动 ， 因 为 我 使 用 的 是 EMMC 核心 板 ， 因 此 设置 从 
EMMC 启动 ， 启 动 以 后 按照 前 面 的 步骤 先 让 ME3630 4G 模块 连接 上 网 络 。 确 保 当 前 开发 板 只 
有 一 个 ME3630 对 应 的 ppp0 网 卡 ， 最 后 直接 ping 百度 官网 即 可 ， 结 果 如 图 71.2.3.6 所 示 : 

/etc/gosuncn # ping www.baidu.com 

PING www.baidu.com (163.177. 151. 110): 56 data bytes 

64 bytes from 163.177.151.110: seq=0 tt1=53 time-29.598 ms 

64 bytes from 163.177.151.110: seq=1 ttlz53 time-57.429 ms 


64 bytes from 163.177.151.110: seq-2 tt1=53 time-48.761 ms 
64 bytes from 163.177.151.110: seq=3 tt1=53 time-48.115 ms 


图 71.2.3.6 ME3630 4G 模块 ping 百度 官网 












loca] IP address 10.151.124.203| 
remote IP address 10.151.124.204 
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71.2.4 ME3630 4G 模块 ECM 联网 测试 








对 于 支持 ECM 接口 的 模块 可 以 直接 通过 ECM 上 网 ，ME3630 模块 支持 ECM 接口 ， 习 
开发 板 ， 输 入 “ifconfig -a” 命 令 可 以 看 到 有 一 个 名 为 “usb0” 的 网 卡 ， 如 图 71.2.4.1 所 示 : 
usb0 Link encap:Ethernet Hwaddr FE:D6:B1:38:B5:6A 
BROADCAST MULTICAST MTU:1500 Metric:l1 
RX packets:0 errors:0 dropped:0 overruns:0 frame:0 
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 
collisions:0 txqueuelen:1000 
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B) 
图 71.2.4.1 usb0 网 卡 
这 个 usb0 网 卡 就 是 ECM 接口 对 应 的 网 卡 ， 我 们 需要 使 用 minicom 输入 一 些 AT 指令 ， 所 
以 要 先 用 minicom 打开 ttyUSB1，ttyUSB1 就 是 ME3630 的 AT 指令 串口 ， 波 特 率 设置 为 
115200。 打 开 以 后 依次 输入 如 下 指令 : 
AT+ZSWITCH=L 
然后 重启 开发 板 。 如 果 模 块 已 经 设置 为 ECM ERAD m T o 
©., EH AT 指令 +CGDCONT 来 设置 数据 参数 。 联 通 卡 的 APN 为 3gnet， 电 信 卡 的 APN 
为 ctnet， 移 动 卡 的 APN 为 cmnet。 比 如 我 现在 用 的 联通 卡 ， 所 以 设置 APN 为 3gnet， 命 令 如 
F: 


pip 
Ht 









































AT*CGDCONT-1," IP" ," CMNET" 
©, REEF AT 命令 : 
AT-ZECMCALL-1 
等 竺 连接 成 功 ， 连 接 成 功 以 后 会 输出 如 图 71.2.4.2 所 示 信 息 : 


pee CONNECT 
OK 


图 71.2.4.2 ME3630 ECM 接口 网 路 连接 成 功 
连接 成 功 以 后 打开 usb0 网 卡 ， 命 令 如 下 : 
ifconfig usb0 up /打开 usb0 网 卡 
usb0 网 卡 打 开 以 后 输入 如 下 命令 获取 IP 地 址 : 
udhcpc -i usb0 
IP 地 址 获取 过 程 如 图 71.2.4.3 所 示 : 


/ € udhcpc -i usbO 

udhcpc: started, v1.29.0 

Setting IP address 0.0.0.0 on usb0 
udhcpc: sending discover 

udhcpc: sending discover 

udhcpc: sending select for 10.164.232.36 
udhcpc: lease of 10.164.232.36 obtained, lease time 43200 
Setting IP address 10.164.232.36 on usb0 
Deleting routers 

route: SIOCDELRT: No such process 

Adding router 10.164.232.37 

Recreating /etc/resolv.conf 

Adding DNS server 120.80.80.80 

Adding DNS server 221.5.88.88 


图 71.2.4.3 usb0 网 卡 获取 IP 地 址 过 程 
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从 图 71.2.4.3 可 以 看 出 ，usb0 网 卡 获取 到 的 IP 地 址 为 10.164.232.36， 然 后 ping 一 下 百度 
官网 ， 如 果 能 ping 通 就 说 明 ME3630 的 ECM 接口 联网 成 功 。 如 果 提 示 “bad address 
www.baidu.com'”， 那 么 请 检查 一 下 DNS 服务 器 地 址 设置 是 否 正 确 ， 打 开 /etc/resolv.conf 文件 ， 
然后 加 入 “nameserver 114.114.114.114” 即 可 。 

至 此 ME3630 4G 模块 的 网 络 连接 就 已 经 全 部 测试 完成 ， 大 家 既 可 以 在 正点 原子 的 
IMX6U-ALPHA 开发 板 上 使 用 4G 上 网 了 。 


71.3 EC20 4G 模块 实验 


71.3.1 EC20 4G 模块 简介 


关于 EC20 4G 模块 的 详细 资料 请 找 卖家 索要 ! 

EC20 有 多 种 不 同 的 配置 ， 比 如 全 网 通 纯 数据 版 本 、 语 音 版 、 带 GNSS 版 等 等 ,建议 大 家 购 
买 的 时 候 至 少 要 选择 全 网 通 数 据 版 ， 因 为 我 们 使 用 4G 模块 主要 还 是 用 于 数据 通信 的 。 移 远 的 
EC20 4G 模块 采用 LTE 3GPP Rel.11 技术 ,支持 最 大 下 行 速率 150Mbps, 最 大 上 行 速率 50Mbps。 
EC20 4G 模块 特性 如 下 : 

1、 一 路 USB2.0 高 速 接口 ， 最 高 可 达 480Mbps。 

、 一 组 模拟 语音 接口 (可 选 )。 

3、1.8V/3.0V SIM 接口 。 

4、1 个 UART 接口 。 

5、W_DISABLE#( 飞 行 模式 控制 )。 

6、LED_WWAN#( 网 络 状态 指示 )。 

EC20 也 支持 AT 指令 ， 本 教程 不 讲 AT 指令 ， 关 于 AT 指令 的 使 用 请 参考 EC20 的 相关 文 
档 。 在 正式 使 用 EC20 4G 模块 之 前 ， 请 先 将 其 插入 到 开发 板 的 MiniPCIE EE, EXER. dA 
Nano SM 卡 、 接 上 天 线 ， 如 图 71.3.1.1 所 示 : 
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图 713.11 连接 好 4G 模块 
一 切 准 备 就 绪 以 后 就 可 以 开始 驱动 EC20 4G 模块 了 。 
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71.3.2 EC20 4G 模块 驱动 修改 


1、 添 加 USB 设备 信息 

我 们 需要 先 在 Linux 内 核 中 添加 EC20 的 USB 设备 信息 ， 因 为 我 们 前 面 说 了 ，EC20 4G 模 
块 用 的 USB 接口 。 打开 Linux 源码 的 drivers/usb/serial/option.c 文件 , 首先 定义 EC20 的 ID Zi, 
内 容 如 下 : 








示例 代码 71.3.2.1 EC20 4G 模块 ID 
L 4 mEe20 dg c 





























2 4define QUECTEL VENDOR ID 0X2C7C 
3 4$define QUECTEL PRODUCT EC20 0X0125 
完成 以 后 如 图 71.3.2.1 所 示 : 
511 
512 /* VIA Telecom */ 
513 £define VIATELECOM VENDOR ID 0x15eb 
514 £Zdefine VIATELECOM PRODUCT CDS7 0x0001 
515 
P a EC20 4G ID 信息 


517 | #define QUECTEL VENDOR ID 0X2C7C 
518|£define QUECTEL PRODUCT EC20 0X0125 








图 71.3.2.1 EC20 ID 添加 位 置 
继续 在 drivers/usb/serial/option.c 文件 里 面 找到 option ids 数组 ， 在 此 数组 里 面 加 入 如 下 内 








X 


示例 代码 71.3.2.2 option_ids 数组 添加 EC20 ID 信息 
( USB DEVICE(QUECTEL VENDOR ID, QUECTEL PRODUCT EC20) j, /* EC20 4G */ 
完成 以 后 option ids 数组 如 图 71.2.2.2 所 示 : 


630 口 static const struct usb device id option ids[] = | 


631 { USB DEVICE(QUECTEL VENDOR ID, QUECTEL PRODUCT EC20) }, /* EC20 4G */ 
632 ( USB DEVICE(OPTION VENDOR ID, OPTION PRODUCT COLT) }, 
633 ( USB DEVICE(OPTION VENDOR ID, OPTION PRODUCT RICOLA) }, 


ENDE 图 71.3.2.2 修改 后 的 option. ids 数组 
继续 在 drivers/usb/serial/option.c 文件 里 面 找到 option probe 函数 ， 在 此 函数 里 面 添加 如 下 
内 容 : 





















































示例 代码 71.3.2.3 option. probe 函数 添加 的 代码 





























jq J% BEZO wy 

2 if (dev desc->idVendor == cpu to lel6(0x05c6) && 
3 dev desc-»idProduct == cpu to le16(0x9003) && 
4 iface desc-»bInterfaceNumber »-2 4) 

5 return -ENODEV; 

6 

7 if (dev desc-»idVendor == cpu to lel6(0x05c6) && 
8 dev desc-»idProduct -- cpu to le16(0x9215) && 
9 iface desc-»bInterfaceNumber »-2 4) 

10 return -ENODEV; 

Jal 
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12 if (dev desc-»idVendor == cpu to lel6(0x2c7c) && 
LS iface desc-»bInterfaceNumber »-2 4) 
dla return -ENODEV; 
添加 完成 以 后 的 option probe 函数 如 图 71.3.2.3 所 示 : 
1885- if (dev desc-»idVendor == cpu to lel6(SAMSUNG VENDOR ID) && 
1886 dev desc-»idProduct -- cpu to lel6(SAMSUNG PRODUCT GT B3730) && 
1887 iface desc-»bInterfaceClass !- USB CLASS CDC DATA) 
1888 return -ENODEV; 


/* EC20 */ 

if (dev desc-»idVendor == cpu to lel6(0x05c6) && 
dev desc-»idProduct == cpu to le16(0x9003) && 
iface desc-»bInterfaceNumber >= 4) 
return -ENODEV; 


添加 到 option_probe 
中 的 代码 


if (dev desc-»idVendor == cpu to lel6(0x05c6) && 
dev desc-»idProduct == cpu to le16(0x9215) && 
iface desc-»bInterfaceNumber >= 4) 
return -ENODEV;| 


if (dev desc-»idVendor == cpu to lel6(0x2c7c) && 
iface desc-»bInterfaceNumber >= 4) 
return -ENODEV; 





1905 /* Store the blacklist info so we can use it during attach. */ 
1906 usb set serial data(serial, (void *)blacklist); 


图 71.3.2.3. 修改 后 的 option probe 函数 
继续 在 drivers/usb/serial/option.c 文件 里 面 找到 option 1port device 结构 体 变量 ， 在 里 面 加 
入 休眠 后 唤醒 接口 ， 如 图 71.3.2.4 所 示 : 




















1843 .read int callback = option instat callback, 
1844E#ifdef CONFIG PM 

1845 .suspend = usb wwan suspend, 

1846 | . resume = usb wwan resume, 





1847 .reset_resume = usb wwan resume, 


1848 fendif 


1849 }; 添加 的 休眠 唤醒 接口 


图 71.3.2.4 添加 的 休眠 唤醒 接 
打开 drivers/usb/serial/usb wwan.c 文件 ,在 usb wwan setup urb 函数 中 添加 零 包 处 理 代 码 ， 
完成 后 的 usb wwan setup urb 函数 如 下 所 示 : 
示例 代码 71.3.2.4 修改 后 的 usb. wwan setup urb 函数 


l. ESI struct urb wusa wien setup us(sErue ueo serial port "(9x 


Ll 











int endpoint, 
Lowe Car, volc eie. Ce vier. suae len, 


void (*callback) (struct urb *)) 


struct usb serial vserial = > 


OUO BAU N 
~ 


Str UC eve velo P 
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8 

9 urb — usb alloc urb(0, GFP KERNEL); /* No ISO */ 
10 TERGO) 

al return NULL; 

T2 

IS usb FLli bulk (el > 

14 usb endioulkpipe(lseriel->dey, endpoint) | eir, 
15 Buft len, callback cius) 

16 

1 [= EE20 */ 

18 if (dir == USB_DIR_OUT) { 

19 struct usb device descriptor *desc = 


&serial-»dev-»descriptor; 


20 if (desc-»idVendor == cpu to lel16(0x05c6) && 
21 desc-»iProduct == cpu to 1e16(0x9090)) 

22 urb-»transfer flags |= URB ZERO PACKET; 
23 

24 if (desc-»idVendor == cpu to lel16(0x05c6) && 
25 desc-»iProduct == cpu to 1e16(0x9003)) 

26 urb-»transfer flags |= URB ZERO PACKET; 
2 

28 if (desc-»idVendor == cpu to le16(0x05c6) && 
29 desc-»iProduct == cpu to 1e16(0x9215)) 

30 urb-»transfer flags |= URB ZERO PACKET; 
3T 

32 if (desc-»idVendor == cpu to lel16(0x2c7c)) 
33 urb->transfer_flags |= URB ZERO PACKET; 
34 } 

25 

36 return urb; 

EY 





第 18-34 行 就 是 要 添加 到 usb wwan setup urb 函数 里 面 的 零 包 处 理 代 码 。 至 此 ，Linux 内 
核 需要 修改 的 地 方 就 完了 。 编 译 一 下 Linux 内 核 ， 检 查 一 下 代码 修改 有 没有 问题 ， 如 果 修 改正 
确 的 话 就 是 没有 任何 问题 的 。 

2、 配 置 Linux 内 核 


我 们 需要 配置 Linux 内 核 , 使 能 USBNET、GSM、CDMA 驱动 等 , 配置 方法 和 我 们 在 71.2.2 
小 节 讲 解 的 ME3630 4G 模块 的 配置 方法 一 样 ， 大 家 参考 71.2.2 小 节 即 可 。 配置 完成 以 后 编译 一 
下 Linux 内 核 ， 然 后 使 用 新 的 zImage 启动 开发 板 。 如 果 EC20 已 经 插 上 上 的话， 系统 启动 以 后 就 
会 输出 如 图 71.3.2.5 所 示 的 信息 : 
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usb 2-1.2: new high-speed USB device number 3 using ci hdrc 
option 2-1.2:1.0: GSM modem (l-port) converter detected 

usb 2-1.2: GSM modem (l-port) converter now attached to ttyUSBO 
option 2-1.2:1.1: GSM modem (l-port) converter detected 

usb 2-1.2: GSM modem (l-port) converter now attached to ttyUSBl 
option 2-1.2:1.2: GSM modem (1-port) converter detected 

usb 2-1.2: GSM modem (1-port) converter now attached to ttyUSB2 
option 2-1.2:1.3: GSM modem (l-port) converter detected 

usb 2-1.2: GSM modem (1-port) converter now attached to ttyUSB3 


图 71.3.2.5 EC20 虚拟 出 的 USB 接口 
从 图 71.3.2.5 可 以 看 出 ， 多 了 ttyUSB0~ttyUSB3， 这 4 个 tty 接口 就 是 EC20 虚拟 出 来 的 ， 
可 以 查看 一 下 /dewttyUSB0~ttyUSB3 是 否 存在 ， 结 果 如 图 71.3.2.6 所 示 : 


/ # 1s /dev/ttyUSB* 
je /dev/ttyUSBl  /dev/ttyUSB2  /dev/ttyUSB3 














L] 


71.3.2.6 EC20 虚拟 出 来 的 tty 接 
71.3.2.6 中 的 这 4 路 ttyUSB 的 含义 见 表 71.3.2.1: 














ttyUSB0 DM 
ttyUSB1 GPS 的 NMEA 信息 输出 接口 
ttyUSB2 AT 指令 接口 

ttyUSB3 PPP 连接 或 AT 指令 接口 














表 71.3.2.1 四 路 ttyUSB 函数 

我 们 用 到 最 多 的 就 是 tyUSB1 和 ttyUSB2， 如 果 你 购买 的 EC20 模块 带 有 GPS 功能 ， 那 么 
就 可 以 通过 ttyUSB1 接口 读 取 GPS 数据 。 如 果 你 想 使 用 EC20 的 AT 指令 功能 ， 那 么 就 使 用 
ttyUSB2 接口 即 可 。 

3、 添 加 移 远 官方 的 GobiNet 驱动 

移 远 为 EC20 提供 了 GobiNet 驱动 ， 驱 动 源码 我 们 已 经 放 到 了 开发 板 光 盘 中 ， 路 径 为 : 1、 
例 程 源码 ->5、 模 块 驱动 源码 ->3、4G 模块 -> 移 远 EC20\EC20 R2.1 Mini PCIe-C->05 
Driver->Linux->GobiNet-> Quectel WCDMA&LTE Linux&Android GobiNet Driver V1.3.0.zip 。 
将 Quectel WCDMA&LTE Linux&Android GobiNet Driver V1.3.0/src 下 的 所 有 .c 和 .h 文件 都 拷 
贝 到 Linux 内 核 中 的 /driver/net/usb 目录 下 ， 也 就 是 图 71.3.2.7 中 所 示 的 文件 : 


?0 R2.1 Mini PCle-C > 05 Driver > Linux > GobiNet > Quectel WCDMA&LTE Linux&Android GobiNet Driver V1.3.0 > src 














^ 


名 称 修改 日 期 类 型 大 小 

Ø GobiUSBNet.c 2017-08-15 15:58 sourceinsight.c file 50 KB 
Ø QMI.c 2016-10-25 13:04 sourceinsight.c file 39 KB 
@ QMI.h 2016-10-25 13:04 H 文件 10 KB 
€^ QMIDevice.c 2016-10-26 11:46 sourceinsight.c file 113 KB 
@ QMIDeviceh 2016-10-25 13:04 H 文件 11 KB 
Ø Structs.h 2017-02-24 10:37 H 文件 14 KB 


图 71.3.2.7 需要 拷贝 的 文件 
拷贝 完成 以 后 打开 Linux 内 核 的 drivers/net/usb/Makefile 文件 ,在 此 文件 末尾 加 入 如 下 内 容 : 
示例 代码 71.3.2.5 修改 后 的 drivers/net/usb/Makefile 文件 
1 obj-$ (CONFIG USB GOBI NET) += GobiNet.o 
2 GobiNet-objs := GobiUSBNet.o QMIDevice.o QMI.o 
最 后 在 drivers/net/usb/Kconfig 文件 中 加 入 下 所 示 内 容 : 

















1536 


LMX6U RAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 
示例 代码 71.3.2.6 drivers/net/usb/Kconfig 要 添加 的 内 容 
config USB GOBI NET 














tristate"Gobi USB Net driver for Quectel module" 


help 


1 

2 

3 

4 Support Quectelmodule. 
5 

6 A modemmanager with support for GobiNet is recommended. 
ql 


Tocompile this driver as a module, choose M here: the module will be 
calledGobiNet.1 


ERARE drivers/net/usb/Kconfig 文件 中 的 位 置 如 图 71.3.2.8 Bras: 











575 

576 品 config USB GOBI NET 

577 tristate"Gobi USB Net driver for Quectel module" 

578 help 

579 Support Quectelmodule. 

580 

581 A modemmanager with support for GobiNet is recommended. 
582 Tocompile this driver as a module, choose M here: the module will be calledGobiNet. 
583 

584 endif # USB NET DRIVERS 添加 的 内 容 

585 


图 71.3.2.8 内 容 要 添加 的 位 置 
完成 以 后 打开 Linux 内 核 配 置 界面 ， 使 能 前 面 添加 的 Gobi 驱动 ， 配 置 路 径 如 下 : 
-> Device Drivers 

-> [*] Network device support 
-> -*- USB Network Adapters 
-> <*> Gobi USB Net driver for Quectel module 
配置 如 图 71.3.2.9 所 示 : 


zuozhongkai@ubuntu: ~/linux/IMX6ULL/linux/temp/linux-imx-rel_imx_4.1.15_2.1.0_ga_alientek 





USB Network Adapters 
Arrow keys navigate the menu. <Enter> selects submenus ---> (or empty submenus ----). 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in 
[ ] excluded <M> module < > module capable 


Sharp Zaurus (stock ROMs) and compatible 

Conexant CX82310 USB ethernet port 

Samsung Kalmia based LTE USB modem 

QMI WWAN driver for Qualcomm MSM based 3G and LTE modems 
Option USB High Speed Mobile Devices 
Intellon PLC based usb adapter 
Apple iPhone USB Ethernet driver 


PS obi USB Net driver for Quectel module 


S"Exit > < Help > < Save > < Load > 








71.3.2.9 使 能 Gobi 驱动 
配置 完成 以 后 就 重新 编译 一 下 Linux 内 核 ， 然 后 使 用 新 的 zImage 启动 开发 板 。 启 动 以 后 检 
查 一 下 “/dev/qcqmi2” 这 个 文件 是 否 存在 ， 如 果 存 在 的 话 就 说 明 Gobi 驱动 工作 成 功 。 至 此 ， 
EC20 的 驱动 就 已 经 修改 完成 了 ， 接 下 来 就 是 使 用 EC20 来 实现 联网 。 
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71.3.3 quectel-CM 移植 








要 使 用 EC20， 我 们 需要 用 到 移 远 提供 的 quectel-CM 这 个 软件 ， 这 个 软件 是 移 远 提供 的 网 
络 管理 工具 , 软件 源码 已 经 放 到 了 开发 板 光盘 中 , 路 径 为 : 1、 例 程 源码 ->5、 模 块 驱动 源码 ->3、 
4G 模 块 -> 移 远 EC20--EC20 R2.1 Mini PCIe-C->05 
Driver-»Linux-GobiNet--WCDMA&LTE QConnectManager Linux&Android V1.1.34.zip . 将 
We _QConnectManager Linux&Android V1.1.34.zip 这 个 压缩 包 进 行 解压 ， 得 到 
quectel-CM 这 个 文件 来 ， 然 后 将 quectel-CM AFP TUR Ubuntu 中 。 找 贝 完成 以 后 进入 到 
Ubuntu 中 的 quectel-CM 文件 来， 使 用 如 下 命令 进行 交叉 编译 : 

make CROSS COMPILE-arm-linux-gnueabihf- 
编译 完成 以 后 得 到 一 个 名 为 “quectel-CM” 软 件 ， 如 图 71.3.3.1 所 示 : 

: $ ls 


















































default.script main.c MPQMI.h QMIThread.c 
dhcpclient.c Makefile MPQMUX.c QMIThread.h udhcpc.c 


GobiNetCM.c MPQCTL.h MPQMUX.h QmiWwanCM.c util.c 
: | 


图 71.3.3.1 编译 出 来 的 quectel-CM 软件 
将 图 71.3.3.1 中 编译 出 来 的 quectel-CM 软件 拷贝 到 开发 板 根 文件 系统 的 /usr/bin 目录 下 , 命 
令 如 下 : 
sudo cp quectel-CM /home/zuozhongkai/linux/nfs/rootfs/usr/bin/ -f 
拷贝 完成 以 后 就 可 以 使 用 quectel-CM 软件 来 实现 EC20 联网 测试 了 。 




















71.3.4 EC20 上 网 测试 


在 开发 板 上 输入 如 下 命令 完成 EC20 的 4G 网 络 连接 : 

quectel-CM -s cenet & 

注意 ，quectel-CM 软件 会 使 用 到 udhepc 来 获取 IP 地址， 所 以 一 定 要 确保 当前 根 文 件 系统 
下 存在 udhcpc。 当 4G 网 络 连接 成 功 以 后 就 会 获取 到 IP 地 址 ， 如 图 71.3.4.1 所 示 : 


[01-02 00:10:46:318] ^x nad udhcpc -f -n -q -t 5 -i eth2 
udhcpc: started, v1.29 

[01- -92 _00:10:46:402] I: IP address 0.0.0.0 on eth2 
udhcpc: sending discover 

udhcpc: sending select for 10.26.28.49 

udhcpc: lease of 10.26.28.49 obtained, lease time 7200 
[01- -65 _00:10:46:603] Setting IP address 10.26.28.49 on eth2 
[01-02, 00:10:46:633] Deleting routers 

route: SIOCDELRT: No such process 

[01-02 00:10:46:672] Adding router 10.26.28.50 

[01-02 00:10:46:696] Recreating /etc/resolv.conf 

[01-02 00:10:46:724] Adding DNS server 116.116.116.116 
[01-02 00:10:46:731] Adding DNS server 221.5.88.88 


图 71.3.4.1 EC20 4G 网 络 连接 成 功 并 获取 到 IP 地 址 
从 图 71.3.4.1 可 以 看 出 ，EC20 对 应 的 网 卡 名 字 为 “eth2” A “ifconfig eth2” 即 可 查看 
eth2 网 卡 的 详细 信息 ， 如 图 71.3.4.2 所 示 : 
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A s p renr ig eth2 
Link encap:Ethernet Hwaddr DA:0D:91:63:8E:49 
inet addr:10.26.28.49 Bcast:10.26.28.51 Mask:255.255.255.252 
inet6 addr: fe80::d80d:91ff:fe63:8e49/64 Scope:Link 
UP BROADCAST RUNNING NOARP MULTICAST MTU:1500 Metric:l1 
RX packets:2 errors:0 dropped:0 overruns:0 frame:0 
a eya ee :5 errors:0 dropped:0 overruns:0 carrier:0 
cl isions:0 txqueuelen:1000 
RX bytes:612 (612.0 B) TX bytes:824 (824.0 B) 





/ € 
图 71.3.4.2 eth2 网 卡 详细 信息 
4G 网 络 测试 需要 关闭 其 他 网 卡 , 否则 的 话 网 络 测试 可 能 有 问题 , 但 是 我 们 现在 是 通过 网 络 

启动 的 系统 ， 并 且 通 过 NFS 挂 载 的 根 文件 系统 ， 因 此 我 们 没 法 关闭 其 他 的 网 卡 ， 比 如 eth0。 为 
了 解决 这 个 问题 ， 我 们 只 能 将 uboot. Linux kernel. .dtb 设备 树 和 根 文件 系统 都 烧 写 到 板子 的 
EMMC 或 NAND 上 ， 然 后 直接 启动 EMMC 或 NAND 上 的 系统 即 可 ， 这 样 就 不 需要 其 他 网 卡 
工作 了 。 烧 写 方法 请 参考 我 们 的 《第 二 十 九 章 系统 烧 写 )， 这 里 就 不 详细 的 讲解 了 。 系 统 烧 写 
完成 以 后 设置 开发 板 从 EMMC 或 NAND 启动 ， 因 为 我 使 用 的 是 EMMC 核心 板 ， 因 此 设置 从 
EMMC 启动 , 启动 以 后 按照 前 面 的 步骤 先 让 EC20 连接 上 网 络 。 确保 当前 开发 板 只 有 一 个 EC20 
对 应 的 eth2 网 卡 ， 然 后 直接 直接 ping 百度 官网 即 可 ， 结 果 如 图 71.3.4.3 所 示 : 

/ # ping www.baidu.com 

PING www.baidu.com (163.177.151.110): 56 data bytes 

64 bytes from 163.177.151.110: seq-0 tt1=54 time-18.342 ms 

64 bytes from 163.177.151.110: seq-1 ttl-54 time-31.896 ms 

64 bytes from 163.177.151.110: seq-2 tt1=54 time-31.401 ms 

64 bytes from 163.177.151.110: seq-3 tt1=54 time-30.934 ms 

64 bytes from 163.177.151.110: seq-4 tt1=54 timez30.339 ms 

图 71.3.4.3 ping 百度 官网 成 功 
如 果 ping 百度 官网 没有 问题 ， 那 么 就 表示 EC20 4G 模块 在 我 们 的 LMX6U-ALPHA 开发 板 

上 工作 正常 。 
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附录 A 
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第 A1 章 Buildroot 根 文 件 系统 构建 


1541 


LMX6U RAR Linux 驱动 开发 指南 O ERAF 





原子 哥 在 线 教 学 ，www.yuanzige.com 论坛 :www.opendev.com 


第 A2 章 Yocto 根 文 件 系统 构建 
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第 A3 章 Ubuntu 根 文件 系统 构建 
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